]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Update RELEASES.md
[rust.git] / RELEASES.md
1 Version 1.49.0 (2020-12-31)
2 ============================
3
4 Language
5 -----------------------
6
7 - [Unions can now implement `Drop`, and you can now have a field in a union
8   with `ManuallyDrop<T>`.][77547]
9 - [You can now cast uninhabited enums to integers.][76199]
10 - [You can now bind by reference and by move in patterns.][76119] This
11   allows you to selectively borrow individual components of a type. E.g.
12   ```rust
13   #[derive(Debug)]
14   struct Person {
15       name: String,
16       age: u8,
17   }
18
19   let person = Person {
20       name: String::from("Alice"),
21       age: 20,
22   };
23
24   // `name` is moved out of person, but `age` is referenced.
25   let Person { name, ref age } = person;
26   println!("{} {}", name, age);
27   ```
28 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
29
30 Compiler
31 -----------------------
32
33 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
34 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
35 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
36 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
37 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
38 - [Output from threads spawned in tests is now captured.][78227]
39 - [TODO: rustc_target: Change os and vendor values to "none" and "unknown" for some targets][78951]
40
41 \* Refer to Rust's [platform support page][forge-platform-support] for more
42 information on Rust's tiered platform support.
43
44 Libraries
45 -----------------------
46
47 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
48 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
49 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
50
51 Stabilized APIs
52 ---------------
53
54 - [`slice::select_nth_unstable`]
55 - [`slice::select_nth_unstable_by`]
56 - [`slice::select_nth_unstable_by_key`]
57
58 The following previously stable methods are now `const`.
59
60 - [`Poll::is_ready`]
61 - [`Poll::is_pending`]
62
63 Cargo
64 -----------------------
65 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
66 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
67 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
68   variable will be set if the crate being built is one the user selected to build, either
69   with `-p` or through defaults.
70 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
71
72
73 Compatibility Notes
74 -------------------
75
76 - [Demoted `i686-unknown-freebsd` to tier 2 support.][78746]
77 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
78   Previously such invalid or unused attributes could be ignored.
79   Previously invalid or unused attributes were ignored.
80
81 Internal Only
82 -------------
83 These changes provide no direct user facing benefits, but represent significant
84 improvements to the internals and overall performance of rustc and
85 related tools.
86
87 - [rustc's internal crates are now compiled using the `initial-exec` Thread
88   Local Storage model.][78201]
89 - [Calculate visibilities once in resolve.][78077]
90 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
91 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
92
93
94 [75991]: https://github.com/rust-lang/rust/pull/75991
95 [78951]: https://github.com/rust-lang/rust/pull/78951
96 [78848]: https://github.com/rust-lang/rust/pull/78848
97 [78746]: https://github.com/rust-lang/rust/pull/78746
98 [78376]: https://github.com/rust-lang/rust/pull/78376
99 [78228]: https://github.com/rust-lang/rust/pull/78228
100 [78227]: https://github.com/rust-lang/rust/pull/78227
101 [78201]: https://github.com/rust-lang/rust/pull/78201
102 [78109]: https://github.com/rust-lang/rust/pull/78109
103 [78077]: https://github.com/rust-lang/rust/pull/78077
104 [77997]: https://github.com/rust-lang/rust/pull/77997
105 [77703]: https://github.com/rust-lang/rust/pull/77703
106 [77547]: https://github.com/rust-lang/rust/pull/77547
107 [77015]: https://github.com/rust-lang/rust/pull/77015
108 [76199]: https://github.com/rust-lang/rust/pull/76199
109 [76119]: https://github.com/rust-lang/rust/pull/76119
110 [75914]: https://github.com/rust-lang/rust/pull/75914
111 [74989]: https://github.com/rust-lang/rust/pull/74989
112 [79004]: https://github.com/rust-lang/rust/pull/79004
113 [78676]: https://github.com/rust-lang/rust/pull/78676
114 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
115 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
116 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
117 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
118 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
119 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
120 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
121 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
122
123
124 Version 1.48.0 (2020-11-19)
125 ==========================
126
127 Language
128 --------
129
130 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
131   is still rejected *semantically*, but can now be parsed by procedural macros.
132
133 Compiler
134 --------
135 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
136   `rustc` whether to link its own C runtime and libraries or to rely on a external
137   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
138 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
139   Note: If you're using cargo you must explicitly pass the `--target` flag.
140 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
141
142 \* Refer to Rust's [platform support page][forge-platform-support] for more
143 information on Rust's tiered platform support.
144
145 Libraries
146 ---------
147 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
148   and `&Stderr`.][76275]
149 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
150 - [The `matches!` macro now supports having a trailing comma.][74880]
151 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
152 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
153
154 Stabilized APIs
155 ---------------
156 - [`slice::as_ptr_range`]
157 - [`slice::as_mut_ptr_range`]
158 - [`VecDeque::make_contiguous`]
159 - [`future::pending`]
160 - [`future::ready`]
161
162 The following previously stable methods are now `const fn`'s:
163
164 - [`Option::is_some`]
165 - [`Option::is_none`]
166 - [`Option::as_ref`]
167 - [`Result::is_ok`]
168 - [`Result::is_err`]
169 - [`Result::as_ref`]
170 - [`Ordering::reverse`]
171 - [`Ordering::then`]
172
173 Cargo
174 -----
175
176 Rustdoc
177 -------
178 - [You can now link to items in `rustdoc` using the intra-doc link
179   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
180   a link to `std::future`'s documentation. See ["Linking to items by
181   name"][intradoc-links] for more information.
182 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
183   when searching through `rustdoc`'s UI.][75740]
184
185 Compatibility Notes
186 -------------------
187 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
188   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
189   promoted to `'static` lifetime any more inside `const fn`s.
190 - [Associated type bindings on trait objects are now verified to meet the bounds
191   declared on the trait when checking that they implement the trait.][27675]
192 - [When trait bounds on associated types or opaque types are ambiguous, the
193   compiler no longer makes an arbitrary choice on which bound to use.][54121]
194 - [Fixed recursive nonterminals not being expanded in macros during
195   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
196   correctly handling recursive nonterminal tokens.
197 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
198 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
199   in places where they have no effect.][73461]
200 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
201   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
202 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
203   disallow zero-initialization.][71274]
204 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
205 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
206   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
207   see the [`catch_unwind`] documentation for further information.
208
209
210
211 Internal Only
212 -------------
213 These changes provide no direct user facing benefits, but represent significant
214 improvements to the internals and overall performance of rustc and
215 related tools.
216
217 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
218   You can continue building with `make` by setting `ninja=false` in
219   your `config.toml`.
220 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
221 - [Made `ensure_sufficient_stack()` non-generic][76680]
222
223 [78143]: https://github.com/rust-lang/rust/issues/78143
224 [76680]: https://github.com/rust-lang/rust/pull/76680/
225 [76030]: https://github.com/rust-lang/rust/pull/76030/
226 [70212]: https://github.com/rust-lang/rust/pull/70212/
227 [27675]: https://github.com/rust-lang/rust/issues/27675/
228 [54121]: https://github.com/rust-lang/rust/issues/54121/
229 [71274]: https://github.com/rust-lang/rust/pull/71274/
230 [77386]: https://github.com/rust-lang/rust/pull/77386/
231 [77153]: https://github.com/rust-lang/rust/pull/77153/
232 [77055]: https://github.com/rust-lang/rust/pull/77055/
233 [76275]: https://github.com/rust-lang/rust/pull/76275/
234 [76310]: https://github.com/rust-lang/rust/pull/76310/
235 [76420]: https://github.com/rust-lang/rust/pull/76420/
236 [76158]: https://github.com/rust-lang/rust/pull/76158/
237 [75857]: https://github.com/rust-lang/rust/pull/75857/
238 [75585]: https://github.com/rust-lang/rust/pull/75585/
239 [75740]: https://github.com/rust-lang/rust/pull/75740/
240 [75502]: https://github.com/rust-lang/rust/pull/75502/
241 [74880]: https://github.com/rust-lang/rust/pull/74880/
242 [74922]: https://github.com/rust-lang/rust/pull/74922/
243 [74430]: https://github.com/rust-lang/rust/pull/74430/
244 [74194]: https://github.com/rust-lang/rust/pull/74194/
245 [73461]: https://github.com/rust-lang/rust/pull/73461/
246 [73166]: https://github.com/rust-lang/rust/pull/73166/
247 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
248 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
249 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
250 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
251 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
252 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
253 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
254 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
255 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
256 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
257 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
258 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
259 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
260 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
261 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
262
263
264 Version 1.47.0 (2020-10-08)
265 ==========================
266
267 Language
268 --------
269 - [Closures will now warn when not used.][74869]
270
271 Compiler
272 --------
273 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
274   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
275   platforms.
276 - [Upgraded to LLVM 11.][73526]
277 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
278 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
279 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
280
281 \* Refer to Rust's [platform support page][forge-platform-support] for more
282 information on Rust's tiered platform support.
283
284 Libraries
285 ---------
286 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
287 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
288   those of length less than 33.][74060]
289 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
290 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
291   `PartialEq`, and `PartialOrd`.][73583]
292
293 Stabilized APIs
294 ---------------
295 - [`Ident::new_raw`]
296 - [`Range::is_empty`]
297 - [`RangeInclusive::is_empty`]
298 - [`Result::as_deref`]
299 - [`Result::as_deref_mut`]
300 - [`Vec::leak`]
301 - [`pointer::offset_from`]
302 - [`f32::TAU`]
303 - [`f64::TAU`]
304
305 The following previously stable APIs have now been made const.
306
307 - [The `new` method for all `NonZero` integers.][73858]
308 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
309   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
310   methods for all integers.][73858]
311 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
312   signed integers.][73858]
313 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
314   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
315   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
316   `is_ascii_control` methods for `char` and `u8`.][73858]
317
318 Cargo
319 -----
320 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
321   You can override this by setting the following in your `Cargo.toml`.
322   ```toml
323   [profile.release.build-override]
324   opt-level = 3
325   ```
326 - [`cargo-help` will now display man pages for commands rather just the
327   `--help` text.][cargo/8456]
328 - [`cargo-metadata` now emits a `test` field indicating if a target has
329   tests enabled.][cargo/8478]
330 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
331 - [`cargo-publish` will now use an alternative registry by default if it's the
332   only registry specified in `package.publish`.][cargo/8571]
333
334 Misc
335 ----
336 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
337   type based search.][75366]
338 - [Added the Ayu theme to rustdoc.][71237]
339
340 Compatibility Notes
341 -------------------
342 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
343 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
344 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
345   help to preserve more span information.][73084] These changes may cause
346   compiliation errors if your macro was unhygenic or didn't correctly handle
347   `Delimiter::None`.
348 - [Moved support for the CloudABI target to tier 3.][75568]
349 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
350 - [Added the `rustc-docs` component.][75560] This allows you to install
351   and read the documentation for the compiler internal APIs. (Currently only
352   available for `x86_64-unknown-linux-gnu`.)
353
354 Internal Only
355 --------
356
357 - [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.
358
359 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
360 [75048]: https://github.com/rust-lang/rust/pull/75048/
361 [74163]: https://github.com/rust-lang/rust/pull/74163/
362 [71237]: https://github.com/rust-lang/rust/pull/71237/
363 [74869]: https://github.com/rust-lang/rust/pull/74869/
364 [73858]: https://github.com/rust-lang/rust/pull/73858/
365 [75716]: https://github.com/rust-lang/rust/pull/75716/
366 [75908]: https://github.com/rust-lang/rust/pull/75908/
367 [75516]: https://github.com/rust-lang/rust/pull/75516/
368 [75560]: https://github.com/rust-lang/rust/pull/75560/
369 [75568]: https://github.com/rust-lang/rust/pull/75568/
370 [75366]: https://github.com/rust-lang/rust/pull/75366/
371 [75204]: https://github.com/rust-lang/rust/pull/75204/
372 [74650]: https://github.com/rust-lang/rust/pull/74650/
373 [74419]: https://github.com/rust-lang/rust/pull/74419/
374 [73964]: https://github.com/rust-lang/rust/pull/73964/
375 [74021]: https://github.com/rust-lang/rust/pull/74021/
376 [74060]: https://github.com/rust-lang/rust/pull/74060/
377 [73893]: https://github.com/rust-lang/rust/pull/73893/
378 [73526]: https://github.com/rust-lang/rust/pull/73526/
379 [73583]: https://github.com/rust-lang/rust/pull/73583/
380 [73084]: https://github.com/rust-lang/rust/pull/73084/
381 [73197]: https://github.com/rust-lang/rust/pull/73197/
382 [72488]: https://github.com/rust-lang/rust/pull/72488/
383 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
384 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
385 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
386 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
387 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
388 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
389 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
390 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
391 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
392 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
393 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
394 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
395 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
396 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
397 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
398
399
400 Version 1.46.0 (2020-08-27)
401 ==========================
402
403 Language
404 --------
405 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
406 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
407   const functions.][73862]
408 - [The `#[track_caller]` attribute can now be added to functions to use the
409   function's caller's location information for panic messages.][72445]
410 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
411   `x.0.0` over `(x.0).0`.
412 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
413   You currently can't use `mem::transmute` in constant functions.
414
415 Compiler
416 --------
417 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
418 - [Enabled static "Position Independent Executables" by default
419   for `x86_64-unknown-linux-musl`.][70740]
420
421 Libraries
422 ---------
423 - [`mem::forget` is now a `const fn`.][73887]
424 - [`String` now implements `From<char>`.][73466]
425 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
426   integer types.][73032]
427 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
428 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
429   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
430 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
431 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
432 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
433
434 Stabilized APIs
435 ---------------
436 - [`Option::zip`]
437 - [`vec::Drain::as_slice`]
438
439 Cargo
440 -----
441 Added a number of new environment variables that are now available when
442 compiling your crate.
443
444 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
445   the specific binary being compiled and the name of the crate.
446 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
447 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
448
449 Compatibility Notes
450 -------------------
451 - [The target configuration option `abi_blacklist` has been renamed
452   to `unsupported_abis`.][74150] The old name will still continue to work.
453 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
454   This was previously accepted but will become a hard error in a future release.
455 - [Rustc will fail to compile if you have a struct with
456   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
457   allowed on `enum`s.
458 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
459   ensure that spans have the correct information, and may cause breakage if you
460   were relying on receiving spans with dummy information.
461 - [The InnoSetup installer for Windows is no longer available.][72569] This was
462   a legacy installer that was replaced by a MSI installer a few years ago but
463   was still being built.
464 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
465 - [Rustc will no longer accept overlapping trait implementations that only
466   differ in how the lifetime was bound.][72493]
467 - [Rustc now correctly relates the lifetime of an existential associated
468   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
469   you to pass a shorter lifetime than expected.
470 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
471   The library will need to be installed for `rustc` to work, even though we
472   expect it to be already available on most systems.
473 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
474   under QEMU.][74820]
475 - [Pretty printing of some tokens in procedural macros changed.][75453] The
476   exact output returned by rustc's pretty printing is an unstable
477   implementation detail: we recommend any macro relying on it to switch to a
478   more robust parsing system.
479
480 [75453]: https://github.com/rust-lang/rust/issues/75453/
481 [74820]: https://github.com/rust-lang/rust/issues/74820/
482 [74420]: https://github.com/rust-lang/rust/issues/74420/
483 [74109]: https://github.com/rust-lang/rust/pull/74109/
484 [74150]: https://github.com/rust-lang/rust/pull/74150/
485 [73862]: https://github.com/rust-lang/rust/pull/73862/
486 [73887]: https://github.com/rust-lang/rust/pull/73887/
487 [73466]: https://github.com/rust-lang/rust/pull/73466/
488 [73516]: https://github.com/rust-lang/rust/pull/73516/
489 [73293]: https://github.com/rust-lang/rust/pull/73293/
490 [73007]: https://github.com/rust-lang/rust/pull/73007/
491 [73032]: https://github.com/rust-lang/rust/pull/73032/
492 [72920]: https://github.com/rust-lang/rust/pull/72920/
493 [72569]: https://github.com/rust-lang/rust/pull/72569/
494 [72583]: https://github.com/rust-lang/rust/pull/72583/
495 [72584]: https://github.com/rust-lang/rust/pull/72584/
496 [72717]: https://github.com/rust-lang/rust/pull/72717/
497 [72437]: https://github.com/rust-lang/rust/pull/72437/
498 [72445]: https://github.com/rust-lang/rust/pull/72445/
499 [72486]: https://github.com/rust-lang/rust/pull/72486/
500 [72493]: https://github.com/rust-lang/rust/pull/72493/
501 [72331]: https://github.com/rust-lang/rust/pull/72331/
502 [71896]: https://github.com/rust-lang/rust/pull/71896/
503 [71660]: https://github.com/rust-lang/rust/pull/71660/
504 [71322]: https://github.com/rust-lang/rust/pull/71322/
505 [70740]: https://github.com/rust-lang/rust/pull/70740/
506 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
507 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
508 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
509 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
510 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
511
512
513 Version 1.45.2 (2020-08-03)
514 ==========================
515
516 * [Fix bindings in tuple struct patterns][74954]
517 * [Fix track_caller integration with trait objects][74784]
518
519 [74954]: https://github.com/rust-lang/rust/issues/74954
520 [74784]: https://github.com/rust-lang/rust/issues/74784
521
522
523 Version 1.45.1 (2020-07-30)
524 ==========================
525
526 * [Fix const propagation with references.][73613]
527 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
528 * [Avoid spurious implicit region bound.][74509]
529 * [Install clippy on x.py install][74457]
530
531 [73613]: https://github.com/rust-lang/rust/pull/73613
532 [73078]: https://github.com/rust-lang/rust/issues/73078
533 [74509]: https://github.com/rust-lang/rust/pull/74509
534 [74457]: https://github.com/rust-lang/rust/pull/74457
535
536
537 Version 1.45.0 (2020-07-16)
538 ==========================
539
540 Language
541 --------
542 - [Out of range float to int conversions using `as` has been defined as a saturating
543   conversion.][71269] This was previously undefined behaviour, but you can use the
544    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
545    may be desirable in rare performance sensitive situations.
546 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
547   using `u64`.][70705]
548 - [Function like procedural macros can now be used in expression, pattern, and  statement
549   positions.][68717] This means you can now use a function-like procedural macro
550   anywhere you can use a declarative (`macro_rules!`) macro.
551
552 Compiler
553 --------
554 - [You can now override individual target features through the `target-feature`
555   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
556   equivalent to `-C target-feature=+avx2,+fma`.
557 - [Added the `force-unwind-tables` flag.][69984] This option allows
558   rustc to always generate unwind tables regardless of panic strategy.
559 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
560   to include LLVM bitcode into generated `rlib`s (this is on by default).
561 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
562 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
563 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
564 - [Upgraded to LLVM 10.][67759]
565
566 \* Refer to Rust's [platform support page][forge-platform-support] for more
567 information on Rust's tiered platform support.
568
569
570 Libraries
571 ---------
572 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
573   and `Ord`.][72239]
574 - [`proc_macro::TokenStream` now implements `Default`.][72234]
575 - [You can now use `char` with
576   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
577   a range of codepoints.][72413] E.g.
578   you can now write the following;
579   ```rust
580   for ch in 'a'..='z' {
581       print!("{}", ch);
582   }
583   println!();
584   // Prints "abcdefghijklmnopqrstuvwxyz"
585   ```
586 - [`OsString` now implements `FromStr`.][71662]
587 - [The `saturating_neg` method has been added to all signed integer primitive
588   types, and the `saturating_abs` method has been added for all integer
589   primitive types.][71886]
590 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
591   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
592   or `Path`.][71447]
593 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
594 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
595   integer types.][69813]
596 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
597   integer types.][72324]
598 - [The `fetch_update` method has been added to all atomic integer types.][71843]
599
600 Stabilized APIs
601 ---------------
602 - [`Arc::as_ptr`]
603 - [`BTreeMap::remove_entry`]
604 - [`Rc::as_ptr`]
605 - [`rc::Weak::as_ptr`]
606 - [`rc::Weak::from_raw`]
607 - [`rc::Weak::into_raw`]
608 - [`str::strip_prefix`]
609 - [`str::strip_suffix`]
610 - [`sync::Weak::as_ptr`]
611 - [`sync::Weak::from_raw`]
612 - [`sync::Weak::into_raw`]
613 - [`char::UNICODE_VERSION`]
614 - [`Span::resolved_at`]
615 - [`Span::located_at`]
616 - [`Span::mixed_site`]
617 - [`unix::process::CommandExt::arg0`]
618
619 Cargo
620 -----
621
622 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
623   time.][cargo/8066]
624
625 Misc
626 ----
627 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
628   `~~outdated information~~` becomes "~~outdated information~~".
629 - [Added an emoji to Rustdoc's deprecated API message.][72014]
630
631 Compatibility Notes
632 -------------------
633 - [Trying to self initialize a static value (that is creating a value using
634   itself) is unsound and now causes a compile error.][71140]
635 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
636   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
637 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
638   previously undocumented and not intended for public use. Rustdoc still provides
639   a non-zero exit code on errors.
640 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
641   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
642   flags while cargo is adding `embed-bitcode` itself. The recommended way to
643   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
644   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
645
646 Internals Only
647 --------------
648 - [Make clippy a git subtree instead of a git submodule][70655]
649 - [Unify the undo log of all snapshot types][69464]
650
651 [71848]: https://github.com/rust-lang/rust/issues/71848/
652 [73420]: https://github.com/rust-lang/rust/issues/73420/
653 [72324]: https://github.com/rust-lang/rust/pull/72324/
654 [71843]: https://github.com/rust-lang/rust/pull/71843/
655 [71886]: https://github.com/rust-lang/rust/pull/71886/
656 [72234]: https://github.com/rust-lang/rust/pull/72234/
657 [72239]: https://github.com/rust-lang/rust/pull/72239/
658 [72397]: https://github.com/rust-lang/rust/pull/72397/
659 [72413]: https://github.com/rust-lang/rust/pull/72413/
660 [72014]: https://github.com/rust-lang/rust/pull/72014/
661 [72062]: https://github.com/rust-lang/rust/pull/72062/
662 [72094]: https://github.com/rust-lang/rust/pull/72094/
663 [72133]: https://github.com/rust-lang/rust/pull/72133/
664 [67759]: https://github.com/rust-lang/rust/pull/67759/
665 [71900]: https://github.com/rust-lang/rust/pull/71900/
666 [71928]: https://github.com/rust-lang/rust/pull/71928/
667 [71662]: https://github.com/rust-lang/rust/pull/71662/
668 [71716]: https://github.com/rust-lang/rust/pull/71716/
669 [71447]: https://github.com/rust-lang/rust/pull/71447/
670 [71269]: https://github.com/rust-lang/rust/pull/71269/
671 [71095]: https://github.com/rust-lang/rust/pull/71095/
672 [71140]: https://github.com/rust-lang/rust/pull/71140/
673 [70655]: https://github.com/rust-lang/rust/pull/70655/
674 [70705]: https://github.com/rust-lang/rust/pull/70705/
675 [69984]: https://github.com/rust-lang/rust/pull/69984/
676 [69813]: https://github.com/rust-lang/rust/pull/69813/
677 [69464]: https://github.com/rust-lang/rust/pull/69464/
678 [68717]: https://github.com/rust-lang/rust/pull/68717/
679 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
680 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
681 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
682 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
683 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
684 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
685 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
686 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
687 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
688 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
689 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
690 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
691 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
692 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
693 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
694 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
695 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
696
697
698 Version 1.44.1 (2020-06-18)
699 ===========================
700
701 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
702 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
703 * [Fix crashes when finding backtrace on macOS.][71397]
704 * [Clippy applies lint levels into different files.][clippy/5356]
705
706 [71397]: https://github.com/rust-lang/rust/issues/71397
707 [73078]: https://github.com/rust-lang/rust/issues/73078
708 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
709 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
710
711
712 Version 1.44.0 (2020-06-04)
713 ==========================
714
715 Language
716 --------
717 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
718 - [Added the `unused_braces` lint.][70081]
719
720 **Syntax-only changes**
721
722 - [Expansion-driven outline module parsing][69838]
723 ```rust
724 #[cfg(FALSE)]
725 mod foo {
726     mod bar {
727         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
728     }
729 }
730 ```
731
732 These are still rejected semantically, so you will likely receive an error but
733 these changes can be seen and parsed by macros and conditional compilation.
734
735 Compiler
736 --------
737 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
738   Additionally when in incremental mode rustc defaults to 256 codegen units.
739 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
740   a panic is thrown.][67502]
741 - [Added tier 3\* support for the `aarch64-unknown-none` and
742   `aarch64-unknown-none-softfloat` targets.][68334]
743 - [Added tier 3 support for `arm64-apple-tvos` and
744   `x86_64-apple-tvos` targets.][68191]
745
746
747 Libraries
748 ---------
749 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
750   `vec![]` to be able to be used in `const` contexts.
751 - [`convert::Infallible` now implements `Hash`.][70281]
752 - [`OsString` now implements `DerefMut` and `IndexMut` returning
753   a `&mut OsStr`.][70048]
754 - [Unicode 13 is now supported.][69929]
755 - [`String` now implements `From<&mut str>`.][69661]
756 - [`IoSlice` now implements `Copy`.][69403]
757 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
758 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
759 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
760   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
761   integer types.][69373]
762
763 Stabilized APIs
764 ---------------
765 - [`PathBuf::with_capacity`]
766 - [`PathBuf::capacity`]
767 - [`PathBuf::clear`]
768 - [`PathBuf::reserve`]
769 - [`PathBuf::reserve_exact`]
770 - [`PathBuf::shrink_to_fit`]
771 - [`f32::to_int_unchecked`]
772 - [`f64::to_int_unchecked`]
773 - [`Layout::align_to`]
774 - [`Layout::pad_to_align`]
775 - [`Layout::array`]
776 - [`Layout::extend`]
777
778 Cargo
779 -----
780 - [Added the `cargo tree` command which will print a tree graph of
781   your dependencies.][cargo/8062] E.g.
782   ```
783     mdbook v0.3.2 (/Users/src/rust/mdbook)
784   ├── ammonia v3.0.0
785   │   ├── html5ever v0.24.0
786   │   │   ├── log v0.4.8
787   │   │   │   └── cfg-if v0.1.9
788   │   │   ├── mac v0.1.1
789   │   │   └── markup5ever v0.9.0
790   │   │       ├── log v0.4.8 (*)
791   │   │       ├── phf v0.7.24
792   │   │       │   └── phf_shared v0.7.24
793   │   │       │       ├── siphasher v0.2.3
794   │   │       │       └── unicase v1.4.2
795   │   │       │           [build-dependencies]
796   │   │       │           └── version_check v0.1.5
797   ...
798   ```
799   You can also display dependencies on multiple versions of the same crate with
800   `cargo tree -d` (short for `cargo tree --duplicates`).
801
802 Misc
803 ----
804 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
805   the version in the sidebar.][69494]
806
807 Compatibility Notes
808 -------------------
809 - [Rustc now correctly generates static libraries on Windows GNU targets with
810   the `.a` extension, rather than the previous `.lib`.][70937]
811 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
812 - [The `file_name` property in JSON output of macro errors now points the actual
813   source file rather than the previous format of `<NAME macros>`.][70969]
814   **Note:** this may not point to a file that actually exists on the user's system.
815 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
816 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
817   not allow zero initialization such as `NonZeroU8`.][66059] This was
818   previously a warning.
819 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
820   operator has been defined as a saturating operation.][71269] This was previously
821   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
822   continue using the current behaviour, which may be desirable in rare performance
823   sensitive situations.
824
825 Internal Only
826 -------------
827 These changes provide no direct user facing benefits, but represent significant
828 improvements to the internals and overall performance of rustc and
829 related tools.
830
831 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
832 - [Replace big JS dict with JSON parsing.][71250]
833
834 [69373]: https://github.com/rust-lang/rust/pull/69373/
835 [66059]: https://github.com/rust-lang/rust/pull/66059/
836 [68191]: https://github.com/rust-lang/rust/pull/68191/
837 [68899]: https://github.com/rust-lang/rust/pull/68899/
838 [71147]: https://github.com/rust-lang/rust/pull/71147/
839 [71250]: https://github.com/rust-lang/rust/pull/71250/
840 [70937]: https://github.com/rust-lang/rust/pull/70937/
841 [70969]: https://github.com/rust-lang/rust/pull/70969/
842 [70632]: https://github.com/rust-lang/rust/pull/70632/
843 [70281]: https://github.com/rust-lang/rust/pull/70281/
844 [70345]: https://github.com/rust-lang/rust/pull/70345/
845 [70048]: https://github.com/rust-lang/rust/pull/70048/
846 [70081]: https://github.com/rust-lang/rust/pull/70081/
847 [70156]: https://github.com/rust-lang/rust/pull/70156/
848 [71269]: https://github.com/rust-lang/rust/pull/71269/
849 [69838]: https://github.com/rust-lang/rust/pull/69838/
850 [69929]: https://github.com/rust-lang/rust/pull/69929/
851 [69661]: https://github.com/rust-lang/rust/pull/69661/
852 [69778]: https://github.com/rust-lang/rust/pull/69778/
853 [69494]: https://github.com/rust-lang/rust/pull/69494/
854 [69403]: https://github.com/rust-lang/rust/pull/69403/
855 [69033]: https://github.com/rust-lang/rust/pull/69033/
856 [68692]: https://github.com/rust-lang/rust/pull/68692/
857 [68334]: https://github.com/rust-lang/rust/pull/68334/
858 [67502]: https://github.com/rust-lang/rust/pull/67502/
859 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
860 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
861 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
862 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
863 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
864 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
865 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
866 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
867 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
868 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
869 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
870 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
871 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
872
873
874 Version 1.43.1 (2020-05-07)
875 ===========================
876
877 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
878 * [Fixed the stabilization of AVX-512 features.][71473]
879 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
880
881 [71430]: https://github.com/rust-lang/rust/pull/71430
882 [71473]: https://github.com/rust-lang/rust/issues/71473
883 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
884
885
886 Version 1.43.0 (2020-04-23)
887 ==========================
888
889 Language
890 --------
891 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
892   the type inferred correctly.][68129]
893 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
894
895 **Syntax only changes**
896 - [Allow `type Foo: Ord` syntactically.][69361]
897 - [Fuse associated and extern items up to defaultness.][69194]
898 - [Syntactically allow `self` in all `fn` contexts.][68764]
899 - [Merge `fn` syntax + cleanup item parsing.][68728]
900 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
901   For example, you may now write:
902   ```rust
903   macro_rules! mac_trait {
904       ($i:item) => {
905           trait T { $i }
906       }
907   }
908   mac_trait! {
909       fn foo() {}
910   }
911   ```
912
913 These are still rejected *semantically*, so you will likely receive an error but
914 these changes can be seen and parsed by macros and
915 conditional compilation.
916
917
918 Compiler
919 --------
920 - [You can now pass multiple lint flags to rustc to override the previous
921   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
922   everything in the `unused` lint group except `unused-variables` which
923   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
924   everything in the `unused` lint group **including** `unused-variables` since
925   the allow flag is specified before the deny flag (and therefore overridden).
926 - [rustc will now prefer your system MinGW libraries over its bundled libraries
927   if they are available on `windows-gnu`.][67429]
928 - [rustc now buffers errors/warnings printed in JSON.][69227]
929
930 Libraries
931 ---------
932 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
933   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
934   respectively.][69538] **Note** These conversions are only available when `N`
935   is `0..=32`.
936 - [You can now use associated constants on floats and integers directly, rather
937   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
938   `f32::NAN` with no imports.
939 - [`u8::is_ascii` is now `const`.][68984]
940 - [`String` now implements `AsMut<str>`.][68742]
941 - [Added the `primitive` module to `std` and `core`.][67637] This module
942   reexports Rust's primitive types. This is mainly useful in macros
943   where you want avoid these types being shadowed.
944 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
945 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
946
947 Stabilized APIs
948 ---------------
949 - [`Once::is_completed`]
950 - [`f32::LOG10_2`]
951 - [`f32::LOG2_10`]
952 - [`f64::LOG10_2`]
953 - [`f64::LOG2_10`]
954 - [`iter::once_with`]
955
956 Cargo
957 -----
958 - [You can now set config `[profile]`s in your `.cargo/config`, or through
959   your environment.][cargo/7823]
960 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
961   executable path when running integration tests or benchmarks.][cargo/7697]
962   `<name>` is the name of your binary as-is e.g. If you wanted the executable
963   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
964
965 Misc
966 ----
967 - [Certain checks in the `const_err` lint were deemed unrelated to const
968   evaluation][69185], and have been moved to the `unconditional_panic` and
969   `arithmetic_overflow` lints.
970
971 Compatibility Notes
972 -------------------
973
974 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
975   has been a warning since 1.36.0.
976 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
977   led to some instances being accepted, and now correctly emits a hard error.
978
979 [69340]: https://github.com/rust-lang/rust/pull/69340
980
981 Internal Only
982 -------------
983 These changes provide no direct user facing benefits, but represent significant
984 improvements to the internals and overall performance of `rustc` and
985 related tools.
986
987 - [All components are now built with `opt-level=3` instead of `2`.][67878]
988 - [Improved how rustc generates drop code.][67332]
989 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
990 - [traits: preallocate 2 Vecs of known initial size][69022]
991 - [Avoid exponential behaviour when relating types][68772]
992 - [Skip `Drop` terminators for enum variants without drop glue][68943]
993 - [Improve performance of coherence checks][68966]
994 - [Deduplicate types in the generator witness][68672]
995 - [Invert control in struct_lint_level.][68725]
996
997 [67332]: https://github.com/rust-lang/rust/pull/67332/
998 [67429]: https://github.com/rust-lang/rust/pull/67429/
999 [67637]: https://github.com/rust-lang/rust/pull/67637/
1000 [67642]: https://github.com/rust-lang/rust/pull/67642/
1001 [67878]: https://github.com/rust-lang/rust/pull/67878/
1002 [67885]: https://github.com/rust-lang/rust/pull/67885/
1003 [68129]: https://github.com/rust-lang/rust/pull/68129/
1004 [68672]: https://github.com/rust-lang/rust/pull/68672/
1005 [68725]: https://github.com/rust-lang/rust/pull/68725/
1006 [68728]: https://github.com/rust-lang/rust/pull/68728/
1007 [68738]: https://github.com/rust-lang/rust/pull/68738/
1008 [68742]: https://github.com/rust-lang/rust/pull/68742/
1009 [68764]: https://github.com/rust-lang/rust/pull/68764/
1010 [68772]: https://github.com/rust-lang/rust/pull/68772/
1011 [68943]: https://github.com/rust-lang/rust/pull/68943/
1012 [68952]: https://github.com/rust-lang/rust/pull/68952/
1013 [68966]: https://github.com/rust-lang/rust/pull/68966/
1014 [68984]: https://github.com/rust-lang/rust/pull/68984/
1015 [69022]: https://github.com/rust-lang/rust/pull/69022/
1016 [69185]: https://github.com/rust-lang/rust/pull/69185/
1017 [69194]: https://github.com/rust-lang/rust/pull/69194/
1018 [69201]: https://github.com/rust-lang/rust/pull/69201/
1019 [69227]: https://github.com/rust-lang/rust/pull/69227/
1020 [69548]: https://github.com/rust-lang/rust/pull/69548/
1021 [69256]: https://github.com/rust-lang/rust/pull/69256/
1022 [69361]: https://github.com/rust-lang/rust/pull/69361/
1023 [69366]: https://github.com/rust-lang/rust/pull/69366/
1024 [69538]: https://github.com/rust-lang/rust/pull/69538/
1025 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1026 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1027 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1028 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1029 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1030 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1031 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1032 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1033
1034
1035 Version 1.42.0 (2020-03-12)
1036 ==========================
1037
1038 Language
1039 --------
1040 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1041   ```rust
1042   fn foo(words: &[&str]) {
1043       match words {
1044           ["Hello", "World", "!", ..] => println!("Hello World!"),
1045           ["Foo", "Bar", ..] => println!("Baz"),
1046           rest => println!("{:?}", rest),
1047       }
1048   }
1049   ```
1050 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1051   that you can create an enum that has the exact layout and ABI of the type
1052   it contains.
1053 - [There are some *syntax-only* changes:][67131]
1054    - `default` is syntactically allowed before items in `trait` definitions.
1055    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1056      leave out their bodies in favor of `;`.
1057    - Bounds on associated types in `impl`s are now syntactically allowed
1058      (e.g. `type Foo: Ord;`).
1059    - `...` (the C-variadic type) may occur syntactically directly as the type of
1060       any function parameter.
1061
1062   These are still rejected *semantically*, so you will likely receive an error
1063   but these changes can be seen and parsed by procedural macros and
1064   conditional compilation.
1065
1066 Compiler
1067 --------
1068 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1069 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1070 - [`Option::{expect,unwrap}` and
1071    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1072    pointing to the location where they were called, rather than
1073    `core`'s internals. ][67887]
1074
1075 \* Refer to Rust's [platform support page][forge-platform-support] for more
1076 information on Rust's tiered platform support.
1077
1078 Libraries
1079 ---------
1080 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1081 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1082    to implement `Sized`.][67935]
1083 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1084 - [`Layout::new` is now `const`.][66254]
1085 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1086
1087
1088 Stabilized APIs
1089 ---------------
1090 - [`CondVar::wait_while`]
1091 - [`CondVar::wait_timeout_while`]
1092 - [`DebugMap::key`]
1093 - [`DebugMap::value`]
1094 - [`ManuallyDrop::take`]
1095 - [`matches!`]
1096 - [`ptr::slice_from_raw_parts_mut`]
1097 - [`ptr::slice_from_raw_parts`]
1098
1099 Cargo
1100 -----
1101 - [You no longer need to include `extern crate proc_macro;` to be able to
1102   `use proc_macro;` in the `2018` edition.][cargo/7700]
1103
1104 Compatibility Notes
1105 -------------------
1106 - [`Error::description` has been deprecated, and its use will now produce a
1107   warning.][66919] It's recommended to use `Display`/`to_string` instead.
1108
1109 [68253]: https://github.com/rust-lang/rust/pull/68253/
1110 [68348]: https://github.com/rust-lang/rust/pull/68348/
1111 [67935]: https://github.com/rust-lang/rust/pull/67935/
1112 [68339]: https://github.com/rust-lang/rust/pull/68339/
1113 [68122]: https://github.com/rust-lang/rust/pull/68122/
1114 [67712]: https://github.com/rust-lang/rust/pull/67712/
1115 [67887]: https://github.com/rust-lang/rust/pull/67887/
1116 [67131]: https://github.com/rust-lang/rust/pull/67131/
1117 [67233]: https://github.com/rust-lang/rust/pull/67233/
1118 [66899]: https://github.com/rust-lang/rust/pull/66899/
1119 [66919]: https://github.com/rust-lang/rust/pull/66919/
1120 [66254]: https://github.com/rust-lang/rust/pull/66254/
1121 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1122 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1123 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1124 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1125 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1126 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1127 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1128 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1129 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1130
1131
1132 Version 1.41.1 (2020-02-27)
1133 ===========================
1134
1135 * [Always check types of static items][69145]
1136 * [Always check lifetime bounds of `Copy` impls][69145]
1137 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1138
1139 [69225]: https://github.com/rust-lang/rust/issues/69225
1140 [69145]: https://github.com/rust-lang/rust/pull/69145
1141
1142
1143 Version 1.41.0 (2020-01-30)
1144 ===========================
1145
1146 Language
1147 --------
1148
1149 - [You can now pass type parameters to foreign items when implementing
1150   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1151 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1152   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1153   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1154 - [You can now use any valid identifier in a `format_args` macro.][66847]
1155   Previously identifiers starting with an underscore were not allowed.
1156 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1157   enum variants.][66183] These are still rejected semantically, but
1158   can be seen and parsed by procedural macros and conditional compilation.
1159
1160 Compiler
1161 --------
1162
1163 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1164 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1165 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1166 - [You can now pass an arguments file passing the `@path` syntax
1167   to rustc.][66172] Note that the format differs somewhat from what is
1168   found in other tooling; please see [the documentation][argfile-docs] for
1169   more information.
1170 - [You can now provide `--extern` flag without a path, indicating that it is
1171   available from the search path or specified with an `-L` flag.][64882]
1172
1173 \* Refer to Rust's [platform support page][forge-platform-support] for more
1174 information on Rust's tiered platform support.
1175
1176 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1177
1178 Libraries
1179 ---------
1180
1181 - [The `core::panic` module is now stable.][66771] It was already stable
1182   through `std`.
1183 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1184   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1185 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1186
1187 Stabilized APIs
1188 ---------------
1189
1190 - [`Result::map_or`]
1191 - [`Result::map_or_else`]
1192 - [`std::rc::Weak::weak_count`]
1193 - [`std::rc::Weak::strong_count`]
1194 - [`std::sync::Weak::weak_count`]
1195 - [`std::sync::Weak::strong_count`]
1196
1197 Cargo
1198 -----
1199
1200 - [Cargo will now document all the private items for binary crates
1201   by default.][cargo/7593]
1202 - [`cargo-install` will now reinstall the package if it detects that it is out
1203   of date.][cargo/7560]
1204 - [Cargo.lock now uses a more git friendly format that should help to reduce
1205   merge conflicts.][cargo/7579]
1206 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
1207   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1208   optimisation level to `2` for debug builds. You can also use
1209   `[profile.<profile>.build-override]` to override build scripts and
1210   their dependencies.
1211
1212 Misc
1213 ----
1214
1215 - [You can now specify `edition` in documentation code blocks to compile the block
1216   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1217   should be compiled the 2018 edition of Rust.
1218 - [You can now provide custom themes to rustdoc with `--theme`, and check the
1219   current theme with `--check-theme`.][54733]
1220 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1221
1222 Compatibility Notes
1223 -------------------
1224
1225 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1226   Apple targets.][apple-32bit-drop] This means that the source code is still
1227   available to build, but the targets are no longer being tested and release
1228   binaries for those platforms will no longer be distributed by the Rust project.
1229   Please refer to the linked blog post for more information.
1230
1231 [54733]: https://github.com/rust-lang/rust/pull/54733/
1232 [61351]: https://github.com/rust-lang/rust/pull/61351/
1233 [67255]: https://github.com/rust-lang/rust/pull/67255/
1234 [66661]: https://github.com/rust-lang/rust/pull/66661/
1235 [66771]: https://github.com/rust-lang/rust/pull/66771/
1236 [66847]: https://github.com/rust-lang/rust/pull/66847/
1237 [66238]: https://github.com/rust-lang/rust/pull/66238/
1238 [66277]: https://github.com/rust-lang/rust/pull/66277/
1239 [66325]: https://github.com/rust-lang/rust/pull/66325/
1240 [66172]: https://github.com/rust-lang/rust/pull/66172/
1241 [66183]: https://github.com/rust-lang/rust/pull/66183/
1242 [65879]: https://github.com/rust-lang/rust/pull/65879/
1243 [65013]: https://github.com/rust-lang/rust/pull/65013/
1244 [64882]: https://github.com/rust-lang/rust/pull/64882/
1245 [64325]: https://github.com/rust-lang/rust/pull/64325/
1246 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1247 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1248 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1249 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1250 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1251 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1252 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1253 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1254 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1255 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1256 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1257
1258 Version 1.40.0 (2019-12-19)
1259 ===========================
1260
1261 Language
1262 --------
1263 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1264   `const` contexts.][65188] e.g.
1265
1266   ```rust
1267   pub struct Point(i32, i32);
1268
1269   const ORIGIN: Point = {
1270       let constructor = Point;
1271
1272       constructor(0, 0)
1273   };
1274   ```
1275
1276 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1277   indicate that there may be variants or fields added in the future.][64639]
1278   For example this requires adding a wild-card branch (`_ => {}`) to any match
1279   statements on a non-exhaustive `enum`. [(RFC 2008)]
1280 - [You can now use function-like procedural macros in `extern` blocks and in
1281   type positions.][63931] e.g. `type Generated = macro!();`
1282 - [Function-like and attribute procedural macros can now emit
1283   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1284 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1285   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1286   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1287
1288 Compiler
1289 --------
1290 - [Added tier 3 support\* for the
1291   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1292 - [Added tier 3 support for the
1293   `aarch64-unknown-none-softfloat` target.][64589]
1294 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1295   `mips64el-unknown-linux-muslabi64` targets.][65843]
1296
1297 \* Refer to Rust's [platform support page][forge-platform-support] for more
1298   information on Rust's tiered platform support.
1299
1300 Libraries
1301 ---------
1302 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1303
1304 Stabilized APIs
1305 ---------------
1306 - [`BTreeMap::get_key_value`]
1307 - [`HashMap::get_key_value`]
1308 - [`Option::as_deref_mut`]
1309 - [`Option::as_deref`]
1310 - [`Option::flatten`]
1311 - [`UdpSocket::peer_addr`]
1312 - [`f32::to_be_bytes`]
1313 - [`f32::to_le_bytes`]
1314 - [`f32::to_ne_bytes`]
1315 - [`f64::to_be_bytes`]
1316 - [`f64::to_le_bytes`]
1317 - [`f64::to_ne_bytes`]
1318 - [`f32::from_be_bytes`]
1319 - [`f32::from_le_bytes`]
1320 - [`f32::from_ne_bytes`]
1321 - [`f64::from_be_bytes`]
1322 - [`f64::from_le_bytes`]
1323 - [`f64::from_ne_bytes`]
1324 - [`mem::take`]
1325 - [`slice::repeat`]
1326 - [`todo!`]
1327
1328 Cargo
1329 -----
1330 - [Cargo will now always display warnings, rather than only on
1331   fresh builds.][cargo/7450]
1332 - [Feature flags (except `--all-features`) passed to a virtual workspace will
1333   now produce an error.][cargo/7507] Previously these flags were ignored.
1334 - [You can now publish `dev-dependencies` without including
1335   a `version`.][cargo/7333]
1336
1337 Misc
1338 ----
1339 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1340   when running documentation tests with `rustdoc`.][63803]
1341
1342 Compatibility Notes
1343 -------------------
1344 - [As previously announced, any previous NLL warnings in the 2015 edition are
1345   now hard errors.][64221]
1346 - [The `include!` macro will now warn if it failed to include the
1347   entire file.][64284] The `include!` macro unintentionally only includes the
1348   first _expression_ in a file, and this can be unintuitive. This will become
1349   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1350 - [Using `#[inline]` on function prototypes and consts now emits a warning under
1351   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1352   or `extern` blocks now correctly emits a hard error.
1353
1354 [65294]: https://github.com/rust-lang/rust/pull/65294/
1355 [66103]: https://github.com/rust-lang/rust/pull/66103/
1356 [65843]: https://github.com/rust-lang/rust/pull/65843/
1357 [65188]: https://github.com/rust-lang/rust/pull/65188/
1358 [65092]: https://github.com/rust-lang/rust/pull/65092/
1359 [64589]: https://github.com/rust-lang/rust/pull/64589/
1360 [64639]: https://github.com/rust-lang/rust/pull/64639/
1361 [64221]: https://github.com/rust-lang/rust/pull/64221/
1362 [64284]: https://github.com/rust-lang/rust/pull/64284/
1363 [63931]: https://github.com/rust-lang/rust/pull/63931/
1364 [64035]: https://github.com/rust-lang/rust/pull/64035/
1365 [63674]: https://github.com/rust-lang/rust/pull/63674/
1366 [63803]: https://github.com/rust-lang/rust/pull/63803/
1367 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1368 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1369 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1370 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1371 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1372 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1373 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1374 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1375 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1376 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1377 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1378 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1379 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1380 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1381 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1382 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1383 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1384 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1385 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1386 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1387 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1388 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1389 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1390 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1391 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1392 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1393
1394
1395 Version 1.39.0 (2019-11-07)
1396 ===========================
1397
1398 Language
1399 --------
1400 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1401   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1402 - [You can now use certain attributes on function, closure, and function pointer
1403   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1404   `deny`, `forbid` as well as inert helper attributes used by procedural macro
1405   attributes applied to items. e.g.
1406   ```rust
1407   fn len(
1408       #[cfg(windows)] slice: &[u16],
1409       #[cfg(not(windows))] slice: &[u8],
1410   ) -> usize {
1411       slice.len()
1412   }
1413   ```
1414 - [You can now take shared references to bind-by-move patterns in the `if` guards
1415   of `match` arms.][63118] e.g.
1416   ```rust
1417   fn main() {
1418       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1419
1420       match array {
1421           nums
1422   //      ---- `nums` is bound by move.
1423               if nums.iter().sum::<u8>() == 10
1424   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
1425           => {
1426               drop(nums);
1427   //          ----------- Legal as `nums` was bound by move and so we have ownership.
1428           }
1429           _ => unreachable!(),
1430       }
1431   }
1432   ```
1433
1434
1435
1436 Compiler
1437 --------
1438 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1439 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1440 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1441   **Note** Cargo currently doesn't use this feature. Refer to
1442   [cargo#7315][cargo/7315] to track this feature's progress.
1443 - [You can now pass `--show-output` argument to test binaries to print the
1444   output of successful tests.][62600]
1445
1446
1447 \* Refer to Rust's [platform support page][forge-platform-support] for more
1448 information on Rust's tiered platform support.
1449
1450 Libraries
1451 ---------
1452 - [`Vec::new` and `String::new` are now `const` functions.][64028]
1453 - [`LinkedList::new` is now a `const` function.][63684]
1454 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1455 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1456   now `const`.][63786]
1457
1458 Stabilized APIs
1459 ---------------
1460 - [`Pin::into_inner`]
1461 - [`Instant::checked_duration_since`]
1462 - [`Instant::saturating_duration_since`]
1463
1464 Cargo
1465 -----
1466 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1467 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1468   `--all` is now deprecated.
1469
1470 Misc
1471 ----
1472 - [You can now pass `-Clinker` to rustdoc to control the linker used
1473   for compiling doctests.][63834]
1474
1475 Compatibility Notes
1476 -------------------
1477 - [Code that was previously accepted by the old borrow checker, but rejected by
1478   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1479   previously a warning, and will also become a hard error in the Rust 2015
1480   edition in the 1.40.0 release.
1481 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
1482   run tests.][63827] This should improve performance when running a large
1483   amount of doctests.
1484 - [The `try!` macro will now issue a deprecation warning.][62672] It is
1485   recommended to use the `?` operator instead.
1486 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1487   returned `0.0`.
1488
1489 [62600]: https://github.com/rust-lang/rust/pull/62600/
1490 [62672]: https://github.com/rust-lang/rust/pull/62672/
1491 [63118]: https://github.com/rust-lang/rust/pull/63118/
1492 [63209]: https://github.com/rust-lang/rust/pull/63209/
1493 [63402]: https://github.com/rust-lang/rust/pull/63402/
1494 [63565]: https://github.com/rust-lang/rust/pull/63565/
1495 [63595]: https://github.com/rust-lang/rust/pull/63595/
1496 [63684]: https://github.com/rust-lang/rust/pull/63684/
1497 [63698]: https://github.com/rust-lang/rust/pull/63698/
1498 [63770]: https://github.com/rust-lang/rust/pull/63770/
1499 [63786]: https://github.com/rust-lang/rust/pull/63786/
1500 [63827]: https://github.com/rust-lang/rust/pull/63827/
1501 [63834]: https://github.com/rust-lang/rust/pull/63834/
1502 [63927]: https://github.com/rust-lang/rust/pull/63927/
1503 [63933]: https://github.com/rust-lang/rust/pull/63933/
1504 [63934]: https://github.com/rust-lang/rust/pull/63934/
1505 [63938]: https://github.com/rust-lang/rust/pull/63938/
1506 [63940]: https://github.com/rust-lang/rust/pull/63940/
1507 [63941]: https://github.com/rust-lang/rust/pull/63941/
1508 [63945]: https://github.com/rust-lang/rust/pull/63945/
1509 [64010]: https://github.com/rust-lang/rust/pull/64010/
1510 [64028]: https://github.com/rust-lang/rust/pull/64028/
1511 [64334]: https://github.com/rust-lang/rust/pull/64334/
1512 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1513 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1514 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1515 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1516 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
1517 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
1518
1519 Version 1.38.0 (2019-09-26)
1520 ==========================
1521
1522 Language
1523 --------
1524 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
1525 - [The `#[deprecated]` attribute can now be used on macros.][62042]
1526
1527 Compiler
1528 --------
1529 - [Added pipelined compilation support to `rustc`.][62766] This will
1530   improve compilation times in some cases. For further information please refer
1531   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
1532 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
1533   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
1534   `x86_64-uwp-windows-msvc` targets.][60260]
1535 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
1536   `armv7-unknown-linux-musleabi` targets.][63107]
1537 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1538 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1539 - [Upgraded to LLVM 9.][62592]
1540
1541 \* Refer to Rust's [platform support page][forge-platform-support] for more
1542 information on Rust's tiered platform support.
1543
1544 Libraries
1545 ---------
1546 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1547 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1548   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1549   is available at `std::clone::Clone`). This also makes all built-in macros
1550   available in `std`/`core` root. e.g. `std::include_bytes!`.
1551 - [`str::Chars` now implements `Debug`.][63000]
1552 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1553 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1554 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1555 - [Added euclidean remainder and division operations (`div_euclid`,
1556   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1557   `overflowing`, and `wrapping` versions are available for all
1558   integer primitives.
1559 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1560   `PartialEq`.][61491]
1561 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1562
1563 Stabilized APIs
1564 ---------------
1565 - [`<*const T>::cast`]
1566 - [`<*mut T>::cast`]
1567 - [`Duration::as_secs_f32`]
1568 - [`Duration::as_secs_f64`]
1569 - [`Duration::div_f32`]
1570 - [`Duration::div_f64`]
1571 - [`Duration::from_secs_f32`]
1572 - [`Duration::from_secs_f64`]
1573 - [`Duration::mul_f32`]
1574 - [`Duration::mul_f64`]
1575 - [`any::type_name`]
1576
1577 Cargo
1578 -----
1579 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1580 - [You can now pass the `--features` option multiple times to enable
1581   multiple features.][cargo/7084]
1582
1583 Misc
1584 ----
1585 - [`rustc` will now warn about some incorrect uses of
1586   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1587
1588 Compatibility Notes
1589 -------------------
1590 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1591   1.38.0.
1592 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1593   issues][62896] with certain crates such as libc.
1594
1595 [60260]: https://github.com/rust-lang/rust/pull/60260/
1596 [61457]: https://github.com/rust-lang/rust/pull/61457/
1597 [61491]: https://github.com/rust-lang/rust/pull/61491/
1598 [61884]: https://github.com/rust-lang/rust/pull/61884/
1599 [61953]: https://github.com/rust-lang/rust/pull/61953/
1600 [62042]: https://github.com/rust-lang/rust/pull/62042/
1601 [62528]: https://github.com/rust-lang/rust/pull/62528/
1602 [62583]: https://github.com/rust-lang/rust/pull/62583/
1603 [62735]: https://github.com/rust-lang/rust/pull/62735/
1604 [62766]: https://github.com/rust-lang/rust/pull/62766/
1605 [62784]: https://github.com/rust-lang/rust/pull/62784/
1606 [62592]: https://github.com/rust-lang/rust/pull/62592/
1607 [62785]: https://github.com/rust-lang/rust/issues/62785/
1608 [62814]: https://github.com/rust-lang/rust/pull/62814/
1609 [62896]: https://github.com/rust-lang/rust/issues/62896/
1610 [63000]: https://github.com/rust-lang/rust/pull/63000/
1611 [63056]: https://github.com/rust-lang/rust/pull/63056/
1612 [63107]: https://github.com/rust-lang/rust/pull/63107/
1613 [63346]: https://github.com/rust-lang/rust/pull/63346/
1614 [63421]: https://github.com/rust-lang/rust/pull/63421/
1615 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1616 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1617 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1618 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1619 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1620 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1621 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1622 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1623 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1624 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1625 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1626 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1627 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1628 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
1629 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1630
1631 Version 1.37.0 (2019-08-15)
1632 ==========================
1633
1634 Language
1635 --------
1636 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1637   [`Box`][62228], or an [array][62235] and unused.
1638 - [You can now use the `cfg` and `cfg_attr` attributes on
1639   generic parameters.][61547]
1640 - [You can now use enum variants through type alias.][61682] e.g. You can
1641   write the following:
1642   ```rust
1643   type MyOption = Option<u8>;
1644
1645   fn increment_or_zero(x: MyOption) -> u8 {
1646       match x {
1647           MyOption::Some(y) => y + 1,
1648           MyOption::None => 0,
1649       }
1650   }
1651   ```
1652 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1653   `const _: u32 = 5;`.
1654 - [You can now use `#[repr(align(X)]` on enums.][61229]
1655 - [The  `?` Kleene macro operator is now available in the
1656   2015 edition.][60932]
1657
1658 Compiler
1659 --------
1660 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1661   and `-C profile-use` flags.][61268] For more information on how to use profile
1662   guided optimization, please refer to the [rustc book][rustc-book-pgo].
1663 - [The `rust-lldb` wrapper script should now work again.][61827]
1664
1665 Libraries
1666 ---------
1667 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1668
1669 Stabilized APIs
1670 ---------------
1671 - [`BufReader::buffer`]
1672 - [`BufWriter::buffer`]
1673 - [`Cell::from_mut`]
1674 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1675 - [`DoubleEndedIterator::nth_back`]
1676 - [`Option::xor`]
1677 - [`Wrapping::reverse_bits`]
1678 - [`i128::reverse_bits`]
1679 - [`i16::reverse_bits`]
1680 - [`i32::reverse_bits`]
1681 - [`i64::reverse_bits`]
1682 - [`i8::reverse_bits`]
1683 - [`isize::reverse_bits`]
1684 - [`slice::copy_within`]
1685 - [`u128::reverse_bits`]
1686 - [`u16::reverse_bits`]
1687 - [`u32::reverse_bits`]
1688 - [`u64::reverse_bits`]
1689 - [`u8::reverse_bits`]
1690 - [`usize::reverse_bits`]
1691
1692 Cargo
1693 -----
1694 - [`Cargo.lock` files are now included by default when publishing executable crates
1695   with executables.][cargo/7026]
1696 - [You can now specify `default-run="foo"` in `[package]` to specify the
1697   default executable to use for `cargo run`.][cargo/7056]
1698
1699 Misc
1700 ----
1701
1702 Compatibility Notes
1703 -------------------
1704 - [Using `...` for inclusive range patterns will now warn by default.][61342]
1705   Please transition your code to using the `..=` syntax for inclusive
1706   ranges instead.
1707 - [Using a trait object without the `dyn` will now warn by default.][61203]
1708   Please transition your code to use `dyn Trait` for trait objects instead.
1709
1710 [62228]: https://github.com/rust-lang/rust/pull/62228/
1711 [62235]: https://github.com/rust-lang/rust/pull/62235/
1712 [61802]: https://github.com/rust-lang/rust/pull/61802/
1713 [61827]: https://github.com/rust-lang/rust/pull/61827/
1714 [61547]: https://github.com/rust-lang/rust/pull/61547/
1715 [61682]: https://github.com/rust-lang/rust/pull/61682/
1716 [61268]: https://github.com/rust-lang/rust/pull/61268/
1717 [61342]: https://github.com/rust-lang/rust/pull/61342/
1718 [61347]: https://github.com/rust-lang/rust/pull/61347/
1719 [61100]: https://github.com/rust-lang/rust/pull/61100/
1720 [61203]: https://github.com/rust-lang/rust/pull/61203/
1721 [61229]: https://github.com/rust-lang/rust/pull/61229/
1722 [60932]: https://github.com/rust-lang/rust/pull/60932/
1723 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1724 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1725 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1726 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1727 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1728 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1729 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1730 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1731 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1732 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1733 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1734 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1735 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1736 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1737 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1738 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1739 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1740 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1741 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1742 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1743 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1744 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1745 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1746 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1747
1748
1749 Version 1.36.0 (2019-07-04)
1750 ==========================
1751
1752 Language
1753 --------
1754 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1755 - [The order of traits in trait objects no longer affects the semantics of that
1756   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1757   `dyn fmt::Debug + Send`, where this was previously not the case.
1758
1759 Libraries
1760 ---------
1761 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1762 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1763 - [`mem::needs_drop` is now available as a const fn.][60364]
1764 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1765 - [`String` now implements `BorrowMut<str>`.][60404]
1766 - [`io::Cursor` now implements `Default`.][60234]
1767 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1768 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1769   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1770   environment has access to heap memory allocation.
1771 - [`String` now implements `From<&String>`.][59825]
1772 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1773   return a tuple of each argument when there is multiple arguments.
1774 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1775   not used.][59648]
1776
1777 Stabilized APIs
1778 ---------------
1779 - [`VecDeque::rotate_left`]
1780 - [`VecDeque::rotate_right`]
1781 - [`Iterator::copied`]
1782 - [`io::IoSlice`]
1783 - [`io::IoSliceMut`]
1784 - [`Read::read_vectored`]
1785 - [`Write::write_vectored`]
1786 - [`str::as_mut_ptr`]
1787 - [`mem::MaybeUninit`]
1788 - [`pointer::align_offset`]
1789 - [`future::Future`]
1790 - [`task::Context`]
1791 - [`task::RawWaker`]
1792 - [`task::RawWakerVTable`]
1793 - [`task::Waker`]
1794 - [`task::Poll`]
1795
1796 Cargo
1797 -----
1798 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1799 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1800
1801 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1802
1803 Clippy
1804 ------
1805 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1806
1807 Misc
1808 ----
1809
1810 Compatibility Notes
1811 -------------------
1812 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1813   longer recommended, and will be deprecated in 1.39.0.
1814
1815 [60318]: https://github.com/rust-lang/rust/pull/60318/
1816 [60364]: https://github.com/rust-lang/rust/pull/60364/
1817 [60370]: https://github.com/rust-lang/rust/pull/60370/
1818 [60404]: https://github.com/rust-lang/rust/pull/60404/
1819 [60234]: https://github.com/rust-lang/rust/pull/60234/
1820 [60244]: https://github.com/rust-lang/rust/pull/60244/
1821 [58623]: https://github.com/rust-lang/rust/pull/58623/
1822 [59648]: https://github.com/rust-lang/rust/pull/59648/
1823 [59675]: https://github.com/rust-lang/rust/pull/59675/
1824 [59825]: https://github.com/rust-lang/rust/pull/59825/
1825 [59826]: https://github.com/rust-lang/rust/pull/59826/
1826 [59445]: https://github.com/rust-lang/rust/pull/59445/
1827 [59114]: https://github.com/rust-lang/rust/pull/59114/
1828 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1829 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1830 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1831 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1832 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1833 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1834 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1835 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1836 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1837 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1838 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1839 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1840 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1841 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1842 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1843 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1844 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1845 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1846 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1847 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1848
1849
1850 Version 1.35.0 (2019-05-23)
1851 ==========================
1852
1853 Language
1854 --------
1855 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1856   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1857 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1858   ```rust
1859   unsafe fn call_unsafe(func: unsafe fn()) {
1860       func()
1861   }
1862
1863   pub fn main() {
1864       unsafe { call_unsafe(|| {}); }
1865   }
1866   ```
1867
1868
1869 Compiler
1870 --------
1871 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1872   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1873 - [Added the `wasm32-unknown-wasi` target.][59464]
1874
1875
1876 Libraries
1877 ---------
1878 - [`Thread` will now show its ID in `Debug` output.][59460]
1879 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1880 - [`alloc::System` now implements `Default`.][59451]
1881 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1882   last field.][59076]
1883 - [`char::{ToLowercase, ToUppercase}` now
1884   implement `ExactSizeIterator`.][58778]
1885 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1886 - [Removed the `Read` trait bounds
1887   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1888 - [You can now call the `dbg!` macro without any parameters to print the file
1889   and line where it is called.][57847]
1890 - [In place ASCII case conversions are now up to 4× faster.][59283]
1891   e.g. `str::make_ascii_lowercase`
1892 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1893   and `Send`.][58369]
1894
1895 Stabilized APIs
1896 ---------------
1897 - [`f32::copysign`]
1898 - [`f64::copysign`]
1899 - [`RefCell::replace_with`]
1900 - [`RefCell::map_split`]
1901 - [`ptr::hash`]
1902 - [`Range::contains`]
1903 - [`RangeFrom::contains`]
1904 - [`RangeTo::contains`]
1905 - [`RangeInclusive::contains`]
1906 - [`RangeToInclusive::contains`]
1907 - [`Option::copied`]
1908
1909 Cargo
1910 -----
1911 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1912   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1913   platform specific.
1914
1915 Misc
1916 ----
1917 - [The Rust toolchain is now available natively for musl based distros.][58575]
1918
1919 [59460]: https://github.com/rust-lang/rust/pull/59460/
1920 [59464]: https://github.com/rust-lang/rust/pull/59464/
1921 [59500]: https://github.com/rust-lang/rust/pull/59500/
1922 [59512]: https://github.com/rust-lang/rust/pull/59512/
1923 [59580]: https://github.com/rust-lang/rust/pull/59580/
1924 [59283]: https://github.com/rust-lang/rust/pull/59283/
1925 [59451]: https://github.com/rust-lang/rust/pull/59451/
1926 [59076]: https://github.com/rust-lang/rust/pull/59076/
1927 [58778]: https://github.com/rust-lang/rust/pull/58778/
1928 [58717]: https://github.com/rust-lang/rust/pull/58717/
1929 [58369]: https://github.com/rust-lang/rust/pull/58369/
1930 [58423]: https://github.com/rust-lang/rust/pull/58423/
1931 [58080]: https://github.com/rust-lang/rust/pull/58080/
1932 [57847]: https://github.com/rust-lang/rust/pull/57847/
1933 [58575]: https://github.com/rust-lang/rust/pull/58575
1934 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1935 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1936 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1937 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1938 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1939 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1940 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1941 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1942 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1943 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1944 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1945 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1946
1947 Version 1.34.2 (2019-05-14)
1948 ===========================
1949
1950 * [Destabilize the `Error::type_id` function due to a security
1951    vulnerability][60785] ([CVE-2019-12083])
1952
1953 [60785]: https://github.com/rust-lang/rust/pull/60785
1954 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1955
1956 Version 1.34.1 (2019-04-25)
1957 ===========================
1958
1959 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1960 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1961 * [Fix Clippy panic when checking some macros][clippy/3805]
1962
1963 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1964 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1965 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1966
1967 Version 1.34.0 (2019-04-11)
1968 ==========================
1969
1970 Language
1971 --------
1972 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1973   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1974   but had no effect.
1975 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1976   `#[attr{}]` procedural macros.][57367]
1977 - [You can now write `extern crate self as foo;`][57407] to import your
1978   crate's root into the extern prelude.
1979
1980
1981 Compiler
1982 --------
1983 - [You can now target `riscv64imac-unknown-none-elf` and
1984   `riscv64gc-unknown-none-elf`.][58406]
1985 - [You can now enable linker plugin LTO optimisations with
1986   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1987   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1988   boundaries.
1989 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1990
1991
1992 Libraries
1993 ---------
1994 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1995   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1996   the `Hash` trait to create an iterator.
1997 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1998   methods.][58421] Most notably you no longer require the `Ord` trait to create
1999   an iterator.
2000 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2001   for all numeric types.][58044]
2002 - [Indexing a `str` is now generic over all types that
2003   implement `SliceIndex<str>`.][57604]
2004 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2005   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2006   produce a warning if their returning type is unused.
2007 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2008   `overflowing_pow` are now available for all numeric types.][57873] These are
2009   equivalent to methods such as `wrapping_add` for the `pow` operation.
2010
2011
2012 Stabilized APIs
2013 ---------------
2014
2015 #### std & core
2016 * [`Any::type_id`]
2017 * [`Error::type_id`]
2018 * [`atomic::AtomicI16`]
2019 * [`atomic::AtomicI32`]
2020 * [`atomic::AtomicI64`]
2021 * [`atomic::AtomicI8`]
2022 * [`atomic::AtomicU16`]
2023 * [`atomic::AtomicU32`]
2024 * [`atomic::AtomicU64`]
2025 * [`atomic::AtomicU8`]
2026 * [`convert::Infallible`]
2027 * [`convert::TryFrom`]
2028 * [`convert::TryInto`]
2029 * [`iter::from_fn`]
2030 * [`iter::successors`]
2031 * [`num::NonZeroI128`]
2032 * [`num::NonZeroI16`]
2033 * [`num::NonZeroI32`]
2034 * [`num::NonZeroI64`]
2035 * [`num::NonZeroI8`]
2036 * [`num::NonZeroIsize`]
2037 * [`slice::sort_by_cached_key`]
2038 * [`str::escape_debug`]
2039 * [`str::escape_default`]
2040 * [`str::escape_unicode`]
2041 * [`str::split_ascii_whitespace`]
2042
2043 #### std
2044 * [`Instant::checked_add`]
2045 * [`Instant::checked_sub`]
2046 * [`SystemTime::checked_add`]
2047 * [`SystemTime::checked_sub`]
2048
2049 Cargo
2050 -----
2051 - [You can now use alternative registries to crates.io.][cargo/6654]
2052
2053 Misc
2054 ----
2055 - [You can now use the `?` operator in your documentation tests without manually
2056   adding `fn main() -> Result<(), _> {}`.][56470]
2057
2058 Compatibility Notes
2059 -------------------
2060 - [`Command::before_exec` is being replaced by the unsafe method
2061   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2062 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
2063   can now use `const` functions in `static` variables.
2064
2065 [58370]: https://github.com/rust-lang/rust/pull/58370/
2066 [58406]: https://github.com/rust-lang/rust/pull/58406/
2067 [58421]: https://github.com/rust-lang/rust/pull/58421/
2068 [58166]: https://github.com/rust-lang/rust/pull/58166/
2069 [58044]: https://github.com/rust-lang/rust/pull/58044/
2070 [58057]: https://github.com/rust-lang/rust/pull/58057/
2071 [58059]: https://github.com/rust-lang/rust/pull/58059/
2072 [57809]: https://github.com/rust-lang/rust/pull/57809/
2073 [57873]: https://github.com/rust-lang/rust/pull/57873/
2074 [57604]: https://github.com/rust-lang/rust/pull/57604/
2075 [57367]: https://github.com/rust-lang/rust/pull/57367/
2076 [57407]: https://github.com/rust-lang/rust/pull/57407/
2077 [57425]: https://github.com/rust-lang/rust/pull/57425/
2078 [57106]: https://github.com/rust-lang/rust/pull/57106/
2079 [56470]: https://github.com/rust-lang/rust/pull/56470/
2080 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2081 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2082 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2083 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2084 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2085 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2086 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2087 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2088 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2089 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2090 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2091 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2092 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2093 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2094 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2095 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2096 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2097 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2098 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2099 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2100 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2101 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2102 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2103 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2104 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2105 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2106 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2107 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2108 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2109 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2110 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2111
2112
2113 Version 1.33.0 (2019-02-28)
2114 ==========================
2115
2116 Language
2117 --------
2118 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2119   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2120 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
2121   E.g. You can have match statement on a `u8` that covers `0..=255` and
2122   you would no longer be required to have a `_ => unreachable!()` case.
2123 - [You can now have multiple patterns in `if let` and `while let`
2124   expressions.][57532] You can do this with the same syntax as a `match`
2125   expression. E.g.
2126   ```rust
2127   enum Creature {
2128       Crab(String),
2129       Lobster(String),
2130       Person(String),
2131   }
2132
2133   fn main() {
2134       let state = Creature::Crab("Ferris");
2135
2136       if let Creature::Crab(name) | Creature::Person(name) = state {
2137           println!("This creature's name is: {}", name);
2138       }
2139   }
2140   ```
2141 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2142   this feature will by default produce a warning as this behaviour can be
2143   unintuitive. E.g. `if let _ = 5 {}`
2144 - [You can now use `let` bindings, assignments, expression statements,
2145   and irrefutable pattern destructuring in const functions.][57175]
2146 - [You can now call unsafe const functions.][57067] E.g.
2147   ```rust
2148   const unsafe fn foo() -> i32 { 5 }
2149   const fn bar() -> i32 {
2150       unsafe { foo() }
2151   }
2152   ```
2153 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2154   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2155 - [You can now specify a specific alignment with the `#[repr(packed)]`
2156   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2157   with an alignment of 2 bytes and a size of 6 bytes.
2158 - [You can now import an item from a module as an `_`.][56303] This allows you to
2159   import a trait's impls, and not have the name in the namespace. E.g.
2160   ```rust
2161   use std::io::Read as _;
2162
2163   // Allowed as there is only one `Read` in the module.
2164   pub trait Read {}
2165   ```
2166 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2167
2168 Compiler
2169 --------
2170 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2171   command line argument.][56351]
2172 - [The minimum required LLVM version has been bumped to 6.0.][56642]
2173 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2174 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2175   tier 2 support.][57130] Visit the [platform support][platform-support] page for
2176   information on Rust's platform support.
2177 - [Added support for the `thumbv7neon-linux-androideabi` and
2178   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2179 - [Added support for the `x86_64-unknown-uefi` target.][56769]
2180
2181 Libraries
2182 ---------
2183 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2184   functions for all numeric types.][57566]
2185 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2186   are now `const` functions for all numeric types.][57105]
2187 - [The methods `is_positive` and `is_negative` are now `const` functions for
2188   all signed numeric types.][57105]
2189 - [The `get` method for all `NonZero` types is now `const`.][57167]
2190 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2191   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2192   numeric types.][57234]
2193 - [`Ipv4Addr::new` is now a `const` function][57234]
2194
2195 Stabilized APIs
2196 ---------------
2197 - [`unix::FileExt::read_exact_at`]
2198 - [`unix::FileExt::write_all_at`]
2199 - [`Option::transpose`]
2200 - [`Result::transpose`]
2201 - [`convert::identity`]
2202 - [`pin::Pin`]
2203 - [`marker::Unpin`]
2204 - [`marker::PhantomPinned`]
2205 - [`Vec::resize_with`]
2206 - [`VecDeque::resize_with`]
2207 - [`Duration::as_millis`]
2208 - [`Duration::as_micros`]
2209 - [`Duration::as_nanos`]
2210
2211
2212 Cargo
2213 -----
2214 - [You can now publish crates that require a feature flag to compile with
2215   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
2216 - [Cargo should now rebuild a crate if a file was modified during the initial
2217   build.][cargo/6484]
2218
2219 Compatibility Notes
2220 -------------------
2221 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2222   are now deprecated in the standard library, and their usage will now produce a warning.
2223   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2224   methods instead.
2225 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2226   downcasting.
2227 - [Libtest no longer creates a new thread for each test when
2228   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
2229
2230 [55982]: https://github.com/rust-lang/rust/pull/55982/
2231 [56243]: https://github.com/rust-lang/rust/pull/56243
2232 [56303]: https://github.com/rust-lang/rust/pull/56303/
2233 [56351]: https://github.com/rust-lang/rust/pull/56351/
2234 [56362]: https://github.com/rust-lang/rust/pull/56362
2235 [56642]: https://github.com/rust-lang/rust/pull/56642/
2236 [56769]: https://github.com/rust-lang/rust/pull/56769/
2237 [56805]: https://github.com/rust-lang/rust/pull/56805
2238 [56947]: https://github.com/rust-lang/rust/pull/56947/
2239 [57049]: https://github.com/rust-lang/rust/pull/57049/
2240 [57067]: https://github.com/rust-lang/rust/pull/57067/
2241 [57105]: https://github.com/rust-lang/rust/pull/57105
2242 [57130]: https://github.com/rust-lang/rust/pull/57130/
2243 [57167]: https://github.com/rust-lang/rust/pull/57167/
2244 [57175]: https://github.com/rust-lang/rust/pull/57175/
2245 [57234]: https://github.com/rust-lang/rust/pull/57234/
2246 [57332]: https://github.com/rust-lang/rust/pull/57332/
2247 [57465]: https://github.com/rust-lang/rust/pull/57465/
2248 [57532]: https://github.com/rust-lang/rust/pull/57532/
2249 [57535]: https://github.com/rust-lang/rust/pull/57535/
2250 [57566]: https://github.com/rust-lang/rust/pull/57566/
2251 [57615]: https://github.com/rust-lang/rust/pull/57615/
2252 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
2253 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2254 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2255 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2256 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2257 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2258 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2259 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2260 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2261 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2262 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2263 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2264 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2265 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2266 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2267 [platform-support]: https://forge.rust-lang.org/platform-support.html
2268
2269 Version 1.32.0 (2019-01-17)
2270 ==========================
2271
2272 Language
2273 --------
2274 #### 2018 edition
2275 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2276   operator allows you to specify zero or one repetitions similar to the `*` and
2277   `+` operators.
2278 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2279   now always resolve to the item (`enum`, `struct`, etc.) available in the
2280   module if present, before resolving to a external crate or an item the prelude.][56759]
2281   E.g.
2282   ```rust
2283   enum Color { Red, Green, Blue }
2284
2285   use Color::*;
2286   ```
2287
2288 #### All editions
2289 - [You can now match against `PhantomData<T>` types.][55837]
2290 - [You can now match against literals in macros with the `literal`
2291   specifier.][56072] This will match against a literal of any type.
2292   E.g. `1`, `'A'`, `"Hello World"`
2293 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
2294   ```rust
2295   struct Point(i32, i32);
2296
2297   impl Point {
2298       pub fn new(x: i32, y: i32) -> Self {
2299           Self(x, y)
2300       }
2301
2302       pub fn is_origin(&self) -> bool {
2303           match self {
2304               Self(0, 0) => true,
2305               _ => false,
2306           }
2307       }
2308   }
2309   ```
2310 - [Self can also now be used in type definitions.][56366] E.g.
2311   ```rust
2312   enum List<T>
2313   where
2314       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2315   {
2316       Nil,
2317       Cons(T, Box<Self>) // likewise here
2318   }
2319   ```
2320 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2321   a `impl Trait` or `dyn Trait` is returned and unused in the program.
2322
2323 Compiler
2324 --------
2325 - [The default allocator has changed from jemalloc to the default allocator on
2326   your system.][55238] The compiler itself on Linux & macOS will still use
2327   jemalloc, but programs compiled with it will use the system allocator.
2328 - [Added the `aarch64-pc-windows-msvc` target.][55702]
2329
2330 Libraries
2331 ---------
2332 - [`PathBuf` now implements `FromStr`.][55148]
2333 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2334 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2335   easily debug expressions in your rust program. E.g.
2336   ```rust
2337   let a = 2;
2338   let b = dbg!(a * 2) + 1;
2339   //      ^-- prints: [src/main.rs:4] a * 2 = 4
2340   assert_eq!(b, 5);
2341   ```
2342
2343 The following APIs are now `const` functions and can be used in a
2344 `const` context.
2345
2346 - [`Cell::as_ptr`]
2347 - [`UnsafeCell::get`]
2348 - [`char::is_ascii`]
2349 - [`iter::empty`]
2350 - [`ManuallyDrop::new`]
2351 - [`ManuallyDrop::into_inner`]
2352 - [`RangeInclusive::start`]
2353 - [`RangeInclusive::end`]
2354 - [`NonNull::as_ptr`]
2355 - [`slice::as_ptr`]
2356 - [`str::as_ptr`]
2357 - [`Duration::as_secs`]
2358 - [`Duration::subsec_millis`]
2359 - [`Duration::subsec_micros`]
2360 - [`Duration::subsec_nanos`]
2361 - [`CStr::as_ptr`]
2362 - [`Ipv4Addr::is_unspecified`]
2363 - [`Ipv6Addr::new`]
2364 - [`Ipv6Addr::octets`]
2365
2366 Stabilized APIs
2367 ---------------
2368 - [`i8::to_be_bytes`]
2369 - [`i8::to_le_bytes`]
2370 - [`i8::to_ne_bytes`]
2371 - [`i8::from_be_bytes`]
2372 - [`i8::from_le_bytes`]
2373 - [`i8::from_ne_bytes`]
2374 - [`i16::to_be_bytes`]
2375 - [`i16::to_le_bytes`]
2376 - [`i16::to_ne_bytes`]
2377 - [`i16::from_be_bytes`]
2378 - [`i16::from_le_bytes`]
2379 - [`i16::from_ne_bytes`]
2380 - [`i32::to_be_bytes`]
2381 - [`i32::to_le_bytes`]
2382 - [`i32::to_ne_bytes`]
2383 - [`i32::from_be_bytes`]
2384 - [`i32::from_le_bytes`]
2385 - [`i32::from_ne_bytes`]
2386 - [`i64::to_be_bytes`]
2387 - [`i64::to_le_bytes`]
2388 - [`i64::to_ne_bytes`]
2389 - [`i64::from_be_bytes`]
2390 - [`i64::from_le_bytes`]
2391 - [`i64::from_ne_bytes`]
2392 - [`i128::to_be_bytes`]
2393 - [`i128::to_le_bytes`]
2394 - [`i128::to_ne_bytes`]
2395 - [`i128::from_be_bytes`]
2396 - [`i128::from_le_bytes`]
2397 - [`i128::from_ne_bytes`]
2398 - [`isize::to_be_bytes`]
2399 - [`isize::to_le_bytes`]
2400 - [`isize::to_ne_bytes`]
2401 - [`isize::from_be_bytes`]
2402 - [`isize::from_le_bytes`]
2403 - [`isize::from_ne_bytes`]
2404 - [`u8::to_be_bytes`]
2405 - [`u8::to_le_bytes`]
2406 - [`u8::to_ne_bytes`]
2407 - [`u8::from_be_bytes`]
2408 - [`u8::from_le_bytes`]
2409 - [`u8::from_ne_bytes`]
2410 - [`u16::to_be_bytes`]
2411 - [`u16::to_le_bytes`]
2412 - [`u16::to_ne_bytes`]
2413 - [`u16::from_be_bytes`]
2414 - [`u16::from_le_bytes`]
2415 - [`u16::from_ne_bytes`]
2416 - [`u32::to_be_bytes`]
2417 - [`u32::to_le_bytes`]
2418 - [`u32::to_ne_bytes`]
2419 - [`u32::from_be_bytes`]
2420 - [`u32::from_le_bytes`]
2421 - [`u32::from_ne_bytes`]
2422 - [`u64::to_be_bytes`]
2423 - [`u64::to_le_bytes`]
2424 - [`u64::to_ne_bytes`]
2425 - [`u64::from_be_bytes`]
2426 - [`u64::from_le_bytes`]
2427 - [`u64::from_ne_bytes`]
2428 - [`u128::to_be_bytes`]
2429 - [`u128::to_le_bytes`]
2430 - [`u128::to_ne_bytes`]
2431 - [`u128::from_be_bytes`]
2432 - [`u128::from_le_bytes`]
2433 - [`u128::from_ne_bytes`]
2434 - [`usize::to_be_bytes`]
2435 - [`usize::to_le_bytes`]
2436 - [`usize::to_ne_bytes`]
2437 - [`usize::from_be_bytes`]
2438 - [`usize::from_le_bytes`]
2439 - [`usize::from_ne_bytes`]
2440
2441 Cargo
2442 -----
2443 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2444 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
2445
2446 Misc
2447 ----
2448 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2449
2450 Compatibility Notes
2451 -------------------
2452 - [The argument types for AVX's
2453   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2454   been changed from `*const` to `*mut` as the previous implementation
2455   was unsound.
2456
2457
2458 [55148]: https://github.com/rust-lang/rust/pull/55148/
2459 [55238]: https://github.com/rust-lang/rust/pull/55238/
2460 [55280]: https://github.com/rust-lang/rust/pull/55280/
2461 [55610]: https://github.com/rust-lang/rust/pull/55610/
2462 [55663]: https://github.com/rust-lang/rust/pull/55663/
2463 [55702]: https://github.com/rust-lang/rust/pull/55702/
2464 [55837]: https://github.com/rust-lang/rust/pull/55837/
2465 [55843]: https://github.com/rust-lang/rust/pull/55843/
2466 [56072]: https://github.com/rust-lang/rust/pull/56072/
2467 [56245]: https://github.com/rust-lang/rust/pull/56245/
2468 [56365]: https://github.com/rust-lang/rust/pull/56365/
2469 [56366]: https://github.com/rust-lang/rust/pull/56366/
2470 [56395]: https://github.com/rust-lang/rust/pull/56395/
2471 [56759]: https://github.com/rust-lang/rust/pull/56759/
2472 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2473 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2474 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2475 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2476 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2477 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2478 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2479 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2480 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2481 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2482 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2483 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2484 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2485 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2486 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2487 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2488 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2489 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2490 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2491 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2492 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2493 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2494 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2495 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2496 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2497 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2498 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2499 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2500 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2501 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2502 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2503 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2504 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2505 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2506 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2507 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2508 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2509 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2510 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
2511 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
2512 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
2513 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
2514 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
2515 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
2516 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
2517 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
2518 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
2519 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
2520 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
2521 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
2522 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
2523 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
2524 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
2525 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
2526 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
2527 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
2528 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
2529 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
2530 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
2531 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
2532 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
2533 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
2534 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
2535 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
2536 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
2537 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
2538 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
2539 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2540 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2541 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2542 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2543 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2544 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2545 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2546 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2547 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2548 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2549 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2550 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2551 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2552 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2553 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2554 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2555 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2556 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2557 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2558 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2559 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2560 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2561 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2562 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2563 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2564 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2565
2566
2567 Version 1.31.1 (2018-12-20)
2568 ===========================
2569
2570 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2571 - [Fix broken go-to-definition in RLS][rls/1171]
2572 - [Fix infinite loop on hover in RLS][rls/1170]
2573
2574 [56562]: https://github.com/rust-lang/rust/pull/56562
2575 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2576 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2577
2578 Version 1.31.0 (2018-12-06)
2579 ==========================
2580
2581 Language
2582 --------
2583 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2584 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2585   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2586   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2587   in structs.
2588 - [You can now define and use `const` functions.][54835] These are currently
2589   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2590   [language reference][const-reference] for what exactly is available.
2591 - [You can now use tool lints, which allow you to scope lints from external
2592   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2593 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2594   a crate, not just in exported functions.][54451]
2595 - [You can now use parentheses in pattern matches.][54497]
2596
2597 Compiler
2598 --------
2599 - [Updated musl to 1.1.20][54430]
2600
2601 Libraries
2602 ---------
2603 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2604   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2605 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2606   into `Option<&mut T>` using the `From` trait.][53218]
2607 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2608
2609
2610 Stabilized APIs
2611 ---------------
2612 - [`slice::align_to`]
2613 - [`slice::align_to_mut`]
2614 - [`slice::chunks_exact`]
2615 - [`slice::chunks_exact_mut`]
2616 - [`slice::rchunks`]
2617 - [`slice::rchunks_mut`]
2618 - [`slice::rchunks_exact`]
2619 - [`slice::rchunks_exact_mut`]
2620 - [`Option::replace`]
2621
2622 Cargo
2623 -----
2624 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2625 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2626   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2627
2628 [52813]: https://github.com/rust-lang/rust/pull/52813/
2629 [53218]: https://github.com/rust-lang/rust/pull/53218/
2630 [53555]: https://github.com/rust-lang/rust/issues/53555/
2631 [54057]: https://github.com/rust-lang/rust/pull/54057/
2632 [54240]: https://github.com/rust-lang/rust/pull/54240/
2633 [54430]: https://github.com/rust-lang/rust/pull/54430/
2634 [54451]: https://github.com/rust-lang/rust/pull/54451/
2635 [54497]: https://github.com/rust-lang/rust/pull/54497/
2636 [54778]: https://github.com/rust-lang/rust/pull/54778/
2637 [54835]: https://github.com/rust-lang/rust/pull/54835/
2638 [54870]: https://github.com/rust-lang/rust/pull/54870/
2639 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2640 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2641 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2642 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2643 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2644 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2645 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2646 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2647 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2648 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2649 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2650 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2651 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2652 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2653
2654 Version 1.30.1 (2018-11-08)
2655 ===========================
2656
2657 - [Fixed overflow ICE in rustdoc][54199]
2658 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2659
2660 [54199]: https://github.com/rust-lang/rust/pull/54199
2661 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2662
2663 Version 1.30.0 (2018-10-25)
2664 ==========================
2665
2666 Language
2667 --------
2668 - [Procedural macros are now available.][52081] These kinds of macros allow for
2669   more powerful code generation. There is a [new chapter available][proc-macros]
2670   in the Rust Programming Language book that goes further in depth.
2671 - [You can now use keywords as identifiers using the raw identifiers
2672   syntax (`r#`),][53236] e.g. `let r#for = true;`
2673 - [Using anonymous parameters in traits is now deprecated with a warning and
2674   will be a hard error in the 2018 edition.][53272]
2675 - [You can now use `crate` in paths.][54404] This allows you to refer to the
2676   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2677 - [Using a external crate no longer requires being prefixed with `::`.][54404]
2678   Previously, using a external crate in a module without a use statement
2679   required `let json = ::serde_json::from_str(foo);` but can now be written
2680   as `let json = serde_json::from_str(foo);`.
2681 - [You can now apply the `#[used]` attribute to static items to prevent the
2682   compiler from optimising them away, even if they appear to be unused,][51363]
2683   e.g. `#[used] static FOO: u32 = 1;`
2684 - [You can now import and reexport macros from other crates with the `use`
2685   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2686   the root module of the crate. If your macro relies on calling other local
2687   macros, it is recommended to export with the
2688   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2689   those macros.
2690 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2691   using the `vis` specifier.][53370]
2692 - [Non-macro attributes now allow all forms of literals, not just
2693   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2694   write `#[attr(true)]`.
2695 - [You can now specify a function to handle a panic in the Rust runtime with the
2696   `#[panic_handler]` attribute.][51366]
2697
2698 Compiler
2699 --------
2700 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
2701 - [Added the `aarch64-unknown-netbsd` target][53165]
2702 - [Upgraded to LLVM 8.][53611]
2703
2704 Libraries
2705 ---------
2706 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2707
2708 Stabilized APIs
2709 ---------------
2710 - [`Ipv4Addr::BROADCAST`]
2711 - [`Ipv4Addr::LOCALHOST`]
2712 - [`Ipv4Addr::UNSPECIFIED`]
2713 - [`Ipv6Addr::LOCALHOST`]
2714 - [`Ipv6Addr::UNSPECIFIED`]
2715 - [`Iterator::find_map`]
2716
2717   The following methods are replacement methods for `trim_left`, `trim_right`,
2718   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2719   in 1.33.0:
2720 - [`str::trim_end_matches`]
2721 - [`str::trim_end`]
2722 - [`str::trim_start_matches`]
2723 - [`str::trim_start`]
2724
2725 Cargo
2726 ----
2727 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2728 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2729   equivalent to calling `rustdoc --error-format=json`.
2730 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2731
2732 Misc
2733 ----
2734 - [`rustdoc` allows you to specify what edition to treat your code as with the
2735   `--edition` option.][54057]
2736 - [`rustdoc` now has the `--color` (specify whether to output color) and
2737   `--error-format` (specify error format, e.g. `json`) options.][53003]
2738 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2739   debug symbols.][53774]
2740 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2741   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2742
2743 [50911]: https://github.com/rust-lang/rust/pull/50911/
2744 [51363]: https://github.com/rust-lang/rust/pull/51363/
2745 [51366]: https://github.com/rust-lang/rust/pull/51366/
2746 [52081]: https://github.com/rust-lang/rust/pull/52081/
2747 [53003]: https://github.com/rust-lang/rust/pull/53003/
2748 [53033]: https://github.com/rust-lang/rust/pull/53033/
2749 [53044]: https://github.com/rust-lang/rust/pull/53044/
2750 [53165]: https://github.com/rust-lang/rust/pull/53165/
2751 [53611]: https://github.com/rust-lang/rust/pull/53611/
2752 [53213]: https://github.com/rust-lang/rust/pull/53213/
2753 [53236]: https://github.com/rust-lang/rust/pull/53236/
2754 [53272]: https://github.com/rust-lang/rust/pull/53272/
2755 [53370]: https://github.com/rust-lang/rust/pull/53370/
2756 [53459]: https://github.com/rust-lang/rust/pull/53459/
2757 [53774]: https://github.com/rust-lang/rust/pull/53774/
2758 [53822]: https://github.com/rust-lang/rust/pull/53822/
2759 [54057]: https://github.com/rust-lang/rust/pull/54057/
2760 [54146]: https://github.com/rust-lang/rust/pull/54146/
2761 [54404]: https://github.com/rust-lang/rust/pull/54404/
2762 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2763 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2764 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2765 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2766
2767 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2768 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2769 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2770 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2771 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2772 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2773 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2774 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2775 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2776 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2777
2778
2779 Version 1.29.2 (2018-10-11)
2780 ===========================
2781
2782 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2783 - The `rls-preview` component on the windows-gnu targets has been restored.
2784
2785 [54639]: https://github.com/rust-lang/rust/pull/54639
2786
2787
2788 Version 1.29.1 (2018-09-25)
2789 ===========================
2790
2791 Security Notes
2792 --------------
2793
2794 - The standard library's `str::repeat` function contained an out of bounds write
2795   caused by an integer overflow. This has been fixed by deterministically
2796   panicking when an overflow happens.
2797
2798   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2799   us.
2800
2801
2802 Version 1.29.0 (2018-09-13)
2803 ==========================
2804
2805 Compiler
2806 --------
2807 - [Bumped minimum LLVM version to 5.0.][51899]
2808 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2809 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2810 - [Upgraded to LLVM 7.][51966]
2811
2812 Libraries
2813 ---------
2814 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2815 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2816 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2817 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2818   for `&str`.][51178]
2819 - [`Cell<T>` now allows `T` to be unsized.][50494]
2820 - [`SocketAddr` is now stable on Redox.][52656]
2821
2822 Stabilized APIs
2823 ---------------
2824 - [`Arc::downcast`]
2825 - [`Iterator::flatten`]
2826 - [`Rc::downcast`]
2827
2828 Cargo
2829 -----
2830 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2831   `--locked` to disable this behavior.
2832 - [`cargo-install` will now allow you to cross compile an install
2833   using `--target`.][cargo/5614]
2834 - [Added the `cargo-fix` subcommand to automatically move project code from
2835   2015 edition to 2018.][cargo/5723]
2836 - [`cargo doc` can now optionally document private types using the
2837   `--document-private-items` flag.][cargo/5543]
2838
2839 Misc
2840 ----
2841 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2842   the specified level to that level.][52354] For example `--cap-lints warn`
2843   will demote `deny` and `forbid` lints to `warn`.
2844 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2845   fails and `101` if there is a panic.][52197]
2846 - [A preview of clippy has been made available through rustup.][51122]
2847   You can install the preview with `rustup component add clippy-preview`.
2848
2849 Compatibility Notes
2850 -------------------
2851 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2852   Use `str::get_unchecked(begin..end)` instead.
2853 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2854   Consider using the `home_dir` function from
2855   https://crates.io/crates/dirs instead.
2856 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2857 - [`cfg` attributes and `--cfg` command line flags are now more
2858   strictly validated.][53893]
2859
2860 [53893]: https://github.com/rust-lang/rust/pull/53893/
2861 [52861]: https://github.com/rust-lang/rust/pull/52861/
2862 [51966]: https://github.com/rust-lang/rust/pull/51966/
2863 [52656]: https://github.com/rust-lang/rust/pull/52656/
2864 [52239]: https://github.com/rust-lang/rust/pull/52239/
2865 [52330]: https://github.com/rust-lang/rust/pull/52330/
2866 [52354]: https://github.com/rust-lang/rust/pull/52354/
2867 [52402]: https://github.com/rust-lang/rust/pull/52402/
2868 [52103]: https://github.com/rust-lang/rust/pull/52103/
2869 [52197]: https://github.com/rust-lang/rust/pull/52197/
2870 [51807]: https://github.com/rust-lang/rust/pull/51807/
2871 [51899]: https://github.com/rust-lang/rust/pull/51899/
2872 [51912]: https://github.com/rust-lang/rust/pull/51912/
2873 [51511]: https://github.com/rust-lang/rust/pull/51511/
2874 [51619]: https://github.com/rust-lang/rust/pull/51619/
2875 [51656]: https://github.com/rust-lang/rust/pull/51656/
2876 [51178]: https://github.com/rust-lang/rust/pull/51178/
2877 [51122]: https://github.com/rust-lang/rust/pull/51122
2878 [50494]: https://github.com/rust-lang/rust/pull/50494/
2879 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2880 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2881 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2882 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2883 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2884 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2885 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2886
2887
2888 Version 1.28.0 (2018-08-02)
2889 ===========================
2890
2891 Language
2892 --------
2893 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2894   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2895   the inner type across Foreign Function Interface (FFI) boundaries.
2896 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2897   and can now be used as identifiers.][51196]
2898 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2899   stable.][51241] This will allow users to specify a global allocator for
2900   their program.
2901 - [Unit test functions marked with the `#[test]` attribute can now return
2902   `Result<(), E: Debug>` in addition to `()`.][51298]
2903 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2904   allows macros to easily target lifetimes.
2905
2906 Compiler
2907 --------
2908 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2909   prioritise making smaller binary sizes. `z` is the same as `s` with the
2910   exception that it does not vectorise loops, which typically results in an even
2911   smaller binary.
2912 - [The short error format is now stable.][49546] Specified with
2913   `--error-format=short` this option will provide a more compressed output of
2914   rust error messages.
2915 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2916 - [Reduced the number of allocations in the macro parser.][50855] This can
2917   improve compile times of macro heavy crates on average by 5%.
2918
2919 Libraries
2920 ---------
2921 - [Implemented `Default` for `&mut str`.][51306]
2922 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2923 - [Implemented `Extend` for `()`.][50234]
2924 - [The `Debug` implementation of `time::Duration` should now be more easily
2925   human readable.][50364] Previously a `Duration` of one second would printed as
2926   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2927 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2928   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2929   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2930   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2931   for `PathBuf`.][50170]
2932 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2933   and `Wrapping<i128>`.][50465]
2934 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2935   possible.][51050] This can provide up to a 40% speed increase.
2936 - [Improved error messages when using `format!`.][50610]
2937
2938 Stabilized APIs
2939 ---------------
2940 - [`Iterator::step_by`]
2941 - [`Path::ancestors`]
2942 - [`SystemTime::UNIX_EPOCH`]
2943 - [`alloc::GlobalAlloc`]
2944 - [`alloc::Layout`]
2945 - [`alloc::LayoutErr`]
2946 - [`alloc::System`]
2947 - [`alloc::alloc`]
2948 - [`alloc::alloc_zeroed`]
2949 - [`alloc::dealloc`]
2950 - [`alloc::realloc`]
2951 - [`alloc::handle_alloc_error`]
2952 - [`btree_map::Entry::or_default`]
2953 - [`fmt::Alignment`]
2954 - [`hash_map::Entry::or_default`]
2955 - [`iter::repeat_with`]
2956 - [`num::NonZeroUsize`]
2957 - [`num::NonZeroU128`]
2958 - [`num::NonZeroU16`]
2959 - [`num::NonZeroU32`]
2960 - [`num::NonZeroU64`]
2961 - [`num::NonZeroU8`]
2962 - [`ops::RangeBounds`]
2963 - [`slice::SliceIndex`]
2964 - [`slice::from_mut`]
2965 - [`slice::from_ref`]
2966 - [`{Any + Send + Sync}::downcast_mut`]
2967 - [`{Any + Send + Sync}::downcast_ref`]
2968 - [`{Any + Send + Sync}::is`]
2969
2970 Cargo
2971 -----
2972 - [Cargo will now no longer allow you to publish crates with build scripts that
2973   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2974   considered to be immutable.
2975
2976 Misc
2977 ----
2978 - [The `suggestion_applicability` field in `rustc`'s json output is now
2979   stable.][50486] This will allow dev tools to check whether a code suggestion
2980   would apply to them.
2981
2982 Compatibility Notes
2983 -------------------
2984 - [Rust will consider trait objects with duplicated constraints to be the same
2985   type as without the duplicated constraint.][51276] For example the below code will
2986   now fail to compile.
2987   ```rust
2988   trait Trait {}
2989
2990   impl Trait + Send {
2991       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2992   }
2993
2994   impl Trait + Send + Send {
2995       fn test(&self) { println!("two"); }
2996   }
2997   ```
2998
2999 [49546]: https://github.com/rust-lang/rust/pull/49546/
3000 [50143]: https://github.com/rust-lang/rust/pull/50143/
3001 [50170]: https://github.com/rust-lang/rust/pull/50170/
3002 [50234]: https://github.com/rust-lang/rust/pull/50234/
3003 [50265]: https://github.com/rust-lang/rust/pull/50265/
3004 [50364]: https://github.com/rust-lang/rust/pull/50364/
3005 [50385]: https://github.com/rust-lang/rust/pull/50385/
3006 [50465]: https://github.com/rust-lang/rust/pull/50465/
3007 [50486]: https://github.com/rust-lang/rust/pull/50486/
3008 [50554]: https://github.com/rust-lang/rust/pull/50554/
3009 [50610]: https://github.com/rust-lang/rust/pull/50610/
3010 [50855]: https://github.com/rust-lang/rust/pull/50855/
3011 [51050]: https://github.com/rust-lang/rust/pull/51050/
3012 [51196]: https://github.com/rust-lang/rust/pull/51196/
3013 [51200]: https://github.com/rust-lang/rust/pull/51200/
3014 [51241]: https://github.com/rust-lang/rust/pull/51241/
3015 [51276]: https://github.com/rust-lang/rust/pull/51276/
3016 [51298]: https://github.com/rust-lang/rust/pull/51298/
3017 [51306]: https://github.com/rust-lang/rust/pull/51306/
3018 [51562]: https://github.com/rust-lang/rust/pull/51562/
3019 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3020 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3021 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3022 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3023 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3024 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3025 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3026 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3027 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3028 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3029 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3030 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3031 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3032 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3033 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3034 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3035 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3036 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3037 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3038 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3039 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3040 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3041 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3042 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3043 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3044 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3045 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3046 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3047 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3048 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
3049
3050 Version 1.27.2 (2018-07-20)
3051 ===========================
3052
3053 Compatibility Notes
3054 -------------------
3055
3056 - The borrow checker was fixed to avoid potential unsoundness when using
3057   match ergonomics: [#52213][52213].
3058
3059 [52213]: https://github.com/rust-lang/rust/issues/52213
3060
3061 Version 1.27.1 (2018-07-10)
3062 ===========================
3063
3064 Security Notes
3065 --------------
3066
3067 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3068   when running, which enabled executing code as some other user on a
3069   given machine. This release fixes that vulnerability; you can read
3070   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
3071
3072   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
3073
3074 Compatibility Notes
3075 -------------------
3076
3077 - The borrow checker was fixed to avoid an additional potential unsoundness when using
3078   match ergonomics: [#51415][51415], [#49534][49534].
3079
3080 [51415]: https://github.com/rust-lang/rust/issues/51415
3081 [49534]: https://github.com/rust-lang/rust/issues/49534
3082 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
3083 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
3084
3085 Version 1.27.0 (2018-06-21)
3086 ==========================
3087
3088 Language
3089 --------
3090 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
3091   be used as an identifier.
3092 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
3093   bare `Trait` syntax, and should make it clearer when being used in tandem with
3094   `impl Trait` because it is equivalent to the following syntax:
3095   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3096   `Box<Trait> == Box<dyn Trait>`.
3097 - [Attributes on generic parameters such as types and lifetimes are
3098   now stable.][48851] e.g.
3099   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3100 - [The `#[must_use]` attribute can now also be used on functions as well as
3101   types.][48925] It provides a lint that by default warns users when the
3102   value returned by a function has not been used.
3103
3104 Compiler
3105 --------
3106 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
3107
3108 Libraries
3109 ---------
3110 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3111   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3112   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3113   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3114   the `cfg` attribute.
3115 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3116   std are now available in core.][49896]
3117 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3118   to `Self`.][49630]
3119 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3120   that the operation isn't done in place.
3121 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3122   the `#[must_use]` attribute][49533] to warn about unused potentially
3123   expensive allocations.
3124
3125 Stabilized APIs
3126 ---------------
3127 - [`DoubleEndedIterator::rfind`]
3128 - [`DoubleEndedIterator::rfold`]
3129 - [`DoubleEndedIterator::try_rfold`]
3130 - [`Duration::from_micros`]
3131 - [`Duration::from_nanos`]
3132 - [`Duration::subsec_micros`]
3133 - [`Duration::subsec_millis`]
3134 - [`HashMap::remove_entry`]
3135 - [`Iterator::try_fold`]
3136 - [`Iterator::try_for_each`]
3137 - [`NonNull::cast`]
3138 - [`Option::filter`]
3139 - [`String::replace_range`]
3140 - [`Take::set_limit`]
3141 - [`hint::unreachable_unchecked`]
3142 - [`os::unix::process::parent_id`]
3143 - [`ptr::swap_nonoverlapping`]
3144 - [`slice::rsplit_mut`]
3145 - [`slice::rsplit`]
3146 - [`slice::swap_with_slice`]
3147
3148 Cargo
3149 -----
3150 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3151   `readme`, and `repository` fields.][cargo/5386]
3152 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3153 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3154   a different directory than `target` for placing compilation artifacts.
3155 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3156   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3157   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3158   where cargo would infer a binary, Cargo will produce a warning. You can
3159   disable this feature ahead of time by setting any of the following to false:
3160   `autobins`, `autobenches`, `autoexamples`, `autotests`.
3161 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3162   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3163
3164 Misc
3165 ----
3166 - [Added “The Rustc book” into the official documentation.][49707]
3167   [“The Rustc book”] documents and teaches how to use the rustc compiler.
3168 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
3169
3170 Compatibility Notes
3171 -------------------
3172 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
3173   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3174   compile, `"".is_empty()` will still compile.
3175 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
3176   will only print the inner type.][48553] E.g.
3177   `print!("{:?}", AtomicBool::new(true))` will print `true`,
3178   not `AtomicBool(true)`.
3179 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3180   could enter higher numbers but they were not supported by LLVM. Up to 512MB
3181   alignment should cover all use cases.
3182 - The `.description()` method on the `std::error::Error` trait
3183   [has been soft-deprecated][50163]. It is no longer required to implement it.
3184
3185 [48553]: https://github.com/rust-lang/rust/pull/48553/
3186 [48851]: https://github.com/rust-lang/rust/pull/48851/
3187 [48925]: https://github.com/rust-lang/rust/pull/48925/
3188 [49533]: https://github.com/rust-lang/rust/pull/49533/
3189 [49623]: https://github.com/rust-lang/rust/pull/49623/
3190 [49630]: https://github.com/rust-lang/rust/pull/49630/
3191 [49664]: https://github.com/rust-lang/rust/pull/49664/
3192 [49699]: https://github.com/rust-lang/rust/pull/49699/
3193 [49707]: https://github.com/rust-lang/rust/pull/49707/
3194 [49719]: https://github.com/rust-lang/rust/pull/49719/
3195 [49896]: https://github.com/rust-lang/rust/pull/49896/
3196 [49968]: https://github.com/rust-lang/rust/pull/49968/
3197 [50163]: https://github.com/rust-lang/rust/pull/50163
3198 [50177]: https://github.com/rust-lang/rust/pull/50177/
3199 [50378]: https://github.com/rust-lang/rust/pull/50378/
3200 [50398]: https://github.com/rust-lang/rust/pull/50398/
3201 [50423]: https://github.com/rust-lang/rust/pull/50423/
3202 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3203 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3204 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
3205 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
3206 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3207 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3208 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3209 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3210 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3211 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3212 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3213 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3214 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3215 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3216 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3217 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3218 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3219 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3220 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3221 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
3222 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3223 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3224 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3225 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
3226 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3227 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3228 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3229 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3230 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
3231 [“The Rustc book”]: https://doc.rust-lang.org/rustc
3232
3233
3234 Version 1.26.2 (2018-06-05)
3235 ==========================
3236
3237 Compatibility Notes
3238 -------------------
3239
3240 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
3241
3242 [51117]: https://github.com/rust-lang/rust/issues/51117
3243
3244
3245 Version 1.26.1 (2018-05-29)
3246 ==========================
3247
3248 Tools
3249 -----
3250
3251 - [RLS now works on Windows.][50646]
3252 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
3253
3254
3255 Compatibility Notes
3256 --------
3257
3258 - [`fn main() -> impl Trait` no longer works for non-Termination
3259   trait.][50656]
3260   This reverts an accidental stabilization.
3261 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3262 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
3263
3264 [50646]: https://github.com/rust-lang/rust/issues/50646
3265 [50656]: https://github.com/rust-lang/rust/pull/50656
3266 [50812]: https://github.com/rust-lang/rust/pull/50812
3267 [50950]: https://github.com/rust-lang/rust/issues/50950
3268 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3269
3270 Version 1.26.0 (2018-05-10)
3271 ==========================
3272
3273 Language
3274 --------
3275 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3276   implement either or both traits.][49299]
3277 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3278 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3279   lifetime can be elided.][49458]
3280 - [`impl Trait` is now stable allowing you to have abstract types in returns
3281    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3282   `fn open(path: impl AsRef<Path>)`.
3283 - [Pattern matching will now automatically apply dereferences.][49394]
3284 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3285 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3286 - [A lot of operations are now available in a const context.][46882] E.g. You
3287   can now index into constant arrays, reference and dereference into constants,
3288   and use tuple struct constructors.
3289 - [Fixed entry slice patterns are now stable.][48516] E.g.
3290   ```rust
3291   let points = [1, 2, 3, 4];
3292   match points {
3293       [1, 2, 3, 4] => println!("All points were sequential."),
3294       _ => println!("Not all points were sequential."),
3295   }
3296   ```
3297
3298
3299 Compiler
3300 --------
3301 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3302 - [Fixed exponential projection complexity on nested types.][48296]
3303   This can provide up to a ~12% reduction in compile times for certain crates.
3304 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3305   to remap path prefixes outputted by the compiler.
3306 - [Added `powerpc-unknown-netbsd` target.][48281]
3307
3308 Libraries
3309 ---------
3310 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3311 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
3312   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3313 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3314 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
3315 - [`ascii::escape_default` is now available in libcore.][48735]
3316 - [Trailing commas are now supported in std and core macros.][48056]
3317 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3318 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3319
3320 Stabilized APIs
3321 ---------------
3322 - [`*const T::add`]
3323 - [`*const T::copy_to_nonoverlapping`]
3324 - [`*const T::copy_to`]
3325 - [`*const T::read_unaligned`]
3326 - [`*const T::read_volatile`]
3327 - [`*const T::read`]
3328 - [`*const T::sub`]
3329 - [`*const T::wrapping_add`]
3330 - [`*const T::wrapping_sub`]
3331 - [`*mut T::add`]
3332 - [`*mut T::copy_to_nonoverlapping`]
3333 - [`*mut T::copy_to`]
3334 - [`*mut T::read_unaligned`]
3335 - [`*mut T::read_volatile`]
3336 - [`*mut T::read`]
3337 - [`*mut T::replace`]
3338 - [`*mut T::sub`]
3339 - [`*mut T::swap`]
3340 - [`*mut T::wrapping_add`]
3341 - [`*mut T::wrapping_sub`]
3342 - [`*mut T::write_bytes`]
3343 - [`*mut T::write_unaligned`]
3344 - [`*mut T::write_volatile`]
3345 - [`*mut T::write`]
3346 - [`Box::leak`]
3347 - [`FromUtf8Error::as_bytes`]
3348 - [`LocalKey::try_with`]
3349 - [`Option::cloned`]
3350 - [`btree_map::Entry::and_modify`]
3351 - [`fs::read_to_string`]
3352 - [`fs::read`]
3353 - [`fs::write`]
3354 - [`hash_map::Entry::and_modify`]
3355 - [`iter::FusedIterator`]
3356 - [`ops::RangeInclusive`]
3357 - [`ops::RangeToInclusive`]
3358 - [`process::id`]
3359 - [`slice::rotate_left`]
3360 - [`slice::rotate_right`]
3361 - [`String::retain`]
3362
3363
3364 Cargo
3365 -----
3366 - [Cargo will now output path to custom commands when `-v` is
3367   passed with `--list`][cargo/5041]
3368 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
3369
3370 Misc
3371 ----
3372 - [The second edition of "The Rust Programming Language" book is now recommended
3373   over the first.][48404]
3374
3375 Compatibility Notes
3376 -------------------
3377
3378 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3379   syntax is now invalid.
3380   ```
3381   use std::ops::Fn as dyn;
3382   fn g(_: Box<dyn(std::fmt::Debug)>) {}
3383   ```
3384 - [The result of dereferences are no longer promoted to `'static`.][47408]
3385   e.g.
3386   ```rust
3387   fn main() {
3388       const PAIR: &(i32, i32) = &(0, 1);
3389       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3390   }
3391   ```
3392 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3393 - [`".e0"` will now no longer parse as `0.0` and will instead cause
3394   an error.][48235]
3395 - [Removed hoedown from rustdoc.][48274]
3396 - [Bounds on higher-kinded lifetimes a hard error.][48326]
3397
3398 [46882]: https://github.com/rust-lang/rust/pull/46882
3399 [47379]: https://github.com/rust-lang/rust/pull/47379
3400 [47408]: https://github.com/rust-lang/rust/pull/47408
3401 [47813]: https://github.com/rust-lang/rust/pull/47813
3402 [48056]: https://github.com/rust-lang/rust/pull/48056
3403 [48125]: https://github.com/rust-lang/rust/pull/48125
3404 [48166]: https://github.com/rust-lang/rust/pull/48166
3405 [48235]: https://github.com/rust-lang/rust/pull/48235
3406 [48274]: https://github.com/rust-lang/rust/pull/48274
3407 [48281]: https://github.com/rust-lang/rust/pull/48281
3408 [48296]: https://github.com/rust-lang/rust/pull/48296
3409 [48326]: https://github.com/rust-lang/rust/pull/48326
3410 [48359]: https://github.com/rust-lang/rust/pull/48359
3411 [48404]: https://github.com/rust-lang/rust/pull/48404
3412 [48481]: https://github.com/rust-lang/rust/pull/48481
3413 [48516]: https://github.com/rust-lang/rust/pull/48516
3414 [48628]: https://github.com/rust-lang/rust/pull/48628
3415 [48629]: https://github.com/rust-lang/rust/pull/48629
3416 [48657]: https://github.com/rust-lang/rust/pull/48657
3417 [48735]: https://github.com/rust-lang/rust/pull/48735
3418 [48978]: https://github.com/rust-lang/rust/pull/48978
3419 [49101]: https://github.com/rust-lang/rust/pull/49101
3420 [49109]: https://github.com/rust-lang/rust/pull/49109
3421 [49121]: https://github.com/rust-lang/rust/pull/49121
3422 [49162]: https://github.com/rust-lang/rust/pull/49162
3423 [49184]: https://github.com/rust-lang/rust/pull/49184
3424 [49234]: https://github.com/rust-lang/rust/pull/49234
3425 [49255]: https://github.com/rust-lang/rust/pull/49255
3426 [49299]: https://github.com/rust-lang/rust/pull/49299
3427 [49305]: https://github.com/rust-lang/rust/pull/49305
3428 [49394]: https://github.com/rust-lang/rust/pull/49394
3429 [49458]: https://github.com/rust-lang/rust/pull/49458
3430 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3431 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3432 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3433 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3434 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3435 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3436 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3437 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3438 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3439 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3440 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3441 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3442 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3443 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3444 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3445 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3446 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3447 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3448 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3449 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3450 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3451 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3452 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3453 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3454 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3455 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3456 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3457 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3458 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3459 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3460 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3461 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3462 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3463 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3464 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3465 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3466 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3467 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3468 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3469 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3470 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3471 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
3472
3473
3474 Version 1.25.0 (2018-03-29)
3475 ==========================
3476
3477 Language
3478 --------
3479 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
3480 - [You can now use nested groups of imports.][47948]
3481   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3482 - [You can now have `|` at the start of a match arm.][47947] e.g.
3483 ```rust
3484 enum Foo { A, B, C }
3485
3486 fn main() {
3487     let x = Foo::A;
3488     match x {
3489         | Foo::A
3490         | Foo::B => println!("AB"),
3491         | Foo::C => println!("C"),
3492     }
3493 }
3494 ```
3495
3496 Compiler
3497 --------
3498 - [Upgraded to LLVM 6.][47828]
3499 - [Added `-C lto=val` option.][47521]
3500 - [Added `i586-unknown-linux-musl` target][47282]
3501
3502 Libraries
3503 ---------
3504 - [Impl Send for `process::Command` on Unix.][47760]
3505 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
3506 - [`UnsafeCell::into_inner` is now safe.][47204]
3507 - [Implement libstd for CloudABI.][47268]
3508 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3509 - [Implement `AsRef<Path>` for Component][46985]
3510 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
3511 - [Moved `Duration` to libcore.][46666]
3512
3513 Stabilized APIs
3514 ---------------
3515 - [`Location::column`]
3516 - [`ptr::NonNull`]
3517
3518 The following functions can now be used in a constant expression.
3519 eg. `static MINUTE: Duration = Duration::from_secs(60);`
3520 - [`Duration::new`][47300]
3521 - [`Duration::from_secs`][47300]
3522 - [`Duration::from_millis`][47300]
3523
3524 Cargo
3525 -----
3526 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
3527 - [`cargo new` now defaults to creating a binary crate, instead of a
3528   library crate.][cargo/5029]
3529
3530 Misc
3531 ----
3532 - [Rust by example is now shipped with new releases][46196]
3533
3534 Compatibility Notes
3535 -------------------
3536 - [Deprecated `net::lookup_host`.][47510]
3537 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
3538 - The borrow checker was sometimes incorrectly permitting overlapping borrows
3539   around indexing operations (see [#47349][47349]). This has been fixed (which also
3540   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
3541 - [Removed deprecated unstable attribute `#[simd]`.][47251]
3542
3543 [33903]: https://github.com/rust-lang/rust/pull/33903
3544 [47947]: https://github.com/rust-lang/rust/pull/47947
3545 [47948]: https://github.com/rust-lang/rust/pull/47948
3546 [47760]: https://github.com/rust-lang/rust/pull/47760
3547 [47790]: https://github.com/rust-lang/rust/pull/47790
3548 [47828]: https://github.com/rust-lang/rust/pull/47828
3549 [47398]: https://github.com/rust-lang/rust/pull/47398
3550 [47510]: https://github.com/rust-lang/rust/pull/47510
3551 [47521]: https://github.com/rust-lang/rust/pull/47521
3552 [47204]: https://github.com/rust-lang/rust/pull/47204
3553 [47251]: https://github.com/rust-lang/rust/pull/47251
3554 [47268]: https://github.com/rust-lang/rust/pull/47268
3555 [47282]: https://github.com/rust-lang/rust/pull/47282
3556 [47300]: https://github.com/rust-lang/rust/pull/47300
3557 [47349]: https://github.com/rust-lang/rust/pull/47349
3558 [46931]: https://github.com/rust-lang/rust/pull/46931
3559 [46985]: https://github.com/rust-lang/rust/pull/46985
3560 [47006]: https://github.com/rust-lang/rust/pull/47006
3561 [46830]: https://github.com/rust-lang/rust/pull/46830
3562 [46095]: https://github.com/rust-lang/rust/pull/46095
3563 [46666]: https://github.com/rust-lang/rust/pull/46666
3564 [46196]: https://github.com/rust-lang/rust/pull/46196
3565 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3566 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3567 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3568 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3569 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3570
3571
3572 Version 1.24.1 (2018-03-01)
3573 ==========================
3574
3575  - [Do not abort when unwinding through FFI][48251]
3576  - [Emit UTF-16 files for linker arguments on Windows][48318]
3577  - [Make the error index generator work again][48308]
3578  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3579
3580 [48251]: https://github.com/rust-lang/rust/issues/48251
3581 [48308]: https://github.com/rust-lang/rust/issues/48308
3582 [48318]: https://github.com/rust-lang/rust/issues/48318
3583 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3584
3585
3586 Version 1.24.0 (2018-02-15)
3587 ==========================
3588
3589 Language
3590 --------
3591 - [External `sysv64` ffi is now available.][46528]
3592   eg. `extern "sysv64" fn foo () {}`
3593
3594 Compiler
3595 --------
3596 - [rustc now uses 16 codegen units by default for release builds.][46910]
3597   For the fastest builds, utilize `codegen-units=1`.
3598 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3599 - [Add `aarch64-unknown-openbsd` support][46760]
3600
3601 Libraries
3602 ---------
3603 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3604   improvement in performance in the majority of cases.
3605 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3606   with Windows.][46798]
3607 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3608 - [impl `From<bool>` for `AtomicBool`][46293]
3609 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3610 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3611 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3612 - [float::from_bits now just uses transmute.][46012] This provides
3613   some optimisations from LLVM.
3614 - [Copied `AsciiExt` methods onto `char`][46077]
3615 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3616 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3617 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3618 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3619
3620 Stabilized APIs
3621 ---------------
3622 - [`RefCell::replace`]
3623 - [`RefCell::swap`]
3624 - [`atomic::spin_loop_hint`]
3625
3626 The following functions can now be used in a constant expression.
3627 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3628
3629 - [`AtomicBool::new`][46287]
3630 - [`AtomicUsize::new`][46287]
3631 - [`AtomicIsize::new`][46287]
3632 - [`AtomicPtr::new`][46287]
3633 - [`Cell::new`][46287]
3634 - [`{integer}::min_value`][46287]
3635 - [`{integer}::max_value`][46287]
3636 - [`mem::size_of`][46287]
3637 - [`mem::align_of`][46287]
3638 - [`ptr::null`][46287]
3639 - [`ptr::null_mut`][46287]
3640 - [`RefCell::new`][46287]
3641 - [`UnsafeCell::new`][46287]
3642
3643 Cargo
3644 -----
3645 - [Added a `workspace.default-members` config that
3646   overrides implied `--all` in virtual workspaces.][cargo/4743]
3647 - [Enable incremental by default on development builds.][cargo/4817] Also added
3648   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3649   per-project or global basis respectively.
3650
3651 Misc
3652 ----
3653
3654 Compatibility Notes
3655 -------------------
3656 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3657 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3658   in accordance with IETF RFC 4291 §2.2.
3659 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3660 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3661   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3662 - [Leading zeros in tuple struct members is now an error][47084]
3663 - [`column!()` macro is one-based instead of zero-based][46977]
3664 - [`fmt::Arguments` can no longer be shared across threads][45198]
3665 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
3666 - [Cargo sets a different working directory for the compiler][cargo/4788]
3667
3668 [44884]: https://github.com/rust-lang/rust/pull/44884
3669 [45198]: https://github.com/rust-lang/rust/pull/45198
3670 [45506]: https://github.com/rust-lang/rust/pull/45506
3671 [45904]: https://github.com/rust-lang/rust/pull/45904
3672 [45990]: https://github.com/rust-lang/rust/pull/45990
3673 [46012]: https://github.com/rust-lang/rust/pull/46012
3674 [46077]: https://github.com/rust-lang/rust/pull/46077
3675 [46094]: https://github.com/rust-lang/rust/pull/46094
3676 [46284]: https://github.com/rust-lang/rust/pull/46284
3677 [46287]: https://github.com/rust-lang/rust/pull/46287
3678 [46293]: https://github.com/rust-lang/rust/pull/46293
3679 [46528]: https://github.com/rust-lang/rust/pull/46528
3680 [46671]: https://github.com/rust-lang/rust/pull/46671
3681 [46713]: https://github.com/rust-lang/rust/pull/46713
3682 [46735]: https://github.com/rust-lang/rust/pull/46735
3683 [46749]: https://github.com/rust-lang/rust/pull/46749
3684 [46760]: https://github.com/rust-lang/rust/pull/46760
3685 [46798]: https://github.com/rust-lang/rust/pull/46798
3686 [46828]: https://github.com/rust-lang/rust/pull/46828
3687 [46831]: https://github.com/rust-lang/rust/pull/46831
3688 [46833]: https://github.com/rust-lang/rust/pull/46833
3689 [46910]: https://github.com/rust-lang/rust/pull/46910
3690 [46977]: https://github.com/rust-lang/rust/pull/46977
3691 [47018]: https://github.com/rust-lang/rust/pull/47018
3692 [47080]: https://github.com/rust-lang/rust/pull/47080
3693 [47084]: https://github.com/rust-lang/rust/pull/47084
3694 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
3695 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
3696 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3697 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3698 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3699 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3700
3701
3702 Version 1.23.0 (2018-01-04)
3703 ==========================
3704
3705 Language
3706 --------
3707 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3708 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
3709   Which should fix some confusing errors in some operations.
3710
3711 Compiler
3712 --------
3713 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
3714   undefined behavior.][45920]
3715 - [rustc now suggests renaming import if names clash.][45660]
3716 - [Display errors/warnings correctly when there are zero-width or
3717   wide characters.][45711]
3718 - [rustc now avoids unnecessary copies of arguments that are
3719   simple bindings][45380] This should improve memory usage on average by 5-10%.
3720 - [Updated musl used to build musl rustc to 1.1.17][45393]
3721
3722 Libraries
3723 ---------
3724 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3725 - [Implement Hash for raw pointers to unsized types][45483]
3726 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3727 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3728 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3729 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3730   and `<*mut T>::as_mut`][44932]
3731 - [Optimized `Thread::{park, unpark}` implementation][45524]
3732 - [Improved `SliceExt::binary_search` performance.][45333]
3733 - [impl `FromIterator<()>` for `()`][45379]
3734 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3735   is now deprecated.
3736
3737 Stabilized APIs
3738 ---------------
3739
3740 Cargo
3741 -----
3742 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3743   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3744 - [Added unit test checking to `cargo check`][cargo/4592]
3745 - [Cargo now lets you install a specific version
3746   using `cargo install --version`][cargo/4637]
3747
3748 Misc
3749 ----
3750 - [Releases now ship with the Cargo book documentation.][45692]
3751 - [rustdoc now prints rendering warnings on every run.][45324]
3752
3753 Compatibility Notes
3754 -------------------
3755 - [Changes have been made to type equality to make it more correct,
3756   in rare cases this could break some code.][45853] [Tracking issue for
3757   further information][45852]
3758 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3759 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3760   Android 9, the minimum supported version is Android 14.
3761 - [Bumped the minimum LLVM to 3.9][45326]
3762
3763 [44042]: https://github.com/rust-lang/rust/pull/44042
3764 [44932]: https://github.com/rust-lang/rust/pull/44932
3765 [45267]: https://github.com/rust-lang/rust/pull/45267
3766 [45324]: https://github.com/rust-lang/rust/pull/45324
3767 [45326]: https://github.com/rust-lang/rust/pull/45326
3768 [45333]: https://github.com/rust-lang/rust/pull/45333
3769 [45379]: https://github.com/rust-lang/rust/pull/45379
3770 [45380]: https://github.com/rust-lang/rust/pull/45380
3771 [45393]: https://github.com/rust-lang/rust/pull/45393
3772 [45435]: https://github.com/rust-lang/rust/pull/45435
3773 [45483]: https://github.com/rust-lang/rust/pull/45483
3774 [45524]: https://github.com/rust-lang/rust/pull/45524
3775 [45571]: https://github.com/rust-lang/rust/pull/45571
3776 [45580]: https://github.com/rust-lang/rust/pull/45580
3777 [45610]: https://github.com/rust-lang/rust/pull/45610
3778 [45660]: https://github.com/rust-lang/rust/pull/45660
3779 [45692]: https://github.com/rust-lang/rust/pull/45692
3780 [45711]: https://github.com/rust-lang/rust/pull/45711
3781 [45772]: https://github.com/rust-lang/rust/pull/45772
3782 [45852]: https://github.com/rust-lang/rust/issues/45852
3783 [45853]: https://github.com/rust-lang/rust/pull/45853
3784 [45887]: https://github.com/rust-lang/rust/pull/45887
3785 [45920]: https://github.com/rust-lang/rust/pull/45920
3786 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3787 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3788 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3789
3790
3791 Version 1.22.1 (2017-11-22)
3792 ==========================
3793
3794 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3795
3796 [46183]: https://github.com/rust-lang/rust/pull/46183
3797
3798 Version 1.22.0 (2017-11-22)
3799 ==========================
3800
3801 Language
3802 --------
3803 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3804 - [Now accepts underscores in unicode escapes][43716]
3805 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3806 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3807
3808 Compiler
3809 --------
3810 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3811 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3812   This should decrease compile times for debug builds.
3813 - [strict memory alignment now enabled on ARMv6][45094]
3814 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3815
3816 Libraries
3817 ---------
3818 - [Allow atomic operations up to 32 bits
3819   on `armv5te_unknown_linux_gnueabi`][44978]
3820 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3821 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3822 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3823 - [Properly detect overflow in `Instant += Duration`.][44220]
3824 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3825 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3826 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3827
3828 Stabilized APIs
3829 ---------------
3830
3831 Cargo
3832 -----
3833 - [Cargo will now build multi file examples in subdirectories of the `examples`
3834   folder that have a `main.rs` file.][cargo/4496]
3835 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3836   the old format will continue to work and can be updated with `cargo update`.
3837 - [Now supports vendoring git repositories][cargo/3992]
3838
3839 Misc
3840 ----
3841 - [`libbacktrace` is now available on Apple platforms.][44251]
3842 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3843   This now lets you specify that a given code example will fail to compile.
3844
3845 Compatibility Notes
3846 -------------------
3847 - [The minimum Android version that rustc can build for has been bumped
3848   to `4.0` from `2.3`][45656]
3849 - [Allowing `T op= &T` for numeric types has broken some type
3850   inference cases][45480]
3851
3852
3853 [42526]: https://github.com/rust-lang/rust/pull/42526
3854 [43017]: https://github.com/rust-lang/rust/pull/43017
3855 [43716]: https://github.com/rust-lang/rust/pull/43716
3856 [43949]: https://github.com/rust-lang/rust/pull/43949
3857 [44015]: https://github.com/rust-lang/rust/pull/44015
3858 [44220]: https://github.com/rust-lang/rust/pull/44220
3859 [44251]: https://github.com/rust-lang/rust/pull/44251
3860 [44287]: https://github.com/rust-lang/rust/pull/44287
3861 [44303]: https://github.com/rust-lang/rust/pull/44303
3862 [44456]: https://github.com/rust-lang/rust/pull/44456
3863 [44466]: https://github.com/rust-lang/rust/pull/44466
3864 [44895]: https://github.com/rust-lang/rust/pull/44895
3865 [44966]: https://github.com/rust-lang/rust/pull/44966
3866 [44978]: https://github.com/rust-lang/rust/pull/44978
3867 [45041]: https://github.com/rust-lang/rust/pull/45041
3868 [45064]: https://github.com/rust-lang/rust/pull/45064
3869 [45075]: https://github.com/rust-lang/rust/pull/45075
3870 [45094]: https://github.com/rust-lang/rust/pull/45094
3871 [45095]: https://github.com/rust-lang/rust/pull/45095
3872 [45480]: https://github.com/rust-lang/rust/issues/45480
3873 [45656]: https://github.com/rust-lang/rust/pull/45656
3874 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3875 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3876 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3877
3878
3879
3880
3881
3882
3883 Version 1.21.0 (2017-10-12)
3884 ==========================
3885
3886 Language
3887 --------
3888 - [You can now use static references for literals.][43838]
3889   Example:
3890   ```rust
3891   fn main() {
3892       let x: &'static u32 = &0;
3893   }
3894   ```
3895 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3896   Example:
3897   ```rust
3898   my_macro!(Vec<i32>::new); // Always worked
3899   my_macro!(Vec::<i32>::new); // Now works
3900   ```
3901
3902 Compiler
3903 --------
3904 - [Upgraded jemalloc to 4.5.0][43911]
3905 - [Enabled unwinding panics on Redox][43917]
3906 - [Now runs LLVM in parallel during translation phase.][43506]
3907   This should reduce peak memory usage.
3908
3909 Libraries
3910 ---------
3911 - [Generate builtin impls for `Clone` for all arrays and tuples that
3912   are `T: Clone`][43690]
3913 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3914 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3915   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3916
3917 Stabilized APIs
3918 ---------------
3919
3920 [`std::mem::discriminant`]
3921
3922 Cargo
3923 -----
3924 - [You can now call `cargo install` with multiple package names][cargo/4216]
3925 - [Cargo commands inside a virtual workspace will now implicitly
3926   pass `--all`][cargo/4335]
3927 - [Added a `[patch]` section to `Cargo.toml` to handle
3928   prepublication dependencies][cargo/4123] [RFC 1969]
3929 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3930   like patterns][cargo/4270]
3931 - [Added the `--all-targets` option][cargo/4400]
3932 - [Using required dependencies as a feature is now deprecated and emits
3933   a warning][cargo/4364]
3934
3935
3936 Misc
3937 ----
3938 - [Cargo docs are moving][43916]
3939   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3940 - [The rustdoc book is now available][43863]
3941   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3942 - [Added a preview of RLS has been made available through rustup][44204]
3943   Install with `rustup component add rls-preview`
3944 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3945   Previously only showed `std::os::unix`.
3946
3947 Compatibility Notes
3948 -------------------
3949 - [Changes in method matching against higher-ranked types][43880] This may cause
3950   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3951 - [rustc's JSON error output's byte position start at top of file.][42973]
3952   Was previously relative to the rustc's internal `CodeMap` struct which
3953   required the unstable library `libsyntax` to correctly use.
3954 - [`unused_results` lint no longer ignores booleans][43728]
3955
3956 [42565]: https://github.com/rust-lang/rust/pull/42565
3957 [42973]: https://github.com/rust-lang/rust/pull/42973
3958 [43348]: https://github.com/rust-lang/rust/pull/43348
3959 [43459]: https://github.com/rust-lang/rust/pull/43459
3960 [43506]: https://github.com/rust-lang/rust/pull/43506
3961 [43540]: https://github.com/rust-lang/rust/pull/43540
3962 [43690]: https://github.com/rust-lang/rust/pull/43690
3963 [43728]: https://github.com/rust-lang/rust/pull/43728
3964 [43838]: https://github.com/rust-lang/rust/pull/43838
3965 [43863]: https://github.com/rust-lang/rust/pull/43863
3966 [43880]: https://github.com/rust-lang/rust/pull/43880
3967 [43911]: https://github.com/rust-lang/rust/pull/43911
3968 [43916]: https://github.com/rust-lang/rust/pull/43916
3969 [43917]: https://github.com/rust-lang/rust/pull/43917
3970 [44204]: https://github.com/rust-lang/rust/pull/44204
3971 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3972 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3973 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3974 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3975 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3976 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3977 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3978 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3979 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3980
3981 Version 1.20.0 (2017-08-31)
3982 ===========================
3983
3984 Language
3985 --------
3986 - [Associated constants are now stabilised.][42809]
3987 - [A lot of macro bugs are now fixed.][42913]
3988
3989 Compiler
3990 --------
3991
3992 - [Struct fields are now properly coerced to the expected field type.][42807]
3993 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3994   `wasm32-experimental-emscripten` target.
3995 - [Changed some of the error messages to be more helpful.][42033]
3996 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3997   it.][43170]
3998 - [rustc now reports the total number of errors on compilation failure][43015]
3999   previously this was only the number of errors in the pass that failed.
4000 - [Expansion in rustc has been sped up 29x.][42533]
4001 - [added `msp430-none-elf` target.][43099]
4002 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4003   applicable][43178]
4004 - [Fixes backtraces on Redox][43228]
4005 - [rustc now identifies different versions of same crate when absolute paths of
4006   different types match in an error message.][42826]
4007
4008 Libraries
4009 ---------
4010
4011
4012 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4013 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4014   tuples.][43011]
4015 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4016   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4017 - [Impl `Clone` for `DefaultHasher`.][42799]
4018 - [Impl `Sync` for `SyncSender`.][42397]
4019 - [Impl `FromStr` for `char`][42271]
4020 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4021   NaN.][42431]
4022 - [allow messages in the `unimplemented!()` macro.][42155]
4023   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4024 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4025 - [Upgrade to Unicode 10.0.0][42999]
4026 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4027 - [Skip the main thread's manual stack guard on Linux][43072]
4028 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4029 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4030   previously 2^15.
4031 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4032
4033 Stabilized APIs
4034 ---------------
4035
4036 - [`CStr::into_c_string`]
4037 - [`CString::as_c_str`]
4038 - [`CString::into_boxed_c_str`]
4039 - [`Chain::get_mut`]
4040 - [`Chain::get_ref`]
4041 - [`Chain::into_inner`]
4042 - [`Option::get_or_insert_with`]
4043 - [`Option::get_or_insert`]
4044 - [`OsStr::into_os_string`]
4045 - [`OsString::into_boxed_os_str`]
4046 - [`Take::get_mut`]
4047 - [`Take::get_ref`]
4048 - [`Utf8Error::error_len`]
4049 - [`char::EscapeDebug`]
4050 - [`char::escape_debug`]
4051 - [`compile_error!`]
4052 - [`f32::from_bits`]
4053 - [`f32::to_bits`]
4054 - [`f64::from_bits`]
4055 - [`f64::to_bits`]
4056 - [`mem::ManuallyDrop`]
4057 - [`slice::sort_unstable_by_key`]
4058 - [`slice::sort_unstable_by`]
4059 - [`slice::sort_unstable`]
4060 - [`str::from_boxed_utf8_unchecked`]
4061 - [`str::as_bytes_mut`]
4062 - [`str::as_bytes_mut`]
4063 - [`str::from_utf8_mut`]
4064 - [`str::from_utf8_unchecked_mut`]
4065 - [`str::get_mut`]
4066 - [`str::get_unchecked_mut`]
4067 - [`str::get_unchecked`]
4068 - [`str::get`]
4069 - [`str::into_boxed_bytes`]
4070
4071
4072 Cargo
4073 -----
4074 - [Cargo API token location moved from `~/.cargo/config` to
4075   `~/.cargo/credentials`.][cargo/3978]
4076 - [Cargo will now build `main.rs` binaries that are in sub-directories of
4077   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4078   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4079 - [You can now specify version of a binary when installed through
4080   `cargo install` using `--vers`.][cargo/4229]
4081 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4082   failure.][cargo/4248]
4083 - [Changed the convention around which file is the crate root.][cargo/4259]
4084 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4085   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4086
4087 Compatibility Notes
4088 -------------------
4089
4090 - [Functions with `'static` in their return types will now not be as usable as
4091   if they were using lifetime parameters instead.][42417]
4092 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
4093   takes the sign of NaN into account where previously didn't.][42430]
4094
4095 [42033]: https://github.com/rust-lang/rust/pull/42033
4096 [42155]: https://github.com/rust-lang/rust/pull/42155
4097 [42271]: https://github.com/rust-lang/rust/pull/42271
4098 [42397]: https://github.com/rust-lang/rust/pull/42397
4099 [42417]: https://github.com/rust-lang/rust/pull/42417
4100 [42430]: https://github.com/rust-lang/rust/pull/42430
4101 [42431]: https://github.com/rust-lang/rust/pull/42431
4102 [42533]: https://github.com/rust-lang/rust/pull/42533
4103 [42571]: https://github.com/rust-lang/rust/pull/42571
4104 [42613]: https://github.com/rust-lang/rust/pull/42613
4105 [42799]: https://github.com/rust-lang/rust/pull/42799
4106 [42807]: https://github.com/rust-lang/rust/pull/42807
4107 [42809]: https://github.com/rust-lang/rust/pull/42809
4108 [42822]: https://github.com/rust-lang/rust/pull/42822
4109 [42826]: https://github.com/rust-lang/rust/pull/42826
4110 [42854]: https://github.com/rust-lang/rust/pull/42854
4111 [42913]: https://github.com/rust-lang/rust/pull/42913
4112 [42999]: https://github.com/rust-lang/rust/pull/42999
4113 [43011]: https://github.com/rust-lang/rust/pull/43011
4114 [43015]: https://github.com/rust-lang/rust/pull/43015
4115 [43072]: https://github.com/rust-lang/rust/pull/43072
4116 [43077]: https://github.com/rust-lang/rust/pull/43077
4117 [43097]: https://github.com/rust-lang/rust/pull/43097
4118 [43099]: https://github.com/rust-lang/rust/pull/43099
4119 [43170]: https://github.com/rust-lang/rust/pull/43170
4120 [43178]: https://github.com/rust-lang/rust/pull/43178
4121 [43185]: https://github.com/rust-lang/rust/pull/43185
4122 [43228]: https://github.com/rust-lang/rust/pull/43228
4123 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4124 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4125 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4126 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4127 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4128 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4129 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4130 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4131 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4132 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4133 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4134 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4135 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4136 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4137 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4138 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4139 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4140 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4141 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4142 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4143 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4144 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4145 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4146 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4147 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4148 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4149 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4150 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4151 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4152 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4153 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4154 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4155 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4156 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4157 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4158 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4159 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4160 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4161 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4162
4163
4164 Version 1.19.0 (2017-07-20)
4165 ===========================
4166
4167 Language
4168 --------
4169
4170 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4171   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4172 - [Macro recursion limit increased to 1024 from 64.][41676]
4173 - [Added lint for detecting unused macros.][41907]
4174 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
4175   For example: `let x = loop { break 7; };`
4176 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4177   contain `Copy` types and cannot have a `Drop` implementation.
4178   Example: `union Foo { bar: u8, baz: usize }`
4179 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4180   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4181
4182 Compiler
4183 --------
4184
4185 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4186 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
4187   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4188   you should use `--target armv7-linux-androideabi`.
4189 - [Fixed ICE when removing a source file between compilation sessions.][41873]
4190 - [Minor optimisation of string operations.][42037]
4191 - [Compiler error message is now `aborting due to previous error(s)` instead of
4192   `aborting due to N previous errors`][42150] This was previously inaccurate and
4193   would only count certain kinds of errors.
4194 - [The compiler now supports Visual Studio 2017][42225]
4195 - [The compiler is now built against LLVM 4.0.1 by default][42948]
4196 - [Added a lot][42264] of [new error codes][42302]
4197 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4198   libraries with C Run-time Libraries(CRT) to be statically linked.
4199 - [Fixed various ARM codegen bugs][42740]
4200
4201 Libraries
4202 ---------
4203
4204 - [`String` now implements `FromIterator<Cow<'a, str>>` and
4205   `Extend<Cow<'a, str>>`][41449]
4206 - [`Vec` now implements `From<&mut [T]>`][41530]
4207 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4208 - [`SplitWhitespace` now implements `Clone`][41659]
4209 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4210   1.5x faster][41764]
4211 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4212   macros, but for printing to stderr.
4213
4214 Stabilized APIs
4215 ---------------
4216
4217 - [`OsString::shrink_to_fit`]
4218 - [`cmp::Reverse`]
4219 - [`Command::envs`]
4220 - [`thread::ThreadId`]
4221
4222 Cargo
4223 -----
4224
4225 - [Build scripts can now add environment variables to the environment
4226   the crate is being compiled in.
4227   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4228 - [Subcommands now replace the current process rather than spawning a new
4229   child process][cargo/3970]
4230 - [Workspace members can now accept glob file patterns][cargo/3979]
4231 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4232   the members in a given workspace.][cargo/3988]
4233 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4234 - [Target directory path is now in the cargo metadata][cargo/4022]
4235 - [Cargo no longer checks out a local working directory for the
4236   crates.io index][cargo/4026] This should provide smaller file size for the
4237   registry, and improve cloning times, especially on Windows machines.
4238 - [Added an `--exclude` option for excluding certain packages when using the
4239   `--all` option][cargo/4031]
4240 - [Cargo will now automatically retry when receiving a 5xx error
4241   from crates.io][cargo/4032]
4242 - [The `--features` option now accepts multiple comma or space
4243   delimited values.][cargo/4084]
4244 - [Added support for custom target specific runners][cargo/3954]
4245
4246 Misc
4247 ----
4248
4249 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4250   Windows Debugger.
4251 - [Rust will now release XZ compressed packages][rust-installer/57]
4252 - [rustup will now prefer to download rust packages with
4253   XZ compression][rustup/1100] over GZip packages.
4254 - [Added the ability to escape `#` in rust documentation][41785] By adding
4255   additional `#`'s ie. `##` is now `#`
4256
4257 Compatibility Notes
4258 -------------------
4259
4260 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4261 - [`-Z` flags are now no longer allowed to be used on the stable
4262   compiler.][41751] This has been a warning for a year previous to this.
4263 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4264   longer works][42844]. Users should migrate to the built-in `check`
4265   command, which has been available since 1.16.
4266 - [Ending a float literal with `._` is now a hard error.
4267   Example: `42._` .][41946]
4268 - [Any use of a private `extern crate` outside of its module is now a
4269   hard error.][36886] This was previously a warning.
4270 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4271   relative while the `::` prefix makes a path absolute, but was ignored and the
4272   path was relative regardless.
4273 - [Floating point constants in match patterns is now a hard error][36890]
4274   This was previously a warning.
4275 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4276   match patterns is now a hard error][36891] This was previously a warning.
4277 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4278   a warning.
4279 - [From the pound escape, lines consisting of multiple `#`s are
4280   now visible][41785]
4281 - [It is an error to re-export private enum variants][42460]. This is
4282   known to break a number of crates that depend on an older version of
4283   mustache.
4284 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4285   to use it to find the linker, and the build will fail where it did
4286   not previously][42607]
4287
4288 [36886]: https://github.com/rust-lang/rust/issues/36886
4289 [36888]: https://github.com/rust-lang/rust/issues/36888
4290 [36890]: https://github.com/rust-lang/rust/issues/36890
4291 [36891]: https://github.com/rust-lang/rust/issues/36891
4292 [36892]: https://github.com/rust-lang/rust/issues/36892
4293 [37406]: https://github.com/rust-lang/rust/issues/37406
4294 [39983]: https://github.com/rust-lang/rust/pull/39983
4295 [41145]: https://github.com/rust-lang/rust/pull/41145
4296 [41192]: https://github.com/rust-lang/rust/pull/41192
4297 [41258]: https://github.com/rust-lang/rust/pull/41258
4298 [41370]: https://github.com/rust-lang/rust/pull/41370
4299 [41449]: https://github.com/rust-lang/rust/pull/41449
4300 [41530]: https://github.com/rust-lang/rust/pull/41530
4301 [41624]: https://github.com/rust-lang/rust/pull/41624
4302 [41656]: https://github.com/rust-lang/rust/pull/41656
4303 [41659]: https://github.com/rust-lang/rust/pull/41659
4304 [41676]: https://github.com/rust-lang/rust/pull/41676
4305 [41751]: https://github.com/rust-lang/rust/pull/41751
4306 [41764]: https://github.com/rust-lang/rust/pull/41764
4307 [41785]: https://github.com/rust-lang/rust/pull/41785
4308 [41873]: https://github.com/rust-lang/rust/pull/41873
4309 [41907]: https://github.com/rust-lang/rust/pull/41907
4310 [41946]: https://github.com/rust-lang/rust/pull/41946
4311 [42016]: https://github.com/rust-lang/rust/pull/42016
4312 [42037]: https://github.com/rust-lang/rust/pull/42037
4313 [42068]: https://github.com/rust-lang/rust/pull/42068
4314 [42150]: https://github.com/rust-lang/rust/pull/42150
4315 [42162]: https://github.com/rust-lang/rust/pull/42162
4316 [42225]: https://github.com/rust-lang/rust/pull/42225
4317 [42264]: https://github.com/rust-lang/rust/pull/42264
4318 [42302]: https://github.com/rust-lang/rust/pull/42302
4319 [42460]: https://github.com/rust-lang/rust/issues/42460
4320 [42607]: https://github.com/rust-lang/rust/issues/42607
4321 [42740]: https://github.com/rust-lang/rust/pull/42740
4322 [42844]: https://github.com/rust-lang/rust/issues/42844
4323 [42948]: https://github.com/rust-lang/rust/pull/42948
4324 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4325 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4326 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4327 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4328 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4329 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4330 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4331 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4332 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4333 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4334 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4335 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4336 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4337 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4338 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4339 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4340 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4341 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4342 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4343 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4344 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4345 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4346
4347
4348 Version 1.18.0 (2017-06-08)
4349 ===========================
4350
4351 Language
4352 --------
4353
4354 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4355   make the item visible to just that module tree. Also accepts the keyword
4356   `crate` to make something public to the whole crate but not users of the
4357   library. Example: `pub(crate) mod utils;`. [RFC 1422].
4358 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4359   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4360 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4361   types like `Write + Send`, trailing `+` are now supported in trait objects,
4362   and better error reporting for trait objects starting with `?Sized`.
4363 - [0e+10 is now a valid floating point literal][40589]
4364 - [Now warns if you bind a lifetime parameter to 'static][40734]
4365 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4366   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4367   representation in some cases.][40377]
4368
4369 Compiler
4370 --------
4371
4372 - [rustc can now emit mir with `--emit mir`][39891]
4373 - [Improved LLVM IR for trivial functions][40367]
4374 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4375 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4376   opportunities found through profiling
4377 - [Improved backtrace formatting when panicking][38165]
4378
4379 Libraries
4380 ---------
4381
4382 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4383   iterator hasn't been advanced the original `Vec` is reassembled with no actual
4384   iteration or reallocation.
4385 - [Simplified HashMap Bucket interface][40561] provides performance
4386   improvements for iterating and cloning.
4387 - [Specialize Vec::from_elem to use calloc][40409]
4388 - [Fixed Race condition in fs::create_dir_all][39799]
4389 - [No longer caching stdio on Windows][40516]
4390 - [Optimized insertion sort in slice][40807] insertion sort in some cases
4391   2.50%~ faster and in one case now 12.50% faster.
4392 - [Optimized `AtomicBool::fetch_nand`][41143]
4393
4394 Stabilized APIs
4395 ---------------
4396
4397 - [`Child::try_wait`]
4398 - [`HashMap::retain`]
4399 - [`HashSet::retain`]
4400 - [`PeekMut::pop`]
4401 - [`TcpStream::peek`]
4402 - [`UdpSocket::peek`]
4403 - [`UdpSocket::peek_from`]
4404
4405 Cargo
4406 -----
4407
4408 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4409   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4410 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
4411 - [Added Android build support][cargo/3885]
4412 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4413   of a certain type, for example `cargo build --bins` will build all
4414   binaries.
4415 - [Added support for haiku][cargo/3952]
4416
4417 Misc
4418 ----
4419
4420 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
4421 - [Added rust-windbg script for better debugging on Windows][39983]
4422 - [Rust now uses the official cross compiler for NetBSD][40612]
4423 - [rustdoc now accepts `#` at the start of files][40828]
4424 - [Fixed jemalloc support for musl][41168]
4425
4426 Compatibility Notes
4427 -------------------
4428
4429 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4430   always placed after the sign if it exists and before the digits. With the `#`
4431   flag the zeroes are placed after the prefix and before the digits.
4432 - [Due to the struct field optimisation][40377], using `transmute` on structs
4433   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4434   always been undefined behavior, but is now more likely to break in practice.
4435 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4436   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4437   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4438 - [Overlapping inherent `impl`s are now a hard error][40728]
4439 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4440 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4441   `out.asm` and `out.ll` instead of only one of the filetypes.
4442 - [ calling a function that returns `Self` will no longer work][41805] when
4443   the size of `Self` cannot be statically determined.
4444 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4445   this has caused a few regressions namely:
4446
4447   - Changed the link order of local static/dynamic libraries (respecting the
4448     order on given rather than having the compiler reorder).
4449   - Changed how MinGW is linked, native code linked to dynamic libraries
4450     may require manually linking to the gcc support library (for the native
4451     code itself)
4452
4453 [38165]: https://github.com/rust-lang/rust/pull/38165
4454 [39799]: https://github.com/rust-lang/rust/pull/39799
4455 [39891]: https://github.com/rust-lang/rust/pull/39891
4456 [39983]: https://github.com/rust-lang/rust/pull/39983
4457 [40043]: https://github.com/rust-lang/rust/pull/40043
4458 [40241]: https://github.com/rust-lang/rust/pull/40241
4459 [40338]: https://github.com/rust-lang/rust/pull/40338
4460 [40367]: https://github.com/rust-lang/rust/pull/40367
4461 [40377]: https://github.com/rust-lang/rust/pull/40377
4462 [40409]: https://github.com/rust-lang/rust/pull/40409
4463 [40516]: https://github.com/rust-lang/rust/pull/40516
4464 [40556]: https://github.com/rust-lang/rust/pull/40556
4465 [40561]: https://github.com/rust-lang/rust/pull/40561
4466 [40589]: https://github.com/rust-lang/rust/pull/40589
4467 [40612]: https://github.com/rust-lang/rust/pull/40612
4468 [40723]: https://github.com/rust-lang/rust/pull/40723
4469 [40728]: https://github.com/rust-lang/rust/pull/40728
4470 [40731]: https://github.com/rust-lang/rust/pull/40731
4471 [40734]: https://github.com/rust-lang/rust/pull/40734
4472 [40805]: https://github.com/rust-lang/rust/pull/40805
4473 [40807]: https://github.com/rust-lang/rust/pull/40807
4474 [40828]: https://github.com/rust-lang/rust/pull/40828
4475 [40870]: https://github.com/rust-lang/rust/pull/40870
4476 [41085]: https://github.com/rust-lang/rust/pull/41085
4477 [41143]: https://github.com/rust-lang/rust/pull/41143
4478 [41168]: https://github.com/rust-lang/rust/pull/41168
4479 [41270]: https://github.com/rust-lang/rust/issues/41270
4480 [41469]: https://github.com/rust-lang/rust/pull/41469
4481 [41805]: https://github.com/rust-lang/rust/issues/41805
4482 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4483 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4484 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4485 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4486 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4487 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4488 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4489 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4490 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4491 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4492 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4493 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4494 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4495 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4496
4497
4498 Version 1.17.0 (2017-04-27)
4499 ===========================
4500
4501 Language
4502 --------
4503
4504 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4505 * [Fields of structs may be initialized without duplicating the field/variable
4506   names][39761]. [RFC 1682]
4507 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4508 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4509   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4510   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
4511   `'b`. Soundness fix.
4512 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
4513 * [Static variables may contain references to other statics][40027]
4514
4515 Compiler
4516 --------
4517
4518 * [Exit quickly on only `--emit dep-info`][40336]
4519 * [Make `-C relocation-model` more correctly determine whether the linker
4520   creates a position-independent executable][40245]
4521 * [Add `-C overflow-checks` to directly control whether integer overflow
4522   panics][40037]
4523 * [The rustc type checker now checks items on demand instead of in a single
4524   in-order pass][40008]. This is mostly an internal refactoring in support of
4525   future work, including incremental type checking, but also resolves [RFC
4526   1647], allowing `Self` to appear in `impl` `where` clauses.
4527 * [Optimize vtable loads][39995]
4528 * [Turn off vectorization for Emscripten targets][39990]
4529 * [Provide suggestions for unknown macros imported with `use`][39953]
4530 * [Fix ICEs in path resolution][39939]
4531 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
4532 * [Add clearer error message using `&str + &str`][39116]
4533
4534 Stabilized APIs
4535 ---------------
4536
4537 * [`Arc::into_raw`]
4538 * [`Arc::from_raw`]
4539 * [`Arc::ptr_eq`]
4540 * [`Rc::into_raw`]
4541 * [`Rc::from_raw`]
4542 * [`Rc::ptr_eq`]
4543 * [`Ordering::then`]
4544 * [`Ordering::then_with`]
4545 * [`BTreeMap::range`]
4546 * [`BTreeMap::range_mut`]
4547 * [`collections::Bound`]
4548 * [`process::abort`]
4549 * [`ptr::read_unaligned`]
4550 * [`ptr::write_unaligned`]
4551 * [`Result::expect_err`]
4552 * [`Cell::swap`]
4553 * [`Cell::replace`]
4554 * [`Cell::into_inner`]
4555 * [`Cell::take`]
4556
4557 Libraries
4558 ---------
4559
4560 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4561 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4562 * [`String` implements `FromIterator<&char>`][40028]
4563 * `Box` [implements][40009] a number of new conversions:
4564   `From<Box<str>> for String`,
4565   `From<Box<[T]>> for Vec<T>`,
4566   `From<Box<CStr>> for CString`,
4567   `From<Box<OsStr>> for OsString`,
4568   `From<Box<Path>> for PathBuf`,
4569   `Into<Box<str>> for String`,
4570   `Into<Box<[T]>> for Vec<T>`,
4571   `Into<Box<CStr>> for CString`,
4572   `Into<Box<OsStr>> for OsString`,
4573   `Into<Box<Path>> for PathBuf`,
4574   `Default for Box<str>`,
4575   `Default for Box<CStr>`,
4576   `Default for Box<OsStr>`,
4577   `From<&CStr> for Box<CStr>`,
4578   `From<&OsStr> for Box<OsStr>`,
4579   `From<&Path> for Box<Path>`
4580 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4581 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4582 * [Slightly optimize `slice::sort`][39538]
4583 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4584 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4585   `Box<str>` implements `From<&str>`][39438]
4586 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4587   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4588 * [`format!` estimates the needed capacity before writing a string][39356]
4589 * [Support unprivileged symlink creation in Windows][38921]
4590 * [`PathBuf` implements `Default`][38764]
4591 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4592 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4593   and poor hash functions.
4594
4595 Cargo
4596 -----
4597
4598 * [Add `cargo check --all`][cargo/3731]
4599 * [Add an option to ignore SSL revocation checking][cargo/3699]
4600 * [Add `cargo run --package`][cargo/3691]
4601 * [Add `required_features`][cargo/3667]
4602 * [Assume `build.rs` is a build script][cargo/3664]
4603 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4604
4605 Misc
4606 ----
4607
4608 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4609   `rustbook`][39633]
4610 * [The "Unstable Book" documents nightly-only features][ubook]
4611 * [Improve the style of the sidebar in rustdoc output][40265]
4612 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4613 * [Fix MSP430 breakage due to `i128`][40257]
4614 * [Preliminary Solaris/SPARCv9 support][39903]
4615 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4616   run without installing the MSVC runtime.
4617 * [`rustdoc --test` includes file names in test names][39788]
4618 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4619   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4620 * [Initial support for `aarch64-unknown-freebsd`][39491]
4621 * [Initial support for `i686-unknown-netbsd`][39426]
4622 * [This release no longer includes the old makefile build system][39431]. Rust
4623   is built with a custom build system, written in Rust, and with Cargo.
4624 * [Add Debug implementations for libcollection structs][39002]
4625 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4626 * [`--test-threads=0` produces an error][38945]
4627 * [`rustup` installs documentation by default][40526]
4628 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4629   WinDbg and Visual Studio to improve the debugging experience.
4630
4631 Compatibility Notes
4632 -------------------
4633
4634 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4635   workaround, either use MSVC 2015 or run vcvars.bat.
4636 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4637   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4638   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4639   fix.
4640 * [`format!` and `Display::to_string` panic if an underlying formatting
4641   implementation returns an error][40117]. Previously the error was silently
4642   ignored. It is incorrect for `write_fmt` to return an error when writing
4643   to a string.
4644 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4645   crates were marked stable and could be accessed from the stable toolchain.
4646 * [Rust git source no longer includes vendored crates][39728]. Those that need
4647   to build with vendored crates should build from release tarballs.
4648 * [Fix inert attributes from `proc_macro_derives`][39572]
4649 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4650   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4651   build system.
4652 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4653   existing code generally ignores the type of dead-code unless a type-hint is
4654   provided; this can cause surprising inference interactions particularly around
4655   defaulting. The new code uniformly ignores the result type of dead-code.
4656 * [Tuple-struct constructors with private fields are no longer visible][38932]
4657 * [Lifetime parameters that do not appear in the arguments are now considered
4658   early-bound][38897], resolving a soundness bug (#[32330]). The
4659   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4660   April of 2016.
4661 * [rustdoc: fix doctests with non-feature crate attributes][38161]
4662 * [Make transmuting from fn item types to pointer-sized types a hard
4663   error][34198]
4664
4665 [27787]: https://github.com/rust-lang/rust/issues/27787
4666 [32330]: https://github.com/rust-lang/rust/issues/32330
4667 [34198]: https://github.com/rust-lang/rust/pull/34198
4668 [38161]: https://github.com/rust-lang/rust/pull/38161
4669 [38368]: https://github.com/rust-lang/rust/pull/38368
4670 [38584]: https://github.com/rust-lang/rust/issues/38584
4671 [38661]: https://github.com/rust-lang/rust/pull/38661
4672 [38764]: https://github.com/rust-lang/rust/pull/38764
4673 [38864]: https://github.com/rust-lang/rust/issues/38864
4674 [38897]: https://github.com/rust-lang/rust/pull/38897
4675 [38921]: https://github.com/rust-lang/rust/pull/38921
4676 [38932]: https://github.com/rust-lang/rust/pull/38932
4677 [38945]: https://github.com/rust-lang/rust/pull/38945
4678 [38981]: https://github.com/rust-lang/rust/pull/38981
4679 [39002]: https://github.com/rust-lang/rust/pull/39002
4680 [39116]: https://github.com/rust-lang/rust/pull/39116
4681 [39193]: https://github.com/rust-lang/rust/pull/39193
4682 [39265]: https://github.com/rust-lang/rust/pull/39265
4683 [39356]: https://github.com/rust-lang/rust/pull/39356
4684 [39372]: https://github.com/rust-lang/rust/pull/39372
4685 [39426]: https://github.com/rust-lang/rust/pull/39426
4686 [39431]: https://github.com/rust-lang/rust/pull/39431
4687 [39438]: https://github.com/rust-lang/rust/pull/39438
4688 [39440]: https://github.com/rust-lang/rust/pull/39440
4689 [39485]: https://github.com/rust-lang/rust/pull/39485
4690 [39491]: https://github.com/rust-lang/rust/pull/39491
4691 [39518]: https://github.com/rust-lang/rust/pull/39518
4692 [39538]: https://github.com/rust-lang/rust/pull/39538
4693 [39572]: https://github.com/rust-lang/rust/pull/39572
4694 [39633]: https://github.com/rust-lang/rust/pull/39633
4695 [39642]: https://github.com/rust-lang/rust/pull/39642
4696 [39728]: https://github.com/rust-lang/rust/pull/39728
4697 [39761]: https://github.com/rust-lang/rust/pull/39761
4698 [39788]: https://github.com/rust-lang/rust/pull/39788
4699 [39793]: https://github.com/rust-lang/rust/pull/39793
4700 [39837]: https://github.com/rust-lang/rust/pull/39837
4701 [39843]: https://github.com/rust-lang/rust/pull/39843
4702 [39851]: https://github.com/rust-lang/rust/pull/39851
4703 [39903]: https://github.com/rust-lang/rust/pull/39903
4704 [39939]: https://github.com/rust-lang/rust/pull/39939
4705 [39953]: https://github.com/rust-lang/rust/pull/39953
4706 [39960]: https://github.com/rust-lang/rust/pull/39960
4707 [39990]: https://github.com/rust-lang/rust/pull/39990
4708 [39995]: https://github.com/rust-lang/rust/pull/39995
4709 [40008]: https://github.com/rust-lang/rust/pull/40008
4710 [40009]: https://github.com/rust-lang/rust/pull/40009
4711 [40027]: https://github.com/rust-lang/rust/pull/40027
4712 [40028]: https://github.com/rust-lang/rust/pull/40028
4713 [40037]: https://github.com/rust-lang/rust/pull/40037
4714 [40117]: https://github.com/rust-lang/rust/pull/40117
4715 [40166]: https://github.com/rust-lang/rust/pull/40166
4716 [40245]: https://github.com/rust-lang/rust/pull/40245
4717 [40257]: https://github.com/rust-lang/rust/pull/40257
4718 [40261]: https://github.com/rust-lang/rust/pull/40261
4719 [40265]: https://github.com/rust-lang/rust/pull/40265
4720 [40319]: https://github.com/rust-lang/rust/pull/40319
4721 [40336]: https://github.com/rust-lang/rust/pull/40336
4722 [40526]: https://github.com/rust-lang/rust/pull/40526
4723 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4724 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4725 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4726 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4727 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4728 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4729 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4730 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4731 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4732 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4733 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4734 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4735 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4736 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4737 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4738 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4739 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4740 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4741 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4742 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4743 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4744 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4745 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4746 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4747 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4748 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4749 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4750 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4751 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4752 [mdbook]: https://crates.io/crates/mdbook
4753 [ubook]: https://doc.rust-lang.org/unstable-book/
4754
4755
4756 Version 1.16.0 (2017-03-16)
4757 ===========================
4758
4759 Language
4760 --------
4761
4762 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4763 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4764   match patterns][38069]
4765 * [Clean up semantics of `self` in an import list][38313]
4766 * [`Self` may appear in `impl` headers][38920]
4767 * [`Self` may appear in struct expressions][39282]
4768
4769 Compiler
4770 --------
4771
4772 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4773   a `.rmeta` file containing only crate metadata][38571]. This can be
4774   used by tools like the Rust Language Service to perform
4775   metadata-only builds.
4776 * [Levenshtein based typo suggestions now work in most places, while
4777   previously they worked only for fields and sometimes for local
4778   variables][38927]. Together with the overhaul of "no
4779   resolution"/"unexpected resolution" errors (#[38154]) they result in
4780   large and systematic improvement in resolution diagnostics.
4781 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4782   `U`][38670]
4783 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4784 * [`rustc` no longer attempts to provide "consider using an explicit
4785   lifetime" suggestions][37057]. They were inaccurate.
4786
4787 Stabilized APIs
4788 ---------------
4789
4790 * [`VecDeque::truncate`]
4791 * [`VecDeque::resize`]
4792 * [`String::insert_str`]
4793 * [`Duration::checked_add`]
4794 * [`Duration::checked_sub`]
4795 * [`Duration::checked_div`]
4796 * [`Duration::checked_mul`]
4797 * [`str::replacen`]
4798 * [`str::repeat`]
4799 * [`SocketAddr::is_ipv4`]
4800 * [`SocketAddr::is_ipv6`]
4801 * [`IpAddr::is_ipv4`]
4802 * [`IpAddr::is_ipv6`]
4803 * [`Vec::dedup_by`]
4804 * [`Vec::dedup_by_key`]
4805 * [`Result::unwrap_or_default`]
4806 * [`<*const T>::wrapping_offset`]
4807 * [`<*mut T>::wrapping_offset`]
4808 * `CommandExt::creation_flags`
4809 * [`File::set_permissions`]
4810 * [`String::split_off`]
4811
4812 Libraries
4813 ---------
4814
4815 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4816   their argument by `Borrow` parameter][37761]
4817 * [All public types in std implement `Debug`][38006]
4818 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4819 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4820 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4821   Windows][38274]
4822 * [std: Fix partial writes in `LineWriter`][38062]
4823 * [std: Clamp max read/write sizes on Unix][38062]
4824 * [Use more specific panic message for `&str` slicing errors][38066]
4825 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4826   functionality cannot be achieved in std currently.
4827 * [`writeln!`, like `println!`, now accepts a form with no string
4828   or formatting arguments, to just print a newline][38469]
4829 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4830 * [Reduce the size of static data in `std_unicode::tables`][38781]
4831 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4832   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4833   `Display`][38909]
4834 * [`Duration` implements `Sum`][38712]
4835 * [`String` implements `ToSocketAddrs`][39048]
4836
4837 Cargo
4838 -----
4839
4840 * [The `cargo check` command does a type check of a project without
4841   building it][cargo/3296]
4842 * [crates.io will display CI badges from Travis and AppVeyor, if
4843   specified in Cargo.toml][cargo/3546]
4844 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4845 * [Compilation profiles accept integer values for `debug`, in addition
4846   to `true` and `false`. These are passed to `rustc` as the value to
4847   `-C debuginfo`][cargo/3534]
4848 * [Implement `cargo --version --verbose`][cargo/3604]
4849 * [All builds now output 'dep-info' build dependencies compatible with
4850   make and ninja][cargo/3557]
4851 * [Build all workspace members with `build --all`][cargo/3511]
4852 * [Document all workspace members with `doc --all`][cargo/3515]
4853 * [Path deps outside workspace are not members][cargo/3443]
4854
4855 Misc
4856 ----
4857
4858 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4859   the path to the Rust implementation][38589]
4860 * [The `armv7-linux-androideabi` target no longer enables NEON
4861   extensions, per Google's ABI guide][38413]
4862 * [The stock standard library can be compiled for Redox OS][38401]
4863 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4864   available.
4865 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4866   builds available.
4867 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4868
4869 Compatibility Notes
4870 -------------------
4871
4872 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4873   match patterns][38069]
4874 * In this release, references to uninhabited types can not be
4875   pattern-matched. This was accidentally allowed in 1.15.
4876 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4877 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4878   Windows][38274]
4879 * [Clean up semantics of `self` in an import list][38313]
4880 * Reimplemented lifetime elision. This change was almost entirely compatible
4881   with existing code, but it did close a number of small bugs and loopholes,
4882   as well as being more accepting in some other [cases][41105].
4883
4884 [37057]: https://github.com/rust-lang/rust/pull/37057
4885 [37761]: https://github.com/rust-lang/rust/pull/37761
4886 [38006]: https://github.com/rust-lang/rust/pull/38006
4887 [38051]: https://github.com/rust-lang/rust/pull/38051
4888 [38062]: https://github.com/rust-lang/rust/pull/38062
4889 [38062]: https://github.com/rust-lang/rust/pull/38622
4890 [38066]: https://github.com/rust-lang/rust/pull/38066
4891 [38069]: https://github.com/rust-lang/rust/pull/38069
4892 [38131]: https://github.com/rust-lang/rust/pull/38131
4893 [38154]: https://github.com/rust-lang/rust/pull/38154
4894 [38274]: https://github.com/rust-lang/rust/pull/38274
4895 [38304]: https://github.com/rust-lang/rust/pull/38304
4896 [38313]: https://github.com/rust-lang/rust/pull/38313
4897 [38314]: https://github.com/rust-lang/rust/pull/38314
4898 [38327]: https://github.com/rust-lang/rust/pull/38327
4899 [38401]: https://github.com/rust-lang/rust/pull/38401
4900 [38413]: https://github.com/rust-lang/rust/pull/38413
4901 [38469]: https://github.com/rust-lang/rust/pull/38469
4902 [38559]: https://github.com/rust-lang/rust/pull/38559
4903 [38571]: https://github.com/rust-lang/rust/pull/38571
4904 [38580]: https://github.com/rust-lang/rust/pull/38580
4905 [38589]: https://github.com/rust-lang/rust/pull/38589
4906 [38670]: https://github.com/rust-lang/rust/pull/38670
4907 [38712]: https://github.com/rust-lang/rust/pull/38712
4908 [38726]: https://github.com/rust-lang/rust/pull/38726
4909 [38781]: https://github.com/rust-lang/rust/pull/38781
4910 [38798]: https://github.com/rust-lang/rust/pull/38798
4911 [38909]: https://github.com/rust-lang/rust/pull/38909
4912 [38920]: https://github.com/rust-lang/rust/pull/38920
4913 [38927]: https://github.com/rust-lang/rust/pull/38927
4914 [39048]: https://github.com/rust-lang/rust/pull/39048
4915 [39282]: https://github.com/rust-lang/rust/pull/39282
4916 [39379]: https://github.com/rust-lang/rust/pull/39379
4917 [41105]: https://github.com/rust-lang/rust/issues/41105
4918 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4919 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4920 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4921 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4922 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4923 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4924 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4925 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4926 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4927 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4928 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4929 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4930 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4931 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4932 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4933 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4934 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4935 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4936 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4937 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4938 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4939 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4940 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4941 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4942 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4943 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4944 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4945 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4946 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4947 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4948
4949
4950 Version 1.15.1 (2017-02-09)
4951 ===========================
4952
4953 * [Fix IntoIter::as_mut_slice's signature][39466]
4954 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4955
4956 [39466]: https://github.com/rust-lang/rust/pull/39466
4957 [39523]: https://github.com/rust-lang/rust/pull/39523
4958
4959
4960 Version 1.15.0 (2017-02-02)
4961 ===========================
4962
4963 Language
4964 --------
4965
4966 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4967   stable. This allows popular code-generating crates like Serde and Diesel to
4968   work ergonomically. [RFC 1681].
4969 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4970   with curly braces][36868]. Part of [RFC 1506].
4971 * [A number of minor changes to name resolution have been activated][37127].
4972   They add up to more consistent semantics, allowing for future evolution of
4973   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4974   details of what is different. The breaking changes here have been transitioned
4975   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4976 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4977   bounds][38279]
4978 * [`?Sized` can be used in `where` clauses][37791]
4979 * [There is now a limit on the size of monomorphized types and it can be
4980   modified with the `#![type_size_limit]` crate attribute, similarly to
4981   the `#![recursion_limit]` attribute][37789]
4982
4983 Compiler
4984 --------
4985
4986 * [On Windows, the compiler will apply dllimport attributes when linking to
4987   extern functions][37973]. Additional attributes and flags can control which
4988   library kind is linked and its name. [RFC 1717].
4989 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4990 * [The `--test` flag works with procedural macro crates][38107]
4991 * [Fix `extern "aapcs" fn` ABI][37814]
4992 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4993 * [The `format!` expander recognizes incorrect `printf` and shell-style
4994   formatting directives and suggests the correct format][37613].
4995 * [Only report one error for all unused imports in an import list][37456]
4996
4997 Compiler Performance
4998 --------------------
4999
5000 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5001 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5002 * [Don't clone in `UnificationTable::probe`][37848]
5003 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5004 * [Use small vectors in type walker][37760]
5005 * [Macro expansion performance was improved][37701]
5006 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5007 * [Replace FNV with a faster hash function][37229]
5008
5009 Stabilized APIs
5010 ---------------
5011
5012 * [`std::iter::Iterator::min_by`]
5013 * [`std::iter::Iterator::max_by`]
5014 * [`std::os::*::fs::FileExt`]
5015 * [`std::sync::atomic::Atomic*::get_mut`]
5016 * [`std::sync::atomic::Atomic*::into_inner`]
5017 * [`std::vec::IntoIter::as_slice`]
5018 * [`std::vec::IntoIter::as_mut_slice`]
5019 * [`std::sync::mpsc::Receiver::try_iter`]
5020 * [`std::os::unix::process::CommandExt::before_exec`]
5021 * [`std::rc::Rc::strong_count`]
5022 * [`std::rc::Rc::weak_count`]
5023 * [`std::sync::Arc::strong_count`]
5024 * [`std::sync::Arc::weak_count`]
5025 * [`std::char::encode_utf8`]
5026 * [`std::char::encode_utf16`]
5027 * [`std::cell::Ref::clone`]
5028 * [`std::io::Take::into_inner`]
5029
5030 Libraries
5031 ---------
5032
5033 * [The standard sorting algorithm has been rewritten for dramatic performance
5034   improvements][38192]. It is a hybrid merge sort, drawing influences from
5035   Timsort. Previously it was a naive merge sort.
5036 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5037 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5038   performance.
5039 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
5040   and `char_indices().last()`][37882]
5041 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
5042 * [Chinese characters display correctly in `fmt::Debug`][37855]
5043 * [Derive `Default` for `Duration`][37699]
5044 * [Support creation of anonymous pipes on WinXP/2k][37677]
5045 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
5046 * [Don't pass overlapped handles to processes][38835]
5047
5048 Cargo
5049 -----
5050
5051 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5052   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5053   should instead check the variable at runtime with `std::env`. That the value
5054   was set at build time was a bug, and incorrect when cross-compiling. This
5055   change is known to cause breakage.
5056 * [Add `--all` flag to `cargo test`][cargo/3221]
5057 * [Compile statically against the MSVC CRT][cargo/3363]
5058 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5059 * [Link OpenSSL statically on OSX][cargo/3311]
5060 * [Apply new fingerprinting to build dir outputs][cargo/3310]
5061 * [Test for bad path overrides with summaries][cargo/3336]
5062 * [Require `cargo install --vers` to take a semver version][cargo/3338]
5063 * [Fix retrying crate downloads for network errors][cargo/3348]
5064 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
5065 * [Emit more info on --message-format=json][cargo/3319]
5066 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5067 * [Don't ignore errors in workspace manifest][cargo/3409]
5068 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5069
5070 Tooling
5071 -------
5072
5073 * [Test runners (binaries built with `--test`) now support a `--list` argument
5074   that lists the tests it contains][38185]
5075 * [Test runners now support a `--exact` argument that makes the test filter
5076   match exactly, instead of matching only a substring of the test name][38181]
5077 * [rustdoc supports a `--playground-url` flag][37763]
5078 * [rustdoc provides more details about `#[should_panic]` errors][37749]
5079
5080 Misc
5081 ----
5082
5083 * [The Rust build system is now written in Rust][37817]. The Makefiles may
5084   continue to be used in this release by passing `--disable-rustbuild` to the
5085   configure script, but they will be deleted soon. Note that the new build
5086   system uses a different on-disk layout that will likely affect any scripts
5087   building Rust.
5088 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5089   releases.
5090 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5091 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5092   releases.
5093
5094 Compatibility Notes
5095 -------------------
5096
5097 * [A number of minor changes to name resolution have been activated][37127].
5098   They add up to more consistent semantics, allowing for future evolution of
5099   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5100   details of what is different. The breaking changes here have been transitioned
5101   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5102 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5103   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5104   should instead check the variable at runtime with `std::env`. That the value
5105   was set at build time was a bug, and incorrect when cross-compiling. This
5106   change is known to cause breakage.
5107 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5108   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5109   1.10 and is now an error by default. It will become a hard error in the near
5110   future.
5111 * [The semantics relating modules to file system directories are changing in
5112   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5113   lint, which is a warning in this release, and will become a hard error in the
5114   future.
5115 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5116 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5117   the underlying iterator][37834]
5118
5119 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5120 [33685]: https://github.com/rust-lang/rust/issues/33685
5121 [36868]: https://github.com/rust-lang/rust/pull/36868
5122 [37127]: https://github.com/rust-lang/rust/pull/37127
5123 [37229]: https://github.com/rust-lang/rust/pull/37229
5124 [37456]: https://github.com/rust-lang/rust/pull/37456
5125 [37527]: https://github.com/rust-lang/rust/pull/37527
5126 [37602]: https://github.com/rust-lang/rust/pull/37602
5127 [37613]: https://github.com/rust-lang/rust/pull/37613
5128 [37615]: https://github.com/rust-lang/rust/pull/37615
5129 [37636]: https://github.com/rust-lang/rust/pull/37636
5130 [37627]: https://github.com/rust-lang/rust/pull/37627
5131 [37642]: https://github.com/rust-lang/rust/pull/37642
5132 [37677]: https://github.com/rust-lang/rust/pull/37677
5133 [37699]: https://github.com/rust-lang/rust/pull/37699
5134 [37701]: https://github.com/rust-lang/rust/pull/37701
5135 [37705]: https://github.com/rust-lang/rust/pull/37705
5136 [37749]: https://github.com/rust-lang/rust/pull/37749
5137 [37760]: https://github.com/rust-lang/rust/pull/37760
5138 [37763]: https://github.com/rust-lang/rust/pull/37763
5139 [37764]: https://github.com/rust-lang/rust/pull/37764
5140 [37789]: https://github.com/rust-lang/rust/pull/37789
5141 [37791]: https://github.com/rust-lang/rust/pull/37791
5142 [37814]: https://github.com/rust-lang/rust/pull/37814
5143 [37817]: https://github.com/rust-lang/rust/pull/37817
5144 [37834]: https://github.com/rust-lang/rust/pull/37834
5145 [37848]: https://github.com/rust-lang/rust/pull/37848
5146 [37855]: https://github.com/rust-lang/rust/pull/37855
5147 [37882]: https://github.com/rust-lang/rust/pull/37882
5148 [37888]: https://github.com/rust-lang/rust/pull/37888
5149 [37973]: https://github.com/rust-lang/rust/pull/37973
5150 [37979]: https://github.com/rust-lang/rust/pull/37979
5151 [38086]: https://github.com/rust-lang/rust/pull/38086
5152 [38107]: https://github.com/rust-lang/rust/pull/38107
5153 [38117]: https://github.com/rust-lang/rust/pull/38117
5154 [38134]: https://github.com/rust-lang/rust/pull/38134
5155 [38146]: https://github.com/rust-lang/rust/pull/38146
5156 [38181]: https://github.com/rust-lang/rust/pull/38181
5157 [38182]: https://github.com/rust-lang/rust/pull/38182
5158 [38185]: https://github.com/rust-lang/rust/pull/38185
5159 [38192]: https://github.com/rust-lang/rust/pull/38192
5160 [38279]: https://github.com/rust-lang/rust/pull/38279
5161 [38835]: https://github.com/rust-lang/rust/pull/38835
5162 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5163 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5164 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5165 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5166 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5167 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5168 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5169 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5170 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5171 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5172 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5173 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5174 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5175 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5176 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5177 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5178 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5179 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5180 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5181 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5182 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5183 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5184 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5185 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5186 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5187 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5188 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5189 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5190 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5191 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5192 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5193 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5194 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5195 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5196 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5197 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5198 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5199 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5200
5201
5202 Version 1.14.0 (2016-12-22)
5203 ===========================
5204
5205 Language
5206 --------
5207
5208 * [`..` matches multiple tuple fields in enum variants, structs
5209   and tuples][36843]. [RFC 1492].
5210 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5211 * [`use *` and `use ::*` both glob-import from the crate root][37367]
5212 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5213   dereferencing][36822]
5214
5215 Compiler
5216 --------
5217
5218 * [Mark enums with non-zero discriminant as non-zero][37224]
5219 * [Lower-case `static mut` names are linted like other
5220   statics and consts][37162]
5221 * [Fix ICE on some macros in const integer positions
5222    (e.g. `[u8; m!()]`)][36819]
5223 * [Improve error message and snippet for "did you mean `x`"][36798]
5224 * [Add a panic-strategy field to the target specification][36794]
5225 * [Include LLVM version in `--version --verbose`][37200]
5226
5227 Compile-time Optimizations
5228 --------------------------
5229
5230 * [Improve macro expansion performance][37569]
5231 * [Shrink `Expr_::ExprInlineAsm`][37445]
5232 * [Replace all uses of SHA-256 with BLAKE2b][37439]
5233 * [Reduce the number of bytes hashed by `IchHasher`][37427]
5234 * [Avoid more allocations when compiling html5ever][37373]
5235 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
5236 * [Avoid some allocations in the macro parser][37318]
5237 * [Use a faster deflate setting][37298]
5238 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5239   during interning of slices][37270]
5240 * [Optimize `write_metadata`][37267]
5241 * [Don't process obligation forest cycles when stalled][37231]
5242 * [Avoid many `CrateConfig` clones][37161]
5243 * [Optimize `Substs::super_fold_with`][37108]
5244 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
5245 * [Speed up `plug_leaks`][36917]
5246
5247 Libraries
5248 ---------
5249
5250 * [`println!()`, with no arguments, prints newline][36825].
5251   Previously, an empty string was required to achieve the same.
5252 * [`Wrapping` impls standard binary and unary operators, as well as
5253    the `Sum` and `Product` iterators][37356]
5254 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5255   Vec<T>`][37326]
5256 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
5257   `VecDeque` iterators][37315]
5258 * [Improve `SipHasher` performance on small values][37312]
5259 * [Add Iterator trait TrustedLen to enable better FromIterator /
5260   Extend][37306]
5261 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5262 * [`ReadDir` implements `Debug`][37221]
5263 * [Implement `RefUnwindSafe` for atomic types][37178]
5264 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5265 * [Avoid allocations in `Decoder::read_str`][37064]
5266 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5267 * [Impl `Debug` for raw pointers to unsized data][36880]
5268 * [Don't reuse `HashMap` random seeds][37470]
5269 * [The internal memory layout of `HashMap` is more cache-friendly, for
5270   significant improvements in some operations][36692]
5271 * [`HashMap` uses less memory on 32-bit architectures][36595]
5272 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5273
5274 Cargo
5275 -----
5276
5277 * [Expose rustc cfg values to build scripts][cargo/3243]
5278 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5279 * [Fix passing --features when testing multiple packages][cargo/3280]
5280 * [Use a single profile set per workspace][cargo/3249]
5281 * [Load `replace` sections from lock files][cargo/3220]
5282 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5283
5284 Tooling
5285 -------
5286
5287 * [rustup is the recommended Rust installation method][1.14rustup]
5288 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5289   S390x. These are [tier 2] platforms and may have major defects. Follow the
5290   instructions on the website to install, or add the targets to an existing
5291   installation with `rustup target add`. The new target triples are:
5292   - `mips-unknown-linux-gnu`
5293   - `mipsel-unknown-linux-gnu`
5294   - `mips64-unknown-linux-gnuabi64`
5295   - `mips64el-unknown-linux-gnuabi64 `
5296   - `powerpc-unknown-linux-gnu`
5297   - `powerpc64-unknown-linux-gnu`
5298   - `powerpc64le-unknown-linux-gnu`
5299   - `s390x-unknown-linux-gnu `
5300 * This release includes target (std) builds for ARM Linux running MUSL
5301   libc. These are [tier 2] platforms and may have major defects. Add the
5302   following triples to an existing rustup installation with `rustup target add`:
5303   - `arm-unknown-linux-musleabi`
5304   - `arm-unknown-linux-musleabihf`
5305   - `armv7-unknown-linux-musleabihf`
5306 * This release includes [experimental support for WebAssembly][1.14wasm], via
5307   the `wasm32-unknown-emscripten` target. This target is known to have major
5308   defects. Please test, report, and fix.
5309 * rustup no longer installs documentation by default. Run `rustup
5310   component add rust-docs` to install.
5311 * [Fix line stepping in debugger][37310]
5312 * [Enable line number debuginfo in releases][37280]
5313
5314 Misc
5315 ----
5316
5317 * [Disable jemalloc on aarch64/powerpc/mips][37392]
5318 * [Add support for Fuchsia OS][37313]
5319 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
5320
5321 Compatibility Notes
5322 -------------------
5323
5324 * [A number of forward-compatibility lints used by the compiler
5325   to gradually introduce language changes have been converted
5326   to deny by default][36894]:
5327   - ["use of inaccessible extern crate erroneously allowed"][36886]
5328   - ["type parameter default erroneously allowed in invalid location"][36887]
5329   - ["detects super or self keywords at the beginning of global path"][36888]
5330   - ["two overlapping inherent impls define an item with the same name
5331     were erroneously allowed"][36889]
5332   - ["floating-point constants cannot be used in patterns"][36890]
5333   - ["constants of struct or enum type can only be used in a pattern if
5334      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5335   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5336 * [Prohibit patterns in trait methods without bodies][37378]
5337 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
5338 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5339 * [The `$crate` macro variable is accepted in fewer locations][37213]
5340 * [Impls specifying extra region requirements beyond the trait
5341   they implement are rejected][37167]
5342 * [Enums may not be unsized][37111]. Unsized enums are intended to
5343   work but never have. For now they are forbidden.
5344 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5345
5346 [tier 2]: https://forge.rust-lang.org/platform-support.html
5347 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5348 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5349 [36430]: https://github.com/rust-lang/rust/pull/36430
5350 [36595]: https://github.com/rust-lang/rust/pull/36595
5351 [36595]: https://github.com/rust-lang/rust/pull/36595
5352 [36692]: https://github.com/rust-lang/rust/pull/36692
5353 [36767]: https://github.com/rust-lang/rust/pull/36767
5354 [36794]: https://github.com/rust-lang/rust/pull/36794
5355 [36798]: https://github.com/rust-lang/rust/pull/36798
5356 [36819]: https://github.com/rust-lang/rust/pull/36819
5357 [36822]: https://github.com/rust-lang/rust/pull/36822
5358 [36825]: https://github.com/rust-lang/rust/pull/36825
5359 [36843]: https://github.com/rust-lang/rust/pull/36843
5360 [36880]: https://github.com/rust-lang/rust/pull/36880
5361 [36886]: https://github.com/rust-lang/rust/issues/36886
5362 [36887]: https://github.com/rust-lang/rust/issues/36887
5363 [36888]: https://github.com/rust-lang/rust/issues/36888
5364 [36889]: https://github.com/rust-lang/rust/issues/36889
5365 [36890]: https://github.com/rust-lang/rust/issues/36890
5366 [36891]: https://github.com/rust-lang/rust/issues/36891
5367 [36892]: https://github.com/rust-lang/rust/issues/36892
5368 [36894]: https://github.com/rust-lang/rust/pull/36894
5369 [36917]: https://github.com/rust-lang/rust/pull/36917
5370 [36993]: https://github.com/rust-lang/rust/pull/36993
5371 [37037]: https://github.com/rust-lang/rust/pull/37037
5372 [37064]: https://github.com/rust-lang/rust/pull/37064
5373 [37094]: https://github.com/rust-lang/rust/pull/37094
5374 [37108]: https://github.com/rust-lang/rust/pull/37108
5375 [37111]: https://github.com/rust-lang/rust/pull/37111
5376 [37161]: https://github.com/rust-lang/rust/pull/37161
5377 [37162]: https://github.com/rust-lang/rust/pull/37162
5378 [37167]: https://github.com/rust-lang/rust/pull/37167
5379 [37178]: https://github.com/rust-lang/rust/pull/37178
5380 [37200]: https://github.com/rust-lang/rust/pull/37200
5381 [37213]: https://github.com/rust-lang/rust/pull/37213
5382 [37221]: https://github.com/rust-lang/rust/pull/37221
5383 [37224]: https://github.com/rust-lang/rust/pull/37224
5384 [37230]: https://github.com/rust-lang/rust/pull/37230
5385 [37231]: https://github.com/rust-lang/rust/pull/37231
5386 [37247]: https://github.com/rust-lang/rust/pull/37247
5387 [37267]: https://github.com/rust-lang/rust/pull/37267
5388 [37270]: https://github.com/rust-lang/rust/pull/37270
5389 [37273]: https://github.com/rust-lang/rust/pull/37273
5390 [37280]: https://github.com/rust-lang/rust/pull/37280
5391 [37298]: https://github.com/rust-lang/rust/pull/37298
5392 [37306]: https://github.com/rust-lang/rust/pull/37306
5393 [37310]: https://github.com/rust-lang/rust/pull/37310
5394 [37312]: https://github.com/rust-lang/rust/pull/37312
5395 [37313]: https://github.com/rust-lang/rust/pull/37313
5396 [37315]: https://github.com/rust-lang/rust/pull/37315
5397 [37318]: https://github.com/rust-lang/rust/pull/37318
5398 [37322]: https://github.com/rust-lang/rust/pull/37322
5399 [37326]: https://github.com/rust-lang/rust/pull/37326
5400 [37351]: https://github.com/rust-lang/rust/pull/37351
5401 [37356]: https://github.com/rust-lang/rust/pull/37356
5402 [37367]: https://github.com/rust-lang/rust/pull/37367
5403 [37373]: https://github.com/rust-lang/rust/pull/37373
5404 [37378]: https://github.com/rust-lang/rust/pull/37378
5405 [37389]: https://github.com/rust-lang/rust/pull/37389
5406 [37392]: https://github.com/rust-lang/rust/pull/37392
5407 [37427]: https://github.com/rust-lang/rust/pull/37427
5408 [37439]: https://github.com/rust-lang/rust/pull/37439
5409 [37445]: https://github.com/rust-lang/rust/pull/37445
5410 [37470]: https://github.com/rust-lang/rust/pull/37470
5411 [37569]: https://github.com/rust-lang/rust/pull/37569
5412 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5413 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5414 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5415 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5416 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5417 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5418 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5419
5420
5421 Version 1.13.0 (2016-11-10)
5422 ===========================
5423
5424 Language
5425 --------
5426
5427 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5428   errors, like the `try!` macro, described in [RFC 0243].
5429 * [Stabilize macros in type position][36014]. Described in [RFC 873].
5430 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5431 * [Fix `#[derive]` for empty tuple structs/variants][35728]
5432 * [Fix lifetime rules for 'if' conditions][36029]
5433 * [Avoid loading and parsing unconfigured non-inline modules][36482]
5434
5435 Compiler
5436 --------
5437
5438 * [Add the `-C link-arg` argument][36574]
5439 * [Remove the old AST-based backend from rustc_trans][35764]
5440 * [Don't enable NEON by default on armv7 Linux][35814]
5441 * [Fix debug line number info for macro expansions][35238]
5442 * [Do not emit "class method" debuginfo for types that are not
5443   DICompositeType][36008]
5444 * [Warn about multiple conflicting #[repr] hints][34623]
5445 * [When sizing DST, don't double-count nested struct prefixes][36351]
5446 * [Default RUST_MIN_STACK to 16MiB for now][36505]
5447 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5448 * [Reject macros with empty repetitions to avoid infinite loop][36721]
5449 * [Expand macros without recursing to avoid stack overflows][36214]
5450
5451 Diagnostics
5452 -----------
5453
5454 * [Replace macro backtraces with labeled local uses][35702]
5455 * [Improve error message for misplaced doc comments][33922]
5456 * [Buffer unix and lock windows to prevent message interleaving][35975]
5457 * [Update lifetime errors to specifically note temporaries][36171]
5458 * [Special case a few colors for Windows][36178]
5459 * [Suggest `use self` when such an import resolves][36289]
5460 * [Be more specific when type parameter shadows primitive type][36338]
5461 * Many minor improvements
5462
5463 Compile-time Optimizations
5464 --------------------------
5465
5466 * [Compute and cache HIR hashes at beginning][35854]
5467 * [Don't hash types in loan paths][36004]
5468 * [Cache projections in trans][35761]
5469 * [Optimize the parser's last token handling][36527]
5470 * [Only instantiate #[inline] functions in codegen units referencing
5471   them][36524]. This leads to big improvements in cases where crates export
5472   define many inline functions without using them directly.
5473 * [Lazily allocate TypedArena's first chunk][36592]
5474 * [Don't allocate during default HashSet creation][36734]
5475
5476 Stabilized APIs
5477 ---------------
5478
5479 * [`checked_abs`]
5480 * [`wrapping_abs`]
5481 * [`overflowing_abs`]
5482 * [`RefCell::try_borrow`]
5483 * [`RefCell::try_borrow_mut`]
5484
5485 Libraries
5486 ---------
5487
5488 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
5489 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5490   covariant][35354]
5491 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5492 * [Implement `Debug` for `std::vec::IntoIter`][35707]
5493 * [`CString`: avoid excessive growth just to 0-terminate][35871]
5494 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5495 * [Use arc4rand on FreeBSD][35884]
5496 * [memrchr: Correct aligned offset computation][35969]
5497 * [Improve Demangling of Rust Symbols][36059]
5498 * [Use monotonic time in condition variables][35048]
5499 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5500 * [Implement conversion traits for `char`][35755]
5501 * [Fix illegal instruction caused by overflow in channel cloning][36104]
5502 * [Zero first byte of CString on drop][36264]
5503 * [Inherit overflow checks for sum and product][36372]
5504 * [Add missing Eq implementations][36423]
5505 * [Implement `Debug` for `DirEntry`][36631]
5506 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5507   `errno`][36754]
5508 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5509 * [Implement more traits for `std::io::ErrorKind`][35911]
5510 * [Optimize BinaryHeap bounds checking][36072]
5511 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
5512   `extend_with_element`][36355]
5513 * [Fix overflow checking in unsigned pow()][34942]
5514
5515 Cargo
5516 -----
5517
5518 * This release includes security fixes to both curl and OpenSSL.
5519 * [Fix transitive doctests when panic=abort][cargo/3021]
5520 * [Add --all-features flag to cargo][cargo/3038]
5521 * [Reject path-based dependencies in `cargo package`][cargo/3060]
5522 * [Don't parse the home directory more than once][cargo/3078]
5523 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
5524 * [Update OpenSSL to 1.0.2j][cargo/3121]
5525 * [Add license and license_file to cargo metadata output][cargo/3110]
5526 * [Make crates-io registry URL optional in config; ignore all changes to
5527   source.crates-io][cargo/3089]
5528 * [Don't download dependencies from other platforms][cargo/3123]
5529 * [Build transitive dev-dependencies when needed][cargo/3125]
5530 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
5531 * [Avoid updating registry when adding existing deps][cargo/3144]
5532 * [Warn about path overrides that won't work][cargo/3136]
5533 * [Use workspaces during `cargo install`][cargo/3146]
5534 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
5535 * [Add --message-format flag][cargo/3000]
5536 * [Pass target environment for rustdoc][cargo/3205]
5537 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
5538 * [Update curl and curl-sys][cargo/3241]
5539 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
5540
5541 Tooling
5542 -------
5543
5544 * [rustdoc: Add the `--sysroot` argument][36586]
5545 * [rustdoc: Fix a couple of issues with the search results][35655]
5546 * [rustdoc: remove the `!` from macro URLs and titles][35234]
5547 * [gdb: Fix pretty-printing special-cased Rust types][35585]
5548 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5549
5550 Misc
5551 ----
5552
5553 * [Remove unmaintained style guide][35124]
5554 * [Add s390x support][36369]
5555 * [Initial work at Haiku OS support][36727]
5556 * [Add mips-uclibc targets][35734]
5557 * [Crate-ify compiler-rt into compiler-builtins][35021]
5558 * [Add rustc version info (git hash + date) to dist tarball][36213]
5559 * Many documentation improvements
5560
5561 Compatibility Notes
5562 -------------------
5563
5564 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5565 * [Deny (by default) transmuting from fn item types to pointer-sized
5566   types][34923]. Continuing the long transition to zero-sized fn items,
5567   per [RFC 401].
5568 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5569   Part of [RFC 1506].
5570 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5571 * [Fix lifetime rules for 'if' conditions][36029].
5572 * [Inherit overflow checks for sum and product][36372].
5573 * [Forbid user-defined macros named "macro_rules"][36730].
5574
5575 [33922]: https://github.com/rust-lang/rust/pull/33922
5576 [34623]: https://github.com/rust-lang/rust/pull/34623
5577 [34923]: https://github.com/rust-lang/rust/pull/34923
5578 [34942]: https://github.com/rust-lang/rust/pull/34942
5579 [34982]: https://github.com/rust-lang/rust/pull/34982
5580 [35021]: https://github.com/rust-lang/rust/pull/35021
5581 [35048]: https://github.com/rust-lang/rust/pull/35048
5582 [35074]: https://github.com/rust-lang/rust/pull/35074
5583 [35124]: https://github.com/rust-lang/rust/pull/35124
5584 [35234]: https://github.com/rust-lang/rust/pull/35234
5585 [35238]: https://github.com/rust-lang/rust/pull/35238
5586 [35354]: https://github.com/rust-lang/rust/pull/35354
5587 [35559]: https://github.com/rust-lang/rust/pull/35559
5588 [35585]: https://github.com/rust-lang/rust/pull/35585
5589 [35627]: https://github.com/rust-lang/rust/pull/35627
5590 [35655]: https://github.com/rust-lang/rust/pull/35655
5591 [35702]: https://github.com/rust-lang/rust/pull/35702
5592 [35707]: https://github.com/rust-lang/rust/pull/35707
5593 [35728]: https://github.com/rust-lang/rust/pull/35728
5594 [35734]: https://github.com/rust-lang/rust/pull/35734
5595 [35755]: https://github.com/rust-lang/rust/pull/35755
5596 [35761]: https://github.com/rust-lang/rust/pull/35761
5597 [35764]: https://github.com/rust-lang/rust/pull/35764
5598 [35814]: https://github.com/rust-lang/rust/pull/35814
5599 [35854]: https://github.com/rust-lang/rust/pull/35854
5600 [35871]: https://github.com/rust-lang/rust/pull/35871
5601 [35884]: https://github.com/rust-lang/rust/pull/35884
5602 [35911]: https://github.com/rust-lang/rust/pull/35911
5603 [35969]: https://github.com/rust-lang/rust/pull/35969
5604 [35975]: https://github.com/rust-lang/rust/pull/35975
5605 [36004]: https://github.com/rust-lang/rust/pull/36004
5606 [36008]: https://github.com/rust-lang/rust/pull/36008
5607 [36014]: https://github.com/rust-lang/rust/pull/36014
5608 [36029]: https://github.com/rust-lang/rust/pull/36029
5609 [36059]: https://github.com/rust-lang/rust/pull/36059
5610 [36072]: https://github.com/rust-lang/rust/pull/36072
5611 [36101]: https://github.com/rust-lang/rust/pull/36101
5612 [36104]: https://github.com/rust-lang/rust/pull/36104
5613 [36171]: https://github.com/rust-lang/rust/pull/36171
5614 [36173]: https://github.com/rust-lang/rust/pull/36173
5615 [36178]: https://github.com/rust-lang/rust/pull/36178
5616 [36213]: https://github.com/rust-lang/rust/pull/36213
5617 [36214]: https://github.com/rust-lang/rust/pull/36214
5618 [36264]: https://github.com/rust-lang/rust/pull/36264
5619 [36266]: https://github.com/rust-lang/rust/pull/36266
5620 [36289]: https://github.com/rust-lang/rust/pull/36289
5621 [36338]: https://github.com/rust-lang/rust/pull/36338
5622 [36351]: https://github.com/rust-lang/rust/pull/36351
5623 [36355]: https://github.com/rust-lang/rust/pull/36355
5624 [36369]: https://github.com/rust-lang/rust/pull/36369
5625 [36372]: https://github.com/rust-lang/rust/pull/36372
5626 [36423]: https://github.com/rust-lang/rust/pull/36423
5627 [36482]: https://github.com/rust-lang/rust/pull/36482
5628 [36505]: https://github.com/rust-lang/rust/pull/36505
5629 [36524]: https://github.com/rust-lang/rust/pull/36524
5630 [36527]: https://github.com/rust-lang/rust/pull/36527
5631 [36551]: https://github.com/rust-lang/rust/pull/36551
5632 [36574]: https://github.com/rust-lang/rust/pull/36574
5633 [36586]: https://github.com/rust-lang/rust/pull/36586
5634 [36592]: https://github.com/rust-lang/rust/pull/36592
5635 [36631]: https://github.com/rust-lang/rust/pull/36631
5636 [36639]: https://github.com/rust-lang/rust/pull/36639
5637 [36721]: https://github.com/rust-lang/rust/pull/36721
5638 [36727]: https://github.com/rust-lang/rust/pull/36727
5639 [36730]: https://github.com/rust-lang/rust/pull/36730
5640 [36734]: https://github.com/rust-lang/rust/pull/36734
5641 [36754]: https://github.com/rust-lang/rust/pull/36754
5642 [36995]: https://github.com/rust-lang/rust/pull/36995
5643 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5644 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5645 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5646 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5647 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5648 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5649 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5650 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5651 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5652 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5653 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5654 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5655 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5656 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5657 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5658 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5659 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5660 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5661 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5662 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5663 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5664 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5665 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5666 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5667 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5668 [rustup]: https://www.rustup.rs
5669 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5670 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5671 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5672 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5673 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5674 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5675 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5676
5677
5678 Version 1.12.1 (2016-10-20)
5679 ===========================
5680
5681 Regression Fixes
5682 ----------------
5683
5684 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5685 * [Confusion with double negation and booleans][36856]
5686 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5687 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5688 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
5689 * [Corrupted memory after updated to 1.12][36936]
5690 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5691 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5692 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5693
5694 [36381]: https://github.com/rust-lang/rust/issues/36381
5695 [36856]: https://github.com/rust-lang/rust/issues/36856
5696 [36875]: https://github.com/rust-lang/rust/issues/36875
5697 [36924]: https://github.com/rust-lang/rust/issues/36924
5698 [36926]: https://github.com/rust-lang/rust/issues/36926
5699 [36936]: https://github.com/rust-lang/rust/issues/36936
5700 [37026]: https://github.com/rust-lang/rust/issues/37026
5701 [37112]: https://github.com/rust-lang/rust/issues/37112
5702 [37153]: https://github.com/rust-lang/rust/issues/37153
5703
5704
5705 Version 1.12.0 (2016-09-29)
5706 ===========================
5707
5708 Highlights
5709 ----------
5710
5711 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5712   This translation pass is far simpler than the previous AST->LLVM pass, and
5713   creates opportunities to perform new optimizations directly on the MIR. It
5714   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5715 * [`rustc` presents a new, more readable error format, along with
5716   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5717   Most common editors supporting Rust have been updated to work with it. It was
5718   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5719
5720 Compiler
5721 --------
5722
5723 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5724   This translation pass is far simpler than the previous AST->LLVM pass, and
5725   creates opportunities to perform new optimizations directly on the MIR. It
5726   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5727 * [Print the Rust target name, not the LLVM target name, with
5728   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5729 * [The computation of `TypeId` is correct in some cases where it was previously
5730   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5731 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5732 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5733   `--print relocation-models`, and `--print code-models` print the available
5734   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5735   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5736 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5737   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5738   These targets produce statically-linked binaries. There are no binary release
5739   builds yet though.
5740
5741 Diagnostics
5742 -----------
5743
5744 * [`rustc` presents a new, more readable error format, along with
5745   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5746   Most common editors supporting Rust have been updated to work with it. It was
5747   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5748 * [In error descriptions, references are now described in plain English,
5749   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5750 * [In error type descriptions, unknown numeric types are named `{integer}` or
5751   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5752 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5753
5754 Language
5755 --------
5756
5757 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5758 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5759 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5760   useful](https://github.com/rust-lang/rust/pull/34908)
5761 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5762   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5763 * [Semicolons are properly required as statement delimiters inside
5764   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5765 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5766
5767 Stabilized APIs
5768 ---------------
5769
5770 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5771 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5772 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5773 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5774 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5775 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5776 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5777 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5778 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5779 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5780   Both on Unix and Windows.
5781 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5782 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5783 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5784 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5785 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5786 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5787 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5788 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5789
5790 Libraries
5791 ---------
5792
5793 * [The `format!` macro and friends now allow a single argument to be formatted
5794   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5795 * [The lifetime bounds on `[T]::binary_search_by` and
5796   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5797 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5798 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5799 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5800 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5801 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5802 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5803 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5804 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5805   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5806 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5807   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5808 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5809 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5810   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5811 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5812 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5813 * [`mpsc::sync_channel` `Receiver`s return any available message before
5814   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5815 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5816 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5817
5818 Cargo
5819 -----
5820
5821 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5822 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5823 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5824 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5825 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5826 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5827 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5828 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5829 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5830 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5831 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5832 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5833 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5834 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5835 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5836 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5837
5838 Performance
5839 -----------
5840
5841 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5842 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5843
5844 Tooling
5845 -------
5846
5847 * [Test binaries now support a `--test-threads` argument to specify the number
5848   of threads used to run tests, and which acts the same as the
5849   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5850 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5851 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5852 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5853 * [Rust releases now come with source packages that can be installed by rustup
5854   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5855   The resulting source code can be used by tools and IDES, located in the
5856   sysroot under `lib/rustlib/src`.
5857
5858 Misc
5859 ----
5860
5861 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5862 * Many minor improvements to the documentation.
5863 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5864
5865 Compatibility Notes
5866 -------------------
5867
5868 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5869   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5870 * [When formatting strings, if "precision" is specified, the "fill",
5871   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5872 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5873
5874
5875 Version 1.11.0 (2016-08-18)
5876 ===========================
5877
5878 Language
5879 --------
5880
5881 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5882 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5883 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5884 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5885
5886 Stabilized APIs
5887 ---------------
5888
5889 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5890 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5891 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5892 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5893 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5894 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5895   (in libcore - previously stabilized in libstd)
5896 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5897   (in libcore - previously stabilized in libstd)
5898 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5899   (in libcore - previously stabilized in libstd)
5900 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5901   (in libcore - previously stabilized in libstd)
5902 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5903 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5904 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5905 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5906
5907 Libraries
5908 ---------
5909
5910 * [The `thread_local!` macro supports multiple definitions in a single
5911    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5912 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5913 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5914   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5915 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5916 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5917 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5918 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5919
5920 Cargo
5921 -----
5922
5923 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5924 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5925 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5926 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5927 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5928   and `-vv` prints warnings for all crates.
5929 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5930 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5931   This provides room for expansion by arbitrary tools.
5932 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5933 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5934 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5935 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5936 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5937 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5938 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5939
5940 Performance
5941 -----------
5942
5943 * [Caching projections speeds up type check dramatically for some
5944   workloads](https://github.com/rust-lang/rust/pull/33816)
5945 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5946   This hasher is faster, but is believed to provide sufficient
5947   protection from collision attacks.
5948 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5949
5950 Rustdoc
5951 -------
5952
5953 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5954 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5955 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5956 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5957 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5958
5959 Tooling
5960 -------
5961
5962 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5963 * [When emitting debug info, rustc emits frame pointers for closures,
5964   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5965 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5966 * Many more errors have been given error codes and extended
5967   explanations
5968 * API documentation continues to be improved, with many new examples
5969
5970 Misc
5971 ----
5972
5973 * [rustc no longer hangs when dependencies recursively re-export
5974   submodules](https://github.com/rust-lang/rust/pull/34542)
5975 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5976 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5977   rewritten](https://github.com/rust-lang/rust/pull/33895)
5978 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5979   No targets use this yet, but it works toward AVR support.
5980
5981 Compatibility Notes
5982 -------------------
5983
5984 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5985 * [The new follow-set rules that place restrictions on `macro_rules!`
5986   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5987   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5988   and has been a warning since 1.10.
5989 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5990   This causes breakage in some corner cases.
5991
5992
5993 Version 1.10.0 (2016-07-07)
5994 ===========================
5995
5996 Language
5997 --------
5998
5999 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6000   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6001 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6002 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6003 * [`panic!` can be converted to a runtime abort with the
6004   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6005   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6006 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6007   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6008   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6009   Note that Cargo does not yet directly support cdylibs.
6010
6011 Stabilized APIs
6012 ---------------
6013
6014 * `os::windows::fs::OpenOptionsExt::access_mode`
6015 * `os::windows::fs::OpenOptionsExt::share_mode`
6016 * `os::windows::fs::OpenOptionsExt::custom_flags`
6017 * `os::windows::fs::OpenOptionsExt::attributes`
6018 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6019 * `os::unix::fs::OpenOptionsExt::custom_flags`
6020 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6021 * `Default for sync::Weak`
6022 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6023 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6024 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6025 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6026 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6027 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6028 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6029 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6030 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6031 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6032 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6033 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6034 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6035 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6036 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6037 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6038 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6039 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
6040 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6041 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6042 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6043 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6044 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6045 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6046 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6047 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6048 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6049 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6050 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6051 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6052 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6053 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
6054 * Read/Write/RawFd impls for `UnixStream`
6055 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6056 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6057 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6058 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6059 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6060 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6061 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
6062 * RawFd impls for `UnixListener`
6063 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6064 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6065 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6066 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6067 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6068 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6069 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6070 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6071 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6072 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6073 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6074 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6075 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6076 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6077 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6078 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6079 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6080 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
6081 * RawFd impls for `UnixDatagram`
6082 * `{BTree,Hash}Map::values_mut`
6083 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
6084
6085 Libraries
6086 ---------
6087
6088 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
6089   The semantics of this minor method are subtle and probably not what
6090   most people want.
6091 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
6092 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6093   will fall back to `/dev/urandom` temporarily to avoid blocking
6094   during early boot](https://github.com/rust-lang/rust/pull/33086).
6095 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6096 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6097 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6098 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6099 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
6100 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
6101   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
6102
6103 Cargo
6104 -----
6105 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
6106   This controls the runtime behavior of the `panic!` macro
6107   and can be either "unwind" (the default), or "abort".
6108   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6109 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6110 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
6111 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
6112   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6113 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6114 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6115 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
6116   By default they are retried twice, which can be customized with the
6117   `net.retry` value in `.cargo/config`.
6118 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6119 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6120 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6121 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
6122   Makes it possible to install multiple crates in parallel.
6123 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6124 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6125 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6126 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6127 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6128 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
6129
6130 Performance
6131 -----------
6132
6133 * [rustc memory usage was reduced by refactoring the context used for
6134   type checking](https://github.com/rust-lang/rust/pull/33425).
6135 * [Speed up creation of `HashMap`s by caching the random keys used
6136   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6137 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6138 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6139 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6140   10x faster than the previous lookup tables.
6141 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6142
6143 Usability
6144 ---------
6145
6146 * Many incremental improvements to documentation and rustdoc.
6147 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6148 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6149 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6150 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6151 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6152 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6153 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6154
6155 Misc
6156 ----
6157
6158 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6159 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6160 * [`std` no longer prints backtraces on platforms where the running
6161   module must be loaded with `env::current_exe`, which can't be relied
6162   on](https://github.com/rust-lang/rust/pull/33554).
6163 * This release includes std binaries for the i586-unknown-linux-gnu,
6164   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6165   i586 target is for old x86 hardware without SSE2, and the armv7
6166   target is for Android running on modern ARM architectures.
6167 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6168   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6169 * [On Unix the runtime aborts by calling `libc::abort` instead of
6170   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
6171 * [Rust is now bootstrapped from the previous release of Rust,
6172   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
6173
6174 Compatibility Notes
6175 -------------------
6176
6177 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
6178 * [`target_env` for Linux ARM targets is just `gnu`, not
6179   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6180 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6181 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6182 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
6183   Affects how macros are parsed.
6184 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
6185 * [Feature-gated attributes on macro-generated macro invocations are
6186   now rejected](https://github.com/rust-lang/rust/pull/32791).
6187 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
6188   This caused some minor changes to type inference.
6189
6190
6191 Version 1.9.0 (2016-05-26)
6192 ==========================
6193
6194 Language
6195 --------
6196
6197 * The `#[deprecated]` attribute when applied to an API will generate
6198   warnings when used. The warnings may be suppressed with
6199   `#[allow(deprecated)]`. [RFC 1270].
6200 * [`fn` item types are zero sized, and each `fn` names a unique
6201   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6202   `transmute` on a `fn` type will generate a warning for a few cycles,
6203   then will be converted to an error.
6204 * [Field and method resolution understand visibility, so private
6205   fields and methods cannot prevent the proper use of public fields
6206   and methods][1.9fv].
6207 * [The parser considers unicode codepoints in the
6208   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6209
6210 Stabilized APIs
6211 ---------------
6212
6213 * [`std::panic`]
6214 * [`std::panic::catch_unwind`] (renamed from `recover`)
6215 * [`std::panic::resume_unwind`] (renamed from `propagate`)
6216 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6217 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
6218 * [`str::is_char_boundary`]
6219 * [`<*const T>::as_ref`]
6220 * [`<*mut T>::as_ref`]
6221 * [`<*mut T>::as_mut`]
6222 * [`AsciiExt::make_ascii_uppercase`]
6223 * [`AsciiExt::make_ascii_lowercase`]
6224 * [`char::decode_utf16`]
6225 * [`char::DecodeUtf16`]
6226 * [`char::DecodeUtf16Error`]
6227 * [`char::DecodeUtf16Error::unpaired_surrogate`]
6228 * [`BTreeSet::take`]
6229 * [`BTreeSet::replace`]
6230 * [`BTreeSet::get`]
6231 * [`HashSet::take`]
6232 * [`HashSet::replace`]
6233 * [`HashSet::get`]
6234 * [`OsString::with_capacity`]
6235 * [`OsString::clear`]
6236 * [`OsString::capacity`]
6237 * [`OsString::reserve`]
6238 * [`OsString::reserve_exact`]
6239 * [`OsStr::is_empty`]
6240 * [`OsStr::len`]
6241 * [`std::os::unix::thread`]
6242 * [`RawPthread`]
6243 * [`JoinHandleExt`]
6244 * [`JoinHandleExt::as_pthread_t`]
6245 * [`JoinHandleExt::into_pthread_t`]
6246 * [`HashSet::hasher`]
6247 * [`HashMap::hasher`]
6248 * [`CommandExt::exec`]
6249 * [`File::try_clone`]
6250 * [`SocketAddr::set_ip`]
6251 * [`SocketAddr::set_port`]
6252 * [`SocketAddrV4::set_ip`]
6253 * [`SocketAddrV4::set_port`]
6254 * [`SocketAddrV6::set_ip`]
6255 * [`SocketAddrV6::set_port`]
6256 * [`SocketAddrV6::set_flowinfo`]
6257 * [`SocketAddrV6::set_scope_id`]
6258 * [`slice::copy_from_slice`]
6259 * [`ptr::read_volatile`]
6260 * [`ptr::write_volatile`]
6261 * [`OpenOptions::create_new`]
6262 * [`TcpStream::set_nodelay`]
6263 * [`TcpStream::nodelay`]
6264 * [`TcpStream::set_ttl`]
6265 * [`TcpStream::ttl`]
6266 * [`TcpStream::set_only_v6`]
6267 * [`TcpStream::only_v6`]
6268 * [`TcpStream::take_error`]
6269 * [`TcpStream::set_nonblocking`]
6270 * [`TcpListener::set_ttl`]
6271 * [`TcpListener::ttl`]
6272 * [`TcpListener::set_only_v6`]
6273 * [`TcpListener::only_v6`]
6274 * [`TcpListener::take_error`]
6275 * [`TcpListener::set_nonblocking`]
6276 * [`UdpSocket::set_broadcast`]
6277 * [`UdpSocket::broadcast`]
6278 * [`UdpSocket::set_multicast_loop_v4`]
6279 * [`UdpSocket::multicast_loop_v4`]
6280 * [`UdpSocket::set_multicast_ttl_v4`]
6281 * [`UdpSocket::multicast_ttl_v4`]
6282 * [`UdpSocket::set_multicast_loop_v6`]
6283 * [`UdpSocket::multicast_loop_v6`]
6284 * [`UdpSocket::set_multicast_ttl_v6`]
6285 * [`UdpSocket::multicast_ttl_v6`]
6286 * [`UdpSocket::set_ttl`]
6287 * [`UdpSocket::ttl`]
6288 * [`UdpSocket::set_only_v6`]
6289 * [`UdpSocket::only_v6`]
6290 * [`UdpSocket::join_multicast_v4`]
6291 * [`UdpSocket::join_multicast_v6`]
6292 * [`UdpSocket::leave_multicast_v4`]
6293 * [`UdpSocket::leave_multicast_v6`]
6294 * [`UdpSocket::take_error`]
6295 * [`UdpSocket::connect`]
6296 * [`UdpSocket::send`]
6297 * [`UdpSocket::recv`]
6298 * [`UdpSocket::set_nonblocking`]
6299
6300 Libraries
6301 ---------
6302
6303 * [`std::sync::Once` is poisoned if its initialization function
6304   fails][1.9o].
6305 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6306 * [Most types implement `fmt::Debug`][1.9db].
6307 * [The default buffer size used by `BufReader` and `BufWriter` was
6308   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6309   used by other languages.
6310 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6311   `Duration` additionally implements `*=` and `/=`][1.9ta].
6312 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
6313 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6314 * [`Chain` implements `BufRead`][1.9ch].
6315 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6316
6317 Cargo
6318 -----
6319
6320 * [Cargo can now run concurrently][1.9cc].
6321 * [Top-level overrides allow specific revisions of crates to be
6322   overridden through the entire crate graph][1.9ct].  This is intended
6323   to make upgrades easier for large projects, by allowing crates to be
6324   forked temporarily until they've been upgraded and republished.
6325 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6326 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6327   on the commandline][1.9cf]. `rustc` arguments can also be specified
6328   in the `build.rustflags` configuration key.
6329
6330 Performance
6331 -----------
6332
6333 * [The time complexity of comparing variables for equivalence during type
6334   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6335   to major compilation time improvement in some scenarios.
6336 * [`ToString` is specialized for `str`, giving it the same performance
6337   as `to_owned`][1.9ts].
6338 * [Spawning processes with `Command::output` no longer creates extra
6339   threads][1.9sp].
6340 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6341   for C-like enums][1.9cl].
6342
6343 Misc
6344 ----
6345
6346 * [Passing the `--quiet` flag to a test runner will produce
6347   much-abbreviated output][1.9q].
6348 * The Rust Project now publishes std binaries for the
6349   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6350   `i586-pc-windows-msvc` targets.
6351
6352 Compatibility Notes
6353 -------------------
6354
6355 * [`std::sync::Once` is poisoned if its initialization function
6356   fails][1.9o].
6357 * [It is illegal to define methods with the same name in overlapping
6358   inherent `impl` blocks][1.9sn].
6359 * [`fn` item types are zero sized, and each `fn` names a unique
6360   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6361   `transmute` on a `fn` type will generate a warning for a few cycles,
6362   then will be converted to an error.
6363 * [Improvements to const evaluation may trigger new errors when integer
6364   literals are out of range][1.9ce].
6365
6366
6367 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
6368 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6369 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
6370 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6371 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
6372 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
6373 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6374 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6375 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
6376 [1.9db]: https://github.com/rust-lang/rust/pull/32054
6377 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
6378 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
6379 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
6380 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
6381 [1.9o]: https://github.com/rust-lang/rust/pull/32325
6382 [1.9q]: https://github.com/rust-lang/rust/pull/31887
6383 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
6384 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
6385 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
6386 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
6387 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
6388 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
6389 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
6390 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6391 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6392 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6393 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6394 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6395 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6396 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6397 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6398 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6399 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6400 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6401 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6402 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6403 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6404 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6405 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6406 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6407 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6408 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6409 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6410 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6411 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6412 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6413 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6414 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6415 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6416 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6417 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6418 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6419 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6420 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6421 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6422 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6423 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6424 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6425 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6426 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6427 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6428 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6429 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6430 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6431 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6432 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6433 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6434 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6435 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6436 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6437 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6438 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6439 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6440 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6441 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6442 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6443 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6444 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6445 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6446 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6447 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6448 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6449 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6450 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6451 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6452 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6453 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6454 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6455 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6456 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6457 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6458 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6459 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6460 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6461 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6462 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6463 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6464 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6465 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6466 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6467 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6468 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6469 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6470 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6471 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6472 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6473 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6474 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6475 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6476 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6477
6478
6479 Version 1.8.0 (2016-04-14)
6480 ==========================
6481
6482 Language
6483 --------
6484
6485 * Rust supports overloading of compound assignment statements like
6486   `+=` by implementing the [`AddAssign`], [`SubAssign`],
6487   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6488   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6489   traits. [RFC 953].
6490 * Empty structs can be defined with braces, as in `struct Foo { }`, in
6491   addition to the non-braced form, `struct Foo;`. [RFC 218].
6492
6493 Libraries
6494 ---------
6495
6496 * Stabilized APIs:
6497   * [`str::encode_utf16`] (renamed from `utf16_units`)
6498   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
6499   * [`Ref::map`]
6500   * [`RefMut::map`]
6501   * [`ptr::drop_in_place`]
6502   * [`time::Instant`]
6503   * [`time::SystemTime`]
6504   * [`Instant::now`]
6505   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
6506   * [`Instant::elapsed`]
6507   * [`SystemTime::now`]
6508   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
6509   * [`SystemTime::elapsed`]
6510   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
6511   * [`SystemTimeError`]
6512   * [`SystemTimeError::duration`]
6513   * Various impls for `SystemTimeError`
6514   * [`UNIX_EPOCH`]
6515   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
6516     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
6517     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
6518 * [The `write!` and `writeln!` macros correctly emit errors if any of
6519   their arguments can't be formatted][1.8w].
6520 * [Various I/O functions support large files on 32-bit Linux][1.8l].
6521 * [The Unix-specific `raw` modules, which contain a number of
6522   redefined C types are deprecated][1.8r], including `os::raw::unix`,
6523   `os::raw::macos`, and `os::raw::linux`. These modules defined types
6524   such as `ino_t` and `dev_t`. The inconsistency of these definitions
6525   across platforms was making it difficult to implement `std`
6526   correctly. Those that need these definitions should use the `libc`
6527   crate. [RFC 1415].
6528 * The Unix-specific `MetadataExt` traits, including
6529   `os::unix::fs::MetadataExt`, which expose values such as inode
6530   numbers [no longer return platform-specific types][1.8r], but
6531   instead return widened integers. [RFC 1415].
6532 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
6533 * [Atomic loads and stores are not volatile][1.8a].
6534 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
6535
6536 Performance
6537 -----------
6538
6539 * [Inlining hash functions lead to a 3% compile-time improvement in
6540   some workloads][1.8h].
6541 * When using jemalloc, its symbols are [unprefixed so that it
6542   overrides the libc malloc implementation][1.8h]. This means that for
6543   rustc, LLVM is now using jemalloc, which results in a 6%
6544   compile-time improvement on a specific workload.
6545 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
6546
6547 Misc
6548 ----
6549
6550 * [32-bit MSVC builds finally implement unwinding][1.8ms].
6551   i686-pc-windows-msvc is now considered a tier-1 platform.
6552 * [The `--print targets` flag prints a list of supported targets][1.8t].
6553 * [The `--print cfg` flag prints the `cfg`s defined for the current
6554   target][1.8cf].
6555 * [`rustc` can be built with an new Cargo-based build system, written
6556   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6557   build system. To enable it configure with `configure --rustbuild`.
6558 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6559   variants while also indicating the total number of missing variants
6560   if more than 3][1.8m].
6561 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6562 * The Rust Project now publishes binary releases of the standard
6563   library for a number of tier-2 targets:
6564   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6565   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6566   `x86_64-rumprun-netbsd`. These can be installed with
6567   tools such as [multirust][1.8mr].
6568
6569 Cargo
6570 -----
6571
6572 * [`cargo init` creates a new Cargo project in the current
6573   directory][1.8ci].  It is otherwise like `cargo new`.
6574 * [Cargo has configuration keys for `-v` and
6575   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6576   `[term]` section of `.cargo/config`.
6577 * [Configuration keys that evaluate to strings or integers can be set
6578   via environment variables][1.8ce]. For example the `build.jobs` key
6579   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6580   precedence over config files.
6581 * [Target-specific dependencies support Rust `cfg` syntax for
6582   describing targets][1.8cfg] so that dependencies for multiple
6583   targets can be specified together. [RFC 1361].
6584 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6585   `RUSTDOC` take precedence over the `build.target-dir`,
6586   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6587 * [The child process tree is killed on Windows when Cargo is
6588   killed][1.8ck].
6589 * [The `build.target` configuration value sets the target platform,
6590   like `--target`][1.8ct].
6591
6592 Compatibility Notes
6593 -------------------
6594
6595 * [Unstable compiler flags have been further restricted][1.8u]. Since
6596   1.0 `-Z` flags have been considered unstable, and other flags that
6597   were considered unstable additionally required passing `-Z
6598   unstable-options` to access. Unlike unstable language and library
6599   features though, these options have been accessible on the stable
6600   release channel. Going forward, *new unstable flags will not be
6601   available on the stable release channel*, and old unstable flags
6602   will warn about their usage. In the future, all unstable flags will
6603   be unavailable on the stable release channel.
6604 * [It is no longer possible to `match` on empty enum variants using
6605   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6606 * The Unix-specific `MetadataExt` traits, including
6607   `os::unix::fs::MetadataExt`, which expose values such as inode
6608   numbers [no longer return platform-specific types][1.8r], but
6609   instead return widened integers. [RFC 1415].
6610 * [Modules sourced from the filesystem cannot appear within arbitrary
6611   blocks, but only within other modules][1.8mf].
6612 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6613 * On Unix, [stack overflow triggers a runtime abort instead of a
6614   SIGSEGV][1.8so].
6615 * [`Command::spawn` and its equivalents return an error if any of
6616   its command-line arguments contain interior `NUL`s][1.8n].
6617 * [Tuple and unit enum variants from other crates are in the type
6618   namespace][1.8tn].
6619 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6620   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6621   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6622   instead of `foo.lib`.
6623
6624
6625 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6626 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6627 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6628 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6629 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6630 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6631 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6632 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6633 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6634 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6635 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6636 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6637 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6638 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6639 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6640 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6641 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6642 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6643 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6644 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6645 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6646 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6647 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6648 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6649 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6650 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6651 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6652 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6653 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6654 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6655 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6656 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6657 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6658 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6659 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6660 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6661 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6662 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6663 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6664 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6665 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6666 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6667 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6668 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6669 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6670 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6671 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6672 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6673 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6674 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6675 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6676 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6677 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6678 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6679 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6680 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6681 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6682 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6683 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6684 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6685
6686
6687 Version 1.7.0 (2016-03-03)
6688 ==========================
6689
6690 Libraries
6691 ---------
6692
6693 * Stabilized APIs
6694   * `Path`
6695     * [`Path::strip_prefix`] (renamed from relative_from)
6696     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
6697   * `Ipv4Addr`
6698     * [`Ipv4Addr::is_loopback`]
6699     * [`Ipv4Addr::is_private`]
6700     * [`Ipv4Addr::is_link_local`]
6701     * [`Ipv4Addr::is_multicast`]
6702     * [`Ipv4Addr::is_broadcast`]
6703     * [`Ipv4Addr::is_documentation`]
6704   * `Ipv6Addr`
6705     * [`Ipv6Addr::is_unspecified`]
6706     * [`Ipv6Addr::is_loopback`]
6707     * [`Ipv6Addr::is_multicast`]
6708   * `Vec`
6709     * [`Vec::as_slice`]
6710     * [`Vec::as_mut_slice`]
6711   * `String`
6712     * [`String::as_str`]
6713     * [`String::as_mut_str`]
6714   * Slices
6715     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6716     be the same length
6717     * `<[T]>::`[`sort_by_key`]
6718   * checked, saturated, and overflowing operations
6719     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6720     * [`i32::saturating_mul`]
6721     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6722     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6723     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6724     * [`u32::saturating_mul`]
6725     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6726     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6727     * and checked, saturated, and overflowing operations for other primitive types
6728   * FFI
6729     * [`ffi::IntoStringError`]
6730     * [`CString::into_string`]
6731     * [`CString::into_bytes`]
6732     * [`CString::into_bytes_with_nul`]
6733     * `From<CString> for Vec<u8>`
6734   * `IntoStringError`
6735     * [`IntoStringError::into_cstring`]
6736     * [`IntoStringError::utf8_error`]
6737     * `Error for IntoStringError`
6738   * Hashing
6739     * [`std::hash::BuildHasher`]
6740     * [`BuildHasher::Hasher`]
6741     * [`BuildHasher::build_hasher`]
6742     * [`std::hash::BuildHasherDefault`]
6743     * [`HashMap::with_hasher`]
6744     * [`HashMap::with_capacity_and_hasher`]
6745     * [`HashSet::with_hasher`]
6746     * [`HashSet::with_capacity_and_hasher`]
6747     * [`std::collections::hash_map::RandomState`]
6748     * [`RandomState::new`]
6749 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6750   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6751   from bytes is faster.
6752 * [The performance of `LineWriter` (and thus `io::stdout`) was
6753   improved by using `memchr` to search for newlines][1.7m].
6754 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6755   `f64` variants were stabilized previously.
6756 * [`BTreeMap` was rewritten to use less memory and improve the performance
6757   of insertion and iteration, the latter by as much as 5x][1.7bm].
6758 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6759   covariant over their contained type][1.7bt].
6760 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6761   over their contained type][1.7ll].
6762 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6763   searching methods.
6764 * [`Any` is implemented for unsized types][1.7a].
6765 * [`Hash` is implemented for `Duration`][1.7h].
6766
6767 Misc
6768 ----
6769
6770 * [When running tests with `--test`, rustdoc will pass `--cfg`
6771   arguments to the compiler][1.7dt].
6772 * [The compiler is built with RPATH information by default][1.7rpa].
6773   This means that it will be possible to run `rustc` when installed in
6774   unusual configurations without configuring the dynamic linker search
6775   path explicitly.
6776 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6777   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6778   over `LD_LIBRARY_PATH`.
6779
6780 Cargo
6781 -----
6782
6783 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6784   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6785 * [The `rerun-if-changed` build script directive no longer causes the
6786   build script to incorrectly run twice in certain scenarios][1.7rr].
6787
6788 Compatibility Notes
6789 -------------------
6790
6791 * Soundness fixes to the interactions between associated types and
6792   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6793   code that violates the new rules. This is a significant change that
6794   is known to break existing code, so it has emitted warnings for the
6795   new error cases since 1.4 to give crate authors time to adapt. The
6796   details of what is changing are subtle; read the RFC for more.
6797 * [Several bugs in the compiler's visibility calculations were
6798   fixed][1.7v]. Since this was found to break significant amounts of
6799   code, the new errors will be emitted as warnings for several release
6800   cycles, under the `private_in_public` lint.
6801 * Defaulted type parameters were accidentally accepted in positions
6802   that were not intended. In this release, [defaulted type parameters
6803   appearing outside of type definitions will generate a
6804   warning][1.7d], which will become an error in future releases.
6805 * [Parsing "." as a float results in an error instead of 0][1.7p].
6806   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6807 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6808
6809 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6810 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6811 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6812 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6813 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6814 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6815 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6816 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6817 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6818 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6819 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6820 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6821 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6822 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6823 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6824 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6825 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6826 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6827 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6828 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6829 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6830 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6831 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6832 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6833 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6834 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6835 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6836 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6837 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6838 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6839 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6840 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6841 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6842 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6843 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6844 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6845 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6846 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6847 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6848 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6849 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6850 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6851 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6852 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6853 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6854 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6855 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6856 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6857 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6858 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6859 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6860 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6861 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6862 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6863 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6864 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6865 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6866 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6867 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6868 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6869 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6870 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6871 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6872 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6873 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6874 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6875 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6876 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6877 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6878 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6879 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6880 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6881 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6882 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6883 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6884 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6885 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6886 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6887 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6888
6889
6890 Version 1.6.0 (2016-01-21)
6891 ==========================
6892
6893 Language
6894 --------
6895
6896 * The `#![no_std]` attribute causes a crate to not be linked to the
6897   standard library, but only the [core library][1.6co], as described
6898   in [RFC 1184]. The core library defines common types and traits but
6899   has no platform dependencies whatsoever, and is the basis for Rust
6900   software in environments that cannot support a full port of the
6901   standard library, such as operating systems. Most of the core
6902   library is now stable.
6903
6904 Libraries
6905 ---------
6906
6907 * Stabilized APIs:
6908   [`Read::read_exact`],
6909   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6910   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6911   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6912   [`os::unix::fs::DirBuilderExt`],
6913   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6914   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6915   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6916   [`collections::hash_map::Drain`],
6917   [`collections::hash_map::HashMap::drain`],
6918   [`collections::hash_set::Drain`],
6919   [`collections::hash_set::HashSet::drain`],
6920   [`collections::binary_heap::Drain`],
6921   [`collections::binary_heap::BinaryHeap::drain`],
6922   [`Vec::extend_from_slice`] (renamed from `push_all`),
6923   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6924   [`RwLock::into_inner`],
6925   [`Iterator::min_by_key`] (renamed from `min_by`),
6926   [`Iterator::max_by_key`] (renamed from `max_by`).
6927 * The [core library][1.6co] is stable, as are most of its APIs.
6928 * [The `assert_eq!` macro supports arguments that don't implement
6929   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6930   `assert!`.
6931 * Several timer functions that take duration in milliseconds [are
6932   deprecated in favor of those that take `Duration`][1.6ms]. These
6933   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6934   `thread::park_timeout_ms`.
6935 * The algorithm by which `Vec` reserves additional elements was
6936   [tweaked to not allocate excessive space][1.6a] while still growing
6937   exponentially.
6938 * `From` conversions are [implemented from integers to floats][1.6f]
6939   in cases where the conversion is lossless. Thus they are not
6940   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6941   or `f64`. They are also not implemented for `isize` and `usize`
6942   because the implementations would be platform-specific. `From` is
6943   also implemented from `f32` to `f64`.
6944 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6945 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6946 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6947 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6948   improvements.
6949 * Sorting slices that are already sorted [is 50% faster in some
6950   cases][1.6s].
6951
6952 Cargo
6953 -----
6954
6955 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6956 * Cargo build scripts can specify their dependencies by emitting the
6957   [`rerun-if-changed`][1.6rr] key.
6958 * crates.io will reject publication of crates with dependencies that
6959   have a wildcard version constraint. Crates with wildcard
6960   dependencies were seen to cause a variety of problems, as described
6961   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6962   warning.
6963 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6964   release folder.  A variety of artifacts that Cargo failed to clean
6965   are now correctly deleted.
6966
6967 Misc
6968 ----
6969
6970 * The `unreachable_code` lint [warns when a function call's argument
6971   diverges][1.6dv].
6972 * The parser indicates [failures that may be caused by
6973   confusingly-similar Unicode characters][1.6uc]
6974 * Certain macro errors [are reported at definition time][1.6m], not
6975   expansion.
6976
6977 Compatibility Notes
6978 -------------------
6979
6980 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6981   environment variable when locating crates. This was a pre-cargo
6982   feature for integrating with the package manager that was
6983   accidentally never removed.
6984 * [A number of bugs were fixed in the privacy checker][1.6p] that
6985   could cause previously-accepted code to break.
6986 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6987 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6988   struct pattern syntax (`Foo(..)`) can no longer be used to match
6989   unit structs. This is a warning now, but will become an error in
6990   future releases. Patterns that share the same name as a const are
6991   now an error.
6992 * A bug was fixed that causes [rustc not to apply default type
6993   parameters][1.6xc] when resolving certain method implementations of
6994   traits defined in other crates.
6995
6996 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6997 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6998 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6999 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7000 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7001 [1.6co]: http://doc.rust-lang.org/core/index.html
7002 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7003 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7004 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7005 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7006 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7007 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7008 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7009 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7010 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7011 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7012 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7013 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7014 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7015 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7016 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7017 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7018 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7019 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7020 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7021 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7022 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7023 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7024 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7025 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7026 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7027 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7028 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7029 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7030 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7031 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7032 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7033 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7034 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7035 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7036 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7037 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7038 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7039 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7040 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7041 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7042 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7043
7044
7045 Version 1.5.0 (2015-12-10)
7046 ==========================
7047
7048 * ~700 changes, numerous bugfixes
7049
7050 Highlights
7051 ----------
7052
7053 * Stabilized APIs:
7054   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7055   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7056   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7057   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7058   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7059   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7060   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7061   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7062   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7063   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7064   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7065   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7066   [`Path::read_link`], [`Path::symlink_metadata`],
7067   [`Utf8Error::valid_up_to`], [`Vec::resize`],
7068   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7069   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7070   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7071   [`slice::split_first_mut`], [`slice::split_first`],
7072   [`slice::split_last_mut`], [`slice::split_last`],
7073   [`char::from_u32_unchecked`], [`fs::canonicalize`],
7074   [`str::MatchIndices`], [`str::RMatchIndices`],
7075   [`str::match_indices`], [`str::rmatch_indices`],
7076   [`str::slice_mut_unchecked`], [`string::ParseError`].
7077 * Rust applications hosted on crates.io can be installed locally to
7078   `~/.cargo/bin` with the [`cargo install`] command. Among other
7079   things this makes it easier to augment Cargo with new subcommands:
7080   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7081   invoked as `cargo foo`.
7082 * Crates with wildcard (`*`) dependencies will [emit warnings when
7083   published][1.5w]. In 1.6 it will no longer be possible to publish
7084   crates with wildcard dependencies.
7085
7086 Breaking Changes
7087 ----------------
7088
7089 * The rules determining when a particular lifetime must outlive
7090   a particular value (known as '[dropck]') have been [modified
7091   to not rely on parametricity][1.5p].
7092 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7093   and `Arc`][1.5a]. Because these smart pointer types implement
7094   `Deref`, this causes breakage in cases where the interior type
7095   contains methods of the same name.
7096 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7097   that they could drop their content. Soundness fix.
7098 * All method invocations are [properly checked][1.5wf1] for
7099   [well-formedness][1.5wf2]. Soundness fix.
7100 * Traits whose supertraits contain `Self` are [not object
7101   safe][1.5o]. Soundness fix.
7102 * Target specifications support a [`no_default_libraries`][1.5nd]
7103   setting that controls whether `-nodefaultlibs` is passed to the
7104   linker, and in turn the `is_like_windows` setting no longer affects
7105   the `-nodefaultlibs` flag.
7106 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7107 * The `#[inline]` and `#[repr]` attributes [can only appear
7108   in valid locations][1.5at].
7109 * Native libraries linked from the local crate are [passed to
7110   the linker before native libraries from upstream crates][1.5nl].
7111 * Two rarely-used attributes, `#[no_debug]` and
7112   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7113 * Negation of unsigned integers, which has been a warning for
7114   several releases, [is now behind a feature gate and will
7115   generate errors][1.5nu].
7116 * The parser accidentally accepted visibility modifiers on
7117   enum variants, a bug [which has been fixed][1.5ev].
7118 * [A bug was fixed that allowed `use` statements to import unstable
7119   features][1.5use].
7120
7121 Language
7122 --------
7123
7124 * When evaluating expressions at compile-time that are not
7125   compile-time constants (const-evaluating expressions in non-const
7126   contexts), incorrect code such as overlong bitshifts and arithmetic
7127   overflow will [generate a warning instead of an error][1.5ce],
7128   delaying the error until runtime. This will allow the
7129   const-evaluator to be expanded in the future backwards-compatibly.
7130 * The `improper_ctypes` lint [no longer warns about using `isize` and
7131   `usize` in FFI][1.5ict].
7132
7133 Libraries
7134 ---------
7135
7136 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7137   invariant][1.5c].
7138 * `Default` is [implemented for mutable slices][1.5d].
7139 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7140 * There are now `From` conversions [between floating point
7141   types][1.5f] where the conversions are lossless.
7142 * There are now `From` conversions [between integer types][1.5i] where
7143   the conversions are lossless.
7144 * [`fs::Metadata` implements `Clone`][1.5fs].
7145 * The `parse` method [accepts a leading "+" when parsing
7146   integers][1.5pi].
7147 * [`AsMut` is implemented for `Vec`][1.5am].
7148 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7149   been optimized][1.5cf] and no longer rely on the default impl.
7150 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7151   `unsafe extern "C"` function types now [implement `Clone`,
7152   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7153   `fmt::Debug` for up to 12 arguments][1.5fp].
7154 * [Dropping `Vec`s is much faster in unoptimized builds when the
7155   element types don't implement `Drop`][1.5dv].
7156 * A bug that caused in incorrect behavior when [combining `VecDeque`
7157   with zero-sized types][1.5vdz] was resolved.
7158 * [`PartialOrd` for slices is faster][1.5po].
7159
7160 Miscellaneous
7161 -------------
7162
7163 * [Crate metadata size was reduced by 20%][1.5md].
7164 * [Improvements to code generation reduced the size of libcore by 3.3
7165   MB and rustc's memory usage by 18MB][1.5m].
7166 * [Improvements to deref translation increased performance in
7167   unoptimized builds][1.5dr].
7168 * Various errors in trait resolution [are deduplicated to only be
7169   reported once][1.5te].
7170 * Rust has preliminary [support for rumprun kernels][1.5rr].
7171 * Rust has preliminary [support for NetBSD on amd64][1.5na].
7172
7173 [1.5use]: https://github.com/rust-lang/rust/pull/28364
7174 [1.5po]: https://github.com/rust-lang/rust/pull/28436
7175 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
7176 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
7177 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
7178 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7179 [1.5md]: https://github.com/rust-lang/rust/pull/28521
7180 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
7181 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
7182 [1.5na]: https://github.com/rust-lang/rust/pull/28543
7183 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
7184 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
7185 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
7186 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
7187 [1.5te]: https://github.com/rust-lang/rust/pull/28645
7188 [1.5at]: https://github.com/rust-lang/rust/pull/28650
7189 [1.5am]: https://github.com/rust-lang/rust/pull/28663
7190 [1.5m]: https://github.com/rust-lang/rust/pull/28778
7191 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
7192 [1.5a]: https://github.com/rust-lang/rust/pull/28811
7193 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
7194 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7195 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7196 [1.5i]: https://github.com/rust-lang/rust/pull/28921
7197 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
7198 [1.5f]: https://github.com/rust-lang/rust/pull/29129
7199 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
7200 [1.5s]: https://github.com/rust-lang/rust/pull/29190
7201 [1.5d]: https://github.com/rust-lang/rust/pull/29245
7202 [1.5o]: https://github.com/rust-lang/rust/pull/29259
7203 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
7204 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7205 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7206 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7207 [1.5c]: https://github.com/rust-lang/rust/pull/29110
7208 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7209 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7210 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7211 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7212 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7213 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7214 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7215 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7216 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7217 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7218 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7219 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7220 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7221 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7222 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7223 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7224 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7225 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7226 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7227 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7228 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7229 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7230 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7231 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7232 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7233 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7234 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7235 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7236 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7237 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7238 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7239 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7240 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7241 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7242 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7243 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7244 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7245 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7246 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7247 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7248 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7249 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7250 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7251 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7252 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7253 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7254 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7255 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7256 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7257 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7258 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7259 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7260 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7261 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7262
7263 Version 1.4.0 (2015-10-29)
7264 ==========================
7265
7266 * ~1200 changes, numerous bugfixes
7267
7268 Highlights
7269 ----------
7270
7271 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7272   GNU) are now supported and recommended for use.
7273
7274 Breaking Changes
7275 ----------------
7276
7277 * [Several changes have been made to fix type soundness and improve
7278   the behavior of associated types][sound]. See [RFC 1214]. Although
7279   we have mostly introduced these changes as warnings this release, to
7280   become errors next release, there are still some scenarios that will
7281   see immediate breakage.
7282 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7283   line breaks in addition to `\n`][crlf].
7284 * [Loans of `'static` lifetime extend to the end of a function][stat].
7285 * [`str::parse` no longer introduces avoidable rounding error when
7286   parsing floating point numbers. Together with earlier changes to
7287   float formatting/output, "round trips" like f.to_string().parse()
7288   now preserve the value of f exactly. Additionally, leading plus
7289   signs are now accepted][fp3].
7290
7291
7292 Language
7293 --------
7294
7295 * `use` statements that import multiple items [can now rename
7296   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7297 * [Binops work correctly on fat pointers][binfat].
7298 * `pub extern crate`, which does not behave as expected, [issues a
7299   warning][pec] until a better solution is found.
7300
7301 Libraries
7302 ---------
7303
7304 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7305   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7306   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7307   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7308   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7309   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7310   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7311   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7312   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7313   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7314   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7315   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7316   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7317   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7318   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7319   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7320   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7321   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7322   [`thread::sleep`].
7323 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7324   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7325   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7326   `f64::from_str_radix`.
7327 * [Reverse-searching strings is faster with the 'two-way'
7328   algorithm][s].
7329 * [`std::io::copy` allows `?Sized` arguments][cc].
7330 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7331   [override `count`, `nth` and `last` with an O(1)
7332   implementation][it].
7333 * [`Default` is implemented for arrays up to `[T; 32]`][d].
7334 * [`IntoRawFd` has been added to the Unix-specific prelude,
7335   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7336   prelude][pr].
7337 * [`Extend<String>` and `FromIterator<String` are both implemented for
7338   `String`][es].
7339 * [`IntoIterator` is implemented for references to `Option` and
7340   `Result`][into2].
7341 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
7342   Copy`][ext] as part of [RFC 839]. This will cause type inference
7343   breakage in rare situations.
7344 * [`BinaryHeap` implements `Debug`][bh2].
7345 * [`Borrow` and `BorrowMut` are implemented for fixed-size
7346   arrays][bm].
7347 * [`extern fn`s with the "Rust" and "C" ABIs implement common
7348   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7349 * [String comparison is faster][faststr].
7350 * `&mut T` where `T: std::fmt::Write` [also implements
7351   `std::fmt::Write`][mutw].
7352 * [A stable regression in `VecDeque::push_back` and other
7353   capacity-altering methods that caused panics for zero-sized types
7354   was fixed][vd].
7355 * [Function pointers implement traits for up to 12 parameters][fp2].
7356
7357 Miscellaneous
7358 -------------
7359
7360 * The compiler [no longer uses the 'morestack' feature to prevent
7361   stack overflow][mm]. Instead it uses guard pages and stack
7362   probes (though stack probes are not yet implemented on any platform
7363   but Windows).
7364 * [The compiler matches traits faster when projections are involved][p].
7365 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
7366   `usize`][ffi].
7367 * [Cargo now displays useful information about what its doing during
7368   `cargo update`][cu].
7369
7370 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7371 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7372 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7373 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7374 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7375 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7376 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7377 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7378 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7379 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7380 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7381 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7382 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7383 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7384 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7385 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7386 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7387 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7388 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7389 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7390 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7391 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7392 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7393 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7394 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7395 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7396 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7397 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7398 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7399 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7400 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7401 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7402 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7403 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7404 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7405 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7406 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7407 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7408 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7409 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7410 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7411 [bh2]: https://github.com/rust-lang/rust/pull/28156
7412 [binfat]: https://github.com/rust-lang/rust/pull/28270
7413 [bm]: https://github.com/rust-lang/rust/pull/28197
7414 [cc]: https://github.com/rust-lang/rust/pull/27531
7415 [crlf]: https://github.com/rust-lang/rust/pull/28034
7416 [cu]: https://github.com/rust-lang/cargo/pull/1931
7417 [d]: https://github.com/rust-lang/rust/pull/27825
7418 [dep]: https://github.com/rust-lang/rust/pull/28339
7419 [es]: https://github.com/rust-lang/rust/pull/27956
7420 [ext]: https://github.com/rust-lang/rust/pull/28094
7421 [faststr]: https://github.com/rust-lang/rust/pull/28338
7422 [ffi]: https://github.com/rust-lang/rust/pull/28779
7423 [fp]: https://github.com/rust-lang/rust/pull/28268
7424 [fp2]: https://github.com/rust-lang/rust/pull/28560
7425 [fp3]: https://github.com/rust-lang/rust/pull/27307
7426 [i]: https://github.com/rust-lang/rust/pull/27451
7427 [into2]: https://github.com/rust-lang/rust/pull/28039
7428 [it]: https://github.com/rust-lang/rust/pull/27652
7429 [mm]: https://github.com/rust-lang/rust/pull/27338
7430 [mutw]: https://github.com/rust-lang/rust/pull/28368
7431 [sound]: https://github.com/rust-lang/rust/pull/27641
7432 [p]: https://github.com/rust-lang/rust/pull/27866
7433 [pec]: https://github.com/rust-lang/rust/pull/28486
7434 [pr]: https://github.com/rust-lang/rust/pull/27896
7435 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7436 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7437 [s]: https://github.com/rust-lang/rust/pull/27474
7438 [stab]: https://github.com/rust-lang/rust/pull/28339
7439 [stat]: https://github.com/rust-lang/rust/pull/28321
7440 [vd]: https://github.com/rust-lang/rust/pull/28494
7441
7442 Version 1.3.0 (2015-09-17)
7443 ==============================
7444
7445 * ~900 changes, numerous bugfixes
7446
7447 Highlights
7448 ----------
7449
7450 * The [new object lifetime defaults][nold] have been [turned
7451   on][nold2] after a cycle of warnings about the change. Now types
7452   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7453   being interpreted as `&'a Box<Trait+'a>` to `&'a
7454   Box<Trait+'static>`.
7455 * [The Rustonomicon][nom] is a new book in the official documentation
7456   that dives into writing unsafe Rust.
7457 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7458   timekeeping is employed by other std APIs, as well as out-of-tree
7459   time crates.
7460
7461 Breaking Changes
7462 ----------------
7463
7464 * The [new object lifetime defaults][nold] have been [turned
7465   on][nold2] after a cycle of warnings about the change.
7466 * There is a known [regression][lr] in how object lifetime elision is
7467   interpreted, the proper solution for which is undetermined.
7468 * The `#[prelude_import]` attribute, an internal implementation
7469   detail, was accidentally stabilized previously. [It has been put
7470   behind the `prelude_import` feature gate][pi]. This change is
7471   believed to break no existing code.
7472 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7473   [more sane for dynamically sized types][dst3]. Code that relied on
7474   the previous behavior is thought to be broken.
7475 * The `dropck` rules, which checks that destructors can't access
7476   destroyed values, [have been updated][dropck] to match the
7477   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7478   cause some previously-compiling code to no longer build.
7479
7480 Language
7481 --------
7482
7483 * The [new object lifetime defaults][nold] have been [turned
7484   on][nold2] after a cycle of warnings about the change.
7485 * Semicolons may [now follow types and paths in
7486   macros](https://github.com/rust-lang/rust/pull/27000).
7487 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7488   [more sane for dynamically sized types][dst3]. Code that relied on
7489   the previous behavior is not known to exist, and suspected to be
7490   broken.
7491 * `'static` variables [may now be recursive][st].
7492 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
7493   implementations correctly.
7494 * The `dropck` rules, which checks that destructors can't access
7495   destroyed values, [have been updated][dropck] to match the
7496   [RFC][dropckrfc].
7497
7498 Libraries
7499 ---------
7500
7501 * The [`Duration`] API, [has been stabilized][ds], as well as the
7502   `std::time` module, which presently contains only `Duration`.
7503 * `Box<str>` and `Box<[T]>` both implement `Clone`.
7504 * The owned C string, [`CString`], implements [`Borrow`] and the
7505   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7506   these allow C strings to be borrowed and cloned in generic code.
7507 * [`CStr`] implements [`Debug`].
7508 * [`AtomicPtr`] implements [`Debug`].
7509 * [`Error`] trait objects [can be downcast to their concrete types][e]
7510   in many common configurations, using the [`is`], [`downcast`],
7511   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
7512   [`Any`] trait.
7513 * Searching for substrings now [employs the two-way algorithm][search]
7514   instead of doing a naive search. This gives major speedups to a
7515   number of methods, including [`contains`][sc], [`find`][sf],
7516   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
7517   [`ends_with`][sew] are also faster.
7518 * The performance of `PartialEq` for slices is [much faster][ps].
7519 * The [`Hash`] trait offers the default method, [`hash_slice`], which
7520   is overridden and optimized by the implementations for scalars.
7521 * The [`Hasher`] trait now has a number of specialized `write_*`
7522   methods for primitive types, for efficiency.
7523 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
7524   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
7525   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
7526   of [`std::error::Error::cause`][iec] also delegates to the inner
7527   error.
7528 * [`process::Child`][pc] gained the [`id`] method, which returns a
7529   `u32` representing the platform-specific process identifier.
7530 * The [`connect`] method on slices is deprecated, replaced by the new
7531   [`join`] method (note that both of these are on the *unstable*
7532   [`SliceConcatExt`] trait, but through the magic of the prelude are
7533   available to stable code anyway).
7534 * The [`Div`] operator is implemented for [`Wrapping`] types.
7535 * [`DerefMut` is implemented for `String`][dms].
7536 * Performance of SipHash (the default hasher for `HashMap`) is
7537   [better for long data][sh].
7538 * [`AtomicPtr`] implements [`Send`].
7539 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
7540   are now [specialized to use uninitialized buffers for increased
7541   performance][rte].
7542 * Lifetime parameters of foreign functions [are now resolved
7543   properly][f].
7544
7545 Misc
7546 ----
7547
7548 * Rust can now, with some coercion, [produce programs that run on
7549   Windows XP][xp], though XP is not considered a supported platform.
7550 * Porting Rust on Windows from the GNU toolchain to MSVC continues
7551   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7552   recommended for use in 1.3, though should be fully-functional
7553   in the [64-bit 1.4 beta][b14].
7554 * On Fedora-based systems installation will [properly configure the
7555   dynamic linker][fl].
7556 * The compiler gained many new extended error descriptions, which can
7557   be accessed with the `--explain` flag.
7558 * The `dropck` pass, which checks that destructors can't access
7559   destroyed values, [has been rewritten][dropck]. This fixes some
7560   soundness holes, and as such will cause some previously-compiling
7561   code to no longer build.
7562 * `rustc` now uses [LLVM to write archive files where possible][ar].
7563   Eventually this will eliminate the compiler's dependency on the ar
7564   utility.
7565 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7566   supported FreeBSD on x86_64).
7567 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7568   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7569   more strict.
7570 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7571   will kill the process instead of leaking][nlp].
7572
7573 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7574 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7575 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7576 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7577 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7578 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7579 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7580 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7581 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7582 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7583 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7584 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7585 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7586 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7587 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7588 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7589 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7590 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7591 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7592 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7593 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7594 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7595 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7596 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7597 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7598 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7599 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7600 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7601 [ar]: https://github.com/rust-lang/rust/pull/26926
7602 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7603 [dms]: https://github.com/rust-lang/rust/pull/26241
7604 [dropck]: https://github.com/rust-lang/rust/pull/27261
7605 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7606 [ds]: https://github.com/rust-lang/rust/pull/26818
7607 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7608 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7609 [dst3]: https://github.com/rust-lang/rust/pull/27351
7610 [e]: https://github.com/rust-lang/rust/pull/24793
7611 [f]: https://github.com/rust-lang/rust/pull/26588
7612 [fb]: https://github.com/rust-lang/rust/pull/26959
7613 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7614 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7615 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7616 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7617 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7618 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7619 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7620 [lic]: https://github.com/rust-lang/rust/pull/26583
7621 [lnu]: https://github.com/rust-lang/rust/pull/27026
7622 [lr]: https://github.com/rust-lang/rust/issues/27248
7623 [lum]: https://github.com/rust-lang/rust/pull/26378
7624 [lur]: https://github.com/rust-lang/rust/pull/26783
7625 [nlp]: https://github.com/rust-lang/rust/pull/27176
7626 [nold2]: https://github.com/rust-lang/rust/pull/27045
7627 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7628 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7629 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7630 [pi]: https://github.com/rust-lang/rust/pull/26699
7631 [ps]: https://github.com/rust-lang/rust/pull/26884
7632 [rte]: https://github.com/rust-lang/rust/pull/26950
7633 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7634 [search]: https://github.com/rust-lang/rust/pull/26327
7635 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7636 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7637 [sh]: https://github.com/rust-lang/rust/pull/27280
7638 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7639 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7640 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7641 [st]: https://github.com/rust-lang/rust/pull/26630
7642 [win1]: https://github.com/rust-lang/rust/pull/26569
7643 [win2]: https://github.com/rust-lang/rust/pull/26741
7644 [win3]: https://github.com/rust-lang/rust/pull/26741
7645 [win4]: https://github.com/rust-lang/rust/pull/27210
7646 [xp]: https://github.com/rust-lang/rust/pull/26569
7647
7648 Version 1.2.0 (2015-08-07)
7649 ==========================
7650
7651 * ~1200 changes, numerous bugfixes
7652
7653 Highlights
7654 ----------
7655
7656 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7657   like `Rc` to contain types without a fixed size, arrays and trait
7658   objects, finally enabling use of `Rc<[T]>` and completing the
7659   implementation of DST.
7660 * [Parallel codegen][parcodegen] is now working again, which can
7661   substantially speed up large builds in debug mode; It also gets
7662   another ~33% speedup when bootstrapping on a 4 core machine (using 8
7663   jobs). It's not enabled by default, but will be "in the near
7664   future". It can be activated with the `-C codegen-units=N` flag to
7665   `rustc`.
7666 * This is the first release with [experimental support for linking
7667   with the MSVC linker and lib C on Windows (instead of using the GNU
7668   variants via MinGW)][win]. It is yet recommended only for the most
7669   intrepid Rustaceans.
7670 * Benchmark compilations are showing a 30% improvement in
7671   bootstrapping over 1.1.
7672
7673 Breaking Changes
7674 ----------------
7675
7676 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7677   unicode case mapping, which is a previously-planned change in
7678   behavior and considered a bugfix.
7679 * [`mem::align_of`] now specifies [the *minimum alignment* for
7680   T][align], which is usually the alignment programs are interested
7681   in, and the same value reported by clang's
7682   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7683   break real code.
7684 * [The `#[packed]` attribute is no longer silently accepted by the
7685   compiler][packed]. This attribute did nothing and code that
7686   mentioned it likely did not work as intended.
7687 * Associated type defaults are [now behind the
7688   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7689   defaults *did not work*, but could be mentioned syntactically. As
7690   such this breakage has minimal impact.
7691
7692 Language
7693 --------
7694
7695 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
7696   matching against dereferenceable values.
7697
7698 Libraries
7699 ---------
7700
7701 * The [`Extend`] trait, which grows a collection from an iterator, is
7702   implemented over iterators of references, for `String`, `Vec`,
7703   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7704   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7705 * The [`iter::once`] function returns an iterator that yields a single
7706   element, and [`iter::empty`] returns an iterator that yields no
7707   elements.
7708 * The [`matches`] and [`rmatches`] methods on `str` return iterators
7709   over substring matches.
7710 * [`Cell`] and [`RefCell`] both implement `Eq`.
7711 * A number of methods for wrapping arithmetic are added to the
7712   integral types, [`wrapping_div`], [`wrapping_rem`],
7713   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7714   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7715   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7716   type.. It is illegal for the default arithmetic operations in Rust
7717   to overflow; the desire to wrap must be explicit.
7718 * The `{:#?}` formatting specifier [displays the alternate,
7719   pretty-printed][debugfmt] form of the `Debug` formatter. This
7720   feature was actually introduced prior to 1.0 with little
7721   fanfare.
7722 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7723   for writing data to formatted strings, similar to [`io::Write`].
7724 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7725   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7726   are used by code generators to emit implementations of [`Debug`].
7727 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7728   methods that convert case, following Unicode case mapping.
7729 * It is now easier to handle poisoned locks. The [`PoisonError`]
7730   type, returned by failing lock operations, exposes `into_inner`,
7731   `get_ref`, and `get_mut`, which all give access to the inner lock
7732   guard, and allow the poisoned lock to continue to operate. The
7733   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7734   poisoned lock without attempting to take the lock.
7735 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7736   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7737   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7738   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7739   `ChildStderr`.
7740 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7741   malformed input.
7742
7743 Misc
7744 ----
7745
7746 * `rustc` employs smarter heuristics for guessing at [typos].
7747 * `rustc` emits more efficient code for [no-op conversions between
7748   unsafe pointers][nop].
7749 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7750   resulting in faster compile times and smaller code.
7751
7752 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7753 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7754 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7755 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7756 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7757 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7758 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7759 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7760 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7761 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7762 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7763 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7764 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7765 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7766 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7767 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7768 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7769 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7770 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7771 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7772 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7773 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7774 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7775 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7776 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7777 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7778 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7779 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7780 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7781 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7782 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7783 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7784 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7785 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7786 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7787 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7788 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7789 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7790 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7791 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7792 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7793 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7794 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7795 [align]: https://github.com/rust-lang/rust/pull/25646
7796 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7797 [typos]: https://github.com/rust-lang/rust/pull/26087
7798 [nop]: https://github.com/rust-lang/rust/pull/26336
7799 [fat]: https://github.com/rust-lang/rust/pull/26411
7800 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7801 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7802 [packed]: https://github.com/rust-lang/rust/pull/25541
7803 [ad]: https://github.com/rust-lang/rust/pull/27382
7804 [win]: https://github.com/rust-lang/rust/pull/25350
7805
7806 Version 1.1.0 (2015-06-25)
7807 =========================
7808
7809 * ~850 changes, numerous bugfixes
7810
7811 Highlights
7812 ----------
7813
7814 * The [`std::fs` module has been expanded][fs] to expand the set of
7815   functionality exposed:
7816   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7817     don't incur a syscall on some platforms.
7818   * A `symlink_metadata` function has been added.
7819   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7820     access to all underlying information.
7821 * The compiler now contains extended explanations of many errors. When an error
7822   with an explanation occurs the compiler suggests using the `--explain` flag
7823   to read the explanation. Error explanations are also [available online][err-index].
7824 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7825   well as other work, the time to bootstrap the compiler decreased by
7826   32%.
7827
7828 Libraries
7829 ---------
7830
7831 * The [`str::split_whitespace`] method splits a string on unicode
7832   whitespace boundaries.
7833 * On both Windows and Unix, new extension traits provide conversion of
7834   I/O types to and from the underlying system handles. On Unix, these
7835   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7836   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7837   `TcpListener`, and `UpdSocket`. Further implementations for
7838   `std::process` will be stabilized later.
7839 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7840   Windows, symlinks can be created with
7841   `std::os::windows::symlink_dir` and
7842   `std::os::windows::symlink_file`.
7843 * The `mpsc::Receiver` type can now be converted into an iterator with
7844   `into_iter` on the [`IntoIterator`] trait.
7845 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7846   implementation of the [`From`] trait.
7847 * The `Debug` implementation for `RangeFull` [creates output that is
7848   more consistent with other implementations][rf].
7849 * [`Debug` is implemented for `File`][file].
7850 * The `Default` implementation for `Arc` [no longer requires `Sync +
7851   Send`][arc].
7852 * [The `Iterator` methods `count`, `nth`, and `last` have been
7853   overridden for slices to have O(1) performance instead of O(n)][si].
7854 * Incorrect handling of paths on Windows has been improved in both the
7855   compiler and the standard library.
7856 * [`AtomicPtr` gained a `Default` implementation][ap].
7857 * In accordance with Rust's policy on arithmetic overflow `abs` now
7858   [panics on overflow when debug assertions are enabled][abs].
7859 * The [`Cloned`] iterator, which was accidentally left unstable for
7860   1.0 [has been stabilized][c].
7861 * The [`Incoming`] iterator, which iterates over incoming TCP
7862   connections, and which was accidentally unnamable in 1.0, [is now
7863   properly exported][inc].
7864 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7865   `sift_up` or `sift_down` panic][bh].
7866 * The [`split_off`] method of `LinkedList` [no longer corrupts
7867   the list in certain scenarios][ll].
7868
7869 Misc
7870 ----
7871
7872 * Type checking performance [has improved notably][sk] with
7873   [multiple improvements][pre].
7874 * The compiler [suggests code changes][ch] for more errors.
7875 * rustc and it's build system have experimental support for [building
7876   toolchains against MUSL][m] instead of glibc on Linux.
7877 * The compiler defines the `target_env` cfg value, which is used for
7878   distinguishing toolchains that are otherwise for the same
7879   platform. Presently this is set to `gnu` for common GNU Linux
7880   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7881 * The [`cargo rustc`][crc] command invokes a build with custom flags
7882   to rustc.
7883 * [Android executables are always position independent][pie].
7884 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7885   with `Drop`][drop].
7886
7887 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7888 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7889 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7890 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7891 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7892 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7893 [rf]: https://github.com/rust-lang/rust/pull/24491
7894 [err-index]: https://doc.rust-lang.org/error-index.html
7895 [sk]: https://github.com/rust-lang/rust/pull/24615
7896 [pre]: https://github.com/rust-lang/rust/pull/25323
7897 [file]: https://github.com/rust-lang/rust/pull/24598
7898 [ch]: https://github.com/rust-lang/rust/pull/24683
7899 [arc]: https://github.com/rust-lang/rust/pull/24695
7900 [si]: https://github.com/rust-lang/rust/pull/24701
7901 [ap]: https://github.com/rust-lang/rust/pull/24834
7902 [m]: https://github.com/rust-lang/rust/pull/24777
7903 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7904 [crc]: https://github.com/rust-lang/cargo/pull/1568
7905 [pie]: https://github.com/rust-lang/rust/pull/24953
7906 [abs]: https://github.com/rust-lang/rust/pull/25441
7907 [c]: https://github.com/rust-lang/rust/pull/25496
7908 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7909 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7910 [inc]: https://github.com/rust-lang/rust/pull/25522
7911 [bh]: https://github.com/rust-lang/rust/pull/25856
7912 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7913 [ll]: https://github.com/rust-lang/rust/pull/26022
7914 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7915 [drop]: https://github.com/rust-lang/rust/pull/24935
7916
7917 Version 1.0.0 (2015-05-15)
7918 ========================
7919
7920 * ~1500 changes, numerous bugfixes
7921
7922 Highlights
7923 ----------
7924
7925 * The vast majority of the standard library is now `#[stable]`. It is
7926   no longer possible to use unstable features with a stable build of
7927   the compiler.
7928 * Many popular crates on [crates.io] now work on the stable release
7929   channel.
7930 * Arithmetic on basic integer types now [checks for overflow in debug
7931   builds][overflow].
7932
7933 Language
7934 --------
7935
7936 * Several [restrictions have been added to trait coherence][coh] in
7937   order to make it easier for upstream authors to change traits
7938   without breaking downstream code.
7939 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7940   improve error messages and macro behavior. For example, `0b1234` is
7941   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7942 * Trait bounds [are always invariant][inv], eliminating the need for
7943   the `PhantomFn` and `MarkerTrait` lang items, which have been
7944   removed.
7945 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7946   "foo" as bar` syntax has been replaced with `extern crate foo as
7947   bar`, and Cargo now automatically translates "-" in *package* names
7948   to underscore for the crate name.
7949 * [Lifetime shadowing is an error][lt].
7950 * [`Send` no longer implies `'static`][send-rfc].
7951 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7952   `MyType::default()`.
7953 * Primitive types [now have inherent methods][prim-inherent],
7954   obviating the need for extension traits like `SliceExt`.
7955 * Methods with `Self: Sized` in their `where` clause are [considered
7956   object-safe][self-sized], allowing many extension traits like
7957   `IteratorExt` to be merged into the traits they extended.
7958 * You can now [refer to associated types][assoc-where] whose
7959   corresponding trait bounds appear only in a `where` clause.
7960 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7961   like `Send` and `Sync` are now library-defined.
7962 * A [Reflect trait][reflect] was introduced, which means that
7963   downcasting via the `Any` trait is effectively limited to concrete
7964   types. This helps retain the potentially-important "parametricity"
7965   property: generic code cannot behave differently for different type
7966   arguments except in minor ways.
7967 * The `unsafe_destructor` feature is now deprecated in favor of the
7968   [new `dropck`][dropck]. This change is a major reduction in unsafe
7969   code.
7970
7971 Libraries
7972 ---------
7973
7974 * The `thread_local` module [has been renamed to `std::thread`][th].
7975 * The methods of `IteratorExt` [have been moved to the `Iterator`
7976   trait itself][ie].
7977 * Several traits that implement Rust's conventions for type
7978   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7979   [centralized in the `std::convert` module][con].
7980 * The `FromError` trait [was removed in favor of `From`][fe].
7981 * The basic sleep function [has moved to
7982   `std::thread::sleep_ms`][slp].
7983 * The `splitn` function now takes an `n` parameter that represents the
7984   number of items yielded by the returned iterator [instead of the
7985   number of 'splits'][spl].
7986 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7987 * [Derived implementations of `PartialOrd` now order enums according
7988   to their explicitly-assigned discriminants][po].
7989 * [Methods for searching strings are generic over `Pattern`s][pat],
7990   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7991   some others.
7992 * [In method resolution, object methods are resolved before inherent
7993   methods][meth].
7994 * [`String::from_str` has been deprecated in favor of the `From` impl,
7995   `String::from`][sf].
7996 * [`io::Error` implements `Sync`][ios].
7997 * [The `words` method on `&str` has been replaced with
7998   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7999   a word?'
8000 * The new path and IO modules are complete and `#[stable]`. This
8001   was the major library focus for this cycle.
8002 * The path API was [revised][path-normalize] to normalize `.`,
8003   adjusting the tradeoffs in favor of the most common usage.
8004 * A large number of remaining APIs in `std` were also stabilized
8005   during this cycle; about 75% of the non-deprecated API surface
8006   is now stable.
8007 * The new [string pattern API][string-pattern] landed, which makes
8008   the string slice API much more internally consistent and flexible.
8009 * A new set of [generic conversion traits][conversion] replaced
8010   many existing ad hoc traits.
8011 * Generic numeric traits were [completely removed][num-traits]. This
8012   was made possible thanks to inherent methods for primitive types,
8013   and the removal gives maximal flexibility for designing a numeric
8014   hierarchy in the future.
8015 * The `Fn` traits are now related via [inheritance][fn-inherit]
8016   and provide ergonomic [blanket implementations][fn-blanket].
8017 * The `Index` and `IndexMut` traits were changed to
8018   [take the index by value][index-value], enabling code like
8019   `hash_map["string"]` to work.
8020 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8021   `Copy` data is known to be `Clone` as well.
8022
8023 Misc
8024 ----
8025
8026 * Many errors now have extended explanations that can be accessed with
8027   the `--explain` flag to `rustc`.
8028 * Many new examples have been added to the standard library
8029   documentation.
8030 * rustdoc has received a number of improvements focused on completion
8031   and polish.
8032 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8033 * Much headway was made on ecosystem-wide CI, making it possible
8034   to [compare builds for breakage][ci-compare].
8035
8036
8037 [crates.io]: http://crates.io
8038 [clo]: https://github.com/rust-lang/rust/pull/24034
8039 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8040 [con]: https://github.com/rust-lang/rust/pull/23875
8041 [cr]: https://github.com/rust-lang/rust/pull/23419
8042 [fe]: https://github.com/rust-lang/rust/pull/23879
8043 [ie]: https://github.com/rust-lang/rust/pull/23300
8044 [inv]: https://github.com/rust-lang/rust/pull/23938
8045 [ios]: https://github.com/rust-lang/rust/pull/24133
8046 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8047 [lt]: https://github.com/rust-lang/rust/pull/24057
8048 [meth]: https://github.com/rust-lang/rust/pull/24056
8049 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8050 [po]: https://github.com/rust-lang/rust/pull/24270
8051 [sf]: https://github.com/rust-lang/rust/pull/24517
8052 [slp]: https://github.com/rust-lang/rust/pull/23949
8053 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8054 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8055 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
8056 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
8057 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8058 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8059 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8060 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8061 [self-sized]: https://github.com/rust-lang/rust/pull/22301
8062 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
8063 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
8064 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
8065 [reflect]: https://github.com/rust-lang/rust/pull/23712
8066 [conversion]: https://github.com/rust-lang/rfcs/pull/529
8067 [num-traits]: https://github.com/rust-lang/rust/pull/23549
8068 [index-value]: https://github.com/rust-lang/rust/pull/23601
8069 [dropck]: https://github.com/rust-lang/rfcs/pull/769
8070 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8071 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8072 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8073 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
8074 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
8075
8076
8077 Version 1.0.0-alpha.2 (2015-02-20)
8078 =====================================
8079
8080 * ~1300 changes, numerous bugfixes
8081
8082 * Highlights
8083
8084     * The various I/O modules were [overhauled][io-rfc] to reduce
8085       unnecessary abstractions and provide better interoperation with
8086       the underlying platform. The old `io` module remains temporarily
8087       at `std::old_io`.
8088     * The standard library now [participates in feature gating][feat],
8089       so use of unstable libraries now requires a `#![feature(...)]`
8090       attribute. The impact of this change is [described on the
8091       forum][feat-forum]. [RFC][feat-rfc].
8092
8093 * Language
8094
8095     * `for` loops [now operate on the `IntoIterator` trait][into],
8096       which eliminates the need to call `.iter()`, etc. to iterate
8097       over collections. There are some new subtleties to remember
8098       though regarding what sort of iterators various types yield, in
8099       particular that `for foo in bar { }` yields values from a move
8100       iterator, destroying the original collection. [RFC][into-rfc].
8101     * Objects now have [default lifetime bounds][obj], so you don't
8102       have to write `Box<Trait+'static>` when you don't care about
8103       storing references. [RFC][obj-rfc].
8104     * In types that implement `Drop`, [lifetimes must outlive the
8105       value][drop]. This will soon make it possible to safely
8106       implement `Drop` for types where `#[unsafe_destructor]` is now
8107       required. Read the [gorgeous RFC][drop-rfc] for details.
8108     * The fully qualified <T as Trait>::X syntax lets you set the Self
8109       type for a trait method or associated type. [RFC][ufcs-rfc].
8110     * References to types that implement `Deref<U>` now [automatically
8111       coerce to references][deref] to the dereferenced type `U`,
8112       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8113       should eliminate many unsightly uses of `&*`, as when converting
8114       from references to vectors into references to
8115       slices. [RFC][deref-rfc].
8116     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8117       `|:|`) is obsolete and closure kind is inferred from context.
8118     * [`Self` is a keyword][Self].
8119
8120 * Libraries
8121
8122     * The `Show` and `String` formatting traits [have been
8123       renamed][fmt] to `Debug` and `Display` to more clearly reflect
8124       their related purposes. Automatically getting a string
8125       conversion to use with `format!("{:?}", something_to_debug)` is
8126       now written `#[derive(Debug)]`.
8127     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8128       OsStr}`, provide strings in platform-specific encodings for easier
8129       interop with system APIs. [RFC][osstr-rfc].
8130     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8131       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8132       creating raw pointers.
8133
8134 * Tooling
8135
8136     * Certain long error messages of the form 'expected foo found bar'
8137       are now [split neatly across multiple
8138       lines][multiline]. Examples in the PR.
8139     * On Unix Rust can be [uninstalled][un] by running
8140       `/usr/local/lib/rustlib/uninstall.sh`.
8141     * The `#[rustc_on_unimplemented]` attribute, requiring the
8142       'on_unimplemented' feature, lets rustc [display custom error
8143       messages when a trait is expected to be implemented for a type
8144       but is not][onun].
8145
8146 * Misc
8147
8148     * Rust is tested against a [LALR grammar][lalr], which parses
8149       almost all the Rust files that rustc does.
8150
8151 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8152 [close]: https://github.com/rust-lang/rust/pull/21843
8153 [deref]: https://github.com/rust-lang/rust/pull/21351
8154 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8155 [drop]: https://github.com/rust-lang/rust/pull/21972
8156 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8157 [feat]: https://github.com/rust-lang/rust/pull/21248
8158 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8159 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8160 [fmt]: https://github.com/rust-lang/rust/pull/21457
8161 [into]: https://github.com/rust-lang/rust/pull/20790
8162 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8163 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8164 [lalr]: https://github.com/rust-lang/rust/pull/21452
8165 [multiline]: https://github.com/rust-lang/rust/pull/19870
8166 [obj]: https://github.com/rust-lang/rust/pull/22230
8167 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8168 [onun]: https://github.com/rust-lang/rust/pull/20889
8169 [osstr]: https://github.com/rust-lang/rust/pull/21488
8170 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8171 [Self]: https://github.com/rust-lang/rust/pull/22158
8172 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8173 [un]: https://github.com/rust-lang/rust/pull/22256
8174
8175
8176 Version 1.0.0-alpha (2015-01-09)
8177 ==================================
8178
8179   * ~2400 changes, numerous bugfixes
8180
8181   * Highlights
8182
8183     * The language itself is considered feature complete for 1.0,
8184       though there will be many usability improvements and bugfixes
8185       before the final release.
8186     * Nearly 50% of the public API surface of the standard library has
8187       been declared 'stable'. Those interfaces are unlikely to change
8188       before 1.0.
8189     * The long-running debate over integer types has been
8190       [settled][ints]: Rust will ship with types named `isize` and
8191       `usize`, rather than `int` and `uint`, for pointer-sized
8192       integers. Guidelines will be rolled out during the alpha cycle.
8193     * Most crates that are not `std` have been moved out of the Rust
8194       distribution into the Cargo ecosystem so they can evolve
8195       separately and don't need to be stabilized as quickly, including
8196       'time', 'getopts', 'num', 'regex', and 'term'.
8197     * Documentation continues to be expanded with more API coverage, more
8198       examples, and more in-depth explanations. The guides have been
8199       consolidated into [The Rust Programming Language][trpl].
8200     * "[Rust By Example][rbe]" is now maintained by the Rust team.
8201     * All official Rust binary installers now come with [Cargo], the
8202       Rust package manager.
8203
8204 * Language
8205
8206     * Closures have been [completely redesigned][unboxed] to be
8207       implemented in terms of traits, can now be used as generic type
8208       bounds and thus monomorphized and inlined, or via an opaque
8209       pointer (boxed) as in the old system. The new system is often
8210       referred to as 'unboxed' closures.
8211     * Traits now support [associated types][assoc], allowing families
8212       of related types to be defined together and used generically in
8213       powerful ways.
8214     * Enum variants are [namespaced by their type names][enum].
8215     * [`where` clauses][where] provide a more versatile and attractive
8216       syntax for specifying generic bounds, though the previous syntax
8217       remains valid.
8218     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8219       numeric types.
8220     * Rust [no longer has a runtime][rt] of any description, and only
8221       supports OS threads, not green threads.
8222     * At long last, Rust has been overhauled for 'dynamically-sized
8223       types' ([DST]), which integrates 'fat pointers' (object types,
8224       arrays, and `str`) more deeply into the type system, making it
8225       more consistent.
8226     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8227       `..j` that produce range types and which, when combined with the
8228       `Index` operator and multidispatch, leads to a convenient slice
8229       notation, `[i..j]`.
8230     * The new range syntax revealed an ambiguity in the fixed-length
8231       array syntax, so now fixed length arrays [are written `[T;
8232       N]`][arrays].
8233     * The `Copy` trait is no longer implemented automatically. Unsafe
8234       pointers no longer implement `Sync` and `Send` so types
8235       containing them don't automatically either. `Sync` and `Send`
8236       are now 'unsafe traits' so one can "forcibly" implement them via
8237       `unsafe impl` if a type confirms to the requirements for them
8238       even though the internals do not (e.g. structs containing unsafe
8239       pointers like `Arc`). These changes are intended to prevent some
8240       footguns and are collectively known as [opt-in built-in
8241       traits][oibit] (though `Sync` and `Send` will soon become pure
8242       library types unknown to the compiler).
8243     * Operator traits now take their operands [by value][ops], and
8244       comparison traits can use multidispatch to compare one type
8245       against multiple other types, allowing e.g. `String` to be
8246       compared with `&str`.
8247     * `if let` and `while let` are no longer feature-gated.
8248     * Rust has adopted a more [uniform syntax for escaping unicode
8249       characters][unicode].
8250     * `macro_rules!` [has been declared stable][mac]. Though it is a
8251       flawed system it is sufficiently popular that it must be usable
8252       for 1.0. Effort has gone into [future-proofing][mac-future] it
8253       in ways that will allow other macro systems to be developed in
8254       parallel, and won't otherwise impact the evolution of the
8255       language.
8256     * The prelude has been [pared back significantly][prelude] such
8257       that it is the minimum necessary to support the most pervasive
8258       code patterns, and through [generalized where clauses][where]
8259       many of the prelude extension traits have been consolidated.
8260     * Rust's rudimentary reflection [has been removed][refl], as it
8261       incurred too much code generation for little benefit.
8262     * [Struct variants][structvars] are no longer feature-gated.
8263     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8264       known as 'higher-ranked trait bounds', this crucially allows
8265       unboxed closures to work.
8266     * Macros invocations surrounded by parens or square brackets and
8267       not terminated by a semicolon are [parsed as
8268       expressions][macros], which makes expressions like `vec![1i32,
8269       2, 3].len()` work as expected.
8270     * Trait objects now implement their traits automatically, and
8271       traits that can be coerced to objects now must be [object
8272       safe][objsafe].
8273     * Automatically deriving traits is now done with `#[derive(...)]`
8274       not `#[deriving(...)]` for [consistency with other naming
8275       conventions][derive].
8276     * Importing the containing module or enum at the same time as
8277       items or variants they contain is [now done with `self` instead
8278       of `mod`][self], as in use `foo::{self, bar}`
8279     * Glob imports are no longer feature-gated.
8280     * The `box` operator and `box` patterns have been feature-gated
8281       pending a redesign. For now unique boxes should be allocated
8282       like other containers, with `Box::new`.
8283
8284 * Libraries
8285
8286     * A [series][coll1] of [efforts][coll2] to establish
8287       [conventions][coll3] for collections types has resulted in API
8288       improvements throughout the standard library.
8289     * New [APIs for error handling][err] provide ergonomic interop
8290       between error types, and [new conventions][err-conv] describe
8291       more clearly the recommended error handling strategies in Rust.
8292     * The `fail!` macro has been renamed to [`panic!`][panic] so that
8293       it is easier to discuss failure in the context of error handling
8294       without making clarifications as to whether you are referring to
8295       the 'fail' macro or failure more generally.
8296     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8297       syscall when available.
8298     * The 'serialize' crate has been renamed 'rustc-serialize' and
8299       moved out of the distribution to Cargo. Although it is widely
8300       used now, it is expected to be superseded in the near future.
8301     * The `Show` formatter, typically implemented with
8302       `#[derive(Show)]` is [now requested with the `{:?}`
8303       specifier][show] and is intended for use by all types, for uses
8304       such as `println!` debugging. The new `String` formatter must be
8305       implemented by hand, uses the `{}` specifier, and is intended
8306       for full-fidelity conversions of things that can logically be
8307       represented as strings.
8308
8309 * Tooling
8310
8311     * [Flexible target specification][flex] allows rustc's code
8312       generation to be configured to support otherwise-unsupported
8313       platforms.
8314     * Rust comes with rust-gdb and rust-lldb scripts that launch their
8315       respective debuggers with Rust-appropriate pretty-printing.
8316     * The Windows installation of Rust is distributed with the
8317       MinGW components currently required to link binaries on that
8318       platform.
8319
8320 * Misc
8321
8322     * Nullable enum optimizations have been extended to more types so
8323       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8324       space than the inner types themselves.
8325     * Work has begun on supporting AArch64.
8326
8327 [Cargo]: https://crates.io
8328 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8329 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8330 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8331 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8332 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8333 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8334 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8335 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
8336 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8337 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8338 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8339 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8340 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8341 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8342 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8343 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8344 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8345 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8346 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8347 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8348 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8349 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8350 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8351 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8352 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8353 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8354 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8355 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8356 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8357 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8358 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
8359 [trpl]: https://doc.rust-lang.org/book/index.html
8360 [rbe]: http://rustbyexample.com/
8361
8362
8363 Version 0.12.0 (2014-10-09)
8364 =============================
8365
8366   * ~1900 changes, numerous bugfixes
8367
8368   * Highlights
8369
8370     * The introductory documentation (now called The Rust Guide) has
8371       been completely rewritten, as have a number of supplementary
8372       guides.
8373     * Rust's package manager, Cargo, continues to improve and is
8374       sometimes considered to be quite awesome.
8375     * Many API's in `std` have been reviewed and updated for
8376       consistency with the in-development Rust coding
8377       guidelines. The standard library documentation tracks
8378       stabilization progress.
8379     * Minor libraries have been moved out-of-tree to the rust-lang org
8380       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8381       be installed with Cargo.
8382     * Lifetime elision allows lifetime annotations to be left off of
8383       function declarations in many common scenarios.
8384     * Rust now works on 64-bit Windows.
8385
8386   * Language
8387     * Indexing can be overloaded with the `Index` and `IndexMut`
8388       traits.
8389     * The `if let` construct takes a branch only if the `let` pattern
8390       matches, currently behind the 'if_let' feature gate.
8391     * 'where clauses', a more flexible syntax for specifying trait
8392       bounds that is more aesthetic, have been added for traits and
8393       free functions. Where clauses will in the future make it
8394       possible to constrain associated types, which would be
8395       impossible with the existing syntax.
8396     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8397       the 'slicing_syntax' feature gate, and can be overloaded with
8398       the `Slice` or `SliceMut` traits.
8399     * The syntax for matching of sub-slices has been changed to use a
8400       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8401       consistency with other uses of `..` and to future-proof
8402       potential additional uses of the syntax.
8403     * The syntax for matching inclusive ranges in patterns has changed
8404       from `0..3` to `0...4` to be consistent with the exclusive range
8405       syntax for slicing.
8406     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
8407       c]`) has been put behind the 'advanced_slice_patterns' feature
8408       gate and may be removed in the future.
8409     * Components of tuples and tuple structs can be extracted using
8410       the `value.0` syntax, currently behind the `tuple_indexing`
8411       feature gate.
8412     * The `#[crate_id]` attribute is no longer supported; versioning
8413       is handled by the package manager.
8414     * Renaming crate imports are now written `extern crate foo as bar`
8415       instead of `extern crate bar = foo`.
8416     * Renaming use statements are now written `use foo as bar` instead
8417       of `use bar = foo`.
8418     * `let` and `match` bindings and argument names in macros are now
8419       hygienic.
8420     * The new, more efficient, closure types ('unboxed closures') have
8421       been added under a feature gate, 'unboxed_closures'. These will
8422       soon replace the existing closure types, once higher-ranked
8423       trait lifetimes are added to the language.
8424     * `move` has been added as a keyword, for indicating closures
8425       that capture by value.
8426     * Mutation and assignment is no longer allowed in pattern guards.
8427     * Generic structs and enums can now have trait bounds.
8428     * The `Share` trait is now called `Sync` to free up the term
8429       'shared' to refer to 'shared reference' (the default reference
8430       type.
8431     * Dynamically-sized types have been mostly implemented,
8432       unifying the behavior of fat-pointer types with the rest of the
8433       type system.
8434     * As part of dynamically-sized types, the `Sized` trait has been
8435       introduced, which qualifying types implement by default, and
8436       which type parameters expect by default. To specify that a type
8437       parameter does not need to be sized, write `<Sized? T>`. Most
8438       types are `Sized`, notable exceptions being unsized arrays
8439       (`[T]`) and trait types.
8440     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8441     * Lifetime bounds can now be applied to type parameters and object
8442       types.
8443     * The old, reference counted GC type, `Gc<T>` which was once
8444       denoted by the `@` sigil, has finally been removed. GC will be
8445       revisited in the future.
8446
8447   * Libraries
8448     * Library documentation has been improved for a number of modules.
8449     * Bit-vectors, collections::bitv has been modernized.
8450     * The url crate is deprecated in favor of
8451       http://github.com/servo/rust-url, which can be installed with
8452       Cargo.
8453     * Most I/O stream types can be cloned and subsequently closed from
8454       a different thread.
8455     * A `std::time::Duration` type has been added for use in I/O
8456       methods that rely on timers, as well as in the 'time' crate's
8457       `Timespec` arithmetic.
8458     * The runtime I/O abstraction layer that enabled the green thread
8459       scheduler to do non-thread-blocking I/O has been removed, along
8460       with the libuv-based implementation employed by the green thread
8461       scheduler. This will greatly simplify the future I/O work.
8462     * `collections::btree` has been rewritten to have a more
8463       idiomatic and efficient design.
8464
8465   * Tooling
8466     * rustdoc output now indicates the stability levels of API's.
8467     * The `--crate-name` flag can specify the name of the crate
8468       being compiled, like `#[crate_name]`.
8469     * The `-C metadata` specifies additional metadata to hash into
8470       symbol names, and `-C extra-filename` specifies additional
8471       information to put into the output filename, for use by the
8472       package manager for versioning.
8473     * debug info generation has continued to improve and should be
8474       more reliable under both gdb and lldb.
8475     * rustc has experimental support for compiling in parallel
8476       using the `-C codegen-units` flag.
8477     * rustc no longer encodes rpath information into binaries by
8478       default.
8479
8480   * Misc
8481     * Stack usage has been optimized with LLVM lifetime annotations.
8482     * Official Rust binaries on Linux are more compatible with older
8483       kernels and distributions, built on CentOS 5.10.
8484
8485
8486 Version 0.11.0 (2014-07-02)
8487 ==========================
8488
8489   * ~1700 changes, numerous bugfixes
8490
8491   * Language
8492     * ~[T] has been removed from the language. This type is superseded by
8493       the Vec<T> type.
8494     * ~str has been removed from the language. This type is superseded by
8495       the String type.
8496     * ~T has been removed from the language. This type is superseded by the
8497       Box<T> type.
8498     * @T has been removed from the language. This type is superseded by the
8499       standard library's std::gc::Gc<T> type.
8500     * Struct fields are now all private by default.
8501     * Vector indices and shift amounts are both required to be a `uint`
8502       instead of any integral type.
8503     * Byte character, byte string, and raw byte string literals are now all
8504       supported by prefixing the normal literal with a `b`.
8505     * Multiple ABIs are no longer allowed in an ABI string
8506     * The syntax for lifetimes on closures/procedures has been tweaked
8507       slightly: `<'a>|A, B|: 'b + K -> T`
8508     * Floating point modulus has been removed from the language; however it
8509       is still provided by a library implementation.
8510     * Private enum variants are now disallowed.
8511     * The `priv` keyword has been removed from the language.
8512     * A closure can no longer be invoked through a &-pointer.
8513     * The `use foo, bar, baz;` syntax has been removed from the language.
8514     * The transmute intrinsic no longer works on type parameters.
8515     * Statics now allow blocks/items in their definition.
8516     * Trait bounds are separated from objects with + instead of : now.
8517     * Objects can no longer be read while they are mutably borrowed.
8518     * The address of a static is now marked as insignificant unless the
8519       #[inline(never)] attribute is placed it.
8520     * The #[unsafe_destructor] attribute is now behind a feature gate.
8521     * Struct literals are no longer allowed in ambiguous positions such as
8522       if, while, match, and for..in.
8523     * Declaration of lang items and intrinsics are now feature-gated by
8524       default.
8525     * Integral literals no longer default to `int`, and floating point
8526       literals no longer default to `f64`. Literals must be suffixed with an
8527       appropriate type if inference cannot determine the type of the
8528       literal.
8529     * The Box<T> type is no longer implicitly borrowed to &mut T.
8530     * Procedures are now required to not capture borrowed references.
8531
8532   * Libraries
8533     * The standard library is now a "facade" over a number of underlying
8534       libraries. This means that development on the standard library should
8535       be speedier due to smaller crates, as well as a clearer line between
8536       all dependencies.
8537     * A new library, libcore, lives under the standard library's facade
8538       which is Rust's "0-assumption" library, suitable for embedded and
8539       kernel development for example.
8540     * A regex crate has been added to the standard distribution. This crate
8541       includes statically compiled regular expressions.
8542     * The unwrap/unwrap_err methods on Result require a Show bound for
8543       better error messages.
8544     * The return types of the std::comm primitives have been centralized
8545       around the Result type.
8546     * A number of I/O primitives have gained the ability to time out their
8547       operations.
8548     * A number of I/O primitives have gained the ability to close their
8549       reading/writing halves to cancel pending operations.
8550     * Reverse iterator methods have been removed in favor of `rev()` on
8551       their forward-iteration counterparts.
8552     * A bitflags! macro has been added to enable easy interop with C and
8553       management of bit flags.
8554     * A debug_assert! macro is now provided which is disabled when
8555       `--cfg ndebug` is passed to the compiler.
8556     * A graphviz crate has been added for creating .dot files.
8557     * The std::cast module has been migrated into std::mem.
8558     * The std::local_data api has been migrated from freestanding functions
8559       to being based on methods.
8560     * The Pod trait has been renamed to Copy.
8561     * jemalloc has been added as the default allocator for types.
8562     * The API for allocating memory has been changed to use proper alignment
8563       and sized deallocation
8564     * Connecting a TcpStream or binding a TcpListener is now based on a
8565       string address and a u16 port. This allows connecting to a hostname as
8566       opposed to an IP.
8567     * The Reader trait now contains a core method, read_at_least(), which
8568       correctly handles many repeated 0-length reads.
8569     * The process-spawning API is now centered around a builder-style
8570       Command struct.
8571     * The :? printing qualifier has been moved from the standard library to
8572       an external libdebug crate.
8573     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8574       have been renamed to Eq/Ord.
8575     * The select/plural methods have been removed from format!. The escapes
8576       for { and } have also changed from \{ and \} to {{ and }},
8577       respectively.
8578     * The TaskBuilder API has been re-worked to be a true builder, and
8579       extension traits for spawning native/green tasks have been added.
8580
8581   * Tooling
8582     * All breaking changes to the language or libraries now have their
8583       commit message annotated with `[breaking-change]` to allow for easy
8584       discovery of breaking changes.
8585     * The compiler will now try to suggest how to annotate lifetimes if a
8586       lifetime-related error occurs.
8587     * Debug info continues to be improved greatly with general bug fixes and
8588       better support for situations like link time optimization (LTO).
8589     * Usage of syntax extensions when cross-compiling has been fixed.
8590     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8591       -fdata-sections and --gc-sections has been enabled by default
8592     * The compiler is now stricter about where it will load module files
8593       from when a module is declared via `mod foo;`.
8594     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8595       Syntax extensions are now discovered via a "plugin registrar" type
8596       which will be extended in the future to other various plugins.
8597     * Lints have been restructured to allow for dynamically loadable lints.
8598     * A number of rustdoc improvements:
8599       * The HTML output has been visually redesigned.
8600       * Markdown is now powered by hoedown instead of sundown.
8601       * Searching heuristics have been greatly improved.
8602       * The search index has been reduced in size by a great amount.
8603       * Cross-crate documentation via `pub use` has been greatly improved.
8604       * Primitive types are now hyperlinked and documented.
8605     * Documentation has been moved from static.rust-lang.org/doc to
8606       doc.rust-lang.org
8607     * A new sandbox, play.rust-lang.org, is available for running and
8608       sharing rust code examples on-line.
8609     * Unused attributes are now more robustly warned about.
8610     * The dead_code lint now warns about unused struct fields.
8611     * Cross-compiling to iOS is now supported.
8612     * Cross-compiling to mipsel is now supported.
8613     * Stability attributes are now inherited by default and no longer apply
8614       to intra-crate usage, only inter-crate usage.
8615     * Error message related to non-exhaustive match expressions have been
8616       greatly improved.
8617
8618
8619 Version 0.10 (2014-04-03)
8620 =========================
8621
8622   * ~1500 changes, numerous bugfixes
8623
8624   * Language
8625     * A new RFC process is now in place for modifying the language.
8626     * Patterns with `@`-pointers have been removed from the language.
8627     * Patterns with unique vectors (`~[T]`) have been removed from the
8628       language.
8629     * Patterns with unique strings (`~str`) have been removed from the
8630       language.
8631     * `@str` has been removed from the language.
8632     * `@[T]` has been removed from the language.
8633     * `@self` has been removed from the language.
8634     * `@Trait` has been removed from the language.
8635     * Headers on `~` allocations which contain `@` boxes inside the type for
8636       reference counting have been removed.
8637     * The semantics around the lifetimes of temporary expressions have changed,
8638       see #3511 and #11585 for more information.
8639     * Cross-crate syntax extensions are now possible, but feature gated. See
8640       #11151 for more information. This includes both `macro_rules!` macros as
8641       well as syntax extensions such as `format!`.
8642     * New lint modes have been added, and older ones have been turned on to be
8643       warn-by-default.
8644       * Unnecessary parentheses
8645       * Uppercase statics
8646       * Camel Case types
8647       * Uppercase variables
8648       * Publicly visible private types
8649       * `#[deriving]` with raw pointers
8650     * Unsafe functions can no longer be coerced to closures.
8651     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8652     * The `#[simd]` attribute is now behind a feature gate.
8653     * Visibility is no longer allowed on `extern crate` statements, and
8654       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8655     * Trailing commas are now allowed in argument lists and tuple patterns.
8656     * The `do` keyword has been removed, it is now a reserved keyword.
8657     * Default type parameters have been implemented, but are feature gated.
8658     * Borrowed variables through captures in closures are now considered soundly.
8659     * `extern mod` is now `extern crate`
8660     * The `Freeze` trait has been removed.
8661     * The `Share` trait has been added for types that can be shared among
8662       threads.
8663     * Labels in macros are now hygienic.
8664     * Expression/statement macro invocations can be delimited with `{}` now.
8665     * Treatment of types allowed in `static mut` locations has been tweaked.
8666     * The `*` and `.` operators are now overloadable through the `Deref` and
8667       `DerefMut` traits.
8668     * `~Trait` and `proc` no longer have `Send` bounds by default.
8669     * Partial type hints are now supported with the `_` type marker.
8670     * An `Unsafe` type was introduced for interior mutability. It is now
8671       considered undefined to transmute from `&T` to `&mut T` without using the
8672       `Unsafe` type.
8673     * The #[linkage] attribute was implemented for extern statics/functions.
8674     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8675     * `Pod` was renamed to `Copy`.
8676
8677   * Libraries
8678     * The `libextra` library has been removed. It has now been decomposed into
8679       component libraries with smaller and more focused nuggets of
8680       functionality. The full list of libraries can be found on the
8681       documentation index page.
8682     * std: `std::condition` has been removed. All I/O errors are now propagated
8683       through the `Result` type. In order to assist with error handling, a
8684       `try!` macro for unwrapping errors with an early return and a lint for
8685       unused results has been added. See #12039 for more information.
8686     * std: The `vec` module has been renamed to `slice`.
8687     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8688       This will become the only growable vector in the future.
8689     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
8690       are now found at `std::io::BufferedReader` instead of
8691       `std::io::buffered::BufferedReader`.
8692     * std: `print` and `println` are no longer in the prelude, the `print!` and
8693       `println!` macros are intended to be used instead.
8694     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8695       attempts to statically prevent cycles.
8696     * std: The standard distribution is adopting the policy of pushing failure
8697       to the user rather than failing in libraries. Many functions (such as
8698       `slice::last()`) now return `Option<T>` instead of `T` + failing.
8699     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8700       deriving mode: `#[deriving(Show)]`.
8701     * std: `ToStr` is now implemented for all types implementing `Show`.
8702     * std: The formatting trait methods now take `&self` instead of `&T`
8703     * std: The `invert()` method on iterators has been renamed to `rev()`
8704     * std: `std::num` has seen a reduction in the genericity of its traits,
8705       consolidating functionality into a few core traits.
8706     * std: Backtraces are now printed on task failure if the environment
8707       variable `RUST_BACKTRACE` is present.
8708     * std: Naming conventions for iterators have been standardized. More details
8709       can be found on the wiki's style guide.
8710     * std: `eof()` has been removed from the `Reader` trait. Specific types may
8711       still implement the function.
8712     * std: Networking types are now cloneable to allow simultaneous reads/writes.
8713     * std: `assert_approx_eq!` has been removed
8714     * std: The `e` and `E` formatting specifiers for floats have been added to
8715       print them in exponential notation.
8716     * std: The `Times` trait has been removed
8717     * std: Indications of variance and opting out of builtin bounds is done
8718       through marker types in `std::kinds::marker` now
8719     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8720       `#[deriving(Hash)]` is now possible.
8721     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8722     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8723     * std: `Chan::new` is now `channel()`.
8724     * std: A new synchronous channel type has been implemented.
8725     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8726     * std: `hashmap` and `trie` have been moved to `libcollections`
8727     * std: `run` has been rolled into `io::process`
8728     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8729     * std: The equality and comparison traits have seen some reorganization.
8730     * std: `rand` has moved to `librand`.
8731     * std: `to_{lower,upper}case` has been implemented for `char`.
8732     * std: Logging has been moved to `liblog`.
8733     * collections: `HashMap` has been rewritten for higher performance and less
8734       memory usage.
8735     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8736       it can be booted manually. The runtime guide has more information and
8737       examples.
8738     * native: All I/O functionality except signals has been implemented.
8739     * green: Task spawning with `libgreen` has been optimized with stack caching
8740       and various trimming of code.
8741     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8742     * sync: The `extra::sync` module has been updated to modern rust (and moved
8743       to the `sync` library), tweaking and improving various interfaces while
8744       dropping redundant functionality.
8745     * sync: A new `Barrier` type has been added to the `sync` library.
8746     * sync: An efficient mutex for native and green tasks has been implemented.
8747     * serialize: The `base64` module has seen some improvement. It treats
8748       newlines better, has non-string error values, and has seen general
8749       cleanup.
8750     * fourcc: A `fourcc!` macro was introduced
8751     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8752       hexadecimal literal.
8753
8754   * Tooling
8755     * `rustpkg` has been deprecated and removed from the main repository. Its
8756       replacement, `cargo`, is under development.
8757     * Nightly builds of rust are now available
8758     * The memory usage of rustc has been improved many times throughout this
8759       release cycle.
8760     * The build process supports disabling rpath support for the rustc binary
8761       itself.
8762     * Code generation has improved in some cases, giving more information to the
8763       LLVM optimization passes to enable more extensive optimizations.
8764     * Debuginfo compatibility with lldb on OSX has been restored.
8765     * The master branch is now gated on an android bot, making building for
8766       android much more reliable.
8767     * Output flags have been centralized into one `--emit` flag.
8768     * Crate type flags have been centralized into one `--crate-type` flag.
8769     * Codegen flags have been consolidated behind a `-C` flag.
8770     * Linking against outdated crates now has improved error messages.
8771     * Error messages with lifetimes will often suggest how to annotate the
8772       function to fix the error.
8773     * Many more types are documented in the standard library, and new guides
8774       were written.
8775     * Many `rustdoc` improvements:
8776       * code blocks are syntax highlighted.
8777       * render standalone markdown files.
8778       * the --test flag tests all code blocks by default.
8779       * exported macros are displayed.
8780       * re-exported types have their documentation inlined at the location of the
8781         first re-export.
8782       * search works across crates that have been rendered to the same output
8783         directory.
8784
8785
8786 Version 0.9 (2014-01-09)
8787 ==========================
8788
8789    * ~1800 changes, numerous bugfixes
8790
8791    * Language
8792       * The `float` type has been removed. Use `f32` or `f64` instead.
8793       * A new facility for enabling experimental features (feature gating) has
8794         been added, using the crate-level `#[feature(foo)]` attribute.
8795       * Managed boxes (@) are now behind a feature gate
8796         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8797         standard library's `Gc` or `Rc` types instead.
8798       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8799       * Jumping back to the top of a loop is now done with `continue` instead of
8800         `loop`.
8801       * Strings can no longer be mutated through index assignment.
8802       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8803         hash delimiters, as in `r###"foo"###`.
8804       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8805         called once.
8806       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8807       * `@fn`s have been removed.
8808       * `do` only works with procs in order to make it obvious what the cost
8809         of `do` is.
8810       * Single-element tuple-like structs can no longer be dereferenced to
8811         obtain the inner value. A more comprehensive solution for overloading
8812         the dereference operator will be provided in the future.
8813       * The `#[link(...)]` attribute has been replaced with
8814         `#[crate_id = "name#vers"]`.
8815       * Empty `impl`s must be terminated with empty braces and may not be
8816         terminated with a semicolon.
8817       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8818         no longer has any special meaning.
8819       * The old `fmt!` string formatting macro has been removed.
8820       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8821         `print!` and `println!`.
8822       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8823       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8824         `extern mod foo = "bar"` instead.
8825       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8826       * Macros can have attributes.
8827       * Macros can expand to items with attributes.
8828       * Macros can expand to multiple items.
8829       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8830       * Comments may be nested.
8831       * Values automatically coerce to trait objects they implement, without
8832         an explicit `as`.
8833       * Enum discriminants are no longer an entire word but as small as needed to
8834         contain all the variants. The `repr` attribute can be used to override
8835         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8836         `#[repr(C)]` to match C enums.
8837       * Non-string literals are not allowed in attributes (they never worked).
8838       * The FFI now supports variadic functions.
8839       * Octal numeric literals, as in `0o7777`.
8840       * The `concat!` syntax extension performs compile-time string concatenation.
8841       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8842         removed as Rust no longer uses segmented stacks.
8843       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8844       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8845         not `*`; ignoring remaining fields of a struct is also done with `..`,
8846         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8847       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8848       * `rustc` supports the "system" calling convention, which defaults to the
8849         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8850         "C" elsewhere.
8851       * The `type_overflow` lint (default: warn) checks literals for overflow.
8852       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8853       * The `attribute_usage` lint (default: warn) warns about unknown
8854         attributes.
8855       * The `unknown_features` lint (default: warn) warns about unknown
8856         feature gates.
8857       * The `dead_code` lint (default: warn) checks for dead code.
8858       * Rust libraries can be linked statically to one another
8859       * `#[link_args]` is behind the `link_args` feature gate.
8860       * Native libraries are now linked with `#[link(name = "foo")]`
8861       * Native libraries can be statically linked to a rust crate
8862         (`#[link(name = "foo", kind = "static")]`).
8863       * Native OS X frameworks are now officially supported
8864         (`#[link(name = "foo", kind = "framework")]`).
8865       * The `#[thread_local]` attribute creates thread-local (not task-local)
8866         variables. Currently behind the `thread_local` feature gate.
8867       * The `return` keyword may be used in closures.
8868       * Types that can be copied via a memcpy implement the `Pod` kind.
8869       * The `cfg` attribute can now be used on struct fields and enum variants.
8870
8871    * Libraries
8872       * std: The `option` and `result` API's have been overhauled to make them
8873         simpler, more consistent, and more composable.
8874       * std: The entire `std::io` module has been replaced with one that is
8875         more comprehensive and that properly interfaces with the underlying
8876         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8877         implemented.
8878       * std: `io::util` contains a number of useful implementations of
8879         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8880         `ZeroReader`, `TeeReader`.
8881       * std: The reference counted pointer type `extra::rc` moved into std.
8882       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8883         just a wrapper around it).
8884       * std: The `Either` type has been removed.
8885       * std: `fmt::Default` can be implemented for any type to provide default
8886         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8887       * std: The `rand` API continues to be tweaked.
8888       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8889         on failure in gdb, is now named `rust_fail`.
8890       * std: The `each_key` and `each_value` methods on `HashMap` have been
8891         replaced by the `keys` and `values` iterators.
8892       * std: Functions dealing with type size and alignment have moved from the
8893         `sys` module to the `mem` module.
8894       * std: The `path` module was written and API changed.
8895       * std: `str::from_utf8` has been changed to cast instead of allocate.
8896       * std: `starts_with` and `ends_with` methods added to vectors via the
8897         `ImmutableEqVector` trait, which is in the prelude.
8898       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8899         if the index is out of bounds.
8900       * std: Task failure no longer propagates between tasks, as the model was
8901         complex, expensive, and incompatible with thread-based tasks.
8902       * std: The `Any` type can be used for dynamic typing.
8903       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8904         `task::try`.
8905       * std: Methods that produce iterators generally do not have an `_iter`
8906         suffix now.
8907       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8908         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8909       * std: `util::ignore` renamed to `prelude::drop`.
8910       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8911         trait.
8912       * std: `vec::raw` has seen a lot of cleanup and API changes.
8913       * std: The standard library no longer includes any C++ code, and very
8914         minimal C, eliminating the dependency on libstdc++.
8915       * std: Runtime scheduling and I/O functionality has been factored out into
8916         extensible interfaces and is now implemented by two different crates:
8917         libnative, for native threading and I/O; and libgreen, for green threading
8918         and I/O. This paves the way for using the standard library in more limited
8919         embedded environments.
8920       * std: The `comm` module has been rewritten to be much faster, have a
8921         simpler, more consistent API, and to work for both native and green
8922         threading.
8923       * std: All libuv dependencies have been moved into the rustuv crate.
8924       * native: New implementations of runtime scheduling on top of OS threads.
8925       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8926         and other I/O.
8927       * green: The green thread scheduler and message passing types are almost
8928         entirely lock-free.
8929       * extra: The `flatpipes` module had bitrotted and was removed.
8930       * extra: All crypto functions have been removed and Rust now has a policy of
8931         not reimplementing crypto in the standard library. In the future crypto
8932         will be provided by external crates with bindings to established libraries.
8933       * extra: `c_vec` has been modernized.
8934       * extra: The `sort` module has been removed. Use the `sort` method on
8935         mutable slices.
8936
8937    * Tooling
8938       * The `rust` and `rusti` commands have been removed, due to lack of
8939         maintenance.
8940       * `rustdoc` was completely rewritten.
8941       * `rustdoc` can test code examples in documentation.
8942       * `rustpkg` can test packages with the argument, 'test'.
8943       * `rustpkg` supports arbitrary dependencies, including C libraries.
8944       * `rustc`'s support for generating debug info is improved again.
8945       * `rustc` has better error reporting for unbalanced delimiters.
8946       * `rustc`'s JIT support was removed due to bitrot.
8947       * Executables and static libraries can be built with LTO (-Z lto)
8948       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8949         build tools.
8950
8951
8952 Version 0.8 (2013-09-26)
8953 ============================
8954
8955    * ~2200 changes, numerous bugfixes
8956
8957    * Language
8958       * The `for` loop syntax has changed to work with the `Iterator` trait.
8959       * At long last, unwinding works on Windows.
8960       * Default methods are ready for use.
8961       * Many trait inheritance bugs fixed.
8962       * Owned and borrowed trait objects work more reliably.
8963       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8964       * rustc can omit emission of code for the `debug!` macro if it is passed
8965         `--cfg ndebug`
8966       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8967         for foo.rs, then foo/mod.rs, and will generate an error when both are
8968         present.
8969       * Strings no longer contain trailing nulls. The new `std::c_str` module
8970         provides new mechanisms for converting to C strings.
8971       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8972       * The FFI has been overhauled such that foreign functions are called directly,
8973         instead of through a stack-switching wrapper.
8974       * Calling a foreign function must be done through a Rust function with the
8975         `#[fixed_stack_segment]` attribute.
8976       * The `externfn!` macro can be used to declare both a foreign function and
8977         a `#[fixed_stack_segment]` wrapper at once.
8978       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8979       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8980       * `priv` is disallowed everywhere except for struct fields and enum variants.
8981       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8982       * `ref` bindings in irrefutable patterns work correctly now.
8983       * `char` is now prevented from containing invalid code points.
8984       * Casting to `bool` is no longer allowed.
8985       * `\0` is now accepted as an escape in chars and strings.
8986       * `yield` is a reserved keyword.
8987       * `typeof` is a reserved keyword.
8988       * Crates may be imported by URL with `extern mod foo = "url";`.
8989       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8990       * Static vectors can be initialized with repeating elements,
8991         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8992       * Static structs can be initialized with functional record update,
8993         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8994       * `cfg!` can be used to conditionally execute code based on the crate
8995         configuration, similarly to `#[cfg(...)]`.
8996       * The `unnecessary_qualification` lint detects unneeded module
8997         prefixes (default: allow).
8998       * Arithmetic operations have been implemented on the SIMD types in
8999         `std::unstable::simd`.
9000       * Exchange allocation headers were removed, reducing memory usage.
9001       * `format!` implements a completely new, extensible, and higher-performance
9002         string formatting system. It will replace `fmt!`.
9003       * `print!` and `println!` write formatted strings (using the `format!`
9004         extension) to stdout.
9005       * `write!` and `writeln!` write formatted strings (using the `format!`
9006         extension) to the new Writers in `std::rt::io`.
9007       * The library section in which a function or static is placed may
9008         be specified with `#[link_section = "..."]`.
9009       * The `proto!` syntax extension for defining bounded message protocols
9010         was removed.
9011       * `macro_rules!` is hygienic for `let` declarations.
9012       * The `#[export_name]` attribute specifies the name of a symbol.
9013       * `unreachable!` can be used to indicate unreachable code, and fails
9014         if executed.
9015
9016    * Libraries
9017       * std: Transitioned to the new runtime, written in Rust.
9018       * std: Added an experimental I/O library, `rt::io`, based on the new
9019         runtime.
9020       * std: A new generic `range` function was added to the prelude, replacing
9021         `uint::range` and friends.
9022       * std: `range_rev` no longer exists. Since range is an iterator it can be
9023         reversed with `range(lo, hi).invert()`.
9024       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9025         renamed to `unwrap_or`.
9026       * std: The `iterator` module was renamed to `iter`.
9027       * std: Integral types now support the `checked_add`, `checked_sub`, and
9028         `checked_mul` operations for detecting overflow.
9029       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9030         consistency.
9031       * std: Methods are standardizing on conventions for casting methods:
9032         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9033         and cheap casts.
9034       * std: The `CString` type in `c_str` provides new ways to convert to and
9035         from C strings.
9036       * std: `DoubleEndedIterator` can yield elements in two directions.
9037       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9038         two splices.
9039       * std: `str::from_bytes` renamed to `str::from_utf8`.
9040       * std: `pop_opt` and `shift_opt` methods added to vectors.
9041       * std: The task-local data interface no longer uses @, and keys are
9042         no longer function pointers.
9043       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9044       * std: Added `SharedPort` to `comm`.
9045       * std: `Eq` has a default method for `ne`; only `eq` is required
9046         in implementations.
9047       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9048         is required in implementations.
9049       * std: `is_utf8` performance is improved, impacting many string functions.
9050       * std: `os::MemoryMap` provides cross-platform mmap.
9051       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9052         are not 'in-bounds' are considered undefined.
9053       * std: Many freestanding functions in `vec` removed in favor of methods.
9054       * std: Many freestanding functions on scalar types removed in favor of
9055         methods.
9056       * std: Many options to task builders were removed since they don't make
9057         sense in the new scheduler design.
9058       * std: More containers implement `FromIterator` so can be created by the
9059         `collect` method.
9060       * std: More complete atomic types in `unstable::atomics`.
9061       * std: `comm::PortSet` removed.
9062       * std: Mutating methods in the `Set` and `Map` traits have been moved into
9063         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9064         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9065         default implementations.
9066       * std: Various `from_str` functions were removed in favor of a generic
9067         `from_str` which is available in the prelude.
9068       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9069       * extra: `dlist`, the doubly-linked list was modernized.
9070       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9071       * extra: Added `glob` module, replacing `std::os::glob`.
9072       * extra: `rope` was removed.
9073       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9074       * extra: `net`, and `timer` were removed. The experimental replacements
9075         are `std::rt::io::net` and `std::rt::io::timer`.
9076       * extra: Iterators implemented for `SmallIntMap`.
9077       * extra: Iterators implemented for `Bitv` and `BitvSet`.
9078       * extra: `SmallIntSet` removed. Use `BitvSet`.
9079       * extra: Performance of JSON parsing greatly improved.
9080       * extra: `semver` updated to SemVer 2.0.0.
9081       * extra: `term` handles more terminals correctly.
9082       * extra: `dbg` module removed.
9083       * extra: `par` module removed.
9084       * extra: `future` was cleaned up, with some method renames.
9085       * extra: Most free functions in `getopts` were converted to methods.
9086
9087    * Other
9088       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9089       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9090         similarly to gcc's `--march` flag.
9091       * rustc's performance compiling small crates is much better.
9092       * rustpkg has received many improvements.
9093       * rustpkg supports git tags as package IDs.
9094       * rustpkg builds into target-specific directories so it can be used for
9095         cross-compiling.
9096       * The number of concurrent test tasks is controlled by the environment
9097         variable RUST_TEST_TASKS.
9098       * The test harness can now report metrics for benchmarks.
9099       * All tools have man pages.
9100       * Programs compiled with `--test` now support the `-h` and `--help` flags.
9101       * The runtime uses jemalloc for allocations.
9102       * Segmented stacks are temporarily disabled as part of the transition to
9103         the new runtime. Stack overflows are possible!
9104       * A new documentation backend, rustdoc_ng, is available for use. It is
9105         still invoked through the normal `rustdoc` command.
9106
9107
9108 Version 0.7 (2013-07-03)
9109 =======================
9110
9111    * ~2000 changes, numerous bugfixes
9112
9113    * Language
9114       * `impl`s no longer accept a visibility qualifier. Put them on methods
9115         instead.
9116       * The borrow checker has been rewritten with flow-sensitivity, fixing
9117         many bugs and inconveniences.
9118       * The `self` parameter no longer implicitly means `&'self self`,
9119         and can be explicitly marked with a lifetime.
9120       * Overloadable compound operators (`+=`, etc.) have been temporarily
9121         removed due to bugs.
9122       * The `for` loop protocol now requires `for`-iterators to return `bool`
9123         so they compose better.
9124       * The `Durable` trait is replaced with the `'static` bounds.
9125       * Trait default methods work more often.
9126       * Structs with the `#[packed]` attribute have byte alignment and
9127         no padding between fields.
9128       * Type parameters bound by `Copy` must now be copied explicitly with
9129         the `copy` keyword.
9130       * It is now illegal to move out of a dereferenced unsafe pointer.
9131       * `Option<~T>` is now represented as a nullable pointer.
9132       * `@mut` does dynamic borrow checks correctly.
9133       * The `main` function is only detected at the topmost level of the crate.
9134         The `#[main]` attribute is still valid anywhere.
9135       * Struct fields may no longer be mutable. Use inherited mutability.
9136       * The `#[no_send]` attribute makes a type that would otherwise be
9137         `Send`, not.
9138       * The `#[no_freeze]` attribute makes a type that would otherwise be
9139         `Freeze`, not.
9140       * Unbounded recursion will abort the process after reaching the limit
9141         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9142       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9143         are never implicitly copyable.
9144       * `#[static_assert]` makes compile-time assertions about static bools.
9145       * At long last, 'argument modes' no longer exist.
9146       * The rarely used `use mod` statement no longer exists.
9147
9148    * Syntax extensions
9149       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9150         argument list.
9151       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9152         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9153         `#[deriving(...)]`.
9154       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9155         and unsuffixed integer literals.
9156
9157    * Libraries
9158       * The `core` crate was renamed to `std`.
9159       * The `std` crate was renamed to `extra`.
9160       * More and improved documentation.
9161       * std: `iterator` module for external iterator objects.
9162       * Many old-style (internal, higher-order function) iterators replaced by
9163         implementations of `Iterator`.
9164       * std: Many old internal vector and string iterators,
9165         incl. `any`, `all`. removed.
9166       * std: The `finalize` method of `Drop` renamed to `drop`.
9167       * std: The `drop` method now takes `&mut self` instead of `&self`.
9168       * std: The prelude no longer re-exports any modules, only types and traits.
9169       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9170         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9171       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9172         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9173       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9174         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9175       * std: Many types implement `Clone`.
9176       * std: `path` type renamed to `Path`.
9177       * std: `mut` module and `Mut` type removed.
9178       * std: Many standalone functions removed in favor of methods and iterators
9179         in `vec`, `str`. In the future methods will also work as functions.
9180       * std: `reinterpret_cast` removed. Use `transmute`.
9181       * std: ascii string handling in `std::ascii`.
9182       * std: `Rand` is implemented for ~/@.
9183       * std: `run` module for spawning processes overhauled.
9184       * std: Various atomic types added to `unstable::atomic`.
9185       * std: Various types implement `Zero`.
9186       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9187       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9188       * std: Added `os::mkdir_recursive`.
9189       * std: Added `os::glob` function performs filesystems globs.
9190       * std: `FuzzyEq` renamed to `ApproxEq`.
9191       * std: `Map` now defines `pop` and `swap` methods.
9192       * std: `Cell` constructors converted to static methods.
9193       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9194       * extra: `flate` module moved from `std` to `extra`.
9195       * extra: `fileinput` module for iterating over a series of files.
9196       * extra: `Complex` number type and `complex` module.
9197       * extra: `Rational` number type and `rational` module.
9198       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9199       * extra: `term` uses terminfo now, is more correct.
9200       * extra: `arc` functions converted to methods.
9201       * extra: Implementation of fixed output size variations of SHA-2.
9202
9203    * Tooling
9204       * `unused_variables` lint mode for unused variables (default: warn).
9205       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9206         (default: warn).
9207       * `unused_mut` lint mode for identifying unused `mut` qualifiers
9208         (default: warn).
9209       * `dead_assignment` lint mode for unread variables (default: warn).
9210       * `unnecessary_allocation` lint mode detects some heap allocations that are
9211         immediately borrowed so could be written without allocating (default: warn).
9212       * `missing_doc` lint mode (default: allow).
9213       * `unreachable_code` lint mode (default: warn).
9214       * The `rusti` command has been rewritten and a number of bugs addressed.
9215       * rustc outputs in color on more terminals.
9216       * rustc accepts a `--link-args` flag to pass arguments to the linker.
9217       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9218       * Compiling with `-g` will make the binary record information about
9219         dynamic borrowcheck failures for debugging.
9220       * rustdoc has a nicer stylesheet.
9221       * Various improvements to rustdoc.
9222       * Improvements to rustpkg (see the detailed release notes).
9223
9224
9225 Version 0.6 (2013-04-03)
9226 ========================
9227
9228    * ~2100 changes, numerous bugfixes
9229
9230    * Syntax changes
9231       * The self type parameter in traits is now spelled `Self`
9232       * The `self` parameter in trait and impl methods must now be explicitly
9233         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9234       * Static methods no longer require the `static` keyword and instead
9235         are distinguished by the lack of a `self` parameter
9236       * Replaced the `Durable` trait with the `'static` lifetime
9237       * The old closure type syntax with the trailing sigil has been
9238         removed in favor of the more consistent leading sigil
9239       * `super` is a keyword, and may be prefixed to paths
9240       * Trait bounds are separated with `+` instead of whitespace
9241       * Traits are implemented with `impl Trait for Type`
9242         instead of `impl Type: Trait`
9243       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9244       * The `export` keyword has finally been removed
9245       * The `move` keyword has been removed (see "Semantic changes")
9246       * The interior mutability qualifier on vectors, `[mut T]`, has been
9247         removed. Use `&mut [T]`, etc.
9248       * `mut` is no longer valid in `~mut T`. Use inherited mutability
9249       * `fail` is no longer a keyword. Use `fail!()`
9250       * `assert` is no longer a keyword. Use `assert!()`
9251       * `log` is no longer a keyword. use `debug!`, etc.
9252       * 1-tuples may be represented as `(T,)`
9253       * Struct fields may no longer be `mut`. Use inherited mutability,
9254         `@mut T`, `core::mut` or `core::cell`
9255       * `extern mod { ... }` is no longer valid syntax for foreign
9256         function modules. Use extern blocks: `extern { ... }`
9257       * Newtype enums removed. Use tuple-structs.
9258       * Trait implementations no longer support visibility modifiers
9259       * Pattern matching over vectors improved and expanded
9260       * `const` renamed to `static` to correspond to lifetime name,
9261         and make room for future `static mut` unsafe mutable globals.
9262       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9263       * `Clone` implementations can be automatically generated with
9264         `#[deriving(Clone)]`
9265       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9266         instead of `foo as Bar`.
9267       * Fixed length vector types are now written as `[int, .. 3]`
9268         instead of `[int * 3]`.
9269       * Fixed length vector types can express the length as a constant
9270         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9271
9272    * Semantic changes
9273       * Types with owned pointers or custom destructors move by default,
9274         eliminating the `move` keyword
9275       * All foreign functions are considered unsafe
9276       * &mut is now unaliasable
9277       * Writes to borrowed @mut pointers are prevented dynamically
9278       * () has size 0
9279       * The name of the main function can be customized using #[main]
9280       * The default type of an inferred closure is &fn instead of @fn
9281       * `use` statements may no longer be "chained" - they cannot import
9282         identifiers imported by previous `use` statements
9283       * `use` statements are crate relative, importing from the "top"
9284         of the crate by default. Paths may be prefixed with `super::`
9285         or `self::` to change the search behavior.
9286       * Method visibility is inherited from the implementation declaration
9287       * Structural records have been removed
9288       * Many more types can be used in static items, including enums
9289         'static-lifetime pointers and vectors
9290       * Pattern matching over vectors improved and expanded
9291       * Typechecking of closure types has been overhauled to
9292         improve inference and eliminate unsoundness
9293       * Macros leave scope at the end of modules, unless that module is
9294         tagged with #[macro_escape]
9295
9296    * Libraries
9297       * Added big integers to `std::bigint`
9298       * Removed `core::oldcomm` module
9299       * Added pipe-based `core::comm` module
9300       * Numeric traits have been reorganized under `core::num`
9301       * `vec::slice` finally returns a slice
9302       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9303       * Containers reorganized around traits in `core::container`
9304       * `core::dvec` removed, `~[T]` is a drop-in replacement
9305       * `core::send_map` renamed to `core::hashmap`
9306       * `std::map` removed; replaced with `core::hashmap`
9307       * `std::treemap` reimplemented as an owned balanced tree
9308       * `std::deque` and `std::smallintmap` reimplemented as owned containers
9309       * `core::trie` added as a fast ordered map for integer keys
9310       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9311       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9312         overload the comparison operators, whereas `TotalOrd` is used
9313         by certain container types
9314
9315    * Other
9316       * Replaced the 'cargo' package manager with 'rustpkg'
9317       * Added all-purpose 'rust' tool
9318       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9319       * rustc now *attempts* to offer spelling suggestions
9320       * Improved support for ARM and Android
9321       * Preliminary MIPS backend
9322       * Improved foreign function ABI implementation for x86, x86_64
9323       * Various memory usage improvements
9324       * Rust code may be embedded in foreign code under limited circumstances
9325       * Inline assembler supported by new asm!() syntax extension.
9326
9327
9328 Version 0.5 (2012-12-21)
9329 ===========================
9330
9331    * ~900 changes, numerous bugfixes
9332
9333    * Syntax changes
9334       * Removed `<-` move operator
9335       * Completed the transition from the `#fmt` extension syntax to `fmt!`
9336       * Removed old fixed length vector syntax - `[T]/N`
9337       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9338       * Macros may now expand to items and statements
9339       * `a.b()` is always parsed as a method call, never as a field projection
9340       * `Eq` and `IterBytes` implementations can be automatically generated
9341         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9342       * Removed the special crate language for `.rc` files
9343       * Function arguments may consist of any irrefutable pattern
9344
9345    * Semantic changes
9346       * `&` and `~` pointers may point to objects
9347       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9348       * Enum variants may be structs
9349       * Destructors can be added to all nominal types with the Drop trait
9350       * Structs and nullary enum variants may be constants
9351       * Values that cannot be implicitly copied are now automatically moved
9352         without writing `move` explicitly
9353       * `&T` may now be coerced to `*T`
9354       * Coercions happen in `let` statements as well as function calls
9355       * `use` statements now take crate-relative paths
9356       * The module and type namespaces have been merged so that static
9357         method names can be resolved under the trait in which they are
9358         declared
9359
9360    * Improved support for language features
9361       * Trait inheritance works in many scenarios
9362       * More support for explicit self arguments in methods - `self`, `&self`
9363         `@self`, and `~self` all generally work as expected
9364       * Static methods work in more situations
9365       * Experimental: Traits may declare default methods for the implementations
9366         to use
9367
9368    * Libraries
9369       * New condition handling system in `core::condition`
9370       * Timsort added to `std::sort`
9371       * New priority queue, `std::priority_queue`
9372       * Pipes for serializable types, `std::flatpipes'
9373       * Serialization overhauled to be trait-based
9374       * Expanded `getopts` definitions
9375       * Moved futures to `std`
9376       * More functions are pure now
9377       * `core::comm` renamed to `oldcomm`. Still deprecated
9378       * `rustdoc` and `cargo` are libraries now
9379
9380    * Misc
9381       * Added a preliminary REPL, `rusti`
9382       * License changed from MIT to dual MIT/APL2
9383
9384
9385 Version 0.4 (2012-10-15)
9386 ==========================
9387
9388    * ~2000 changes, numerous bugfixes
9389
9390    * Syntax
9391       * All keywords are now strict and may not be used as identifiers anywhere
9392       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9393         'of', 'with', 'to', 'class'.
9394       * Classes are replaced with simpler structs
9395       * Explicit method self types
9396       * `ret` became `return` and `alt` became `match`
9397       * `import` is now `use`; `use is now `extern mod`
9398       * `extern mod { ... }` is now `extern { ... }`
9399       * `use mod` is the recommended way to import modules
9400       * `pub` and `priv` replace deprecated export lists
9401       * The syntax of `match` pattern arms now uses fat arrow (=>)
9402       * `main` no longer accepts an args vector; use `os::args` instead
9403
9404    * Semantics
9405       * Trait implementations are now coherent, ala Haskell typeclasses
9406       * Trait methods may be static
9407       * Argument modes are deprecated
9408       * Borrowed pointers are much more mature and recommended for use
9409       * Strings and vectors in the static region are stored in constant memory
9410       * Typestate was removed
9411       * Resolution rewritten to be more reliable
9412       * Support for 'dual-mode' data structures (freezing and thawing)
9413
9414    * Libraries
9415       * Most binary operators can now be overloaded via the traits in
9416         `core::ops'
9417       * `std::net::url` for representing URLs
9418       * Sendable hash maps in `core::send_map`
9419       * `core::task' gained a (currently unsafe) task-local storage API
9420
9421    * Concurrency
9422       * An efficient new intertask communication primitive called the pipe,
9423         along with a number of higher-level channel types, in `core::pipes`
9424       * `std::arc`, an atomically reference counted, immutable, shared memory
9425         type
9426       * `std::sync`, various exotic synchronization tools based on arcs and pipes
9427       * Futures are now based on pipes and sendable
9428       * More robust linked task failure
9429       * Improved task builder API
9430
9431    * Other
9432       * Improved error reporting
9433       * Preliminary JIT support
9434       * Preliminary work on precise GC
9435       * Extensive architectural improvements to rustc
9436       * Begun a transition away from buggy C++-based reflection (shape) code to
9437         Rust-based (visitor) code
9438       * All hash functions and tables converted to secure, randomized SipHash
9439
9440
9441 Version 0.3  (2012-07-12)
9442 ========================
9443
9444    * ~1900 changes, numerous bugfixes
9445
9446    * New coding conveniences
9447       * Integer-literal suffix inference
9448       * Per-item control over warnings, errors
9449       * #[cfg(windows)] and #[cfg(unix)] attributes
9450       * Documentation comments
9451       * More compact closure syntax
9452       * 'do' expressions for treating higher-order functions as
9453         control structures
9454       * *-patterns (wildcard extended to all constructor fields)
9455
9456    * Semantic cleanup
9457       * Name resolution pass and exhaustiveness checker rewritten
9458       * Region pointers and borrow checking supersede alias
9459         analysis
9460       * Init-ness checking is now provided by a region-based liveness
9461         pass instead of the typestate pass; same for last-use analysis
9462       * Extensive work on region pointers
9463
9464    * Experimental new language features
9465       * Slices and fixed-size, interior-allocated vectors
9466       * #!-comments for lang versioning, shell execution
9467       * Destructors and iface implementation for classes;
9468         type-parameterized classes and class methods
9469       * 'const' type kind for types that can be used to implement
9470         shared-memory concurrency patterns
9471
9472    * Type reflection
9473
9474    * Removal of various obsolete features
9475       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9476                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
9477
9478       * Constructs: do-while loops ('do' repurposed), fn binding,
9479                     resources (replaced by destructors)
9480
9481    * Compiler reorganization
9482       * Syntax-layer of compiler split into separate crate
9483       * Clang (from LLVM project) integrated into build
9484       * Typechecker split into sub-modules
9485
9486    * New library code
9487       * New time functions
9488       * Extension methods for many built-in types
9489       * Arc: atomic-refcount read-only / exclusive-use shared cells
9490       * Par: parallel map and search routines
9491       * Extensive work on libuv interface
9492       * Much vector code moved to libraries
9493       * Syntax extensions: #line, #col, #file, #mod, #stringify,
9494         #include, #include_str, #include_bin
9495
9496    * Tool improvements
9497       * Cargo automatically resolves dependencies
9498
9499
9500 Version 0.2  (2012-03-29)
9501 =========================
9502
9503    * >1500 changes, numerous bugfixes
9504
9505    * New docs and doc tooling
9506
9507    * New port: FreeBSD x86_64
9508
9509    * Compilation model enhancements
9510       * Generics now specialized, multiply instantiated
9511       * Functions now inlined across separate crates
9512
9513    * Scheduling, stack and threading fixes
9514       * Noticeably improved message-passing performance
9515       * Explicit schedulers
9516       * Callbacks from C
9517       * Helgrind clean
9518
9519    * Experimental new language features
9520       * Operator overloading
9521       * Region pointers
9522       * Classes
9523
9524    * Various language extensions
9525       * C-callback function types: 'crust fn ...'
9526       * Infinite-loop construct: 'loop { ... }'
9527       * Shorten 'mutable' to 'mut'
9528       * Required mutable-local qualifier: 'let mut ...'
9529       * Basic glob-exporting: 'export foo::*;'
9530       * Alt now exhaustive, 'alt check' for runtime-checked
9531       * Block-function form of 'for' loop, with 'break' and 'ret'.
9532
9533    * New library code
9534       * AST quasi-quote syntax extension
9535       * Revived libuv interface
9536       * New modules: core::{future, iter}, std::arena
9537       * Merged per-platform std::{os*, fs*} to core::{libc, os}
9538       * Extensive cleanup, regularization in libstd, libcore
9539
9540
9541 Version 0.1  (2012-01-20)
9542 ===============================
9543
9544    * Most language features work, including:
9545       * Unique pointers, unique closures, move semantics
9546       * Interface-constrained generics
9547       * Static interface dispatch
9548       * Stack growth
9549       * Multithread task scheduling
9550       * Typestate predicates
9551       * Failure unwinding, destructors
9552       * Pattern matching and destructuring assignment
9553       * Lightweight block-lambda syntax
9554       * Preliminary macro-by-example
9555
9556    * Compiler works with the following configurations:
9557       * Linux: x86 and x86_64 hosts and targets
9558       * macOS: x86 and x86_64 hosts and targets
9559       * Windows: x86 hosts and targets
9560
9561    * Cross compilation / multi-target configuration supported.
9562
9563    * Preliminary API-documentation and package-management tools included.
9564
9565 Known issues:
9566
9567    * Documentation is incomplete.
9568
9569    * Performance is below intended target.
9570
9571    * Standard library APIs are subject to extensive change, reorganization.
9572
9573    * Language-level versioning is not yet operational - future code will
9574      break unexpectedly.