]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Make const_evaluatable_unchecked lint example not depend on the architecture pointer...
[rust.git] / RELEASES.md
1 Version 1.46.0 (2020-08-27)
2 ==========================
3
4 Language
5 --------
6 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
7 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
8   const functions.][73862]
9 - [The `#[track_caller]` attribute can now be added to functions to use the
10   function's caller's location information for panic messages.][72445]
11 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
12   `x.0.0` over `(x.0).0`.
13 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
14   You currently can't use `mem::transmute` in constant functions.
15
16 Compiler
17 --------
18 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
19 - [Enabled static "Position Independent Executables" by default
20   for `x86_64-unknown-linux-musl`.][70740]
21
22 Libraries
23 ---------
24 - [`mem::forget` is now a `const fn`.][73887]
25 - [`String` now implements `From<char>`.][73466]
26 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
27   integer types.][73032]
28 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
29 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
30   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
31 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
32 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
33 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
34
35 Stabilized APIs
36 ---------------
37 - [`Option::zip`]
38 - [`vec::Drain::as_slice`]
39
40 Cargo
41 -----
42 Added a number of new environment variables that are now available when
43 compiling your crate.
44
45 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
46   the specific binary being compiled and the name of the crate.
47 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
48 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
49
50 Compatibility Notes
51 -------------------
52 - [The target configuration option `abi_blacklist` has been renamed
53   to `unsupported_abis`.][74150] The old name will still continue to work.
54 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
55   This was previously accepted but will become a hard error in a future release.
56 - [Rustc will fail to compile if you have a struct with
57   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
58   allowed on `enum`s.
59 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
60   ensure that spans have the correct information, and may cause breakage if you
61   were relying on receiving spans with dummy information.
62 - [The InnoSetup installer for Windows is no longer available.][72569] This was
63   a legacy installer that was replaced by a MSI installer a few years ago but
64   was still being built.
65 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
66 - [Rustc will no longer accept overlapping trait implementations that only
67   differ in how the lifetime was bound.][72493]
68 - [Rustc now correctly relates the lifetime of an existential associated
69   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
70   you to pass a shorter lifetime than expected.
71 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
72   The library will need to be installed for `rustc` to work, even though we
73   expect it to be already available on most systems.
74 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
75   under QEMU.][74820]
76 - [Pretty printing of some tokens in procedural macros changed.][75453] The
77   exact output returned by rustc's pretty printing is an unstable
78   implementation detail: we recommend any macro relying on it to switch to a
79   more robust parsing system.
80
81 [75453]: https://github.com/rust-lang/rust/issues/75453/
82 [74820]: https://github.com/rust-lang/rust/issues/74820/
83 [74420]: https://github.com/rust-lang/rust/issues/74420/
84 [74109]: https://github.com/rust-lang/rust/pull/74109/
85 [74150]: https://github.com/rust-lang/rust/pull/74150/
86 [73862]: https://github.com/rust-lang/rust/pull/73862/
87 [73887]: https://github.com/rust-lang/rust/pull/73887/
88 [73466]: https://github.com/rust-lang/rust/pull/73466/
89 [73516]: https://github.com/rust-lang/rust/pull/73516/
90 [73293]: https://github.com/rust-lang/rust/pull/73293/
91 [73007]: https://github.com/rust-lang/rust/pull/73007/
92 [73032]: https://github.com/rust-lang/rust/pull/73032/
93 [72920]: https://github.com/rust-lang/rust/pull/72920/
94 [72569]: https://github.com/rust-lang/rust/pull/72569/
95 [72583]: https://github.com/rust-lang/rust/pull/72583/
96 [72584]: https://github.com/rust-lang/rust/pull/72584/
97 [72717]: https://github.com/rust-lang/rust/pull/72717/
98 [72437]: https://github.com/rust-lang/rust/pull/72437/
99 [72445]: https://github.com/rust-lang/rust/pull/72445/
100 [72486]: https://github.com/rust-lang/rust/pull/72486/
101 [72493]: https://github.com/rust-lang/rust/pull/72493/
102 [72331]: https://github.com/rust-lang/rust/pull/72331/
103 [71896]: https://github.com/rust-lang/rust/pull/71896/
104 [71660]: https://github.com/rust-lang/rust/pull/71660/
105 [71322]: https://github.com/rust-lang/rust/pull/71322/
106 [70740]: https://github.com/rust-lang/rust/pull/70740/
107 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
108 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
109 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
110 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
111 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
112
113
114 Version 1.45.2 (2020-08-03)
115 ==========================
116
117 * [Fix bindings in tuple struct patterns][74954]
118 * [Fix track_caller integration with trait objects][74784]
119
120 [74954]: https://github.com/rust-lang/rust/issues/74954
121 [74784]: https://github.com/rust-lang/rust/issues/74784
122
123
124 Version 1.45.1 (2020-07-30)
125 ==========================
126
127 * [Fix const propagation with references.][73613]
128 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
129 * [Avoid spurious implicit region bound.][74509]
130 * [Install clippy on x.py install][74457]
131
132 [73613]: https://github.com/rust-lang/rust/pull/73613
133 [73078]: https://github.com/rust-lang/rust/issues/73078
134 [74509]: https://github.com/rust-lang/rust/pull/74509
135 [74457]: https://github.com/rust-lang/rust/pull/74457
136
137
138 Version 1.45.0 (2020-07-16)
139 ==========================
140
141 Language
142 --------
143 - [Out of range float to int conversions using `as` has been defined as a saturating
144   conversion.][71269] This was previously undefined behaviour, but you can use the
145    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
146    may be desirable in rare performance sensitive situations.
147 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
148   using `u64`.][70705]
149 - [Function like procedural macros can now be used in expression, pattern, and  statement
150   positions.][68717] This means you can now use a function-like procedural macro
151   anywhere you can use a declarative (`macro_rules!`) macro.
152
153 Compiler
154 --------
155 - [You can now override individual target features through the `target-feature`
156   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
157   equivalent to `-C target-feature=+avx2,+fma`.
158 - [Added the `force-unwind-tables` flag.][69984] This option allows
159   rustc to always generate unwind tables regardless of panic strategy.
160 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
161   to include LLVM bitcode into generated `rlib`s (this is on by default).
162 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
163 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
164 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
165
166 \* Refer to Rust's [platform support page][forge-platform-support] for more
167 information on Rust's tiered platform support.
168
169
170 Libraries
171 ---------
172 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
173   and `Ord`.][72239]
174 - [`proc_macro::TokenStream` now implements `Default`.][72234]
175 - [You can now use `char` with
176   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
177   a range of codepoints.][72413] E.g.
178   you can now write the following;
179   ```rust
180   for ch in 'a'..='z' {
181       print!("{}", ch);
182   }
183   println!();
184   // Prints "abcdefghijklmnopqrstuvwxyz"
185   ```
186 - [`OsString` now implements `FromStr`.][71662]
187 - [The `saturating_neg` method has been added to all signed integer primitive
188   types, and the `saturating_abs` method has been added for all integer
189   primitive types.][71886]
190 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
191   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
192   or `Path`.][71447]
193 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
194 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
195   integer types.][69813]
196 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
197   integer types.][72324]
198 - [The `fetch_update` method has been added to all atomic integer types.][71843]
199
200 Stabilized APIs
201 ---------------
202 - [`Arc::as_ptr`]
203 - [`BTreeMap::remove_entry`]
204 - [`Rc::as_ptr`]
205 - [`rc::Weak::as_ptr`]
206 - [`rc::Weak::from_raw`]
207 - [`rc::Weak::into_raw`]
208 - [`str::strip_prefix`]
209 - [`str::strip_suffix`]
210 - [`sync::Weak::as_ptr`]
211 - [`sync::Weak::from_raw`]
212 - [`sync::Weak::into_raw`]
213 - [`char::UNICODE_VERSION`]
214 - [`Span::resolved_at`]
215 - [`Span::located_at`]
216 - [`Span::mixed_site`]
217 - [`unix::process::CommandExt::arg0`]
218
219 Cargo
220 -----
221
222 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
223   time.][cargo/8066]
224
225 Misc
226 ----
227 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
228   `~~outdated information~~` becomes "~~outdated information~~".
229 - [Added an emoji to Rustdoc's deprecated API message.][72014]
230
231 Compatibility Notes
232 -------------------
233 - [Trying to self initialize a static value (that is creating a value using
234   itself) is unsound and now causes a compile error.][71140]
235 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
236   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
237 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
238   previously undocumented and not intended for public use. Rustdoc still provides
239   a non-zero exit code on errors.
240 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
241   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
242   flags while cargo is adding `embed-bitcode` itself. The recommended way to
243   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
244   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
245
246 Internals Only
247 --------------
248 - [Make clippy a git subtree instead of a git submodule][70655]
249 - [Unify the undo log of all snapshot types][69464]
250
251 [71848]: https://github.com/rust-lang/rust/issues/71848/
252 [73420]: https://github.com/rust-lang/rust/issues/73420/
253 [72324]: https://github.com/rust-lang/rust/pull/72324/
254 [71843]: https://github.com/rust-lang/rust/pull/71843/
255 [71886]: https://github.com/rust-lang/rust/pull/71886/
256 [72234]: https://github.com/rust-lang/rust/pull/72234/
257 [72239]: https://github.com/rust-lang/rust/pull/72239/
258 [72397]: https://github.com/rust-lang/rust/pull/72397/
259 [72413]: https://github.com/rust-lang/rust/pull/72413/
260 [72014]: https://github.com/rust-lang/rust/pull/72014/
261 [72062]: https://github.com/rust-lang/rust/pull/72062/
262 [72094]: https://github.com/rust-lang/rust/pull/72094/
263 [72133]: https://github.com/rust-lang/rust/pull/72133/
264 [71900]: https://github.com/rust-lang/rust/pull/71900/
265 [71928]: https://github.com/rust-lang/rust/pull/71928/
266 [71662]: https://github.com/rust-lang/rust/pull/71662/
267 [71716]: https://github.com/rust-lang/rust/pull/71716/
268 [71447]: https://github.com/rust-lang/rust/pull/71447/
269 [71269]: https://github.com/rust-lang/rust/pull/71269/
270 [71095]: https://github.com/rust-lang/rust/pull/71095/
271 [71140]: https://github.com/rust-lang/rust/pull/71140/
272 [70655]: https://github.com/rust-lang/rust/pull/70655/
273 [70705]: https://github.com/rust-lang/rust/pull/70705/
274 [69984]: https://github.com/rust-lang/rust/pull/69984/
275 [69813]: https://github.com/rust-lang/rust/pull/69813/
276 [69464]: https://github.com/rust-lang/rust/pull/69464/
277 [68717]: https://github.com/rust-lang/rust/pull/68717/
278 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
279 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
280 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
281 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
282 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
283 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
284 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
285 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
286 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
287 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
288 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
289 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
290 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
291 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
292 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
293 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
294 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
295
296
297 Version 1.44.1 (2020-06-18)
298 ===========================
299
300 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
301 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
302 * [Fix crashes when finding backtrace on macOS.][71397]
303 * [Clippy applies lint levels into different files.][clippy/5356]
304
305 [71397]: https://github.com/rust-lang/rust/issues/71397
306 [73078]: https://github.com/rust-lang/rust/issues/73078
307 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
308 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
309
310
311 Version 1.44.0 (2020-06-04)
312 ==========================
313
314 Language
315 --------
316 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
317 - [Added the `unused_braces` lint.][70081]
318
319 **Syntax-only changes**
320
321 - [Expansion-driven outline module parsing][69838]
322 ```rust
323 #[cfg(FALSE)]
324 mod foo {
325     mod bar {
326         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
327     }
328 }
329 ```
330
331 These are still rejected semantically, so you will likely receive an error but
332 these changes can be seen and parsed by macros and conditional compilation.
333
334 Compiler
335 --------
336 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
337   Additionally when in incremental mode rustc defaults to 256 codegen units.
338 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
339   a panic is thrown.][67502]
340 - [Added tier 3\* support for the `aarch64-unknown-none` and
341   `aarch64-unknown-none-softfloat` targets.][68334]
342 - [Added tier 3 support for `arm64-apple-tvos` and
343   `x86_64-apple-tvos` targets.][68191]
344
345
346 Libraries
347 ---------
348 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
349   `vec![]` to be able to be used in `const` contexts.
350 - [`convert::Infallible` now implements `Hash`.][70281]
351 - [`OsString` now implements `DerefMut` and `IndexMut` returning
352   a `&mut OsStr`.][70048]
353 - [Unicode 13 is now supported.][69929]
354 - [`String` now implements `From<&mut str>`.][69661]
355 - [`IoSlice` now implements `Copy`.][69403]
356 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
357 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
358 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
359   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
360   integer types.][69373]
361
362 Stabilized APIs
363 ---------------
364 - [`PathBuf::with_capacity`]
365 - [`PathBuf::capacity`]
366 - [`PathBuf::clear`]
367 - [`PathBuf::reserve`]
368 - [`PathBuf::reserve_exact`]
369 - [`PathBuf::shrink_to_fit`]
370 - [`f32::to_int_unchecked`]
371 - [`f64::to_int_unchecked`]
372 - [`Layout::align_to`]
373 - [`Layout::pad_to_align`]
374 - [`Layout::array`]
375 - [`Layout::extend`]
376
377 Cargo
378 -----
379 - [Added the `cargo tree` command which will print a tree graph of
380   your dependencies.][cargo/8062] E.g.
381   ```
382     mdbook v0.3.2 (/Users/src/rust/mdbook)
383   ├── ammonia v3.0.0
384   │   ├── html5ever v0.24.0
385   │   │   ├── log v0.4.8
386   │   │   │   └── cfg-if v0.1.9
387   │   │   ├── mac v0.1.1
388   │   │   └── markup5ever v0.9.0
389   │   │       ├── log v0.4.8 (*)
390   │   │       ├── phf v0.7.24
391   │   │       │   └── phf_shared v0.7.24
392   │   │       │       ├── siphasher v0.2.3
393   │   │       │       └── unicase v1.4.2
394   │   │       │           [build-dependencies]
395   │   │       │           └── version_check v0.1.5
396   ...
397   ```
398   You can also display dependencies on multiple versions of the same crate with
399   `cargo tree -d` (short for `cargo tree --duplicates`).
400
401 Misc
402 ----
403 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
404   the version in the sidebar.][69494]
405
406 Compatibility Notes
407 -------------------
408 - [Rustc now correctly generates static libraries on Windows GNU targets with
409   the `.a` extension, rather than the previous `.lib`.][70937]
410 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
411 - [The `file_name` property in JSON output of macro errors now points the actual
412   source file rather than the previous format of `<NAME macros>`.][70969]
413   **Note:** this may not point to a file that actually exists on the user's system.
414 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
415 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
416   not allow zero initialization such as `NonZeroU8`.][66059] This was
417   previously a warning.
418 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
419   operator has been defined as a saturating operation.][71269] This was previously
420   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
421   continue using the current behaviour, which may be desirable in rare performance
422   sensitive situations.
423
424 Internal Only
425 -------------
426 These changes provide no direct user facing benefits, but represent significant
427 improvements to the internals and overall performance of rustc and
428 related tools.
429
430 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
431 - [Replace big JS dict with JSON parsing.][71250]
432
433 [69373]: https://github.com/rust-lang/rust/pull/69373/
434 [66059]: https://github.com/rust-lang/rust/pull/66059/
435 [68191]: https://github.com/rust-lang/rust/pull/68191/
436 [68899]: https://github.com/rust-lang/rust/pull/68899/
437 [71147]: https://github.com/rust-lang/rust/pull/71147/
438 [71250]: https://github.com/rust-lang/rust/pull/71250/
439 [70937]: https://github.com/rust-lang/rust/pull/70937/
440 [70969]: https://github.com/rust-lang/rust/pull/70969/
441 [70632]: https://github.com/rust-lang/rust/pull/70632/
442 [70281]: https://github.com/rust-lang/rust/pull/70281/
443 [70345]: https://github.com/rust-lang/rust/pull/70345/
444 [70048]: https://github.com/rust-lang/rust/pull/70048/
445 [70081]: https://github.com/rust-lang/rust/pull/70081/
446 [70156]: https://github.com/rust-lang/rust/pull/70156/
447 [71269]: https://github.com/rust-lang/rust/pull/71269/
448 [69838]: https://github.com/rust-lang/rust/pull/69838/
449 [69929]: https://github.com/rust-lang/rust/pull/69929/
450 [69661]: https://github.com/rust-lang/rust/pull/69661/
451 [69778]: https://github.com/rust-lang/rust/pull/69778/
452 [69494]: https://github.com/rust-lang/rust/pull/69494/
453 [69403]: https://github.com/rust-lang/rust/pull/69403/
454 [69033]: https://github.com/rust-lang/rust/pull/69033/
455 [68692]: https://github.com/rust-lang/rust/pull/68692/
456 [68334]: https://github.com/rust-lang/rust/pull/68334/
457 [67502]: https://github.com/rust-lang/rust/pull/67502/
458 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
459 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
460 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
461 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
462 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
463 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
464 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
465 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
466 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
467 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
468 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
469 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
470 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
471
472
473 Version 1.43.1 (2020-05-07)
474 ===========================
475
476 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
477 * [Fixed the stabilization of AVX-512 features.][71473]
478 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
479
480 [71430]: https://github.com/rust-lang/rust/pull/71430
481 [71473]: https://github.com/rust-lang/rust/issues/71473
482 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
483
484
485 Version 1.43.0 (2020-04-23)
486 ==========================
487
488 Language
489 --------
490 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
491   the type inferred correctly.][68129]
492 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
493
494 **Syntax only changes**
495 - [Allow `type Foo: Ord` syntactically.][69361]
496 - [Fuse associated and extern items up to defaultness.][69194]
497 - [Syntactically allow `self` in all `fn` contexts.][68764]
498 - [Merge `fn` syntax + cleanup item parsing.][68728]
499 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
500   For example, you may now write:
501   ```rust
502   macro_rules! mac_trait {
503       ($i:item) => {
504           trait T { $i }
505       }
506   }
507   mac_trait! {
508       fn foo() {}
509   }
510   ```
511
512 These are still rejected *semantically*, so you will likely receive an error but
513 these changes can be seen and parsed by macros and
514 conditional compilation.
515
516
517 Compiler
518 --------
519 - [You can now pass multiple lint flags to rustc to override the previous
520   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
521   everything in the `unused` lint group except `unused-variables` which
522   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
523   everything in the `unused` lint group **including** `unused-variables` since
524   the allow flag is specified before the deny flag (and therefore overridden).
525 - [rustc will now prefer your system MinGW libraries over its bundled libraries
526   if they are available on `windows-gnu`.][67429]
527 - [rustc now buffers errors/warnings printed in JSON.][69227]
528
529 Libraries
530 ---------
531 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
532   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
533   respectively.][69538] **Note** These conversions are only available when `N`
534   is `0..=32`.
535 - [You can now use associated constants on floats and integers directly, rather
536   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
537   `f32::NAN` with no imports.
538 - [`u8::is_ascii` is now `const`.][68984]
539 - [`String` now implements `AsMut<str>`.][68742]
540 - [Added the `primitive` module to `std` and `core`.][67637] This module
541   reexports Rust's primitive types. This is mainly useful in macros
542   where you want avoid these types being shadowed.
543 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
544 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
545
546 Stabilized APIs
547 ---------------
548 - [`Once::is_completed`]
549 - [`f32::LOG10_2`]
550 - [`f32::LOG2_10`]
551 - [`f64::LOG10_2`]
552 - [`f64::LOG2_10`]
553 - [`iter::once_with`]
554
555 Cargo
556 -----
557 - [You can now set config `[profile]`s in your `.cargo/config`, or through
558   your environment.][cargo/7823]
559 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
560   executable path when running integration tests or benchmarks.][cargo/7697]
561   `<name>` is the name of your binary as-is e.g. If you wanted the executable
562   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
563
564 Misc
565 ----
566 - [Certain checks in the `const_err` lint were deemed unrelated to const
567   evaluation][69185], and have been moved to the `unconditional_panic` and
568   `arithmetic_overflow` lints.
569
570 Compatibility Notes
571 -------------------
572
573 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
574   has been a warning since 1.36.0.
575 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
576   led to some instances being accepted, and now correctly emits a hard error.
577
578 [69340]: https://github.com/rust-lang/rust/pull/69340
579
580 Internal Only
581 -------------
582 These changes provide no direct user facing benefits, but represent significant
583 improvements to the internals and overall performance of `rustc` and
584 related tools.
585
586 - [All components are now built with `opt-level=3` instead of `2`.][67878]
587 - [Improved how rustc generates drop code.][67332]
588 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
589 - [traits: preallocate 2 Vecs of known initial size][69022]
590 - [Avoid exponential behaviour when relating types][68772]
591 - [Skip `Drop` terminators for enum variants without drop glue][68943]
592 - [Improve performance of coherence checks][68966]
593 - [Deduplicate types in the generator witness][68672]
594 - [Invert control in struct_lint_level.][68725]
595
596 [67332]: https://github.com/rust-lang/rust/pull/67332/
597 [67429]: https://github.com/rust-lang/rust/pull/67429/
598 [67637]: https://github.com/rust-lang/rust/pull/67637/
599 [67642]: https://github.com/rust-lang/rust/pull/67642/
600 [67878]: https://github.com/rust-lang/rust/pull/67878/
601 [67885]: https://github.com/rust-lang/rust/pull/67885/
602 [68129]: https://github.com/rust-lang/rust/pull/68129/
603 [68672]: https://github.com/rust-lang/rust/pull/68672/
604 [68725]: https://github.com/rust-lang/rust/pull/68725/
605 [68728]: https://github.com/rust-lang/rust/pull/68728/
606 [68738]: https://github.com/rust-lang/rust/pull/68738/
607 [68742]: https://github.com/rust-lang/rust/pull/68742/
608 [68764]: https://github.com/rust-lang/rust/pull/68764/
609 [68772]: https://github.com/rust-lang/rust/pull/68772/
610 [68943]: https://github.com/rust-lang/rust/pull/68943/
611 [68952]: https://github.com/rust-lang/rust/pull/68952/
612 [68966]: https://github.com/rust-lang/rust/pull/68966/
613 [68984]: https://github.com/rust-lang/rust/pull/68984/
614 [69022]: https://github.com/rust-lang/rust/pull/69022/
615 [69185]: https://github.com/rust-lang/rust/pull/69185/
616 [69194]: https://github.com/rust-lang/rust/pull/69194/
617 [69201]: https://github.com/rust-lang/rust/pull/69201/
618 [69227]: https://github.com/rust-lang/rust/pull/69227/
619 [69548]: https://github.com/rust-lang/rust/pull/69548/
620 [69256]: https://github.com/rust-lang/rust/pull/69256/
621 [69361]: https://github.com/rust-lang/rust/pull/69361/
622 [69366]: https://github.com/rust-lang/rust/pull/69366/
623 [69538]: https://github.com/rust-lang/rust/pull/69538/
624 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
625 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
626 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
627 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
628 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
629 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
630 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
631 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
632
633
634 Version 1.42.0 (2020-03-12)
635 ==========================
636
637 Language
638 --------
639 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
640   ```rust
641   fn foo(words: &[&str]) {
642       match words {
643           ["Hello", "World", "!", ..] => println!("Hello World!"),
644           ["Foo", "Bar", ..] => println!("Baz"),
645           rest => println!("{:?}", rest),
646       }
647   }
648   ```
649 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
650   that you can create an enum that has the exact layout and ABI of the type
651   it contains.
652 - [There are some *syntax-only* changes:][67131]
653    - `default` is syntactically allowed before items in `trait` definitions.
654    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
655      leave out their bodies in favor of `;`.
656    - Bounds on associated types in `impl`s are now syntactically allowed
657      (e.g. `type Foo: Ord;`).
658    - `...` (the C-variadic type) may occur syntactically directly as the type of
659       any function parameter.
660
661   These are still rejected *semantically*, so you will likely receive an error
662   but these changes can be seen and parsed by procedural macros and
663   conditional compilation.
664
665 Compiler
666 --------
667 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
668 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
669 - [`Option::{expect,unwrap}` and
670    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
671    pointing to the location where they were called, rather than
672    `core`'s internals. ][67887]
673
674 \* Refer to Rust's [platform support page][forge-platform-support] for more
675 information on Rust's tiered platform support.
676
677 Libraries
678 ---------
679 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
680 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
681    to implement `Sized`.][67935]
682 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
683 - [`Layout::new` is now `const`.][66254]
684 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
685
686
687 Stabilized APIs
688 ---------------
689 - [`CondVar::wait_while`]
690 - [`CondVar::wait_timeout_while`]
691 - [`DebugMap::key`]
692 - [`DebugMap::value`]
693 - [`ManuallyDrop::take`]
694 - [`matches!`]
695 - [`ptr::slice_from_raw_parts_mut`]
696 - [`ptr::slice_from_raw_parts`]
697
698 Cargo
699 -----
700 - [You no longer need to include `extern crate proc_macro;` to be able to
701   `use proc_macro;` in the `2018` edition.][cargo/7700]
702
703 Compatibility Notes
704 -------------------
705 - [`Error::description` has been deprecated, and its use will now produce a
706   warning.][66919] It's recommended to use `Display`/`to_string` instead.
707
708 [68253]: https://github.com/rust-lang/rust/pull/68253/
709 [68348]: https://github.com/rust-lang/rust/pull/68348/
710 [67935]: https://github.com/rust-lang/rust/pull/67935/
711 [68339]: https://github.com/rust-lang/rust/pull/68339/
712 [68122]: https://github.com/rust-lang/rust/pull/68122/
713 [67712]: https://github.com/rust-lang/rust/pull/67712/
714 [67887]: https://github.com/rust-lang/rust/pull/67887/
715 [67131]: https://github.com/rust-lang/rust/pull/67131/
716 [67233]: https://github.com/rust-lang/rust/pull/67233/
717 [66899]: https://github.com/rust-lang/rust/pull/66899/
718 [66919]: https://github.com/rust-lang/rust/pull/66919/
719 [66254]: https://github.com/rust-lang/rust/pull/66254/
720 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
721 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
722 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
723 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
724 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
725 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
726 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
727 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
728 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
729
730
731 Version 1.41.1 (2020-02-27)
732 ===========================
733
734 * [Always check types of static items][69145]
735 * [Always check lifetime bounds of `Copy` impls][69145]
736 * [Fix miscompilation in callers of `Layout::repeat`][69225]
737
738 [69225]: https://github.com/rust-lang/rust/issues/69225
739 [69145]: https://github.com/rust-lang/rust/pull/69145
740
741
742 Version 1.41.0 (2020-01-30)
743 ===========================
744
745 Language
746 --------
747
748 - [You can now pass type parameters to foreign items when implementing
749   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
750 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
751   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
752   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
753 - [You can now use any valid identifier in a `format_args` macro.][66847]
754   Previously identifiers starting with an underscore were not allowed.
755 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
756   enum variants.][66183] These are still rejected semantically, but
757   can be seen and parsed by procedural macros and conditional compilation.
758
759 Compiler
760 --------
761
762 - [Rustc will now warn if you have unused loop `'label`s.][66325]
763 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
764 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
765 - [You can now pass an arguments file passing the `@path` syntax
766   to rustc.][66172] Note that the format differs somewhat from what is
767   found in other tooling; please see [the documentation][argfile-docs] for
768   more information.
769 - [You can now provide `--extern` flag without a path, indicating that it is
770   available from the search path or specified with an `-L` flag.][64882]
771
772 \* Refer to Rust's [platform support page][forge-platform-support] for more
773 information on Rust's tiered platform support.
774
775 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
776
777 Libraries
778 ---------
779
780 - [The `core::panic` module is now stable.][66771] It was already stable
781   through `std`.
782 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
783   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
784 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
785
786 Stabilized APIs
787 ---------------
788
789 - [`Result::map_or`]
790 - [`Result::map_or_else`]
791 - [`std::rc::Weak::weak_count`]
792 - [`std::rc::Weak::strong_count`]
793 - [`std::sync::Weak::weak_count`]
794 - [`std::sync::Weak::strong_count`]
795
796 Cargo
797 -----
798
799 - [Cargo will now document all the private items for binary crates
800   by default.][cargo/7593]
801 - [`cargo-install` will now reinstall the package if it detects that it is out
802   of date.][cargo/7560]
803 - [Cargo.lock now uses a more git friendly format that should help to reduce
804   merge conflicts.][cargo/7579]
805 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
806   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
807   optimisation level to `2` for debug builds. You can also use
808   `[profile.<profile>.build-override]` to override build scripts and
809   their dependencies.
810
811 Misc
812 ----
813
814 - [You can now specify `edition` in documentation code blocks to compile the block
815   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
816   should be compiled the 2018 edition of Rust.
817 - [You can now provide custom themes to rustdoc with `--theme`, and check the
818   current theme with `--check-theme`.][54733]
819 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
820
821 Compatibility Notes
822 -------------------
823
824 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
825   Apple targets.][apple-32bit-drop] This means that the source code is still
826   available to build, but the targets are no longer being tested and release
827   binaries for those platforms will no longer be distributed by the Rust project.
828   Please refer to the linked blog post for more information.
829
830 [54733]: https://github.com/rust-lang/rust/pull/54733/
831 [61351]: https://github.com/rust-lang/rust/pull/61351/
832 [67255]: https://github.com/rust-lang/rust/pull/67255/
833 [66661]: https://github.com/rust-lang/rust/pull/66661/
834 [66771]: https://github.com/rust-lang/rust/pull/66771/
835 [66847]: https://github.com/rust-lang/rust/pull/66847/
836 [66238]: https://github.com/rust-lang/rust/pull/66238/
837 [66277]: https://github.com/rust-lang/rust/pull/66277/
838 [66325]: https://github.com/rust-lang/rust/pull/66325/
839 [66172]: https://github.com/rust-lang/rust/pull/66172/
840 [66183]: https://github.com/rust-lang/rust/pull/66183/
841 [65879]: https://github.com/rust-lang/rust/pull/65879/
842 [65013]: https://github.com/rust-lang/rust/pull/65013/
843 [64882]: https://github.com/rust-lang/rust/pull/64882/
844 [64325]: https://github.com/rust-lang/rust/pull/64325/
845 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
846 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
847 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
848 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
849 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
850 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
851 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
852 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
853 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
854 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
855 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
856
857 Version 1.40.0 (2019-12-19)
858 ===========================
859
860 Language
861 --------
862 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
863   `const` contexts.][65188] e.g.
864
865   ```rust
866   pub struct Point(i32, i32);
867
868   const ORIGIN: Point = {
869       let constructor = Point;
870
871       constructor(0, 0)
872   };
873   ```
874
875 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
876   indicate that there may be variants or fields added in the future.][64639]
877   For example this requires adding a wild-card branch (`_ => {}`) to any match
878   statements on a non-exhaustive `enum`. [(RFC 2008)]
879 - [You can now use function-like procedural macros in `extern` blocks and in
880   type positions.][63931] e.g. `type Generated = macro!();`
881 - [Function-like and attribute procedural macros can now emit
882   `macro_rules!` items, so you can now have your macros generate macros.][64035]
883 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
884   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
885   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
886
887 Compiler
888 --------
889 - [Added tier 3 support\* for the
890   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
891 - [Added tier 3 support for the
892   `aarch64-unknown-none-softfloat` target.][64589]
893 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
894   `mips64el-unknown-linux-muslabi64` targets.][65843]
895
896 \* Refer to Rust's [platform support page][forge-platform-support] for more
897   information on Rust's tiered platform support.
898
899 Libraries
900 ---------
901 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
902
903 Stabilized APIs
904 ---------------
905 - [`BTreeMap::get_key_value`]
906 - [`HashMap::get_key_value`]
907 - [`Option::as_deref_mut`]
908 - [`Option::as_deref`]
909 - [`Option::flatten`]
910 - [`UdpSocket::peer_addr`]
911 - [`f32::to_be_bytes`]
912 - [`f32::to_le_bytes`]
913 - [`f32::to_ne_bytes`]
914 - [`f64::to_be_bytes`]
915 - [`f64::to_le_bytes`]
916 - [`f64::to_ne_bytes`]
917 - [`f32::from_be_bytes`]
918 - [`f32::from_le_bytes`]
919 - [`f32::from_ne_bytes`]
920 - [`f64::from_be_bytes`]
921 - [`f64::from_le_bytes`]
922 - [`f64::from_ne_bytes`]
923 - [`mem::take`]
924 - [`slice::repeat`]
925 - [`todo!`]
926
927 Cargo
928 -----
929 - [Cargo will now always display warnings, rather than only on
930   fresh builds.][cargo/7450]
931 - [Feature flags (except `--all-features`) passed to a virtual workspace will
932   now produce an error.][cargo/7507] Previously these flags were ignored.
933 - [You can now publish `dev-dependencies` without including
934   a `version`.][cargo/7333]
935
936 Misc
937 ----
938 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
939   when running documentation tests with `rustdoc`.][63803]
940
941 Compatibility Notes
942 -------------------
943 - [As previously announced, any previous NLL warnings in the 2015 edition are
944   now hard errors.][64221]
945 - [The `include!` macro will now warn if it failed to include the
946   entire file.][64284] The `include!` macro unintentionally only includes the
947   first _expression_ in a file, and this can be unintuitive. This will become
948   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
949 - [Using `#[inline]` on function prototypes and consts now emits a warning under
950   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
951   or `extern` blocks now correctly emits a hard error.
952
953 [65294]: https://github.com/rust-lang/rust/pull/65294/
954 [66103]: https://github.com/rust-lang/rust/pull/66103/
955 [65843]: https://github.com/rust-lang/rust/pull/65843/
956 [65188]: https://github.com/rust-lang/rust/pull/65188/
957 [65092]: https://github.com/rust-lang/rust/pull/65092/
958 [64589]: https://github.com/rust-lang/rust/pull/64589/
959 [64639]: https://github.com/rust-lang/rust/pull/64639/
960 [64221]: https://github.com/rust-lang/rust/pull/64221/
961 [64284]: https://github.com/rust-lang/rust/pull/64284/
962 [63931]: https://github.com/rust-lang/rust/pull/63931/
963 [64035]: https://github.com/rust-lang/rust/pull/64035/
964 [63674]: https://github.com/rust-lang/rust/pull/63674/
965 [63803]: https://github.com/rust-lang/rust/pull/63803/
966 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
967 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
968 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
969 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
970 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
971 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
972 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
973 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
974 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
975 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
976 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
977 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
978 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
979 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
980 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
981 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
982 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
983 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
984 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
985 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
986 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
987 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
988 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
989 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
990 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
991 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
992
993
994 Version 1.39.0 (2019-11-07)
995 ===========================
996
997 Language
998 --------
999 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1000   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1001 - [You can now use certain attributes on function, closure, and function pointer
1002   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1003   `deny`, `forbid` as well as inert helper attributes used by procedural macro
1004   attributes applied to items. e.g.
1005   ```rust
1006   fn len(
1007       #[cfg(windows)] slice: &[u16],
1008       #[cfg(not(windows))] slice: &[u8],
1009   ) -> usize {
1010       slice.len()
1011   }
1012   ```
1013 - [You can now take shared references to bind-by-move patterns in the `if` guards
1014   of `match` arms.][63118] e.g.
1015   ```rust
1016   fn main() {
1017       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1018
1019       match array {
1020           nums
1021   //      ---- `nums` is bound by move.
1022               if nums.iter().sum::<u8>() == 10
1023   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
1024           => {
1025               drop(nums);
1026   //          ----------- Legal as `nums` was bound by move and so we have ownership.
1027           }
1028           _ => unreachable!(),
1029       }
1030   }
1031   ```
1032
1033
1034
1035 Compiler
1036 --------
1037 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1038 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1039 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1040   **Note** Cargo currently doesn't use this feature. Refer to
1041   [cargo#7315][cargo/7315] to track this feature's progress.
1042 - [You can now pass `--show-output` argument to test binaries to print the
1043   output of successful tests.][62600]
1044
1045
1046 \* Refer to Rust's [platform support page][forge-platform-support] for more
1047 information on Rust's tiered platform support.
1048
1049 Libraries
1050 ---------
1051 - [`Vec::new` and `String::new` are now `const` functions.][64028]
1052 - [`LinkedList::new` is now a `const` function.][63684]
1053 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1054 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1055   now `const`.][63786]
1056
1057 Stabilized APIs
1058 ---------------
1059 - [`Pin::into_inner`]
1060 - [`Instant::checked_duration_since`]
1061 - [`Instant::saturating_duration_since`]
1062
1063 Cargo
1064 -----
1065 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1066 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1067   `--all` is now deprecated.
1068
1069 Misc
1070 ----
1071 - [You can now pass `-Clinker` to rustdoc to control the linker used
1072   for compiling doctests.][63834]
1073
1074 Compatibility Notes
1075 -------------------
1076 - [Code that was previously accepted by the old borrow checker, but rejected by
1077   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1078   previously a warning, and will also become a hard error in the Rust 2015
1079   edition in the 1.40.0 release.
1080 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
1081   run tests.][63827] This should improve performance when running a large
1082   amount of doctests.
1083 - [The `try!` macro will now issue a deprecation warning.][62672] It is
1084   recommended to use the `?` operator instead.
1085 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1086   returned `0.0`.
1087
1088 [62600]: https://github.com/rust-lang/rust/pull/62600/
1089 [62672]: https://github.com/rust-lang/rust/pull/62672/
1090 [63118]: https://github.com/rust-lang/rust/pull/63118/
1091 [63209]: https://github.com/rust-lang/rust/pull/63209/
1092 [63402]: https://github.com/rust-lang/rust/pull/63402/
1093 [63565]: https://github.com/rust-lang/rust/pull/63565/
1094 [63595]: https://github.com/rust-lang/rust/pull/63595/
1095 [63684]: https://github.com/rust-lang/rust/pull/63684/
1096 [63698]: https://github.com/rust-lang/rust/pull/63698/
1097 [63770]: https://github.com/rust-lang/rust/pull/63770/
1098 [63786]: https://github.com/rust-lang/rust/pull/63786/
1099 [63827]: https://github.com/rust-lang/rust/pull/63827/
1100 [63834]: https://github.com/rust-lang/rust/pull/63834/
1101 [63927]: https://github.com/rust-lang/rust/pull/63927/
1102 [63933]: https://github.com/rust-lang/rust/pull/63933/
1103 [63934]: https://github.com/rust-lang/rust/pull/63934/
1104 [63938]: https://github.com/rust-lang/rust/pull/63938/
1105 [63940]: https://github.com/rust-lang/rust/pull/63940/
1106 [63941]: https://github.com/rust-lang/rust/pull/63941/
1107 [63945]: https://github.com/rust-lang/rust/pull/63945/
1108 [64010]: https://github.com/rust-lang/rust/pull/64010/
1109 [64028]: https://github.com/rust-lang/rust/pull/64028/
1110 [64334]: https://github.com/rust-lang/rust/pull/64334/
1111 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1112 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1113 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1114 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1115 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
1116 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
1117
1118 Version 1.38.0 (2019-09-26)
1119 ==========================
1120
1121 Language
1122 --------
1123 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
1124 - [The `#[deprecated]` attribute can now be used on macros.][62042]
1125
1126 Compiler
1127 --------
1128 - [Added pipelined compilation support to `rustc`.][62766] This will
1129   improve compilation times in some cases. For further information please refer
1130   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
1131 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
1132   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
1133   `x86_64-uwp-windows-msvc` targets.][60260]
1134 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
1135   `armv7-unknown-linux-musleabi` targets.][63107]
1136 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1137 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1138
1139 \* Refer to Rust's [platform support page][forge-platform-support] for more
1140 information on Rust's tiered platform support.
1141
1142 Libraries
1143 ---------
1144 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1145 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1146   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1147   is available at `std::clone::Clone`). This also makes all built-in macros
1148   available in `std`/`core` root. e.g. `std::include_bytes!`.
1149 - [`str::Chars` now implements `Debug`.][63000]
1150 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1151 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1152 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1153 - [Added euclidean remainder and division operations (`div_euclid`,
1154   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1155   `overflowing`, and `wrapping` versions are available for all
1156   integer primitives.
1157 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1158   `PartialEq`.][61491]
1159 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1160
1161 Stabilized APIs
1162 ---------------
1163 - [`<*const T>::cast`]
1164 - [`<*mut T>::cast`]
1165 - [`Duration::as_secs_f32`]
1166 - [`Duration::as_secs_f64`]
1167 - [`Duration::div_f32`]
1168 - [`Duration::div_f64`]
1169 - [`Duration::from_secs_f32`]
1170 - [`Duration::from_secs_f64`]
1171 - [`Duration::mul_f32`]
1172 - [`Duration::mul_f64`]
1173 - [`any::type_name`]
1174
1175 Cargo
1176 -----
1177 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1178 - [You can now pass the `--features` option multiple times to enable
1179   multiple features.][cargo/7084]
1180
1181 Misc
1182 ----
1183 - [`rustc` will now warn about some incorrect uses of
1184   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1185
1186 Compatibility Notes
1187 -------------------
1188 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1189   1.38.0.
1190 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1191   issues][62896] with certain crates such as libc.
1192
1193 [60260]: https://github.com/rust-lang/rust/pull/60260/
1194 [61457]: https://github.com/rust-lang/rust/pull/61457/
1195 [61491]: https://github.com/rust-lang/rust/pull/61491/
1196 [61884]: https://github.com/rust-lang/rust/pull/61884/
1197 [61953]: https://github.com/rust-lang/rust/pull/61953/
1198 [62042]: https://github.com/rust-lang/rust/pull/62042/
1199 [62528]: https://github.com/rust-lang/rust/pull/62528/
1200 [62583]: https://github.com/rust-lang/rust/pull/62583/
1201 [62735]: https://github.com/rust-lang/rust/pull/62735/
1202 [62766]: https://github.com/rust-lang/rust/pull/62766/
1203 [62784]: https://github.com/rust-lang/rust/pull/62784/
1204 [62785]: https://github.com/rust-lang/rust/issues/62785/
1205 [62814]: https://github.com/rust-lang/rust/pull/62814/
1206 [62896]: https://github.com/rust-lang/rust/issues/62896/
1207 [63000]: https://github.com/rust-lang/rust/pull/63000/
1208 [63056]: https://github.com/rust-lang/rust/pull/63056/
1209 [63107]: https://github.com/rust-lang/rust/pull/63107/
1210 [63346]: https://github.com/rust-lang/rust/pull/63346/
1211 [63421]: https://github.com/rust-lang/rust/pull/63421/
1212 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1213 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1214 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1215 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1216 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1217 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1218 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1219 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1220 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1221 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1222 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1223 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1224 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1225 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
1226 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1227
1228 Version 1.37.0 (2019-08-15)
1229 ==========================
1230
1231 Language
1232 --------
1233 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1234   [`Box`][62228], or an [array][62235] and unused.
1235 - [You can now use the `cfg` and `cfg_attr` attributes on
1236   generic parameters.][61547]
1237 - [You can now use enum variants through type alias.][61682] e.g. You can
1238   write the following:
1239   ```rust
1240   type MyOption = Option<u8>;
1241
1242   fn increment_or_zero(x: MyOption) -> u8 {
1243       match x {
1244           MyOption::Some(y) => y + 1,
1245           MyOption::None => 0,
1246       }
1247   }
1248   ```
1249 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1250   `const _: u32 = 5;`.
1251 - [You can now use `#[repr(align(X)]` on enums.][61229]
1252 - [The  `?` Kleene macro operator is now available in the
1253   2015 edition.][60932]
1254
1255 Compiler
1256 --------
1257 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1258   and `-C profile-use` flags.][61268] For more information on how to use profile
1259   guided optimization, please refer to the [rustc book][rustc-book-pgo].
1260 - [The `rust-lldb` wrapper script should now work again.][61827]
1261
1262 Libraries
1263 ---------
1264 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1265
1266 Stabilized APIs
1267 ---------------
1268 - [`BufReader::buffer`]
1269 - [`BufWriter::buffer`]
1270 - [`Cell::from_mut`]
1271 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1272 - [`DoubleEndedIterator::nth_back`]
1273 - [`Option::xor`]
1274 - [`Wrapping::reverse_bits`]
1275 - [`i128::reverse_bits`]
1276 - [`i16::reverse_bits`]
1277 - [`i32::reverse_bits`]
1278 - [`i64::reverse_bits`]
1279 - [`i8::reverse_bits`]
1280 - [`isize::reverse_bits`]
1281 - [`slice::copy_within`]
1282 - [`u128::reverse_bits`]
1283 - [`u16::reverse_bits`]
1284 - [`u32::reverse_bits`]
1285 - [`u64::reverse_bits`]
1286 - [`u8::reverse_bits`]
1287 - [`usize::reverse_bits`]
1288
1289 Cargo
1290 -----
1291 - [`Cargo.lock` files are now included by default when publishing executable crates
1292   with executables.][cargo/7026]
1293 - [You can now specify `default-run="foo"` in `[package]` to specify the
1294   default executable to use for `cargo run`.][cargo/7056]
1295
1296 Misc
1297 ----
1298
1299 Compatibility Notes
1300 -------------------
1301 - [Using `...` for inclusive range patterns will now warn by default.][61342]
1302   Please transition your code to using the `..=` syntax for inclusive
1303   ranges instead.
1304 - [Using a trait object without the `dyn` will now warn by default.][61203]
1305   Please transition your code to use `dyn Trait` for trait objects instead.
1306
1307 [62228]: https://github.com/rust-lang/rust/pull/62228/
1308 [62235]: https://github.com/rust-lang/rust/pull/62235/
1309 [61802]: https://github.com/rust-lang/rust/pull/61802/
1310 [61827]: https://github.com/rust-lang/rust/pull/61827/
1311 [61547]: https://github.com/rust-lang/rust/pull/61547/
1312 [61682]: https://github.com/rust-lang/rust/pull/61682/
1313 [61268]: https://github.com/rust-lang/rust/pull/61268/
1314 [61342]: https://github.com/rust-lang/rust/pull/61342/
1315 [61347]: https://github.com/rust-lang/rust/pull/61347/
1316 [61100]: https://github.com/rust-lang/rust/pull/61100/
1317 [61203]: https://github.com/rust-lang/rust/pull/61203/
1318 [61229]: https://github.com/rust-lang/rust/pull/61229/
1319 [60932]: https://github.com/rust-lang/rust/pull/60932/
1320 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1321 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1322 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1323 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1324 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1325 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1326 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1327 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1328 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1329 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1330 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1331 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1332 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1333 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1334 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1335 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1336 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1337 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1338 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1339 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1340 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1341 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1342 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1343 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1344
1345
1346 Version 1.36.0 (2019-07-04)
1347 ==========================
1348
1349 Language
1350 --------
1351 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1352 - [The order of traits in trait objects no longer affects the semantics of that
1353   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1354   `dyn fmt::Debug + Send`, where this was previously not the case.
1355
1356 Libraries
1357 ---------
1358 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1359 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1360 - [`mem::needs_drop` is now available as a const fn.][60364]
1361 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1362 - [`String` now implements `BorrowMut<str>`.][60404]
1363 - [`io::Cursor` now implements `Default`.][60234]
1364 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1365 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1366   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1367   environment has access to heap memory allocation.
1368 - [`String` now implements `From<&String>`.][59825]
1369 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1370   return a tuple of each argument when there is multiple arguments.
1371 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1372   not used.][59648]
1373
1374 Stabilized APIs
1375 ---------------
1376 - [`VecDeque::rotate_left`]
1377 - [`VecDeque::rotate_right`]
1378 - [`Iterator::copied`]
1379 - [`io::IoSlice`]
1380 - [`io::IoSliceMut`]
1381 - [`Read::read_vectored`]
1382 - [`Write::write_vectored`]
1383 - [`str::as_mut_ptr`]
1384 - [`mem::MaybeUninit`]
1385 - [`pointer::align_offset`]
1386 - [`future::Future`]
1387 - [`task::Context`]
1388 - [`task::RawWaker`]
1389 - [`task::RawWakerVTable`]
1390 - [`task::Waker`]
1391 - [`task::Poll`]
1392
1393 Cargo
1394 -----
1395 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1396 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1397
1398 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1399
1400 Clippy
1401 ------
1402 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1403
1404 Misc
1405 ----
1406
1407 Compatibility Notes
1408 -------------------
1409 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1410   longer recommended, and will be deprecated in 1.39.0.
1411
1412 [60318]: https://github.com/rust-lang/rust/pull/60318/
1413 [60364]: https://github.com/rust-lang/rust/pull/60364/
1414 [60370]: https://github.com/rust-lang/rust/pull/60370/
1415 [60404]: https://github.com/rust-lang/rust/pull/60404/
1416 [60234]: https://github.com/rust-lang/rust/pull/60234/
1417 [60244]: https://github.com/rust-lang/rust/pull/60244/
1418 [58623]: https://github.com/rust-lang/rust/pull/58623/
1419 [59648]: https://github.com/rust-lang/rust/pull/59648/
1420 [59675]: https://github.com/rust-lang/rust/pull/59675/
1421 [59825]: https://github.com/rust-lang/rust/pull/59825/
1422 [59826]: https://github.com/rust-lang/rust/pull/59826/
1423 [59445]: https://github.com/rust-lang/rust/pull/59445/
1424 [59114]: https://github.com/rust-lang/rust/pull/59114/
1425 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1426 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1427 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1428 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1429 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1430 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1431 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1432 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1433 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1434 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1435 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1436 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1437 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1438 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1439 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1440 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1441 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1442 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1443 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1444 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1445
1446
1447 Version 1.35.0 (2019-05-23)
1448 ==========================
1449
1450 Language
1451 --------
1452 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1453   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1454 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1455   ```rust
1456   unsafe fn call_unsafe(func: unsafe fn()) {
1457       func()
1458   }
1459
1460   pub fn main() {
1461       unsafe { call_unsafe(|| {}); }
1462   }
1463   ```
1464
1465
1466 Compiler
1467 --------
1468 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1469   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1470 - [Added the `wasm32-unknown-wasi` target.][59464]
1471
1472
1473 Libraries
1474 ---------
1475 - [`Thread` will now show its ID in `Debug` output.][59460]
1476 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1477 - [`alloc::System` now implements `Default`.][59451]
1478 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1479   last field.][59076]
1480 - [`char::{ToLowercase, ToUppercase}` now
1481   implement `ExactSizeIterator`.][58778]
1482 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1483 - [Removed the `Read` trait bounds
1484   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1485 - [You can now call the `dbg!` macro without any parameters to print the file
1486   and line where it is called.][57847]
1487 - [In place ASCII case conversions are now up to 4× faster.][59283]
1488   e.g. `str::make_ascii_lowercase`
1489 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1490   and `Send`.][58369]
1491
1492 Stabilized APIs
1493 ---------------
1494 - [`f32::copysign`]
1495 - [`f64::copysign`]
1496 - [`RefCell::replace_with`]
1497 - [`RefCell::map_split`]
1498 - [`ptr::hash`]
1499 - [`Range::contains`]
1500 - [`RangeFrom::contains`]
1501 - [`RangeTo::contains`]
1502 - [`RangeInclusive::contains`]
1503 - [`RangeToInclusive::contains`]
1504 - [`Option::copied`]
1505
1506 Cargo
1507 -----
1508 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1509   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1510   platform specific.
1511
1512 Misc
1513 ----
1514 - [The Rust toolchain is now available natively for musl based distros.][58575]
1515
1516 [59460]: https://github.com/rust-lang/rust/pull/59460/
1517 [59464]: https://github.com/rust-lang/rust/pull/59464/
1518 [59500]: https://github.com/rust-lang/rust/pull/59500/
1519 [59512]: https://github.com/rust-lang/rust/pull/59512/
1520 [59580]: https://github.com/rust-lang/rust/pull/59580/
1521 [59283]: https://github.com/rust-lang/rust/pull/59283/
1522 [59451]: https://github.com/rust-lang/rust/pull/59451/
1523 [59076]: https://github.com/rust-lang/rust/pull/59076/
1524 [58778]: https://github.com/rust-lang/rust/pull/58778/
1525 [58717]: https://github.com/rust-lang/rust/pull/58717/
1526 [58369]: https://github.com/rust-lang/rust/pull/58369/
1527 [58423]: https://github.com/rust-lang/rust/pull/58423/
1528 [58080]: https://github.com/rust-lang/rust/pull/58080/
1529 [57847]: https://github.com/rust-lang/rust/pull/57847/
1530 [58575]: https://github.com/rust-lang/rust/pull/58575
1531 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1532 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1533 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1534 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1535 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1536 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1537 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1538 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1539 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1540 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1541 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1542 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1543
1544 Version 1.34.2 (2019-05-14)
1545 ===========================
1546
1547 * [Destabilize the `Error::type_id` function due to a security
1548    vulnerability][60785] ([CVE-2019-12083])
1549
1550 [60785]: https://github.com/rust-lang/rust/pull/60785
1551 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1552
1553 Version 1.34.1 (2019-04-25)
1554 ===========================
1555
1556 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1557 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1558 * [Fix Clippy panic when checking some macros][clippy/3805]
1559
1560 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1561 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1562 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1563
1564 Version 1.34.0 (2019-04-11)
1565 ==========================
1566
1567 Language
1568 --------
1569 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1570   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1571   but had no effect.
1572 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1573   `#[attr{}]` procedural macros.][57367]
1574 - [You can now write `extern crate self as foo;`][57407] to import your
1575   crate's root into the extern prelude.
1576
1577
1578 Compiler
1579 --------
1580 - [You can now target `riscv64imac-unknown-none-elf` and
1581   `riscv64gc-unknown-none-elf`.][58406]
1582 - [You can now enable linker plugin LTO optimisations with
1583   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1584   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1585   boundaries.
1586 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1587
1588
1589 Libraries
1590 ---------
1591 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1592   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1593   the `Hash` trait to create an iterator.
1594 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1595   methods.][58421] Most notably you no longer require the `Ord` trait to create
1596   an iterator.
1597 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1598   for all numeric types.][58044]
1599 - [Indexing a `str` is now generic over all types that
1600   implement `SliceIndex<str>`.][57604]
1601 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1602   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1603   produce a warning if their returning type is unused.
1604 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1605   `overflowing_pow` are now available for all numeric types.][57873] These are
1606   equivalent to methods such as `wrapping_add` for the `pow` operation.
1607
1608
1609 Stabilized APIs
1610 ---------------
1611
1612 #### std & core
1613 * [`Any::type_id`]
1614 * [`Error::type_id`]
1615 * [`atomic::AtomicI16`]
1616 * [`atomic::AtomicI32`]
1617 * [`atomic::AtomicI64`]
1618 * [`atomic::AtomicI8`]
1619 * [`atomic::AtomicU16`]
1620 * [`atomic::AtomicU32`]
1621 * [`atomic::AtomicU64`]
1622 * [`atomic::AtomicU8`]
1623 * [`convert::Infallible`]
1624 * [`convert::TryFrom`]
1625 * [`convert::TryInto`]
1626 * [`iter::from_fn`]
1627 * [`iter::successors`]
1628 * [`num::NonZeroI128`]
1629 * [`num::NonZeroI16`]
1630 * [`num::NonZeroI32`]
1631 * [`num::NonZeroI64`]
1632 * [`num::NonZeroI8`]
1633 * [`num::NonZeroIsize`]
1634 * [`slice::sort_by_cached_key`]
1635 * [`str::escape_debug`]
1636 * [`str::escape_default`]
1637 * [`str::escape_unicode`]
1638 * [`str::split_ascii_whitespace`]
1639
1640 #### std
1641 * [`Instant::checked_add`]
1642 * [`Instant::checked_sub`]
1643 * [`SystemTime::checked_add`]
1644 * [`SystemTime::checked_sub`]
1645
1646 Cargo
1647 -----
1648 - [You can now use alternative registries to crates.io.][cargo/6654]
1649
1650 Misc
1651 ----
1652 - [You can now use the `?` operator in your documentation tests without manually
1653   adding `fn main() -> Result<(), _> {}`.][56470]
1654
1655 Compatibility Notes
1656 -------------------
1657 - [`Command::before_exec` is being replaced by the unsafe method
1658   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1659 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1660   can now use `const` functions in `static` variables.
1661
1662 [58370]: https://github.com/rust-lang/rust/pull/58370/
1663 [58406]: https://github.com/rust-lang/rust/pull/58406/
1664 [58421]: https://github.com/rust-lang/rust/pull/58421/
1665 [58166]: https://github.com/rust-lang/rust/pull/58166/
1666 [58044]: https://github.com/rust-lang/rust/pull/58044/
1667 [58057]: https://github.com/rust-lang/rust/pull/58057/
1668 [58059]: https://github.com/rust-lang/rust/pull/58059/
1669 [57809]: https://github.com/rust-lang/rust/pull/57809/
1670 [57873]: https://github.com/rust-lang/rust/pull/57873/
1671 [57604]: https://github.com/rust-lang/rust/pull/57604/
1672 [57367]: https://github.com/rust-lang/rust/pull/57367/
1673 [57407]: https://github.com/rust-lang/rust/pull/57407/
1674 [57425]: https://github.com/rust-lang/rust/pull/57425/
1675 [57106]: https://github.com/rust-lang/rust/pull/57106/
1676 [56470]: https://github.com/rust-lang/rust/pull/56470/
1677 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1678 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1679 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1680 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1681 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1682 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1683 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1684 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1685 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1686 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1687 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1688 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1689 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1690 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1691 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1692 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1693 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1694 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1695 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1696 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1697 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1698 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1699 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1700 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1701 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1702 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1703 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1704 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1705 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1706 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1707 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1708
1709
1710 Version 1.33.0 (2019-02-28)
1711 ==========================
1712
1713 Language
1714 --------
1715 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1716   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1717 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1718   E.g. You can have match statement on a `u8` that covers `0..=255` and
1719   you would no longer be required to have a `_ => unreachable!()` case.
1720 - [You can now have multiple patterns in `if let` and `while let`
1721   expressions.][57532] You can do this with the same syntax as a `match`
1722   expression. E.g.
1723   ```rust
1724   enum Creature {
1725       Crab(String),
1726       Lobster(String),
1727       Person(String),
1728   }
1729
1730   fn main() {
1731       let state = Creature::Crab("Ferris");
1732
1733       if let Creature::Crab(name) | Creature::Person(name) = state {
1734           println!("This creature's name is: {}", name);
1735       }
1736   }
1737   ```
1738 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1739   this feature will by default produce a warning as this behaviour can be
1740   unintuitive. E.g. `if let _ = 5 {}`
1741 - [You can now use `let` bindings, assignments, expression statements,
1742   and irrefutable pattern destructuring in const functions.][57175]
1743 - [You can now call unsafe const functions.][57067] E.g.
1744   ```rust
1745   const unsafe fn foo() -> i32 { 5 }
1746   const fn bar() -> i32 {
1747       unsafe { foo() }
1748   }
1749   ```
1750 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1751   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1752 - [You can now specify a specific alignment with the `#[repr(packed)]`
1753   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1754   with an alignment of 2 bytes and a size of 6 bytes.
1755 - [You can now import an item from a module as an `_`.][56303] This allows you to
1756   import a trait's impls, and not have the name in the namespace. E.g.
1757   ```rust
1758   use std::io::Read as _;
1759
1760   // Allowed as there is only one `Read` in the module.
1761   pub trait Read {}
1762   ```
1763 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1764
1765 Compiler
1766 --------
1767 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1768   command line argument.][56351]
1769 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1770 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1771 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1772   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1773   information on Rust's platform support.
1774 - [Added support for the `thumbv7neon-linux-androideabi` and
1775   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1776 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1777
1778 Libraries
1779 ---------
1780 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1781   functions for all numeric types.][57566]
1782 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1783   are now `const` functions for all numeric types.][57105]
1784 - [The methods `is_positive` and `is_negative` are now `const` functions for
1785   all signed numeric types.][57105]
1786 - [The `get` method for all `NonZero` types is now `const`.][57167]
1787 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1788   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1789   numeric types.][57234]
1790 - [`Ipv4Addr::new` is now a `const` function][57234]
1791
1792 Stabilized APIs
1793 ---------------
1794 - [`unix::FileExt::read_exact_at`]
1795 - [`unix::FileExt::write_all_at`]
1796 - [`Option::transpose`]
1797 - [`Result::transpose`]
1798 - [`convert::identity`]
1799 - [`pin::Pin`]
1800 - [`marker::Unpin`]
1801 - [`marker::PhantomPinned`]
1802 - [`Vec::resize_with`]
1803 - [`VecDeque::resize_with`]
1804 - [`Duration::as_millis`]
1805 - [`Duration::as_micros`]
1806 - [`Duration::as_nanos`]
1807
1808
1809 Cargo
1810 -----
1811 - [You can now publish crates that require a feature flag to compile with
1812   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1813 - [Cargo should now rebuild a crate if a file was modified during the initial
1814   build.][cargo/6484]
1815
1816 Compatibility Notes
1817 -------------------
1818 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1819   are now deprecated in the standard library, and their usage will now produce a warning.
1820   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1821   methods instead.
1822 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1823   downcasting.
1824 - [Libtest no longer creates a new thread for each test when
1825   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1826
1827 [55982]: https://github.com/rust-lang/rust/pull/55982/
1828 [56243]: https://github.com/rust-lang/rust/pull/56243
1829 [56303]: https://github.com/rust-lang/rust/pull/56303/
1830 [56351]: https://github.com/rust-lang/rust/pull/56351/
1831 [56362]: https://github.com/rust-lang/rust/pull/56362
1832 [56642]: https://github.com/rust-lang/rust/pull/56642/
1833 [56769]: https://github.com/rust-lang/rust/pull/56769/
1834 [56805]: https://github.com/rust-lang/rust/pull/56805
1835 [56947]: https://github.com/rust-lang/rust/pull/56947/
1836 [57049]: https://github.com/rust-lang/rust/pull/57049/
1837 [57067]: https://github.com/rust-lang/rust/pull/57067/
1838 [57105]: https://github.com/rust-lang/rust/pull/57105
1839 [57130]: https://github.com/rust-lang/rust/pull/57130/
1840 [57167]: https://github.com/rust-lang/rust/pull/57167/
1841 [57175]: https://github.com/rust-lang/rust/pull/57175/
1842 [57234]: https://github.com/rust-lang/rust/pull/57234/
1843 [57332]: https://github.com/rust-lang/rust/pull/57332/
1844 [57465]: https://github.com/rust-lang/rust/pull/57465/
1845 [57532]: https://github.com/rust-lang/rust/pull/57532/
1846 [57535]: https://github.com/rust-lang/rust/pull/57535/
1847 [57566]: https://github.com/rust-lang/rust/pull/57566/
1848 [57615]: https://github.com/rust-lang/rust/pull/57615/
1849 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1850 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1851 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1852 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1853 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1854 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1855 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1856 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1857 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1858 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1859 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1860 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1861 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1862 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1863 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1864 [platform-support]: https://forge.rust-lang.org/platform-support.html
1865
1866 Version 1.32.0 (2019-01-17)
1867 ==========================
1868
1869 Language
1870 --------
1871 #### 2018 edition
1872 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1873   operator allows you to specify zero or one repetitions similar to the `*` and
1874   `+` operators.
1875 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1876   now always resolve to the item (`enum`, `struct`, etc.) available in the
1877   module if present, before resolving to a external crate or an item the prelude.][56759]
1878   E.g.
1879   ```rust
1880   enum Color { Red, Green, Blue }
1881
1882   use Color::*;
1883   ```
1884
1885 #### All editions
1886 - [You can now match against `PhantomData<T>` types.][55837]
1887 - [You can now match against literals in macros with the `literal`
1888   specifier.][56072] This will match against a literal of any type.
1889   E.g. `1`, `'A'`, `"Hello World"`
1890 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1891   ```rust
1892   struct Point(i32, i32);
1893
1894   impl Point {
1895       pub fn new(x: i32, y: i32) -> Self {
1896           Self(x, y)
1897       }
1898
1899       pub fn is_origin(&self) -> bool {
1900           match self {
1901               Self(0, 0) => true,
1902               _ => false,
1903           }
1904       }
1905   }
1906   ```
1907 - [Self can also now be used in type definitions.][56366] E.g.
1908   ```rust
1909   enum List<T>
1910   where
1911       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1912   {
1913       Nil,
1914       Cons(T, Box<Self>) // likewise here
1915   }
1916   ```
1917 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1918   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1919
1920 Compiler
1921 --------
1922 - [The default allocator has changed from jemalloc to the default allocator on
1923   your system.][55238] The compiler itself on Linux & macOS will still use
1924   jemalloc, but programs compiled with it will use the system allocator.
1925 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1926
1927 Libraries
1928 ---------
1929 - [`PathBuf` now implements `FromStr`.][55148]
1930 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1931 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1932   easily debug expressions in your rust program. E.g.
1933   ```rust
1934   let a = 2;
1935   let b = dbg!(a * 2) + 1;
1936   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1937   assert_eq!(b, 5);
1938   ```
1939
1940 The following APIs are now `const` functions and can be used in a
1941 `const` context.
1942
1943 - [`Cell::as_ptr`]
1944 - [`UnsafeCell::get`]
1945 - [`char::is_ascii`]
1946 - [`iter::empty`]
1947 - [`ManuallyDrop::new`]
1948 - [`ManuallyDrop::into_inner`]
1949 - [`RangeInclusive::start`]
1950 - [`RangeInclusive::end`]
1951 - [`NonNull::as_ptr`]
1952 - [`slice::as_ptr`]
1953 - [`str::as_ptr`]
1954 - [`Duration::as_secs`]
1955 - [`Duration::subsec_millis`]
1956 - [`Duration::subsec_micros`]
1957 - [`Duration::subsec_nanos`]
1958 - [`CStr::as_ptr`]
1959 - [`Ipv4Addr::is_unspecified`]
1960 - [`Ipv6Addr::new`]
1961 - [`Ipv6Addr::octets`]
1962
1963 Stabilized APIs
1964 ---------------
1965 - [`i8::to_be_bytes`]
1966 - [`i8::to_le_bytes`]
1967 - [`i8::to_ne_bytes`]
1968 - [`i8::from_be_bytes`]
1969 - [`i8::from_le_bytes`]
1970 - [`i8::from_ne_bytes`]
1971 - [`i16::to_be_bytes`]
1972 - [`i16::to_le_bytes`]
1973 - [`i16::to_ne_bytes`]
1974 - [`i16::from_be_bytes`]
1975 - [`i16::from_le_bytes`]
1976 - [`i16::from_ne_bytes`]
1977 - [`i32::to_be_bytes`]
1978 - [`i32::to_le_bytes`]
1979 - [`i32::to_ne_bytes`]
1980 - [`i32::from_be_bytes`]
1981 - [`i32::from_le_bytes`]
1982 - [`i32::from_ne_bytes`]
1983 - [`i64::to_be_bytes`]
1984 - [`i64::to_le_bytes`]
1985 - [`i64::to_ne_bytes`]
1986 - [`i64::from_be_bytes`]
1987 - [`i64::from_le_bytes`]
1988 - [`i64::from_ne_bytes`]
1989 - [`i128::to_be_bytes`]
1990 - [`i128::to_le_bytes`]
1991 - [`i128::to_ne_bytes`]
1992 - [`i128::from_be_bytes`]
1993 - [`i128::from_le_bytes`]
1994 - [`i128::from_ne_bytes`]
1995 - [`isize::to_be_bytes`]
1996 - [`isize::to_le_bytes`]
1997 - [`isize::to_ne_bytes`]
1998 - [`isize::from_be_bytes`]
1999 - [`isize::from_le_bytes`]
2000 - [`isize::from_ne_bytes`]
2001 - [`u8::to_be_bytes`]
2002 - [`u8::to_le_bytes`]
2003 - [`u8::to_ne_bytes`]
2004 - [`u8::from_be_bytes`]
2005 - [`u8::from_le_bytes`]
2006 - [`u8::from_ne_bytes`]
2007 - [`u16::to_be_bytes`]
2008 - [`u16::to_le_bytes`]
2009 - [`u16::to_ne_bytes`]
2010 - [`u16::from_be_bytes`]
2011 - [`u16::from_le_bytes`]
2012 - [`u16::from_ne_bytes`]
2013 - [`u32::to_be_bytes`]
2014 - [`u32::to_le_bytes`]
2015 - [`u32::to_ne_bytes`]
2016 - [`u32::from_be_bytes`]
2017 - [`u32::from_le_bytes`]
2018 - [`u32::from_ne_bytes`]
2019 - [`u64::to_be_bytes`]
2020 - [`u64::to_le_bytes`]
2021 - [`u64::to_ne_bytes`]
2022 - [`u64::from_be_bytes`]
2023 - [`u64::from_le_bytes`]
2024 - [`u64::from_ne_bytes`]
2025 - [`u128::to_be_bytes`]
2026 - [`u128::to_le_bytes`]
2027 - [`u128::to_ne_bytes`]
2028 - [`u128::from_be_bytes`]
2029 - [`u128::from_le_bytes`]
2030 - [`u128::from_ne_bytes`]
2031 - [`usize::to_be_bytes`]
2032 - [`usize::to_le_bytes`]
2033 - [`usize::to_ne_bytes`]
2034 - [`usize::from_be_bytes`]
2035 - [`usize::from_le_bytes`]
2036 - [`usize::from_ne_bytes`]
2037
2038 Cargo
2039 -----
2040 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2041 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
2042
2043 Misc
2044 ----
2045 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2046
2047 Compatibility Notes
2048 -------------------
2049 - [The argument types for AVX's
2050   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2051   been changed from `*const` to `*mut` as the previous implementation
2052   was unsound.
2053
2054
2055 [55148]: https://github.com/rust-lang/rust/pull/55148/
2056 [55238]: https://github.com/rust-lang/rust/pull/55238/
2057 [55280]: https://github.com/rust-lang/rust/pull/55280/
2058 [55610]: https://github.com/rust-lang/rust/pull/55610/
2059 [55663]: https://github.com/rust-lang/rust/pull/55663/
2060 [55702]: https://github.com/rust-lang/rust/pull/55702/
2061 [55837]: https://github.com/rust-lang/rust/pull/55837/
2062 [55843]: https://github.com/rust-lang/rust/pull/55843/
2063 [56072]: https://github.com/rust-lang/rust/pull/56072/
2064 [56245]: https://github.com/rust-lang/rust/pull/56245/
2065 [56365]: https://github.com/rust-lang/rust/pull/56365/
2066 [56366]: https://github.com/rust-lang/rust/pull/56366/
2067 [56395]: https://github.com/rust-lang/rust/pull/56395/
2068 [56759]: https://github.com/rust-lang/rust/pull/56759/
2069 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2070 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2071 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2072 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2073 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2074 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2075 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2076 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2077 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2078 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2079 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2080 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2081 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2082 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2083 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2084 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2085 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2086 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2087 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2088 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2089 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2090 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2091 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2092 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2093 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2094 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2095 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2096 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2097 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2098 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2099 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2100 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2101 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2102 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2103 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2104 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2105 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2106 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2107 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
2108 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
2109 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
2110 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
2111 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
2112 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
2113 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
2114 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
2115 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
2116 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
2117 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
2118 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
2119 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
2120 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
2121 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
2122 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
2123 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
2124 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
2125 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
2126 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
2127 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
2128 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
2129 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
2130 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
2131 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
2132 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
2133 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
2134 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
2135 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
2136 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2137 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2138 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2139 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2140 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2141 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2142 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2143 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2144 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2145 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2146 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2147 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2148 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2149 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2150 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2151 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2152 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2153 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2154 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2155 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2156 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2157 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2158 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2159 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2160 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2161 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2162
2163
2164 Version 1.31.1 (2018-12-20)
2165 ===========================
2166
2167 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2168 - [Fix broken go-to-definition in RLS][rls/1171]
2169 - [Fix infinite loop on hover in RLS][rls/1170]
2170
2171 [56562]: https://github.com/rust-lang/rust/pull/56562
2172 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2173 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2174
2175 Version 1.31.0 (2018-12-06)
2176 ==========================
2177
2178 Language
2179 --------
2180 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2181 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2182   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2183   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2184   in structs.
2185 - [You can now define and use `const` functions.][54835] These are currently
2186   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2187   [language reference][const-reference] for what exactly is available.
2188 - [You can now use tool lints, which allow you to scope lints from external
2189   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2190 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2191   a crate, not just in exported functions.][54451]
2192 - [You can now use parentheses in pattern matches.][54497]
2193
2194 Compiler
2195 --------
2196 - [Updated musl to 1.1.20][54430]
2197
2198 Libraries
2199 ---------
2200 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2201   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2202 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2203   into `Option<&mut T>` using the `From` trait.][53218]
2204 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2205
2206
2207 Stabilized APIs
2208 ---------------
2209 - [`slice::align_to`]
2210 - [`slice::align_to_mut`]
2211 - [`slice::chunks_exact`]
2212 - [`slice::chunks_exact_mut`]
2213 - [`slice::rchunks`]
2214 - [`slice::rchunks_mut`]
2215 - [`slice::rchunks_exact`]
2216 - [`slice::rchunks_exact_mut`]
2217 - [`Option::replace`]
2218
2219 Cargo
2220 -----
2221 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2222 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2223   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2224
2225 [52813]: https://github.com/rust-lang/rust/pull/52813/
2226 [53218]: https://github.com/rust-lang/rust/pull/53218/
2227 [53555]: https://github.com/rust-lang/rust/issues/53555/
2228 [54057]: https://github.com/rust-lang/rust/pull/54057/
2229 [54240]: https://github.com/rust-lang/rust/pull/54240/
2230 [54430]: https://github.com/rust-lang/rust/pull/54430/
2231 [54451]: https://github.com/rust-lang/rust/pull/54451/
2232 [54497]: https://github.com/rust-lang/rust/pull/54497/
2233 [54778]: https://github.com/rust-lang/rust/pull/54778/
2234 [54835]: https://github.com/rust-lang/rust/pull/54835/
2235 [54870]: https://github.com/rust-lang/rust/pull/54870/
2236 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2237 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2238 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2239 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2240 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2241 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2242 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2243 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2244 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2245 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2246 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2247 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2248 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2249 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2250
2251 Version 1.30.1 (2018-11-08)
2252 ===========================
2253
2254 - [Fixed overflow ICE in rustdoc][54199]
2255 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2256
2257 [54199]: https://github.com/rust-lang/rust/pull/54199
2258 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2259
2260 Version 1.30.0 (2018-10-25)
2261 ==========================
2262
2263 Language
2264 --------
2265 - [Procedural macros are now available.][52081] These kinds of macros allow for
2266   more powerful code generation. There is a [new chapter available][proc-macros]
2267   in the Rust Programming Language book that goes further in depth.
2268 - [You can now use keywords as identifiers using the raw identifiers
2269   syntax (`r#`),][53236] e.g. `let r#for = true;`
2270 - [Using anonymous parameters in traits is now deprecated with a warning and
2271   will be a hard error in the 2018 edition.][53272]
2272 - [You can now use `crate` in paths.][54404] This allows you to refer to the
2273   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2274 - [Using a external crate no longer requires being prefixed with `::`.][54404]
2275   Previously, using a external crate in a module without a use statement
2276   required `let json = ::serde_json::from_str(foo);` but can now be written
2277   as `let json = serde_json::from_str(foo);`.
2278 - [You can now apply the `#[used]` attribute to static items to prevent the
2279   compiler from optimising them away, even if they appear to be unused,][51363]
2280   e.g. `#[used] static FOO: u32 = 1;`
2281 - [You can now import and reexport macros from other crates with the `use`
2282   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2283   the root module of the crate. If your macro relies on calling other local
2284   macros, it is recommended to export with the
2285   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2286   those macros.
2287 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2288   using the `vis` specifier.][53370]
2289 - [Non-macro attributes now allow all forms of literals, not just
2290   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2291   write `#[attr(true)]`.
2292 - [You can now specify a function to handle a panic in the Rust runtime with the
2293   `#[panic_handler]` attribute.][51366]
2294
2295 Compiler
2296 --------
2297 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
2298 - [Added the `aarch64-unknown-netbsd` target][53165]
2299
2300 Libraries
2301 ---------
2302 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2303
2304 Stabilized APIs
2305 ---------------
2306 - [`Ipv4Addr::BROADCAST`]
2307 - [`Ipv4Addr::LOCALHOST`]
2308 - [`Ipv4Addr::UNSPECIFIED`]
2309 - [`Ipv6Addr::LOCALHOST`]
2310 - [`Ipv6Addr::UNSPECIFIED`]
2311 - [`Iterator::find_map`]
2312
2313   The following methods are replacement methods for `trim_left`, `trim_right`,
2314   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2315   in 1.33.0:
2316 - [`str::trim_end_matches`]
2317 - [`str::trim_end`]
2318 - [`str::trim_start_matches`]
2319 - [`str::trim_start`]
2320
2321 Cargo
2322 ----
2323 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2324 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2325   equivalent to calling `rustdoc --error-format=json`.
2326 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2327
2328 Misc
2329 ----
2330 - [`rustdoc` allows you to specify what edition to treat your code as with the
2331   `--edition` option.][54057]
2332 - [`rustdoc` now has the `--color` (specify whether to output color) and
2333   `--error-format` (specify error format, e.g. `json`) options.][53003]
2334 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2335   debug symbols.][53774]
2336 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2337   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2338
2339 [50911]: https://github.com/rust-lang/rust/pull/50911/
2340 [51363]: https://github.com/rust-lang/rust/pull/51363/
2341 [51366]: https://github.com/rust-lang/rust/pull/51366/
2342 [52081]: https://github.com/rust-lang/rust/pull/52081/
2343 [53003]: https://github.com/rust-lang/rust/pull/53003/
2344 [53033]: https://github.com/rust-lang/rust/pull/53033/
2345 [53044]: https://github.com/rust-lang/rust/pull/53044/
2346 [53165]: https://github.com/rust-lang/rust/pull/53165/
2347 [53213]: https://github.com/rust-lang/rust/pull/53213/
2348 [53236]: https://github.com/rust-lang/rust/pull/53236/
2349 [53272]: https://github.com/rust-lang/rust/pull/53272/
2350 [53370]: https://github.com/rust-lang/rust/pull/53370/
2351 [53459]: https://github.com/rust-lang/rust/pull/53459/
2352 [53774]: https://github.com/rust-lang/rust/pull/53774/
2353 [53822]: https://github.com/rust-lang/rust/pull/53822/
2354 [54057]: https://github.com/rust-lang/rust/pull/54057/
2355 [54146]: https://github.com/rust-lang/rust/pull/54146/
2356 [54404]: https://github.com/rust-lang/rust/pull/54404/
2357 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2358 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2359 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2360 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2361
2362 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2363 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2364 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2365 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2366 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2367 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2368 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2369 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2370 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2371 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2372
2373
2374 Version 1.29.2 (2018-10-11)
2375 ===========================
2376
2377 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2378 - The `rls-preview` component on the windows-gnu targets has been restored.
2379
2380 [54639]: https://github.com/rust-lang/rust/pull/54639
2381
2382
2383 Version 1.29.1 (2018-09-25)
2384 ===========================
2385
2386 Security Notes
2387 --------------
2388
2389 - The standard library's `str::repeat` function contained an out of bounds write
2390   caused by an integer overflow. This has been fixed by deterministically
2391   panicking when an overflow happens.
2392
2393   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2394   us.
2395
2396
2397 Version 1.29.0 (2018-09-13)
2398 ==========================
2399
2400 Compiler
2401 --------
2402 - [Bumped minimum LLVM version to 5.0.][51899]
2403 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2404 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2405
2406 Libraries
2407 ---------
2408 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2409 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2410 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2411 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2412   for `&str`.][51178]
2413 - [`Cell<T>` now allows `T` to be unsized.][50494]
2414 - [`SocketAddr` is now stable on Redox.][52656]
2415
2416 Stabilized APIs
2417 ---------------
2418 - [`Arc::downcast`]
2419 - [`Iterator::flatten`]
2420 - [`Rc::downcast`]
2421
2422 Cargo
2423 -----
2424 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2425   `--locked` to disable this behavior.
2426 - [`cargo-install` will now allow you to cross compile an install
2427   using `--target`.][cargo/5614]
2428 - [Added the `cargo-fix` subcommand to automatically move project code from
2429   2015 edition to 2018.][cargo/5723]
2430 - [`cargo doc` can now optionally document private types using the
2431   `--document-private-items` flag.][cargo/5543]
2432
2433 Misc
2434 ----
2435 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2436   the specified level to that level.][52354] For example `--cap-lints warn`
2437   will demote `deny` and `forbid` lints to `warn`.
2438 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2439   fails and `101` if there is a panic.][52197]
2440 - [A preview of clippy has been made available through rustup.][51122]
2441   You can install the preview with `rustup component add clippy-preview`.
2442
2443 Compatibility Notes
2444 -------------------
2445 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2446   Use `str::get_unchecked(begin..end)` instead.
2447 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2448   Consider using the `home_dir` function from
2449   https://crates.io/crates/dirs instead.
2450 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2451 - [`cfg` attributes and `--cfg` command line flags are now more
2452   strictly validated.][53893]
2453
2454 [53893]: https://github.com/rust-lang/rust/pull/53893/
2455 [52861]: https://github.com/rust-lang/rust/pull/52861/
2456 [52656]: https://github.com/rust-lang/rust/pull/52656/
2457 [52239]: https://github.com/rust-lang/rust/pull/52239/
2458 [52330]: https://github.com/rust-lang/rust/pull/52330/
2459 [52354]: https://github.com/rust-lang/rust/pull/52354/
2460 [52402]: https://github.com/rust-lang/rust/pull/52402/
2461 [52103]: https://github.com/rust-lang/rust/pull/52103/
2462 [52197]: https://github.com/rust-lang/rust/pull/52197/
2463 [51807]: https://github.com/rust-lang/rust/pull/51807/
2464 [51899]: https://github.com/rust-lang/rust/pull/51899/
2465 [51912]: https://github.com/rust-lang/rust/pull/51912/
2466 [51511]: https://github.com/rust-lang/rust/pull/51511/
2467 [51619]: https://github.com/rust-lang/rust/pull/51619/
2468 [51656]: https://github.com/rust-lang/rust/pull/51656/
2469 [51178]: https://github.com/rust-lang/rust/pull/51178/
2470 [51122]: https://github.com/rust-lang/rust/pull/51122
2471 [50494]: https://github.com/rust-lang/rust/pull/50494/
2472 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2473 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2474 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2475 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2476 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2477 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2478 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2479
2480
2481 Version 1.28.0 (2018-08-02)
2482 ===========================
2483
2484 Language
2485 --------
2486 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2487   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2488   the inner type across Foreign Function Interface (FFI) boundaries.
2489 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2490   and can now be used as identifiers.][51196]
2491 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2492   stable.][51241] This will allow users to specify a global allocator for
2493   their program.
2494 - [Unit test functions marked with the `#[test]` attribute can now return
2495   `Result<(), E: Debug>` in addition to `()`.][51298]
2496 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2497   allows macros to easily target lifetimes.
2498
2499 Compiler
2500 --------
2501 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2502   prioritise making smaller binary sizes. `z` is the same as `s` with the
2503   exception that it does not vectorise loops, which typically results in an even
2504   smaller binary.
2505 - [The short error format is now stable.][49546] Specified with
2506   `--error-format=short` this option will provide a more compressed output of
2507   rust error messages.
2508 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2509 - [Reduced the number of allocations in the macro parser.][50855] This can
2510   improve compile times of macro heavy crates on average by 5%.
2511
2512 Libraries
2513 ---------
2514 - [Implemented `Default` for `&mut str`.][51306]
2515 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2516 - [Implemented `Extend` for `()`.][50234]
2517 - [The `Debug` implementation of `time::Duration` should now be more easily
2518   human readable.][50364] Previously a `Duration` of one second would printed as
2519   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2520 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2521   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2522   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2523   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2524   for `PathBuf`.][50170]
2525 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2526   and `Wrapping<i128>`.][50465]
2527 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2528   possible.][51050] This can provide up to a 40% speed increase.
2529 - [Improved error messages when using `format!`.][50610]
2530
2531 Stabilized APIs
2532 ---------------
2533 - [`Iterator::step_by`]
2534 - [`Path::ancestors`]
2535 - [`SystemTime::UNIX_EPOCH`]
2536 - [`alloc::GlobalAlloc`]
2537 - [`alloc::Layout`]
2538 - [`alloc::LayoutErr`]
2539 - [`alloc::System`]
2540 - [`alloc::alloc`]
2541 - [`alloc::alloc_zeroed`]
2542 - [`alloc::dealloc`]
2543 - [`alloc::realloc`]
2544 - [`alloc::handle_alloc_error`]
2545 - [`btree_map::Entry::or_default`]
2546 - [`fmt::Alignment`]
2547 - [`hash_map::Entry::or_default`]
2548 - [`iter::repeat_with`]
2549 - [`num::NonZeroUsize`]
2550 - [`num::NonZeroU128`]
2551 - [`num::NonZeroU16`]
2552 - [`num::NonZeroU32`]
2553 - [`num::NonZeroU64`]
2554 - [`num::NonZeroU8`]
2555 - [`ops::RangeBounds`]
2556 - [`slice::SliceIndex`]
2557 - [`slice::from_mut`]
2558 - [`slice::from_ref`]
2559 - [`{Any + Send + Sync}::downcast_mut`]
2560 - [`{Any + Send + Sync}::downcast_ref`]
2561 - [`{Any + Send + Sync}::is`]
2562
2563 Cargo
2564 -----
2565 - [Cargo will now no longer allow you to publish crates with build scripts that
2566   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2567   considered to be immutable.
2568
2569 Misc
2570 ----
2571 - [The `suggestion_applicability` field in `rustc`'s json output is now
2572   stable.][50486] This will allow dev tools to check whether a code suggestion
2573   would apply to them.
2574
2575 Compatibility Notes
2576 -------------------
2577 - [Rust will consider trait objects with duplicated constraints to be the same
2578   type as without the duplicated constraint.][51276] For example the below code will
2579   now fail to compile.
2580   ```rust
2581   trait Trait {}
2582
2583   impl Trait + Send {
2584       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2585   }
2586
2587   impl Trait + Send + Send {
2588       fn test(&self) { println!("two"); }
2589   }
2590   ```
2591
2592 [49546]: https://github.com/rust-lang/rust/pull/49546/
2593 [50143]: https://github.com/rust-lang/rust/pull/50143/
2594 [50170]: https://github.com/rust-lang/rust/pull/50170/
2595 [50234]: https://github.com/rust-lang/rust/pull/50234/
2596 [50265]: https://github.com/rust-lang/rust/pull/50265/
2597 [50364]: https://github.com/rust-lang/rust/pull/50364/
2598 [50385]: https://github.com/rust-lang/rust/pull/50385/
2599 [50465]: https://github.com/rust-lang/rust/pull/50465/
2600 [50486]: https://github.com/rust-lang/rust/pull/50486/
2601 [50554]: https://github.com/rust-lang/rust/pull/50554/
2602 [50610]: https://github.com/rust-lang/rust/pull/50610/
2603 [50855]: https://github.com/rust-lang/rust/pull/50855/
2604 [51050]: https://github.com/rust-lang/rust/pull/51050/
2605 [51196]: https://github.com/rust-lang/rust/pull/51196/
2606 [51200]: https://github.com/rust-lang/rust/pull/51200/
2607 [51241]: https://github.com/rust-lang/rust/pull/51241/
2608 [51276]: https://github.com/rust-lang/rust/pull/51276/
2609 [51298]: https://github.com/rust-lang/rust/pull/51298/
2610 [51306]: https://github.com/rust-lang/rust/pull/51306/
2611 [51562]: https://github.com/rust-lang/rust/pull/51562/
2612 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2613 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2614 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2615 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2616 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2617 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2618 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2619 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2620 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2621 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2622 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2623 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2624 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2625 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2626 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2627 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2628 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2629 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2630 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2631 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2632 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2633 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2634 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2635 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2636 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2637 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2638 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2639 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2640 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2641 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2642
2643 Version 1.27.2 (2018-07-20)
2644 ===========================
2645
2646 Compatibility Notes
2647 -------------------
2648
2649 - The borrow checker was fixed to avoid potential unsoundness when using
2650   match ergonomics: [#52213][52213].
2651
2652 [52213]: https://github.com/rust-lang/rust/issues/52213
2653
2654 Version 1.27.1 (2018-07-10)
2655 ===========================
2656
2657 Security Notes
2658 --------------
2659
2660 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2661   when running, which enabled executing code as some other user on a
2662   given machine. This release fixes that vulnerability; you can read
2663   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2664
2665   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2666
2667 Compatibility Notes
2668 -------------------
2669
2670 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2671   match ergonomics: [#51415][51415], [#49534][49534].
2672
2673 [51415]: https://github.com/rust-lang/rust/issues/51415
2674 [49534]: https://github.com/rust-lang/rust/issues/49534
2675 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2676 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2677
2678 Version 1.27.0 (2018-06-21)
2679 ==========================
2680
2681 Language
2682 --------
2683 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2684   be used as an identifier.
2685 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2686   bare `Trait` syntax, and should make it clearer when being used in tandem with
2687   `impl Trait` because it is equivalent to the following syntax:
2688   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2689   `Box<Trait> == Box<dyn Trait>`.
2690 - [Attributes on generic parameters such as types and lifetimes are
2691   now stable.][48851] e.g.
2692   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2693 - [The `#[must_use]` attribute can now also be used on functions as well as
2694   types.][48925] It provides a lint that by default warns users when the
2695   value returned by a function has not been used.
2696
2697 Compiler
2698 --------
2699 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2700
2701 Libraries
2702 ---------
2703 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2704   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2705   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2706   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2707   the `cfg` attribute.
2708 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2709   std are now available in core.][49896]
2710 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2711   to `Self`.][49630]
2712 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2713   that the operation isn't done in place.
2714 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2715   the `#[must_use]` attribute][49533] to warn about unused potentially
2716   expensive allocations.
2717
2718 Stabilized APIs
2719 ---------------
2720 - [`DoubleEndedIterator::rfind`]
2721 - [`DoubleEndedIterator::rfold`]
2722 - [`DoubleEndedIterator::try_rfold`]
2723 - [`Duration::from_micros`]
2724 - [`Duration::from_nanos`]
2725 - [`Duration::subsec_micros`]
2726 - [`Duration::subsec_millis`]
2727 - [`HashMap::remove_entry`]
2728 - [`Iterator::try_fold`]
2729 - [`Iterator::try_for_each`]
2730 - [`NonNull::cast`]
2731 - [`Option::filter`]
2732 - [`String::replace_range`]
2733 - [`Take::set_limit`]
2734 - [`hint::unreachable_unchecked`]
2735 - [`os::unix::process::parent_id`]
2736 - [`ptr::swap_nonoverlapping`]
2737 - [`slice::rsplit_mut`]
2738 - [`slice::rsplit`]
2739 - [`slice::swap_with_slice`]
2740
2741 Cargo
2742 -----
2743 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2744   `readme`, and `repository` fields.][cargo/5386]
2745 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2746 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2747   a different directory than `target` for placing compilation artifacts.
2748 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2749   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2750   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2751   where cargo would infer a binary, Cargo will produce a warning. You can
2752   disable this feature ahead of time by setting any of the following to false:
2753   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2754 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2755   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2756
2757 Misc
2758 ----
2759 - [Added “The Rustc book” into the official documentation.][49707]
2760   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2761 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2762
2763 Compatibility Notes
2764 -------------------
2765 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2766   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2767   compile, `"".is_empty()` will still compile.
2768 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2769   will only print the inner type.][48553] E.g.
2770   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2771   not `AtomicBool(true)`.
2772 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2773   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2774   alignment should cover all use cases.
2775 - The `.description()` method on the `std::error::Error` trait
2776   [has been soft-deprecated][50163]. It is no longer required to implement it.
2777
2778 [48553]: https://github.com/rust-lang/rust/pull/48553/
2779 [48851]: https://github.com/rust-lang/rust/pull/48851/
2780 [48925]: https://github.com/rust-lang/rust/pull/48925/
2781 [49533]: https://github.com/rust-lang/rust/pull/49533/
2782 [49623]: https://github.com/rust-lang/rust/pull/49623/
2783 [49630]: https://github.com/rust-lang/rust/pull/49630/
2784 [49664]: https://github.com/rust-lang/rust/pull/49664/
2785 [49699]: https://github.com/rust-lang/rust/pull/49699/
2786 [49707]: https://github.com/rust-lang/rust/pull/49707/
2787 [49719]: https://github.com/rust-lang/rust/pull/49719/
2788 [49896]: https://github.com/rust-lang/rust/pull/49896/
2789 [49968]: https://github.com/rust-lang/rust/pull/49968/
2790 [50163]: https://github.com/rust-lang/rust/pull/50163
2791 [50177]: https://github.com/rust-lang/rust/pull/50177/
2792 [50378]: https://github.com/rust-lang/rust/pull/50378/
2793 [50398]: https://github.com/rust-lang/rust/pull/50398/
2794 [50423]: https://github.com/rust-lang/rust/pull/50423/
2795 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2796 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2797 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2798 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2799 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2800 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2801 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2802 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2803 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2804 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2805 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2806 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2807 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2808 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2809 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2810 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2811 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2812 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2813 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2814 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2815 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2816 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2817 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2818 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2819 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2820 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2821 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2822 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2823 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2824 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2825
2826
2827 Version 1.26.2 (2018-06-05)
2828 ==========================
2829
2830 Compatibility Notes
2831 -------------------
2832
2833 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2834
2835 [51117]: https://github.com/rust-lang/rust/issues/51117
2836
2837
2838 Version 1.26.1 (2018-05-29)
2839 ==========================
2840
2841 Tools
2842 -----
2843
2844 - [RLS now works on Windows.][50646]
2845 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2846
2847
2848 Compatibility Notes
2849 --------
2850
2851 - [`fn main() -> impl Trait` no longer works for non-Termination
2852   trait.][50656]
2853   This reverts an accidental stabilization.
2854 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2855 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2856
2857 [50646]: https://github.com/rust-lang/rust/issues/50646
2858 [50656]: https://github.com/rust-lang/rust/pull/50656
2859 [50812]: https://github.com/rust-lang/rust/pull/50812
2860 [50950]: https://github.com/rust-lang/rust/issues/50950
2861 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2862
2863 Version 1.26.0 (2018-05-10)
2864 ==========================
2865
2866 Language
2867 --------
2868 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2869   implement either or both traits.][49299]
2870 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2871 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2872   lifetime can be elided.][49458]
2873 - [`impl Trait` is now stable allowing you to have abstract types in returns
2874    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2875   `fn open(path: impl AsRef<Path>)`.
2876 - [Pattern matching will now automatically apply dereferences.][49394]
2877 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2878 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2879 - [A lot of operations are now available in a const context.][46882] E.g. You
2880   can now index into constant arrays, reference and dereference into constants,
2881   and use tuple struct constructors.
2882 - [Fixed entry slice patterns are now stable.][48516] E.g.
2883   ```rust
2884   let points = [1, 2, 3, 4];
2885   match points {
2886       [1, 2, 3, 4] => println!("All points were sequential."),
2887       _ => println!("Not all points were sequential."),
2888   }
2889   ```
2890
2891
2892 Compiler
2893 --------
2894 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2895 - [Fixed exponential projection complexity on nested types.][48296]
2896   This can provide up to a ~12% reduction in compile times for certain crates.
2897 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2898   to remap path prefixes outputted by the compiler.
2899 - [Added `powerpc-unknown-netbsd` target.][48281]
2900
2901 Libraries
2902 ---------
2903 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2904 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2905   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2906 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2907 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2908 - [`ascii::escape_default` is now available in libcore.][48735]
2909 - [Trailing commas are now supported in std and core macros.][48056]
2910 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2911 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2912
2913 Stabilized APIs
2914 ---------------
2915 - [`*const T::add`]
2916 - [`*const T::copy_to_nonoverlapping`]
2917 - [`*const T::copy_to`]
2918 - [`*const T::read_unaligned`]
2919 - [`*const T::read_volatile`]
2920 - [`*const T::read`]
2921 - [`*const T::sub`]
2922 - [`*const T::wrapping_add`]
2923 - [`*const T::wrapping_sub`]
2924 - [`*mut T::add`]
2925 - [`*mut T::copy_to_nonoverlapping`]
2926 - [`*mut T::copy_to`]
2927 - [`*mut T::read_unaligned`]
2928 - [`*mut T::read_volatile`]
2929 - [`*mut T::read`]
2930 - [`*mut T::replace`]
2931 - [`*mut T::sub`]
2932 - [`*mut T::swap`]
2933 - [`*mut T::wrapping_add`]
2934 - [`*mut T::wrapping_sub`]
2935 - [`*mut T::write_bytes`]
2936 - [`*mut T::write_unaligned`]
2937 - [`*mut T::write_volatile`]
2938 - [`*mut T::write`]
2939 - [`Box::leak`]
2940 - [`FromUtf8Error::as_bytes`]
2941 - [`LocalKey::try_with`]
2942 - [`Option::cloned`]
2943 - [`btree_map::Entry::and_modify`]
2944 - [`fs::read_to_string`]
2945 - [`fs::read`]
2946 - [`fs::write`]
2947 - [`hash_map::Entry::and_modify`]
2948 - [`iter::FusedIterator`]
2949 - [`ops::RangeInclusive`]
2950 - [`ops::RangeToInclusive`]
2951 - [`process::id`]
2952 - [`slice::rotate_left`]
2953 - [`slice::rotate_right`]
2954 - [`String::retain`]
2955
2956
2957 Cargo
2958 -----
2959 - [Cargo will now output path to custom commands when `-v` is
2960   passed with `--list`][cargo/5041]
2961 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2962
2963 Misc
2964 ----
2965 - [The second edition of "The Rust Programming Language" book is now recommended
2966   over the first.][48404]
2967
2968 Compatibility Notes
2969 -------------------
2970
2971 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2972   syntax is now invalid.
2973   ```
2974   use std::ops::Fn as dyn;
2975   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2976   ```
2977 - [The result of dereferences are no longer promoted to `'static`.][47408]
2978   e.g.
2979   ```rust
2980   fn main() {
2981       const PAIR: &(i32, i32) = &(0, 1);
2982       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2983   }
2984   ```
2985 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2986 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2987   an error.][48235]
2988 - [Removed hoedown from rustdoc.][48274]
2989 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2990
2991 [46882]: https://github.com/rust-lang/rust/pull/46882
2992 [47379]: https://github.com/rust-lang/rust/pull/47379
2993 [47408]: https://github.com/rust-lang/rust/pull/47408
2994 [47813]: https://github.com/rust-lang/rust/pull/47813
2995 [48056]: https://github.com/rust-lang/rust/pull/48056
2996 [48125]: https://github.com/rust-lang/rust/pull/48125
2997 [48166]: https://github.com/rust-lang/rust/pull/48166
2998 [48235]: https://github.com/rust-lang/rust/pull/48235
2999 [48274]: https://github.com/rust-lang/rust/pull/48274
3000 [48281]: https://github.com/rust-lang/rust/pull/48281
3001 [48296]: https://github.com/rust-lang/rust/pull/48296
3002 [48326]: https://github.com/rust-lang/rust/pull/48326
3003 [48359]: https://github.com/rust-lang/rust/pull/48359
3004 [48404]: https://github.com/rust-lang/rust/pull/48404
3005 [48481]: https://github.com/rust-lang/rust/pull/48481
3006 [48516]: https://github.com/rust-lang/rust/pull/48516
3007 [48628]: https://github.com/rust-lang/rust/pull/48628
3008 [48629]: https://github.com/rust-lang/rust/pull/48629
3009 [48657]: https://github.com/rust-lang/rust/pull/48657
3010 [48735]: https://github.com/rust-lang/rust/pull/48735
3011 [48978]: https://github.com/rust-lang/rust/pull/48978
3012 [49101]: https://github.com/rust-lang/rust/pull/49101
3013 [49109]: https://github.com/rust-lang/rust/pull/49109
3014 [49121]: https://github.com/rust-lang/rust/pull/49121
3015 [49162]: https://github.com/rust-lang/rust/pull/49162
3016 [49184]: https://github.com/rust-lang/rust/pull/49184
3017 [49234]: https://github.com/rust-lang/rust/pull/49234
3018 [49255]: https://github.com/rust-lang/rust/pull/49255
3019 [49299]: https://github.com/rust-lang/rust/pull/49299
3020 [49305]: https://github.com/rust-lang/rust/pull/49305
3021 [49394]: https://github.com/rust-lang/rust/pull/49394
3022 [49458]: https://github.com/rust-lang/rust/pull/49458
3023 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3024 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3025 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3026 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3027 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3028 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3029 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3030 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3031 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3032 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3033 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3034 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3035 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3036 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3037 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3038 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3039 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3040 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3041 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3042 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3043 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3044 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3045 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3046 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3047 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3048 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3049 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3050 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3051 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3052 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3053 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3054 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3055 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3056 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3057 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3058 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3059 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3060 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3061 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3062 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3063 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3064 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
3065
3066
3067 Version 1.25.0 (2018-03-29)
3068 ==========================
3069
3070 Language
3071 --------
3072 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
3073 - [You can now use nested groups of imports.][47948]
3074   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3075 - [You can now have `|` at the start of a match arm.][47947] e.g.
3076 ```rust
3077 enum Foo { A, B, C }
3078
3079 fn main() {
3080     let x = Foo::A;
3081     match x {
3082         | Foo::A
3083         | Foo::B => println!("AB"),
3084         | Foo::C => println!("C"),
3085     }
3086 }
3087 ```
3088
3089 Compiler
3090 --------
3091 - [Upgraded to LLVM 6.][47828]
3092 - [Added `-C lto=val` option.][47521]
3093 - [Added `i586-unknown-linux-musl` target][47282]
3094
3095 Libraries
3096 ---------
3097 - [Impl Send for `process::Command` on Unix.][47760]
3098 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
3099 - [`UnsafeCell::into_inner` is now safe.][47204]
3100 - [Implement libstd for CloudABI.][47268]
3101 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3102 - [Implement `AsRef<Path>` for Component][46985]
3103 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
3104 - [Moved `Duration` to libcore.][46666]
3105
3106 Stabilized APIs
3107 ---------------
3108 - [`Location::column`]
3109 - [`ptr::NonNull`]
3110
3111 The following functions can now be used in a constant expression.
3112 eg. `static MINUTE: Duration = Duration::from_secs(60);`
3113 - [`Duration::new`][47300]
3114 - [`Duration::from_secs`][47300]
3115 - [`Duration::from_millis`][47300]
3116
3117 Cargo
3118 -----
3119 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
3120 - [`cargo new` now defaults to creating a binary crate, instead of a
3121   library crate.][cargo/5029]
3122
3123 Misc
3124 ----
3125 - [Rust by example is now shipped with new releases][46196]
3126
3127 Compatibility Notes
3128 -------------------
3129 - [Deprecated `net::lookup_host`.][47510]
3130 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
3131 - The borrow checker was sometimes incorrectly permitting overlapping borrows
3132   around indexing operations (see [#47349][47349]). This has been fixed (which also
3133   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
3134 - [Removed deprecated unstable attribute `#[simd]`.][47251]
3135
3136 [33903]: https://github.com/rust-lang/rust/pull/33903
3137 [47947]: https://github.com/rust-lang/rust/pull/47947
3138 [47948]: https://github.com/rust-lang/rust/pull/47948
3139 [47760]: https://github.com/rust-lang/rust/pull/47760
3140 [47790]: https://github.com/rust-lang/rust/pull/47790
3141 [47828]: https://github.com/rust-lang/rust/pull/47828
3142 [47398]: https://github.com/rust-lang/rust/pull/47398
3143 [47510]: https://github.com/rust-lang/rust/pull/47510
3144 [47521]: https://github.com/rust-lang/rust/pull/47521
3145 [47204]: https://github.com/rust-lang/rust/pull/47204
3146 [47251]: https://github.com/rust-lang/rust/pull/47251
3147 [47268]: https://github.com/rust-lang/rust/pull/47268
3148 [47282]: https://github.com/rust-lang/rust/pull/47282
3149 [47300]: https://github.com/rust-lang/rust/pull/47300
3150 [47349]: https://github.com/rust-lang/rust/pull/47349
3151 [46931]: https://github.com/rust-lang/rust/pull/46931
3152 [46985]: https://github.com/rust-lang/rust/pull/46985
3153 [47006]: https://github.com/rust-lang/rust/pull/47006
3154 [46830]: https://github.com/rust-lang/rust/pull/46830
3155 [46095]: https://github.com/rust-lang/rust/pull/46095
3156 [46666]: https://github.com/rust-lang/rust/pull/46666
3157 [46196]: https://github.com/rust-lang/rust/pull/46196
3158 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3159 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3160 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3161 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3162 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3163
3164
3165 Version 1.24.1 (2018-03-01)
3166 ==========================
3167
3168  - [Do not abort when unwinding through FFI][48251]
3169  - [Emit UTF-16 files for linker arguments on Windows][48318]
3170  - [Make the error index generator work again][48308]
3171  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3172
3173 [48251]: https://github.com/rust-lang/rust/issues/48251
3174 [48308]: https://github.com/rust-lang/rust/issues/48308
3175 [48318]: https://github.com/rust-lang/rust/issues/48318
3176 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3177
3178
3179 Version 1.24.0 (2018-02-15)
3180 ==========================
3181
3182 Language
3183 --------
3184 - [External `sysv64` ffi is now available.][46528]
3185   eg. `extern "sysv64" fn foo () {}`
3186
3187 Compiler
3188 --------
3189 - [rustc now uses 16 codegen units by default for release builds.][46910]
3190   For the fastest builds, utilize `codegen-units=1`.
3191 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3192 - [Add `aarch64-unknown-openbsd` support][46760]
3193
3194 Libraries
3195 ---------
3196 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3197   improvement in performance in the majority of cases.
3198 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3199   with Windows.][46798]
3200 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3201 - [impl `From<bool>` for `AtomicBool`][46293]
3202 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3203 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3204 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3205 - [float::from_bits now just uses transmute.][46012] This provides
3206   some optimisations from LLVM.
3207 - [Copied `AsciiExt` methods onto `char`][46077]
3208 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3209 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3210 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3211 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3212
3213 Stabilized APIs
3214 ---------------
3215 - [`RefCell::replace`]
3216 - [`RefCell::swap`]
3217 - [`atomic::spin_loop_hint`]
3218
3219 The following functions can now be used in a constant expression.
3220 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3221
3222 - [`AtomicBool::new`][46287]
3223 - [`AtomicUsize::new`][46287]
3224 - [`AtomicIsize::new`][46287]
3225 - [`AtomicPtr::new`][46287]
3226 - [`Cell::new`][46287]
3227 - [`{integer}::min_value`][46287]
3228 - [`{integer}::max_value`][46287]
3229 - [`mem::size_of`][46287]
3230 - [`mem::align_of`][46287]
3231 - [`ptr::null`][46287]
3232 - [`ptr::null_mut`][46287]
3233 - [`RefCell::new`][46287]
3234 - [`UnsafeCell::new`][46287]
3235
3236 Cargo
3237 -----
3238 - [Added a `workspace.default-members` config that
3239   overrides implied `--all` in virtual workspaces.][cargo/4743]
3240 - [Enable incremental by default on development builds.][cargo/4817] Also added
3241   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3242   per-project or global basis respectively.
3243
3244 Misc
3245 ----
3246
3247 Compatibility Notes
3248 -------------------
3249 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3250 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3251   in accordance with IETF RFC 4291 §2.2.
3252 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3253 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3254   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3255 - [Leading zeros in tuple struct members is now an error][47084]
3256 - [`column!()` macro is one-based instead of zero-based][46977]
3257 - [`fmt::Arguments` can no longer be shared across threads][45198]
3258 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
3259 - [Cargo sets a different working directory for the compiler][cargo/4788]
3260
3261 [44884]: https://github.com/rust-lang/rust/pull/44884
3262 [45198]: https://github.com/rust-lang/rust/pull/45198
3263 [45506]: https://github.com/rust-lang/rust/pull/45506
3264 [45904]: https://github.com/rust-lang/rust/pull/45904
3265 [45990]: https://github.com/rust-lang/rust/pull/45990
3266 [46012]: https://github.com/rust-lang/rust/pull/46012
3267 [46077]: https://github.com/rust-lang/rust/pull/46077
3268 [46094]: https://github.com/rust-lang/rust/pull/46094
3269 [46284]: https://github.com/rust-lang/rust/pull/46284
3270 [46287]: https://github.com/rust-lang/rust/pull/46287
3271 [46293]: https://github.com/rust-lang/rust/pull/46293
3272 [46528]: https://github.com/rust-lang/rust/pull/46528
3273 [46671]: https://github.com/rust-lang/rust/pull/46671
3274 [46713]: https://github.com/rust-lang/rust/pull/46713
3275 [46735]: https://github.com/rust-lang/rust/pull/46735
3276 [46749]: https://github.com/rust-lang/rust/pull/46749
3277 [46760]: https://github.com/rust-lang/rust/pull/46760
3278 [46798]: https://github.com/rust-lang/rust/pull/46798
3279 [46828]: https://github.com/rust-lang/rust/pull/46828
3280 [46831]: https://github.com/rust-lang/rust/pull/46831
3281 [46833]: https://github.com/rust-lang/rust/pull/46833
3282 [46910]: https://github.com/rust-lang/rust/pull/46910
3283 [46977]: https://github.com/rust-lang/rust/pull/46977
3284 [47018]: https://github.com/rust-lang/rust/pull/47018
3285 [47080]: https://github.com/rust-lang/rust/pull/47080
3286 [47084]: https://github.com/rust-lang/rust/pull/47084
3287 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
3288 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
3289 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3290 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3291 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3292 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3293
3294
3295 Version 1.23.0 (2018-01-04)
3296 ==========================
3297
3298 Language
3299 --------
3300 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3301 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
3302   Which should fix some confusing errors in some operations.
3303
3304 Compiler
3305 --------
3306 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
3307   undefined behavior.][45920]
3308 - [rustc now suggests renaming import if names clash.][45660]
3309 - [Display errors/warnings correctly when there are zero-width or
3310   wide characters.][45711]
3311 - [rustc now avoids unnecessary copies of arguments that are
3312   simple bindings][45380] This should improve memory usage on average by 5-10%.
3313 - [Updated musl used to build musl rustc to 1.1.17][45393]
3314
3315 Libraries
3316 ---------
3317 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3318 - [Implement Hash for raw pointers to unsized types][45483]
3319 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3320 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3321 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3322 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3323   and `<*mut T>::as_mut`][44932]
3324 - [Optimized `Thread::{park, unpark}` implementation][45524]
3325 - [Improved `SliceExt::binary_search` performance.][45333]
3326 - [impl `FromIterator<()>` for `()`][45379]
3327 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3328   is now deprecated.
3329
3330 Stabilized APIs
3331 ---------------
3332
3333 Cargo
3334 -----
3335 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3336   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3337 - [Added unit test checking to `cargo check`][cargo/4592]
3338 - [Cargo now lets you install a specific version
3339   using `cargo install --version`][cargo/4637]
3340
3341 Misc
3342 ----
3343 - [Releases now ship with the Cargo book documentation.][45692]
3344 - [rustdoc now prints rendering warnings on every run.][45324]
3345
3346 Compatibility Notes
3347 -------------------
3348 - [Changes have been made to type equality to make it more correct,
3349   in rare cases this could break some code.][45853] [Tracking issue for
3350   further information][45852]
3351 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3352 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3353   Android 9, the minimum supported version is Android 14.
3354 - [Bumped the minimum LLVM to 3.9][45326]
3355
3356 [44042]: https://github.com/rust-lang/rust/pull/44042
3357 [44932]: https://github.com/rust-lang/rust/pull/44932
3358 [45267]: https://github.com/rust-lang/rust/pull/45267
3359 [45324]: https://github.com/rust-lang/rust/pull/45324
3360 [45326]: https://github.com/rust-lang/rust/pull/45326
3361 [45333]: https://github.com/rust-lang/rust/pull/45333
3362 [45379]: https://github.com/rust-lang/rust/pull/45379
3363 [45380]: https://github.com/rust-lang/rust/pull/45380
3364 [45393]: https://github.com/rust-lang/rust/pull/45393
3365 [45435]: https://github.com/rust-lang/rust/pull/45435
3366 [45483]: https://github.com/rust-lang/rust/pull/45483
3367 [45524]: https://github.com/rust-lang/rust/pull/45524
3368 [45571]: https://github.com/rust-lang/rust/pull/45571
3369 [45580]: https://github.com/rust-lang/rust/pull/45580
3370 [45610]: https://github.com/rust-lang/rust/pull/45610
3371 [45660]: https://github.com/rust-lang/rust/pull/45660
3372 [45692]: https://github.com/rust-lang/rust/pull/45692
3373 [45711]: https://github.com/rust-lang/rust/pull/45711
3374 [45772]: https://github.com/rust-lang/rust/pull/45772
3375 [45852]: https://github.com/rust-lang/rust/issues/45852
3376 [45853]: https://github.com/rust-lang/rust/pull/45853
3377 [45887]: https://github.com/rust-lang/rust/pull/45887
3378 [45920]: https://github.com/rust-lang/rust/pull/45920
3379 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3380 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3381 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3382
3383
3384 Version 1.22.1 (2017-11-22)
3385 ==========================
3386
3387 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3388
3389 [46183]: https://github.com/rust-lang/rust/pull/46183
3390
3391 Version 1.22.0 (2017-11-22)
3392 ==========================
3393
3394 Language
3395 --------
3396 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3397 - [Now accepts underscores in unicode escapes][43716]
3398 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3399 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3400
3401 Compiler
3402 --------
3403 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3404 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3405   This should decrease compile times for debug builds.
3406 - [strict memory alignment now enabled on ARMv6][45094]
3407 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3408
3409 Libraries
3410 ---------
3411 - [Allow atomic operations up to 32 bits
3412   on `armv5te_unknown_linux_gnueabi`][44978]
3413 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3414 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3415 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3416 - [Properly detect overflow in `Instant += Duration`.][44220]
3417 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3418 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3419 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3420
3421 Stabilized APIs
3422 ---------------
3423
3424 Cargo
3425 -----
3426 - [Cargo will now build multi file examples in subdirectories of the `examples`
3427   folder that have a `main.rs` file.][cargo/4496]
3428 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3429   the old format will continue to work and can be updated with `cargo update`.
3430 - [Now supports vendoring git repositories][cargo/3992]
3431
3432 Misc
3433 ----
3434 - [`libbacktrace` is now available on Apple platforms.][44251]
3435 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3436   This now lets you specify that a given code example will fail to compile.
3437
3438 Compatibility Notes
3439 -------------------
3440 - [The minimum Android version that rustc can build for has been bumped
3441   to `4.0` from `2.3`][45656]
3442 - [Allowing `T op= &T` for numeric types has broken some type
3443   inference cases][45480]
3444
3445
3446 [42526]: https://github.com/rust-lang/rust/pull/42526
3447 [43017]: https://github.com/rust-lang/rust/pull/43017
3448 [43716]: https://github.com/rust-lang/rust/pull/43716
3449 [43949]: https://github.com/rust-lang/rust/pull/43949
3450 [44015]: https://github.com/rust-lang/rust/pull/44015
3451 [44220]: https://github.com/rust-lang/rust/pull/44220
3452 [44251]: https://github.com/rust-lang/rust/pull/44251
3453 [44287]: https://github.com/rust-lang/rust/pull/44287
3454 [44303]: https://github.com/rust-lang/rust/pull/44303
3455 [44456]: https://github.com/rust-lang/rust/pull/44456
3456 [44466]: https://github.com/rust-lang/rust/pull/44466
3457 [44895]: https://github.com/rust-lang/rust/pull/44895
3458 [44966]: https://github.com/rust-lang/rust/pull/44966
3459 [44978]: https://github.com/rust-lang/rust/pull/44978
3460 [45041]: https://github.com/rust-lang/rust/pull/45041
3461 [45064]: https://github.com/rust-lang/rust/pull/45064
3462 [45075]: https://github.com/rust-lang/rust/pull/45075
3463 [45094]: https://github.com/rust-lang/rust/pull/45094
3464 [45095]: https://github.com/rust-lang/rust/pull/45095
3465 [45480]: https://github.com/rust-lang/rust/issues/45480
3466 [45656]: https://github.com/rust-lang/rust/pull/45656
3467 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3468 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3469 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3470
3471
3472
3473
3474
3475
3476 Version 1.21.0 (2017-10-12)
3477 ==========================
3478
3479 Language
3480 --------
3481 - [You can now use static references for literals.][43838]
3482   Example:
3483   ```rust
3484   fn main() {
3485       let x: &'static u32 = &0;
3486   }
3487   ```
3488 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3489   Example:
3490   ```rust
3491   my_macro!(Vec<i32>::new); // Always worked
3492   my_macro!(Vec::<i32>::new); // Now works
3493   ```
3494
3495 Compiler
3496 --------
3497 - [Upgraded jemalloc to 4.5.0][43911]
3498 - [Enabled unwinding panics on Redox][43917]
3499 - [Now runs LLVM in parallel during translation phase.][43506]
3500   This should reduce peak memory usage.
3501
3502 Libraries
3503 ---------
3504 - [Generate builtin impls for `Clone` for all arrays and tuples that
3505   are `T: Clone`][43690]
3506 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3507 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3508   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3509
3510 Stabilized APIs
3511 ---------------
3512
3513 [`std::mem::discriminant`]
3514
3515 Cargo
3516 -----
3517 - [You can now call `cargo install` with multiple package names][cargo/4216]
3518 - [Cargo commands inside a virtual workspace will now implicitly
3519   pass `--all`][cargo/4335]
3520 - [Added a `[patch]` section to `Cargo.toml` to handle
3521   prepublication dependencies][cargo/4123] [RFC 1969]
3522 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3523   like patterns][cargo/4270]
3524 - [Added the `--all-targets` option][cargo/4400]
3525 - [Using required dependencies as a feature is now deprecated and emits
3526   a warning][cargo/4364]
3527
3528
3529 Misc
3530 ----
3531 - [Cargo docs are moving][43916]
3532   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3533 - [The rustdoc book is now available][43863]
3534   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3535 - [Added a preview of RLS has been made available through rustup][44204]
3536   Install with `rustup component add rls-preview`
3537 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3538   Previously only showed `std::os::unix`.
3539
3540 Compatibility Notes
3541 -------------------
3542 - [Changes in method matching against higher-ranked types][43880] This may cause
3543   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3544 - [rustc's JSON error output's byte position start at top of file.][42973]
3545   Was previously relative to the rustc's internal `CodeMap` struct which
3546   required the unstable library `libsyntax` to correctly use.
3547 - [`unused_results` lint no longer ignores booleans][43728]
3548
3549 [42565]: https://github.com/rust-lang/rust/pull/42565
3550 [42973]: https://github.com/rust-lang/rust/pull/42973
3551 [43348]: https://github.com/rust-lang/rust/pull/43348
3552 [43459]: https://github.com/rust-lang/rust/pull/43459
3553 [43506]: https://github.com/rust-lang/rust/pull/43506
3554 [43540]: https://github.com/rust-lang/rust/pull/43540
3555 [43690]: https://github.com/rust-lang/rust/pull/43690
3556 [43728]: https://github.com/rust-lang/rust/pull/43728
3557 [43838]: https://github.com/rust-lang/rust/pull/43838
3558 [43863]: https://github.com/rust-lang/rust/pull/43863
3559 [43880]: https://github.com/rust-lang/rust/pull/43880
3560 [43911]: https://github.com/rust-lang/rust/pull/43911
3561 [43916]: https://github.com/rust-lang/rust/pull/43916
3562 [43917]: https://github.com/rust-lang/rust/pull/43917
3563 [44204]: https://github.com/rust-lang/rust/pull/44204
3564 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3565 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3566 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3567 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3568 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3569 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3570 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3571 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3572 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3573
3574 Version 1.20.0 (2017-08-31)
3575 ===========================
3576
3577 Language
3578 --------
3579 - [Associated constants are now stabilised.][42809]
3580 - [A lot of macro bugs are now fixed.][42913]
3581
3582 Compiler
3583 --------
3584
3585 - [Struct fields are now properly coerced to the expected field type.][42807]
3586 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3587   `wasm32-experimental-emscripten` target.
3588 - [Changed some of the error messages to be more helpful.][42033]
3589 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3590   it.][43170]
3591 - [rustc now reports the total number of errors on compilation failure][43015]
3592   previously this was only the number of errors in the pass that failed.
3593 - [Expansion in rustc has been sped up 29x.][42533]
3594 - [added `msp430-none-elf` target.][43099]
3595 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3596   applicable][43178]
3597 - [Fixes backtraces on Redox][43228]
3598 - [rustc now identifies different versions of same crate when absolute paths of
3599   different types match in an error message.][42826]
3600
3601 Libraries
3602 ---------
3603
3604
3605 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3606 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3607   tuples.][43011]
3608 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3609   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3610 - [Impl `Clone` for `DefaultHasher`.][42799]
3611 - [Impl `Sync` for `SyncSender`.][42397]
3612 - [Impl `FromStr` for `char`][42271]
3613 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3614   NaN.][42431]
3615 - [allow messages in the `unimplemented!()` macro.][42155]
3616   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3617 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3618 - [Upgrade to Unicode 10.0.0][42999]
3619 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3620 - [Skip the main thread's manual stack guard on Linux][43072]
3621 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3622 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3623   previously 2^15.
3624 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3625
3626 Stabilized APIs
3627 ---------------
3628
3629 - [`CStr::into_c_string`]
3630 - [`CString::as_c_str`]
3631 - [`CString::into_boxed_c_str`]
3632 - [`Chain::get_mut`]
3633 - [`Chain::get_ref`]
3634 - [`Chain::into_inner`]
3635 - [`Option::get_or_insert_with`]
3636 - [`Option::get_or_insert`]
3637 - [`OsStr::into_os_string`]
3638 - [`OsString::into_boxed_os_str`]
3639 - [`Take::get_mut`]
3640 - [`Take::get_ref`]
3641 - [`Utf8Error::error_len`]
3642 - [`char::EscapeDebug`]
3643 - [`char::escape_debug`]
3644 - [`compile_error!`]
3645 - [`f32::from_bits`]
3646 - [`f32::to_bits`]
3647 - [`f64::from_bits`]
3648 - [`f64::to_bits`]
3649 - [`mem::ManuallyDrop`]
3650 - [`slice::sort_unstable_by_key`]
3651 - [`slice::sort_unstable_by`]
3652 - [`slice::sort_unstable`]
3653 - [`str::from_boxed_utf8_unchecked`]
3654 - [`str::as_bytes_mut`]
3655 - [`str::as_bytes_mut`]
3656 - [`str::from_utf8_mut`]
3657 - [`str::from_utf8_unchecked_mut`]
3658 - [`str::get_mut`]
3659 - [`str::get_unchecked_mut`]
3660 - [`str::get_unchecked`]
3661 - [`str::get`]
3662 - [`str::into_boxed_bytes`]
3663
3664
3665 Cargo
3666 -----
3667 - [Cargo API token location moved from `~/.cargo/config` to
3668   `~/.cargo/credentials`.][cargo/3978]
3669 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3670   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3671   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3672 - [You can now specify version of a binary when installed through
3673   `cargo install` using `--vers`.][cargo/4229]
3674 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3675   failure.][cargo/4248]
3676 - [Changed the convention around which file is the crate root.][cargo/4259]
3677 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3678   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3679
3680 Compatibility Notes
3681 -------------------
3682
3683 - [Functions with `'static` in their return types will now not be as usable as
3684   if they were using lifetime parameters instead.][42417]
3685 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3686   takes the sign of NaN into account where previously didn't.][42430]
3687
3688 [42033]: https://github.com/rust-lang/rust/pull/42033
3689 [42155]: https://github.com/rust-lang/rust/pull/42155
3690 [42271]: https://github.com/rust-lang/rust/pull/42271
3691 [42397]: https://github.com/rust-lang/rust/pull/42397
3692 [42417]: https://github.com/rust-lang/rust/pull/42417
3693 [42430]: https://github.com/rust-lang/rust/pull/42430
3694 [42431]: https://github.com/rust-lang/rust/pull/42431
3695 [42533]: https://github.com/rust-lang/rust/pull/42533
3696 [42571]: https://github.com/rust-lang/rust/pull/42571
3697 [42613]: https://github.com/rust-lang/rust/pull/42613
3698 [42799]: https://github.com/rust-lang/rust/pull/42799
3699 [42807]: https://github.com/rust-lang/rust/pull/42807
3700 [42809]: https://github.com/rust-lang/rust/pull/42809
3701 [42822]: https://github.com/rust-lang/rust/pull/42822
3702 [42826]: https://github.com/rust-lang/rust/pull/42826
3703 [42854]: https://github.com/rust-lang/rust/pull/42854
3704 [42913]: https://github.com/rust-lang/rust/pull/42913
3705 [42999]: https://github.com/rust-lang/rust/pull/42999
3706 [43011]: https://github.com/rust-lang/rust/pull/43011
3707 [43015]: https://github.com/rust-lang/rust/pull/43015
3708 [43072]: https://github.com/rust-lang/rust/pull/43072
3709 [43077]: https://github.com/rust-lang/rust/pull/43077
3710 [43097]: https://github.com/rust-lang/rust/pull/43097
3711 [43099]: https://github.com/rust-lang/rust/pull/43099
3712 [43170]: https://github.com/rust-lang/rust/pull/43170
3713 [43178]: https://github.com/rust-lang/rust/pull/43178
3714 [43185]: https://github.com/rust-lang/rust/pull/43185
3715 [43228]: https://github.com/rust-lang/rust/pull/43228
3716 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3717 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3718 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3719 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3720 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3721 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3722 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3723 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3724 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3725 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3726 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3727 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3728 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3729 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3730 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3731 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3732 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3733 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3734 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3735 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3736 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3737 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3738 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3739 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3740 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3741 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3742 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3743 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3744 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3745 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3746 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3747 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3748 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3749 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3750 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3751 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3752 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3753 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3754 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3755
3756
3757 Version 1.19.0 (2017-07-20)
3758 ===========================
3759
3760 Language
3761 --------
3762
3763 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3764   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3765 - [Macro recursion limit increased to 1024 from 64.][41676]
3766 - [Added lint for detecting unused macros.][41907]
3767 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3768   For example: `let x = loop { break 7; };`
3769 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3770   contain `Copy` types and cannot have a `Drop` implementation.
3771   Example: `union Foo { bar: u8, baz: usize }`
3772 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3773   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3774
3775 Compiler
3776 --------
3777
3778 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3779 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3780   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3781   you should use `--target armv7-linux-androideabi`.
3782 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3783 - [Minor optimisation of string operations.][42037]
3784 - [Compiler error message is now `aborting due to previous error(s)` instead of
3785   `aborting due to N previous errors`][42150] This was previously inaccurate and
3786   would only count certain kinds of errors.
3787 - [The compiler now supports Visual Studio 2017][42225]
3788 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3789 - [Added a lot][42264] of [new error codes][42302]
3790 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3791   libraries with C Run-time Libraries(CRT) to be statically linked.
3792 - [Fixed various ARM codegen bugs][42740]
3793
3794 Libraries
3795 ---------
3796
3797 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3798   `Extend<Cow<'a, str>>`][41449]
3799 - [`Vec` now implements `From<&mut [T]>`][41530]
3800 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3801 - [`SplitWhitespace` now implements `Clone`][41659]
3802 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3803   1.5x faster][41764]
3804 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3805   macros, but for printing to stderr.
3806
3807 Stabilized APIs
3808 ---------------
3809
3810 - [`OsString::shrink_to_fit`]
3811 - [`cmp::Reverse`]
3812 - [`Command::envs`]
3813 - [`thread::ThreadId`]
3814
3815 Cargo
3816 -----
3817
3818 - [Build scripts can now add environment variables to the environment
3819   the crate is being compiled in.
3820   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3821 - [Subcommands now replace the current process rather than spawning a new
3822   child process][cargo/3970]
3823 - [Workspace members can now accept glob file patterns][cargo/3979]
3824 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3825   the members in a given workspace.][cargo/3988]
3826 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3827 - [Target directory path is now in the cargo metadata][cargo/4022]
3828 - [Cargo no longer checks out a local working directory for the
3829   crates.io index][cargo/4026] This should provide smaller file size for the
3830   registry, and improve cloning times, especially on Windows machines.
3831 - [Added an `--exclude` option for excluding certain packages when using the
3832   `--all` option][cargo/4031]
3833 - [Cargo will now automatically retry when receiving a 5xx error
3834   from crates.io][cargo/4032]
3835 - [The `--features` option now accepts multiple comma or space
3836   delimited values.][cargo/4084]
3837 - [Added support for custom target specific runners][cargo/3954]
3838
3839 Misc
3840 ----
3841
3842 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3843   Windows Debugger.
3844 - [Rust will now release XZ compressed packages][rust-installer/57]
3845 - [rustup will now prefer to download rust packages with
3846   XZ compression][rustup/1100] over GZip packages.
3847 - [Added the ability to escape `#` in rust documentation][41785] By adding
3848   additional `#`'s ie. `##` is now `#`
3849
3850 Compatibility Notes
3851 -------------------
3852
3853 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3854 - [`-Z` flags are now no longer allowed to be used on the stable
3855   compiler.][41751] This has been a warning for a year previous to this.
3856 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3857   longer works][42844]. Users should migrate to the built-in `check`
3858   command, which has been available since 1.16.
3859 - [Ending a float literal with `._` is now a hard error.
3860   Example: `42._` .][41946]
3861 - [Any use of a private `extern crate` outside of its module is now a
3862   hard error.][36886] This was previously a warning.
3863 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3864   relative while the `::` prefix makes a path absolute, but was ignored and the
3865   path was relative regardless.
3866 - [Floating point constants in match patterns is now a hard error][36890]
3867   This was previously a warning.
3868 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3869   match patterns is now a hard error][36891] This was previously a warning.
3870 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3871   a warning.
3872 - [From the pound escape, lines consisting of multiple `#`s are
3873   now visible][41785]
3874 - [It is an error to re-export private enum variants][42460]. This is
3875   known to break a number of crates that depend on an older version of
3876   mustache.
3877 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3878   to use it to find the linker, and the build will fail where it did
3879   not previously][42607]
3880
3881 [36886]: https://github.com/rust-lang/rust/issues/36886
3882 [36888]: https://github.com/rust-lang/rust/issues/36888
3883 [36890]: https://github.com/rust-lang/rust/issues/36890
3884 [36891]: https://github.com/rust-lang/rust/issues/36891
3885 [36892]: https://github.com/rust-lang/rust/issues/36892
3886 [37406]: https://github.com/rust-lang/rust/issues/37406
3887 [39983]: https://github.com/rust-lang/rust/pull/39983
3888 [41145]: https://github.com/rust-lang/rust/pull/41145
3889 [41192]: https://github.com/rust-lang/rust/pull/41192
3890 [41258]: https://github.com/rust-lang/rust/pull/41258
3891 [41370]: https://github.com/rust-lang/rust/pull/41370
3892 [41449]: https://github.com/rust-lang/rust/pull/41449
3893 [41530]: https://github.com/rust-lang/rust/pull/41530
3894 [41624]: https://github.com/rust-lang/rust/pull/41624
3895 [41656]: https://github.com/rust-lang/rust/pull/41656
3896 [41659]: https://github.com/rust-lang/rust/pull/41659
3897 [41676]: https://github.com/rust-lang/rust/pull/41676
3898 [41751]: https://github.com/rust-lang/rust/pull/41751
3899 [41764]: https://github.com/rust-lang/rust/pull/41764
3900 [41785]: https://github.com/rust-lang/rust/pull/41785
3901 [41873]: https://github.com/rust-lang/rust/pull/41873
3902 [41907]: https://github.com/rust-lang/rust/pull/41907
3903 [41946]: https://github.com/rust-lang/rust/pull/41946
3904 [42016]: https://github.com/rust-lang/rust/pull/42016
3905 [42037]: https://github.com/rust-lang/rust/pull/42037
3906 [42068]: https://github.com/rust-lang/rust/pull/42068
3907 [42150]: https://github.com/rust-lang/rust/pull/42150
3908 [42162]: https://github.com/rust-lang/rust/pull/42162
3909 [42225]: https://github.com/rust-lang/rust/pull/42225
3910 [42264]: https://github.com/rust-lang/rust/pull/42264
3911 [42302]: https://github.com/rust-lang/rust/pull/42302
3912 [42460]: https://github.com/rust-lang/rust/issues/42460
3913 [42607]: https://github.com/rust-lang/rust/issues/42607
3914 [42740]: https://github.com/rust-lang/rust/pull/42740
3915 [42844]: https://github.com/rust-lang/rust/issues/42844
3916 [42948]: https://github.com/rust-lang/rust/pull/42948
3917 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3918 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3919 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3920 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3921 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3922 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3923 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3924 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3925 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3926 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3927 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3928 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3929 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3930 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3931 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3932 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3933 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3934 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3935 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3936 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3937 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3938 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3939
3940
3941 Version 1.18.0 (2017-06-08)
3942 ===========================
3943
3944 Language
3945 --------
3946
3947 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3948   make the item visible to just that module tree. Also accepts the keyword
3949   `crate` to make something public to the whole crate but not users of the
3950   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3951 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3952   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3953 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3954   types like `Write + Send`, trailing `+` are now supported in trait objects,
3955   and better error reporting for trait objects starting with `?Sized`.
3956 - [0e+10 is now a valid floating point literal][40589]
3957 - [Now warns if you bind a lifetime parameter to 'static][40734]
3958 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3959   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3960   representation in some cases.][40377]
3961
3962 Compiler
3963 --------
3964
3965 - [rustc can now emit mir with `--emit mir`][39891]
3966 - [Improved LLVM IR for trivial functions][40367]
3967 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3968 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3969   opportunities found through profiling
3970 - [Improved backtrace formatting when panicking][38165]
3971
3972 Libraries
3973 ---------
3974
3975 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3976   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3977   iteration or reallocation.
3978 - [Simplified HashMap Bucket interface][40561] provides performance
3979   improvements for iterating and cloning.
3980 - [Specialize Vec::from_elem to use calloc][40409]
3981 - [Fixed Race condition in fs::create_dir_all][39799]
3982 - [No longer caching stdio on Windows][40516]
3983 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3984   2.50%~ faster and in one case now 12.50% faster.
3985 - [Optimized `AtomicBool::fetch_nand`][41143]
3986
3987 Stabilized APIs
3988 ---------------
3989
3990 - [`Child::try_wait`]
3991 - [`HashMap::retain`]
3992 - [`HashSet::retain`]
3993 - [`PeekMut::pop`]
3994 - [`TcpStream::peek`]
3995 - [`UdpSocket::peek`]
3996 - [`UdpSocket::peek_from`]
3997
3998 Cargo
3999 -----
4000
4001 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4002   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4003 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
4004 - [Added Android build support][cargo/3885]
4005 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4006   of a certain type, for example `cargo build --bins` will build all
4007   binaries.
4008 - [Added support for haiku][cargo/3952]
4009
4010 Misc
4011 ----
4012
4013 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
4014 - [Added rust-windbg script for better debugging on Windows][39983]
4015 - [Rust now uses the official cross compiler for NetBSD][40612]
4016 - [rustdoc now accepts `#` at the start of files][40828]
4017 - [Fixed jemalloc support for musl][41168]
4018
4019 Compatibility Notes
4020 -------------------
4021
4022 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4023   always placed after the sign if it exists and before the digits. With the `#`
4024   flag the zeroes are placed after the prefix and before the digits.
4025 - [Due to the struct field optimisation][40377], using `transmute` on structs
4026   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4027   always been undefined behavior, but is now more likely to break in practice.
4028 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4029   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4030   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4031 - [Overlapping inherent `impl`s are now a hard error][40728]
4032 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4033 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4034   `out.asm` and `out.ll` instead of only one of the filetypes.
4035 - [ calling a function that returns `Self` will no longer work][41805] when
4036   the size of `Self` cannot be statically determined.
4037 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4038   this has caused a few regressions namely:
4039
4040   - Changed the link order of local static/dynamic libraries (respecting the
4041     order on given rather than having the compiler reorder).
4042   - Changed how MinGW is linked, native code linked to dynamic libraries
4043     may require manually linking to the gcc support library (for the native
4044     code itself)
4045
4046 [38165]: https://github.com/rust-lang/rust/pull/38165
4047 [39799]: https://github.com/rust-lang/rust/pull/39799
4048 [39891]: https://github.com/rust-lang/rust/pull/39891
4049 [39983]: https://github.com/rust-lang/rust/pull/39983
4050 [40043]: https://github.com/rust-lang/rust/pull/40043
4051 [40241]: https://github.com/rust-lang/rust/pull/40241
4052 [40338]: https://github.com/rust-lang/rust/pull/40338
4053 [40367]: https://github.com/rust-lang/rust/pull/40367
4054 [40377]: https://github.com/rust-lang/rust/pull/40377
4055 [40409]: https://github.com/rust-lang/rust/pull/40409
4056 [40516]: https://github.com/rust-lang/rust/pull/40516
4057 [40556]: https://github.com/rust-lang/rust/pull/40556
4058 [40561]: https://github.com/rust-lang/rust/pull/40561
4059 [40589]: https://github.com/rust-lang/rust/pull/40589
4060 [40612]: https://github.com/rust-lang/rust/pull/40612
4061 [40723]: https://github.com/rust-lang/rust/pull/40723
4062 [40728]: https://github.com/rust-lang/rust/pull/40728
4063 [40731]: https://github.com/rust-lang/rust/pull/40731
4064 [40734]: https://github.com/rust-lang/rust/pull/40734
4065 [40805]: https://github.com/rust-lang/rust/pull/40805
4066 [40807]: https://github.com/rust-lang/rust/pull/40807
4067 [40828]: https://github.com/rust-lang/rust/pull/40828
4068 [40870]: https://github.com/rust-lang/rust/pull/40870
4069 [41085]: https://github.com/rust-lang/rust/pull/41085
4070 [41143]: https://github.com/rust-lang/rust/pull/41143
4071 [41168]: https://github.com/rust-lang/rust/pull/41168
4072 [41270]: https://github.com/rust-lang/rust/issues/41270
4073 [41469]: https://github.com/rust-lang/rust/pull/41469
4074 [41805]: https://github.com/rust-lang/rust/issues/41805
4075 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4076 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4077 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4078 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4079 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4080 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4081 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4082 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4083 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4084 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4085 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4086 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4087 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4088 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4089
4090
4091 Version 1.17.0 (2017-04-27)
4092 ===========================
4093
4094 Language
4095 --------
4096
4097 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4098 * [Fields of structs may be initialized without duplicating the field/variable
4099   names][39761]. [RFC 1682]
4100 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4101 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4102   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4103   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
4104   `'b`. Soundness fix.
4105 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
4106 * [Static variables may contain references to other statics][40027]
4107
4108 Compiler
4109 --------
4110
4111 * [Exit quickly on only `--emit dep-info`][40336]
4112 * [Make `-C relocation-model` more correctly determine whether the linker
4113   creates a position-independent executable][40245]
4114 * [Add `-C overflow-checks` to directly control whether integer overflow
4115   panics][40037]
4116 * [The rustc type checker now checks items on demand instead of in a single
4117   in-order pass][40008]. This is mostly an internal refactoring in support of
4118   future work, including incremental type checking, but also resolves [RFC
4119   1647], allowing `Self` to appear in `impl` `where` clauses.
4120 * [Optimize vtable loads][39995]
4121 * [Turn off vectorization for Emscripten targets][39990]
4122 * [Provide suggestions for unknown macros imported with `use`][39953]
4123 * [Fix ICEs in path resolution][39939]
4124 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
4125 * [Add clearer error message using `&str + &str`][39116]
4126
4127 Stabilized APIs
4128 ---------------
4129
4130 * [`Arc::into_raw`]
4131 * [`Arc::from_raw`]
4132 * [`Arc::ptr_eq`]
4133 * [`Rc::into_raw`]
4134 * [`Rc::from_raw`]
4135 * [`Rc::ptr_eq`]
4136 * [`Ordering::then`]
4137 * [`Ordering::then_with`]
4138 * [`BTreeMap::range`]
4139 * [`BTreeMap::range_mut`]
4140 * [`collections::Bound`]
4141 * [`process::abort`]
4142 * [`ptr::read_unaligned`]
4143 * [`ptr::write_unaligned`]
4144 * [`Result::expect_err`]
4145 * [`Cell::swap`]
4146 * [`Cell::replace`]
4147 * [`Cell::into_inner`]
4148 * [`Cell::take`]
4149
4150 Libraries
4151 ---------
4152
4153 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4154 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4155 * [`String` implements `FromIterator<&char>`][40028]
4156 * `Box` [implements][40009] a number of new conversions:
4157   `From<Box<str>> for String`,
4158   `From<Box<[T]>> for Vec<T>`,
4159   `From<Box<CStr>> for CString`,
4160   `From<Box<OsStr>> for OsString`,
4161   `From<Box<Path>> for PathBuf`,
4162   `Into<Box<str>> for String`,
4163   `Into<Box<[T]>> for Vec<T>`,
4164   `Into<Box<CStr>> for CString`,
4165   `Into<Box<OsStr>> for OsString`,
4166   `Into<Box<Path>> for PathBuf`,
4167   `Default for Box<str>`,
4168   `Default for Box<CStr>`,
4169   `Default for Box<OsStr>`,
4170   `From<&CStr> for Box<CStr>`,
4171   `From<&OsStr> for Box<OsStr>`,
4172   `From<&Path> for Box<Path>`
4173 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4174 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4175 * [Slightly optimize `slice::sort`][39538]
4176 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4177 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4178   `Box<str>` implements `From<&str>`][39438]
4179 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4180   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4181 * [`format!` estimates the needed capacity before writing a string][39356]
4182 * [Support unprivileged symlink creation in Windows][38921]
4183 * [`PathBuf` implements `Default`][38764]
4184 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4185 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4186   and poor hash functions.
4187
4188 Cargo
4189 -----
4190
4191 * [Add `cargo check --all`][cargo/3731]
4192 * [Add an option to ignore SSL revocation checking][cargo/3699]
4193 * [Add `cargo run --package`][cargo/3691]
4194 * [Add `required_features`][cargo/3667]
4195 * [Assume `build.rs` is a build script][cargo/3664]
4196 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4197
4198 Misc
4199 ----
4200
4201 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4202   `rustbook`][39633]
4203 * [The "Unstable Book" documents nightly-only features][ubook]
4204 * [Improve the style of the sidebar in rustdoc output][40265]
4205 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4206 * [Fix MSP430 breakage due to `i128`][40257]
4207 * [Preliminary Solaris/SPARCv9 support][39903]
4208 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4209   run without installing the MSVC runtime.
4210 * [`rustdoc --test` includes file names in test names][39788]
4211 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4212   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4213 * [Initial support for `aarch64-unknown-freebsd`][39491]
4214 * [Initial support for `i686-unknown-netbsd`][39426]
4215 * [This release no longer includes the old makefile build system][39431]. Rust
4216   is built with a custom build system, written in Rust, and with Cargo.
4217 * [Add Debug implementations for libcollection structs][39002]
4218 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4219 * [`--test-threads=0` produces an error][38945]
4220 * [`rustup` installs documentation by default][40526]
4221 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4222   WinDbg and Visual Studio to improve the debugging experience.
4223
4224 Compatibility Notes
4225 -------------------
4226
4227 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4228   workaround, either use MSVC 2015 or run vcvars.bat.
4229 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4230   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4231   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4232   fix.
4233 * [`format!` and `Display::to_string` panic if an underlying formatting
4234   implementation returns an error][40117]. Previously the error was silently
4235   ignored. It is incorrect for `write_fmt` to return an error when writing
4236   to a string.
4237 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4238   crates were marked stable and could be accessed from the stable toolchain.
4239 * [Rust git source no longer includes vendored crates][39728]. Those that need
4240   to build with vendored crates should build from release tarballs.
4241 * [Fix inert attributes from `proc_macro_derives`][39572]
4242 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4243   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4244   build system.
4245 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4246   existing code generally ignores the type of dead-code unless a type-hint is
4247   provided; this can cause surprising inference interactions particularly around
4248   defaulting. The new code uniformly ignores the result type of dead-code.
4249 * [Tuple-struct constructors with private fields are no longer visible][38932]
4250 * [Lifetime parameters that do not appear in the arguments are now considered
4251   early-bound][38897], resolving a soundness bug (#[32330]). The
4252   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4253   April of 2016.
4254 * [rustdoc: fix doctests with non-feature crate attributes][38161]
4255 * [Make transmuting from fn item types to pointer-sized types a hard
4256   error][34198]
4257
4258 [27787]: https://github.com/rust-lang/rust/issues/27787
4259 [32330]: https://github.com/rust-lang/rust/issues/32330
4260 [34198]: https://github.com/rust-lang/rust/pull/34198
4261 [38161]: https://github.com/rust-lang/rust/pull/38161
4262 [38368]: https://github.com/rust-lang/rust/pull/38368
4263 [38584]: https://github.com/rust-lang/rust/issues/38584
4264 [38661]: https://github.com/rust-lang/rust/pull/38661
4265 [38764]: https://github.com/rust-lang/rust/pull/38764
4266 [38864]: https://github.com/rust-lang/rust/issues/38864
4267 [38897]: https://github.com/rust-lang/rust/pull/38897
4268 [38921]: https://github.com/rust-lang/rust/pull/38921
4269 [38932]: https://github.com/rust-lang/rust/pull/38932
4270 [38945]: https://github.com/rust-lang/rust/pull/38945
4271 [38981]: https://github.com/rust-lang/rust/pull/38981
4272 [39002]: https://github.com/rust-lang/rust/pull/39002
4273 [39116]: https://github.com/rust-lang/rust/pull/39116
4274 [39193]: https://github.com/rust-lang/rust/pull/39193
4275 [39265]: https://github.com/rust-lang/rust/pull/39265
4276 [39356]: https://github.com/rust-lang/rust/pull/39356
4277 [39372]: https://github.com/rust-lang/rust/pull/39372
4278 [39426]: https://github.com/rust-lang/rust/pull/39426
4279 [39431]: https://github.com/rust-lang/rust/pull/39431
4280 [39438]: https://github.com/rust-lang/rust/pull/39438
4281 [39440]: https://github.com/rust-lang/rust/pull/39440
4282 [39485]: https://github.com/rust-lang/rust/pull/39485
4283 [39491]: https://github.com/rust-lang/rust/pull/39491
4284 [39518]: https://github.com/rust-lang/rust/pull/39518
4285 [39538]: https://github.com/rust-lang/rust/pull/39538
4286 [39572]: https://github.com/rust-lang/rust/pull/39572
4287 [39633]: https://github.com/rust-lang/rust/pull/39633
4288 [39642]: https://github.com/rust-lang/rust/pull/39642
4289 [39728]: https://github.com/rust-lang/rust/pull/39728
4290 [39761]: https://github.com/rust-lang/rust/pull/39761
4291 [39788]: https://github.com/rust-lang/rust/pull/39788
4292 [39793]: https://github.com/rust-lang/rust/pull/39793
4293 [39837]: https://github.com/rust-lang/rust/pull/39837
4294 [39843]: https://github.com/rust-lang/rust/pull/39843
4295 [39851]: https://github.com/rust-lang/rust/pull/39851
4296 [39903]: https://github.com/rust-lang/rust/pull/39903
4297 [39939]: https://github.com/rust-lang/rust/pull/39939
4298 [39953]: https://github.com/rust-lang/rust/pull/39953
4299 [39960]: https://github.com/rust-lang/rust/pull/39960
4300 [39990]: https://github.com/rust-lang/rust/pull/39990
4301 [39995]: https://github.com/rust-lang/rust/pull/39995
4302 [40008]: https://github.com/rust-lang/rust/pull/40008
4303 [40009]: https://github.com/rust-lang/rust/pull/40009
4304 [40027]: https://github.com/rust-lang/rust/pull/40027
4305 [40028]: https://github.com/rust-lang/rust/pull/40028
4306 [40037]: https://github.com/rust-lang/rust/pull/40037
4307 [40117]: https://github.com/rust-lang/rust/pull/40117
4308 [40166]: https://github.com/rust-lang/rust/pull/40166
4309 [40245]: https://github.com/rust-lang/rust/pull/40245
4310 [40257]: https://github.com/rust-lang/rust/pull/40257
4311 [40261]: https://github.com/rust-lang/rust/pull/40261
4312 [40265]: https://github.com/rust-lang/rust/pull/40265
4313 [40319]: https://github.com/rust-lang/rust/pull/40319
4314 [40336]: https://github.com/rust-lang/rust/pull/40336
4315 [40526]: https://github.com/rust-lang/rust/pull/40526
4316 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4317 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4318 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4319 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4320 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4321 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4322 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4323 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4324 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4325 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4326 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4327 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4328 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4329 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4330 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4331 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4332 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4333 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4334 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4335 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4336 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4337 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4338 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4339 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4340 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4341 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4342 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4343 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4344 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4345 [mdbook]: https://crates.io/crates/mdbook
4346 [ubook]: https://doc.rust-lang.org/unstable-book/
4347
4348
4349 Version 1.16.0 (2017-03-16)
4350 ===========================
4351
4352 Language
4353 --------
4354
4355 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4356 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4357   match patterns][38069]
4358 * [Clean up semantics of `self` in an import list][38313]
4359 * [`Self` may appear in `impl` headers][38920]
4360 * [`Self` may appear in struct expressions][39282]
4361
4362 Compiler
4363 --------
4364
4365 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4366   a `.rmeta` file containing only crate metadata][38571]. This can be
4367   used by tools like the Rust Language Service to perform
4368   metadata-only builds.
4369 * [Levenshtein based typo suggestions now work in most places, while
4370   previously they worked only for fields and sometimes for local
4371   variables][38927]. Together with the overhaul of "no
4372   resolution"/"unexpected resolution" errors (#[38154]) they result in
4373   large and systematic improvement in resolution diagnostics.
4374 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4375   `U`][38670]
4376 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4377 * [`rustc` no longer attempts to provide "consider using an explicit
4378   lifetime" suggestions][37057]. They were inaccurate.
4379
4380 Stabilized APIs
4381 ---------------
4382
4383 * [`VecDeque::truncate`]
4384 * [`VecDeque::resize`]
4385 * [`String::insert_str`]
4386 * [`Duration::checked_add`]
4387 * [`Duration::checked_sub`]
4388 * [`Duration::checked_div`]
4389 * [`Duration::checked_mul`]
4390 * [`str::replacen`]
4391 * [`str::repeat`]
4392 * [`SocketAddr::is_ipv4`]
4393 * [`SocketAddr::is_ipv6`]
4394 * [`IpAddr::is_ipv4`]
4395 * [`IpAddr::is_ipv6`]
4396 * [`Vec::dedup_by`]
4397 * [`Vec::dedup_by_key`]
4398 * [`Result::unwrap_or_default`]
4399 * [`<*const T>::wrapping_offset`]
4400 * [`<*mut T>::wrapping_offset`]
4401 * `CommandExt::creation_flags`
4402 * [`File::set_permissions`]
4403 * [`String::split_off`]
4404
4405 Libraries
4406 ---------
4407
4408 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4409   their argument by `Borrow` parameter][37761]
4410 * [All public types in std implement `Debug`][38006]
4411 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4412 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4413 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4414   Windows][38274]
4415 * [std: Fix partial writes in `LineWriter`][38062]
4416 * [std: Clamp max read/write sizes on Unix][38062]
4417 * [Use more specific panic message for `&str` slicing errors][38066]
4418 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4419   functionality cannot be achieved in std currently.
4420 * [`writeln!`, like `println!`, now accepts a form with no string
4421   or formatting arguments, to just print a newline][38469]
4422 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4423 * [Reduce the size of static data in `std_unicode::tables`][38781]
4424 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4425   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4426   `Display`][38909]
4427 * [`Duration` implements `Sum`][38712]
4428 * [`String` implements `ToSocketAddrs`][39048]
4429
4430 Cargo
4431 -----
4432
4433 * [The `cargo check` command does a type check of a project without
4434   building it][cargo/3296]
4435 * [crates.io will display CI badges from Travis and AppVeyor, if
4436   specified in Cargo.toml][cargo/3546]
4437 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4438 * [Compilation profiles accept integer values for `debug`, in addition
4439   to `true` and `false`. These are passed to `rustc` as the value to
4440   `-C debuginfo`][cargo/3534]
4441 * [Implement `cargo --version --verbose`][cargo/3604]
4442 * [All builds now output 'dep-info' build dependencies compatible with
4443   make and ninja][cargo/3557]
4444 * [Build all workspace members with `build --all`][cargo/3511]
4445 * [Document all workspace members with `doc --all`][cargo/3515]
4446 * [Path deps outside workspace are not members][cargo/3443]
4447
4448 Misc
4449 ----
4450
4451 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4452   the path to the Rust implementation][38589]
4453 * [The `armv7-linux-androideabi` target no longer enables NEON
4454   extensions, per Google's ABI guide][38413]
4455 * [The stock standard library can be compiled for Redox OS][38401]
4456 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4457   available.
4458 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4459   builds available.
4460 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4461
4462 Compatibility Notes
4463 -------------------
4464
4465 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4466   match patterns][38069]
4467 * In this release, references to uninhabited types can not be
4468   pattern-matched. This was accidentally allowed in 1.15.
4469 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4470 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4471   Windows][38274]
4472 * [Clean up semantics of `self` in an import list][38313]
4473 * Reimplemented lifetime elision. This change was almost entirely compatible
4474   with existing code, but it did close a number of small bugs and loopholes,
4475   as well as being more accepting in some other [cases][41105].
4476
4477 [37057]: https://github.com/rust-lang/rust/pull/37057
4478 [37761]: https://github.com/rust-lang/rust/pull/37761
4479 [38006]: https://github.com/rust-lang/rust/pull/38006
4480 [38051]: https://github.com/rust-lang/rust/pull/38051
4481 [38062]: https://github.com/rust-lang/rust/pull/38062
4482 [38062]: https://github.com/rust-lang/rust/pull/38622
4483 [38066]: https://github.com/rust-lang/rust/pull/38066
4484 [38069]: https://github.com/rust-lang/rust/pull/38069
4485 [38131]: https://github.com/rust-lang/rust/pull/38131
4486 [38154]: https://github.com/rust-lang/rust/pull/38154
4487 [38274]: https://github.com/rust-lang/rust/pull/38274
4488 [38304]: https://github.com/rust-lang/rust/pull/38304
4489 [38313]: https://github.com/rust-lang/rust/pull/38313
4490 [38314]: https://github.com/rust-lang/rust/pull/38314
4491 [38327]: https://github.com/rust-lang/rust/pull/38327
4492 [38401]: https://github.com/rust-lang/rust/pull/38401
4493 [38413]: https://github.com/rust-lang/rust/pull/38413
4494 [38469]: https://github.com/rust-lang/rust/pull/38469
4495 [38559]: https://github.com/rust-lang/rust/pull/38559
4496 [38571]: https://github.com/rust-lang/rust/pull/38571
4497 [38580]: https://github.com/rust-lang/rust/pull/38580
4498 [38589]: https://github.com/rust-lang/rust/pull/38589
4499 [38670]: https://github.com/rust-lang/rust/pull/38670
4500 [38712]: https://github.com/rust-lang/rust/pull/38712
4501 [38726]: https://github.com/rust-lang/rust/pull/38726
4502 [38781]: https://github.com/rust-lang/rust/pull/38781
4503 [38798]: https://github.com/rust-lang/rust/pull/38798
4504 [38909]: https://github.com/rust-lang/rust/pull/38909
4505 [38920]: https://github.com/rust-lang/rust/pull/38920
4506 [38927]: https://github.com/rust-lang/rust/pull/38927
4507 [39048]: https://github.com/rust-lang/rust/pull/39048
4508 [39282]: https://github.com/rust-lang/rust/pull/39282
4509 [39379]: https://github.com/rust-lang/rust/pull/39379
4510 [41105]: https://github.com/rust-lang/rust/issues/41105
4511 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4512 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4513 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4514 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4515 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4516 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4517 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4518 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4519 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4520 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4521 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4522 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4523 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4524 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4525 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4526 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4527 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4528 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4529 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4530 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4531 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4532 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4533 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4534 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4535 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4536 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4537 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4538 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4539 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4540 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4541
4542
4543 Version 1.15.1 (2017-02-09)
4544 ===========================
4545
4546 * [Fix IntoIter::as_mut_slice's signature][39466]
4547 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4548
4549 [39466]: https://github.com/rust-lang/rust/pull/39466
4550 [39523]: https://github.com/rust-lang/rust/pull/39523
4551
4552
4553 Version 1.15.0 (2017-02-02)
4554 ===========================
4555
4556 Language
4557 --------
4558
4559 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4560   stable. This allows popular code-generating crates like Serde and Diesel to
4561   work ergonomically. [RFC 1681].
4562 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4563   with curly braces][36868]. Part of [RFC 1506].
4564 * [A number of minor changes to name resolution have been activated][37127].
4565   They add up to more consistent semantics, allowing for future evolution of
4566   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4567   details of what is different. The breaking changes here have been transitioned
4568   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4569 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4570   bounds][38279]
4571 * [`?Sized` can be used in `where` clauses][37791]
4572 * [There is now a limit on the size of monomorphized types and it can be
4573   modified with the `#![type_size_limit]` crate attribute, similarly to
4574   the `#![recursion_limit]` attribute][37789]
4575
4576 Compiler
4577 --------
4578
4579 * [On Windows, the compiler will apply dllimport attributes when linking to
4580   extern functions][37973]. Additional attributes and flags can control which
4581   library kind is linked and its name. [RFC 1717].
4582 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4583 * [The `--test` flag works with procedural macro crates][38107]
4584 * [Fix `extern "aapcs" fn` ABI][37814]
4585 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4586 * [The `format!` expander recognizes incorrect `printf` and shell-style
4587   formatting directives and suggests the correct format][37613].
4588 * [Only report one error for all unused imports in an import list][37456]
4589
4590 Compiler Performance
4591 --------------------
4592
4593 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4594 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4595 * [Don't clone in `UnificationTable::probe`][37848]
4596 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4597 * [Use small vectors in type walker][37760]
4598 * [Macro expansion performance was improved][37701]
4599 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4600 * [Replace FNV with a faster hash function][37229]
4601
4602 Stabilized APIs
4603 ---------------
4604
4605 * [`std::iter::Iterator::min_by`]
4606 * [`std::iter::Iterator::max_by`]
4607 * [`std::os::*::fs::FileExt`]
4608 * [`std::sync::atomic::Atomic*::get_mut`]
4609 * [`std::sync::atomic::Atomic*::into_inner`]
4610 * [`std::vec::IntoIter::as_slice`]
4611 * [`std::vec::IntoIter::as_mut_slice`]
4612 * [`std::sync::mpsc::Receiver::try_iter`]
4613 * [`std::os::unix::process::CommandExt::before_exec`]
4614 * [`std::rc::Rc::strong_count`]
4615 * [`std::rc::Rc::weak_count`]
4616 * [`std::sync::Arc::strong_count`]
4617 * [`std::sync::Arc::weak_count`]
4618 * [`std::char::encode_utf8`]
4619 * [`std::char::encode_utf16`]
4620 * [`std::cell::Ref::clone`]
4621 * [`std::io::Take::into_inner`]
4622
4623 Libraries
4624 ---------
4625
4626 * [The standard sorting algorithm has been rewritten for dramatic performance
4627   improvements][38192]. It is a hybrid merge sort, drawing influences from
4628   Timsort. Previously it was a naive merge sort.
4629 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4630 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4631   performance.
4632 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4633   and `char_indices().last()`][37882]
4634 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4635 * [Chinese characters display correctly in `fmt::Debug`][37855]
4636 * [Derive `Default` for `Duration`][37699]
4637 * [Support creation of anonymous pipes on WinXP/2k][37677]
4638 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4639 * [Don't pass overlapped handles to processes][38835]
4640
4641 Cargo
4642 -----
4643
4644 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4645   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4646   should instead check the variable at runtime with `std::env`. That the value
4647   was set at build time was a bug, and incorrect when cross-compiling. This
4648   change is known to cause breakage.
4649 * [Add `--all` flag to `cargo test`][cargo/3221]
4650 * [Compile statically against the MSVC CRT][cargo/3363]
4651 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4652 * [Link OpenSSL statically on OSX][cargo/3311]
4653 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4654 * [Test for bad path overrides with summaries][cargo/3336]
4655 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4656 * [Fix retrying crate downloads for network errors][cargo/3348]
4657 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4658 * [Emit more info on --message-format=json][cargo/3319]
4659 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4660 * [Don't ignore errors in workspace manifest][cargo/3409]
4661 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4662
4663 Tooling
4664 -------
4665
4666 * [Test runners (binaries built with `--test`) now support a `--list` argument
4667   that lists the tests it contains][38185]
4668 * [Test runners now support a `--exact` argument that makes the test filter
4669   match exactly, instead of matching only a substring of the test name][38181]
4670 * [rustdoc supports a `--playground-url` flag][37763]
4671 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4672
4673 Misc
4674 ----
4675
4676 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4677   continue to be used in this release by passing `--disable-rustbuild` to the
4678   configure script, but they will be deleted soon. Note that the new build
4679   system uses a different on-disk layout that will likely affect any scripts
4680   building Rust.
4681 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4682   releases.
4683 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4684 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4685   releases.
4686
4687 Compatibility Notes
4688 -------------------
4689
4690 * [A number of minor changes to name resolution have been activated][37127].
4691   They add up to more consistent semantics, allowing for future evolution of
4692   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4693   details of what is different. The breaking changes here have been transitioned
4694   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4695 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4696   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4697   should instead check the variable at runtime with `std::env`. That the value
4698   was set at build time was a bug, and incorrect when cross-compiling. This
4699   change is known to cause breakage.
4700 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4701   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4702   1.10 and is now an error by default. It will become a hard error in the near
4703   future.
4704 * [The semantics relating modules to file system directories are changing in
4705   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4706   lint, which is a warning in this release, and will become a hard error in the
4707   future.
4708 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4709 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4710   the underlying iterator][37834]
4711
4712 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4713 [33685]: https://github.com/rust-lang/rust/issues/33685
4714 [36868]: https://github.com/rust-lang/rust/pull/36868
4715 [37127]: https://github.com/rust-lang/rust/pull/37127
4716 [37229]: https://github.com/rust-lang/rust/pull/37229
4717 [37456]: https://github.com/rust-lang/rust/pull/37456
4718 [37527]: https://github.com/rust-lang/rust/pull/37527
4719 [37602]: https://github.com/rust-lang/rust/pull/37602
4720 [37613]: https://github.com/rust-lang/rust/pull/37613
4721 [37615]: https://github.com/rust-lang/rust/pull/37615
4722 [37636]: https://github.com/rust-lang/rust/pull/37636
4723 [37627]: https://github.com/rust-lang/rust/pull/37627
4724 [37642]: https://github.com/rust-lang/rust/pull/37642
4725 [37677]: https://github.com/rust-lang/rust/pull/37677
4726 [37699]: https://github.com/rust-lang/rust/pull/37699
4727 [37701]: https://github.com/rust-lang/rust/pull/37701
4728 [37705]: https://github.com/rust-lang/rust/pull/37705
4729 [37749]: https://github.com/rust-lang/rust/pull/37749
4730 [37760]: https://github.com/rust-lang/rust/pull/37760
4731 [37763]: https://github.com/rust-lang/rust/pull/37763
4732 [37764]: https://github.com/rust-lang/rust/pull/37764
4733 [37789]: https://github.com/rust-lang/rust/pull/37789
4734 [37791]: https://github.com/rust-lang/rust/pull/37791
4735 [37814]: https://github.com/rust-lang/rust/pull/37814
4736 [37817]: https://github.com/rust-lang/rust/pull/37817
4737 [37834]: https://github.com/rust-lang/rust/pull/37834
4738 [37848]: https://github.com/rust-lang/rust/pull/37848
4739 [37855]: https://github.com/rust-lang/rust/pull/37855
4740 [37882]: https://github.com/rust-lang/rust/pull/37882
4741 [37888]: https://github.com/rust-lang/rust/pull/37888
4742 [37973]: https://github.com/rust-lang/rust/pull/37973
4743 [37979]: https://github.com/rust-lang/rust/pull/37979
4744 [38086]: https://github.com/rust-lang/rust/pull/38086
4745 [38107]: https://github.com/rust-lang/rust/pull/38107
4746 [38117]: https://github.com/rust-lang/rust/pull/38117
4747 [38134]: https://github.com/rust-lang/rust/pull/38134
4748 [38146]: https://github.com/rust-lang/rust/pull/38146
4749 [38181]: https://github.com/rust-lang/rust/pull/38181
4750 [38182]: https://github.com/rust-lang/rust/pull/38182
4751 [38185]: https://github.com/rust-lang/rust/pull/38185
4752 [38192]: https://github.com/rust-lang/rust/pull/38192
4753 [38279]: https://github.com/rust-lang/rust/pull/38279
4754 [38835]: https://github.com/rust-lang/rust/pull/38835
4755 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4756 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4757 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4758 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4759 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4760 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4761 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4762 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4763 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4764 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4765 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4766 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4767 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4768 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4769 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4770 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4771 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4772 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4773 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4774 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4775 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4776 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4777 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4778 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4779 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4780 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4781 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4782 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4783 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4784 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4785 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4786 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4787 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4788 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4789 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4790 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4791 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4792 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4793
4794
4795 Version 1.14.0 (2016-12-22)
4796 ===========================
4797
4798 Language
4799 --------
4800
4801 * [`..` matches multiple tuple fields in enum variants, structs
4802   and tuples][36843]. [RFC 1492].
4803 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4804 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4805 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4806   dereferencing][36822]
4807
4808 Compiler
4809 --------
4810
4811 * [Mark enums with non-zero discriminant as non-zero][37224]
4812 * [Lower-case `static mut` names are linted like other
4813   statics and consts][37162]
4814 * [Fix ICE on some macros in const integer positions
4815    (e.g. `[u8; m!()]`)][36819]
4816 * [Improve error message and snippet for "did you mean `x`"][36798]
4817 * [Add a panic-strategy field to the target specification][36794]
4818 * [Include LLVM version in `--version --verbose`][37200]
4819
4820 Compile-time Optimizations
4821 --------------------------
4822
4823 * [Improve macro expansion performance][37569]
4824 * [Shrink `Expr_::ExprInlineAsm`][37445]
4825 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4826 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4827 * [Avoid more allocations when compiling html5ever][37373]
4828 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4829 * [Avoid some allocations in the macro parser][37318]
4830 * [Use a faster deflate setting][37298]
4831 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4832   during interning of slices][37270]
4833 * [Optimize `write_metadata`][37267]
4834 * [Don't process obligation forest cycles when stalled][37231]
4835 * [Avoid many `CrateConfig` clones][37161]
4836 * [Optimize `Substs::super_fold_with`][37108]
4837 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4838 * [Speed up `plug_leaks`][36917]
4839
4840 Libraries
4841 ---------
4842
4843 * [`println!()`, with no arguments, prints newline][36825].
4844   Previously, an empty string was required to achieve the same.
4845 * [`Wrapping` impls standard binary and unary operators, as well as
4846    the `Sum` and `Product` iterators][37356]
4847 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4848   Vec<T>`][37326]
4849 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4850   `VecDeque` iterators][37315]
4851 * [Improve `SipHasher` performance on small values][37312]
4852 * [Add Iterator trait TrustedLen to enable better FromIterator /
4853   Extend][37306]
4854 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4855 * [`ReadDir` implements `Debug`][37221]
4856 * [Implement `RefUnwindSafe` for atomic types][37178]
4857 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4858 * [Avoid allocations in `Decoder::read_str`][37064]
4859 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4860 * [Impl `Debug` for raw pointers to unsized data][36880]
4861 * [Don't reuse `HashMap` random seeds][37470]
4862 * [The internal memory layout of `HashMap` is more cache-friendly, for
4863   significant improvements in some operations][36692]
4864 * [`HashMap` uses less memory on 32-bit architectures][36595]
4865 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4866
4867 Cargo
4868 -----
4869
4870 * [Expose rustc cfg values to build scripts][cargo/3243]
4871 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4872 * [Fix passing --features when testing multiple packages][cargo/3280]
4873 * [Use a single profile set per workspace][cargo/3249]
4874 * [Load `replace` sections from lock files][cargo/3220]
4875 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4876
4877 Tooling
4878 -------
4879
4880 * [rustup is the recommended Rust installation method][1.14rustup]
4881 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4882   S390x. These are [tier 2] platforms and may have major defects. Follow the
4883   instructions on the website to install, or add the targets to an existing
4884   installation with `rustup target add`. The new target triples are:
4885   - `mips-unknown-linux-gnu`
4886   - `mipsel-unknown-linux-gnu`
4887   - `mips64-unknown-linux-gnuabi64`
4888   - `mips64el-unknown-linux-gnuabi64 `
4889   - `powerpc-unknown-linux-gnu`
4890   - `powerpc64-unknown-linux-gnu`
4891   - `powerpc64le-unknown-linux-gnu`
4892   - `s390x-unknown-linux-gnu `
4893 * This release includes target (std) builds for ARM Linux running MUSL
4894   libc. These are [tier 2] platforms and may have major defects. Add the
4895   following triples to an existing rustup installation with `rustup target add`:
4896   - `arm-unknown-linux-musleabi`
4897   - `arm-unknown-linux-musleabihf`
4898   - `armv7-unknown-linux-musleabihf`
4899 * This release includes [experimental support for WebAssembly][1.14wasm], via
4900   the `wasm32-unknown-emscripten` target. This target is known to have major
4901   defects. Please test, report, and fix.
4902 * rustup no longer installs documentation by default. Run `rustup
4903   component add rust-docs` to install.
4904 * [Fix line stepping in debugger][37310]
4905 * [Enable line number debuginfo in releases][37280]
4906
4907 Misc
4908 ----
4909
4910 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4911 * [Add support for Fuchsia OS][37313]
4912 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4913
4914 Compatibility Notes
4915 -------------------
4916
4917 * [A number of forward-compatibility lints used by the compiler
4918   to gradually introduce language changes have been converted
4919   to deny by default][36894]:
4920   - ["use of inaccessible extern crate erroneously allowed"][36886]
4921   - ["type parameter default erroneously allowed in invalid location"][36887]
4922   - ["detects super or self keywords at the beginning of global path"][36888]
4923   - ["two overlapping inherent impls define an item with the same name
4924     were erroneously allowed"][36889]
4925   - ["floating-point constants cannot be used in patterns"][36890]
4926   - ["constants of struct or enum type can only be used in a pattern if
4927      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4928   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4929 * [Prohibit patterns in trait methods without bodies][37378]
4930 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4931 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4932 * [The `$crate` macro variable is accepted in fewer locations][37213]
4933 * [Impls specifying extra region requirements beyond the trait
4934   they implement are rejected][37167]
4935 * [Enums may not be unsized][37111]. Unsized enums are intended to
4936   work but never have. For now they are forbidden.
4937 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4938
4939 [tier 2]: https://forge.rust-lang.org/platform-support.html
4940 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4941 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4942 [36430]: https://github.com/rust-lang/rust/pull/36430
4943 [36595]: https://github.com/rust-lang/rust/pull/36595
4944 [36595]: https://github.com/rust-lang/rust/pull/36595
4945 [36692]: https://github.com/rust-lang/rust/pull/36692
4946 [36767]: https://github.com/rust-lang/rust/pull/36767
4947 [36794]: https://github.com/rust-lang/rust/pull/36794
4948 [36798]: https://github.com/rust-lang/rust/pull/36798
4949 [36819]: https://github.com/rust-lang/rust/pull/36819
4950 [36822]: https://github.com/rust-lang/rust/pull/36822
4951 [36825]: https://github.com/rust-lang/rust/pull/36825
4952 [36843]: https://github.com/rust-lang/rust/pull/36843
4953 [36880]: https://github.com/rust-lang/rust/pull/36880
4954 [36886]: https://github.com/rust-lang/rust/issues/36886
4955 [36887]: https://github.com/rust-lang/rust/issues/36887
4956 [36888]: https://github.com/rust-lang/rust/issues/36888
4957 [36889]: https://github.com/rust-lang/rust/issues/36889
4958 [36890]: https://github.com/rust-lang/rust/issues/36890
4959 [36891]: https://github.com/rust-lang/rust/issues/36891
4960 [36892]: https://github.com/rust-lang/rust/issues/36892
4961 [36894]: https://github.com/rust-lang/rust/pull/36894
4962 [36917]: https://github.com/rust-lang/rust/pull/36917
4963 [36993]: https://github.com/rust-lang/rust/pull/36993
4964 [37037]: https://github.com/rust-lang/rust/pull/37037
4965 [37064]: https://github.com/rust-lang/rust/pull/37064
4966 [37094]: https://github.com/rust-lang/rust/pull/37094
4967 [37108]: https://github.com/rust-lang/rust/pull/37108
4968 [37111]: https://github.com/rust-lang/rust/pull/37111
4969 [37161]: https://github.com/rust-lang/rust/pull/37161
4970 [37162]: https://github.com/rust-lang/rust/pull/37162
4971 [37167]: https://github.com/rust-lang/rust/pull/37167
4972 [37178]: https://github.com/rust-lang/rust/pull/37178
4973 [37200]: https://github.com/rust-lang/rust/pull/37200
4974 [37213]: https://github.com/rust-lang/rust/pull/37213
4975 [37221]: https://github.com/rust-lang/rust/pull/37221
4976 [37224]: https://github.com/rust-lang/rust/pull/37224
4977 [37230]: https://github.com/rust-lang/rust/pull/37230
4978 [37231]: https://github.com/rust-lang/rust/pull/37231
4979 [37247]: https://github.com/rust-lang/rust/pull/37247
4980 [37267]: https://github.com/rust-lang/rust/pull/37267
4981 [37270]: https://github.com/rust-lang/rust/pull/37270
4982 [37273]: https://github.com/rust-lang/rust/pull/37273
4983 [37280]: https://github.com/rust-lang/rust/pull/37280
4984 [37298]: https://github.com/rust-lang/rust/pull/37298
4985 [37306]: https://github.com/rust-lang/rust/pull/37306
4986 [37310]: https://github.com/rust-lang/rust/pull/37310
4987 [37312]: https://github.com/rust-lang/rust/pull/37312
4988 [37313]: https://github.com/rust-lang/rust/pull/37313
4989 [37315]: https://github.com/rust-lang/rust/pull/37315
4990 [37318]: https://github.com/rust-lang/rust/pull/37318
4991 [37322]: https://github.com/rust-lang/rust/pull/37322
4992 [37326]: https://github.com/rust-lang/rust/pull/37326
4993 [37351]: https://github.com/rust-lang/rust/pull/37351
4994 [37356]: https://github.com/rust-lang/rust/pull/37356
4995 [37367]: https://github.com/rust-lang/rust/pull/37367
4996 [37373]: https://github.com/rust-lang/rust/pull/37373
4997 [37378]: https://github.com/rust-lang/rust/pull/37378
4998 [37389]: https://github.com/rust-lang/rust/pull/37389
4999 [37392]: https://github.com/rust-lang/rust/pull/37392
5000 [37427]: https://github.com/rust-lang/rust/pull/37427
5001 [37439]: https://github.com/rust-lang/rust/pull/37439
5002 [37445]: https://github.com/rust-lang/rust/pull/37445
5003 [37470]: https://github.com/rust-lang/rust/pull/37470
5004 [37569]: https://github.com/rust-lang/rust/pull/37569
5005 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5006 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5007 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5008 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5009 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5010 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5011 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5012
5013
5014 Version 1.13.0 (2016-11-10)
5015 ===========================
5016
5017 Language
5018 --------
5019
5020 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5021   errors, like the `try!` macro, described in [RFC 0243].
5022 * [Stabilize macros in type position][36014]. Described in [RFC 873].
5023 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5024 * [Fix `#[derive]` for empty tuple structs/variants][35728]
5025 * [Fix lifetime rules for 'if' conditions][36029]
5026 * [Avoid loading and parsing unconfigured non-inline modules][36482]
5027
5028 Compiler
5029 --------
5030
5031 * [Add the `-C link-arg` argument][36574]
5032 * [Remove the old AST-based backend from rustc_trans][35764]
5033 * [Don't enable NEON by default on armv7 Linux][35814]
5034 * [Fix debug line number info for macro expansions][35238]
5035 * [Do not emit "class method" debuginfo for types that are not
5036   DICompositeType][36008]
5037 * [Warn about multiple conflicting #[repr] hints][34623]
5038 * [When sizing DST, don't double-count nested struct prefixes][36351]
5039 * [Default RUST_MIN_STACK to 16MiB for now][36505]
5040 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5041 * [Reject macros with empty repetitions to avoid infinite loop][36721]
5042 * [Expand macros without recursing to avoid stack overflows][36214]
5043
5044 Diagnostics
5045 -----------
5046
5047 * [Replace macro backtraces with labeled local uses][35702]
5048 * [Improve error message for misplaced doc comments][33922]
5049 * [Buffer unix and lock windows to prevent message interleaving][35975]
5050 * [Update lifetime errors to specifically note temporaries][36171]
5051 * [Special case a few colors for Windows][36178]
5052 * [Suggest `use self` when such an import resolves][36289]
5053 * [Be more specific when type parameter shadows primitive type][36338]
5054 * Many minor improvements
5055
5056 Compile-time Optimizations
5057 --------------------------
5058
5059 * [Compute and cache HIR hashes at beginning][35854]
5060 * [Don't hash types in loan paths][36004]
5061 * [Cache projections in trans][35761]
5062 * [Optimize the parser's last token handling][36527]
5063 * [Only instantiate #[inline] functions in codegen units referencing
5064   them][36524]. This leads to big improvements in cases where crates export
5065   define many inline functions without using them directly.
5066 * [Lazily allocate TypedArena's first chunk][36592]
5067 * [Don't allocate during default HashSet creation][36734]
5068
5069 Stabilized APIs
5070 ---------------
5071
5072 * [`checked_abs`]
5073 * [`wrapping_abs`]
5074 * [`overflowing_abs`]
5075 * [`RefCell::try_borrow`]
5076 * [`RefCell::try_borrow_mut`]
5077
5078 Libraries
5079 ---------
5080
5081 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
5082 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5083   covariant][35354]
5084 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5085 * [Implement `Debug` for `std::vec::IntoIter`][35707]
5086 * [`CString`: avoid excessive growth just to 0-terminate][35871]
5087 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5088 * [Use arc4rand on FreeBSD][35884]
5089 * [memrchr: Correct aligned offset computation][35969]
5090 * [Improve Demangling of Rust Symbols][36059]
5091 * [Use monotonic time in condition variables][35048]
5092 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5093 * [Implement conversion traits for `char`][35755]
5094 * [Fix illegal instruction caused by overflow in channel cloning][36104]
5095 * [Zero first byte of CString on drop][36264]
5096 * [Inherit overflow checks for sum and product][36372]
5097 * [Add missing Eq implementations][36423]
5098 * [Implement `Debug` for `DirEntry`][36631]
5099 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5100   `errno`][36754]
5101 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5102 * [Implement more traits for `std::io::ErrorKind`][35911]
5103 * [Optimize BinaryHeap bounds checking][36072]
5104 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
5105   `extend_with_element`][36355]
5106 * [Fix overflow checking in unsigned pow()][34942]
5107
5108 Cargo
5109 -----
5110
5111 * This release includes security fixes to both curl and OpenSSL.
5112 * [Fix transitive doctests when panic=abort][cargo/3021]
5113 * [Add --all-features flag to cargo][cargo/3038]
5114 * [Reject path-based dependencies in `cargo package`][cargo/3060]
5115 * [Don't parse the home directory more than once][cargo/3078]
5116 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
5117 * [Update OpenSSL to 1.0.2j][cargo/3121]
5118 * [Add license and license_file to cargo metadata output][cargo/3110]
5119 * [Make crates-io registry URL optional in config; ignore all changes to
5120   source.crates-io][cargo/3089]
5121 * [Don't download dependencies from other platforms][cargo/3123]
5122 * [Build transitive dev-dependencies when needed][cargo/3125]
5123 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
5124 * [Avoid updating registry when adding existing deps][cargo/3144]
5125 * [Warn about path overrides that won't work][cargo/3136]
5126 * [Use workspaces during `cargo install`][cargo/3146]
5127 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
5128 * [Add --message-format flag][cargo/3000]
5129 * [Pass target environment for rustdoc][cargo/3205]
5130 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
5131 * [Update curl and curl-sys][cargo/3241]
5132 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
5133
5134 Tooling
5135 -------
5136
5137 * [rustdoc: Add the `--sysroot` argument][36586]
5138 * [rustdoc: Fix a couple of issues with the search results][35655]
5139 * [rustdoc: remove the `!` from macro URLs and titles][35234]
5140 * [gdb: Fix pretty-printing special-cased Rust types][35585]
5141 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5142
5143 Misc
5144 ----
5145
5146 * [Remove unmaintained style guide][35124]
5147 * [Add s390x support][36369]
5148 * [Initial work at Haiku OS support][36727]
5149 * [Add mips-uclibc targets][35734]
5150 * [Crate-ify compiler-rt into compiler-builtins][35021]
5151 * [Add rustc version info (git hash + date) to dist tarball][36213]
5152 * Many documentation improvements
5153
5154 Compatibility Notes
5155 -------------------
5156
5157 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5158 * [Deny (by default) transmuting from fn item types to pointer-sized
5159   types][34923]. Continuing the long transition to zero-sized fn items,
5160   per [RFC 401].
5161 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5162   Part of [RFC 1506].
5163 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5164 * [Fix lifetime rules for 'if' conditions][36029].
5165 * [Inherit overflow checks for sum and product][36372].
5166 * [Forbid user-defined macros named "macro_rules"][36730].
5167
5168 [33922]: https://github.com/rust-lang/rust/pull/33922
5169 [34623]: https://github.com/rust-lang/rust/pull/34623
5170 [34923]: https://github.com/rust-lang/rust/pull/34923
5171 [34942]: https://github.com/rust-lang/rust/pull/34942
5172 [34982]: https://github.com/rust-lang/rust/pull/34982
5173 [35021]: https://github.com/rust-lang/rust/pull/35021
5174 [35048]: https://github.com/rust-lang/rust/pull/35048
5175 [35074]: https://github.com/rust-lang/rust/pull/35074
5176 [35124]: https://github.com/rust-lang/rust/pull/35124
5177 [35234]: https://github.com/rust-lang/rust/pull/35234
5178 [35238]: https://github.com/rust-lang/rust/pull/35238
5179 [35354]: https://github.com/rust-lang/rust/pull/35354
5180 [35559]: https://github.com/rust-lang/rust/pull/35559
5181 [35585]: https://github.com/rust-lang/rust/pull/35585
5182 [35627]: https://github.com/rust-lang/rust/pull/35627
5183 [35655]: https://github.com/rust-lang/rust/pull/35655
5184 [35702]: https://github.com/rust-lang/rust/pull/35702
5185 [35707]: https://github.com/rust-lang/rust/pull/35707
5186 [35728]: https://github.com/rust-lang/rust/pull/35728
5187 [35734]: https://github.com/rust-lang/rust/pull/35734
5188 [35755]: https://github.com/rust-lang/rust/pull/35755
5189 [35761]: https://github.com/rust-lang/rust/pull/35761
5190 [35764]: https://github.com/rust-lang/rust/pull/35764
5191 [35814]: https://github.com/rust-lang/rust/pull/35814
5192 [35854]: https://github.com/rust-lang/rust/pull/35854
5193 [35871]: https://github.com/rust-lang/rust/pull/35871
5194 [35884]: https://github.com/rust-lang/rust/pull/35884
5195 [35911]: https://github.com/rust-lang/rust/pull/35911
5196 [35969]: https://github.com/rust-lang/rust/pull/35969
5197 [35975]: https://github.com/rust-lang/rust/pull/35975
5198 [36004]: https://github.com/rust-lang/rust/pull/36004
5199 [36008]: https://github.com/rust-lang/rust/pull/36008
5200 [36014]: https://github.com/rust-lang/rust/pull/36014
5201 [36029]: https://github.com/rust-lang/rust/pull/36029
5202 [36059]: https://github.com/rust-lang/rust/pull/36059
5203 [36072]: https://github.com/rust-lang/rust/pull/36072
5204 [36101]: https://github.com/rust-lang/rust/pull/36101
5205 [36104]: https://github.com/rust-lang/rust/pull/36104
5206 [36171]: https://github.com/rust-lang/rust/pull/36171
5207 [36173]: https://github.com/rust-lang/rust/pull/36173
5208 [36178]: https://github.com/rust-lang/rust/pull/36178
5209 [36213]: https://github.com/rust-lang/rust/pull/36213
5210 [36214]: https://github.com/rust-lang/rust/pull/36214
5211 [36264]: https://github.com/rust-lang/rust/pull/36264
5212 [36266]: https://github.com/rust-lang/rust/pull/36266
5213 [36289]: https://github.com/rust-lang/rust/pull/36289
5214 [36338]: https://github.com/rust-lang/rust/pull/36338
5215 [36351]: https://github.com/rust-lang/rust/pull/36351
5216 [36355]: https://github.com/rust-lang/rust/pull/36355
5217 [36369]: https://github.com/rust-lang/rust/pull/36369
5218 [36372]: https://github.com/rust-lang/rust/pull/36372
5219 [36423]: https://github.com/rust-lang/rust/pull/36423
5220 [36482]: https://github.com/rust-lang/rust/pull/36482
5221 [36505]: https://github.com/rust-lang/rust/pull/36505
5222 [36524]: https://github.com/rust-lang/rust/pull/36524
5223 [36527]: https://github.com/rust-lang/rust/pull/36527
5224 [36551]: https://github.com/rust-lang/rust/pull/36551
5225 [36574]: https://github.com/rust-lang/rust/pull/36574
5226 [36586]: https://github.com/rust-lang/rust/pull/36586
5227 [36592]: https://github.com/rust-lang/rust/pull/36592
5228 [36631]: https://github.com/rust-lang/rust/pull/36631
5229 [36639]: https://github.com/rust-lang/rust/pull/36639
5230 [36721]: https://github.com/rust-lang/rust/pull/36721
5231 [36727]: https://github.com/rust-lang/rust/pull/36727
5232 [36730]: https://github.com/rust-lang/rust/pull/36730
5233 [36734]: https://github.com/rust-lang/rust/pull/36734
5234 [36754]: https://github.com/rust-lang/rust/pull/36754
5235 [36995]: https://github.com/rust-lang/rust/pull/36995
5236 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5237 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5238 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5239 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5240 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5241 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5242 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5243 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5244 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5245 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5246 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5247 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5248 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5249 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5250 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5251 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5252 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5253 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5254 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5255 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5256 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5257 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5258 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5259 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5260 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5261 [rustup]: https://www.rustup.rs
5262 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5263 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5264 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5265 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5266 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5267 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5268 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5269
5270
5271 Version 1.12.1 (2016-10-20)
5272 ===========================
5273
5274 Regression Fixes
5275 ----------------
5276
5277 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5278 * [Confusion with double negation and booleans][36856]
5279 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5280 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5281 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
5282 * [Corrupted memory after updated to 1.12][36936]
5283 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5284 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5285 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5286
5287 [36381]: https://github.com/rust-lang/rust/issues/36381
5288 [36856]: https://github.com/rust-lang/rust/issues/36856
5289 [36875]: https://github.com/rust-lang/rust/issues/36875
5290 [36924]: https://github.com/rust-lang/rust/issues/36924
5291 [36926]: https://github.com/rust-lang/rust/issues/36926
5292 [36936]: https://github.com/rust-lang/rust/issues/36936
5293 [37026]: https://github.com/rust-lang/rust/issues/37026
5294 [37112]: https://github.com/rust-lang/rust/issues/37112
5295 [37153]: https://github.com/rust-lang/rust/issues/37153
5296
5297
5298 Version 1.12.0 (2016-09-29)
5299 ===========================
5300
5301 Highlights
5302 ----------
5303
5304 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5305   This translation pass is far simpler than the previous AST->LLVM pass, and
5306   creates opportunities to perform new optimizations directly on the MIR. It
5307   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5308 * [`rustc` presents a new, more readable error format, along with
5309   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5310   Most common editors supporting Rust have been updated to work with it. It was
5311   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5312
5313 Compiler
5314 --------
5315
5316 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5317   This translation pass is far simpler than the previous AST->LLVM pass, and
5318   creates opportunities to perform new optimizations directly on the MIR. It
5319   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5320 * [Print the Rust target name, not the LLVM target name, with
5321   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5322 * [The computation of `TypeId` is correct in some cases where it was previously
5323   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5324 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5325 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5326   `--print relocation-models`, and `--print code-models` print the available
5327   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5328   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5329 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5330   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5331   These targets produce statically-linked binaries. There are no binary release
5332   builds yet though.
5333
5334 Diagnostics
5335 -----------
5336
5337 * [`rustc` presents a new, more readable error format, along with
5338   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5339   Most common editors supporting Rust have been updated to work with it. It was
5340   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5341 * [In error descriptions, references are now described in plain English,
5342   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5343 * [In error type descriptions, unknown numeric types are named `{integer}` or
5344   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5345 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5346
5347 Language
5348 --------
5349
5350 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5351 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5352 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5353   useful](https://github.com/rust-lang/rust/pull/34908)
5354 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5355   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5356 * [Semicolons are properly required as statement delimiters inside
5357   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5358 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5359
5360 Stabilized APIs
5361 ---------------
5362
5363 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5364 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5365 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5366 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5367 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5368 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5369 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5370 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5371 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5372 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5373   Both on Unix and Windows.
5374 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5375 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5376 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5377 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5378 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5379 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5380 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5381 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5382
5383 Libraries
5384 ---------
5385
5386 * [The `format!` macro and friends now allow a single argument to be formatted
5387   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5388 * [The lifetime bounds on `[T]::binary_search_by` and
5389   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5390 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5391 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5392 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5393 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5394 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5395 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5396 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5397 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5398   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5399 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5400   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5401 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5402 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5403   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5404 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5405 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5406 * [`mpsc::sync_channel` `Receiver`s return any available message before
5407   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5408 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5409 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5410
5411 Cargo
5412 -----
5413
5414 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5415 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5416 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5417 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5418 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5419 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5420 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5421 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5422 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5423 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5424 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5425 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5426 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5427 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5428 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5429 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5430
5431 Performance
5432 -----------
5433
5434 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5435 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5436
5437 Tooling
5438 -------
5439
5440 * [Test binaries now support a `--test-threads` argument to specify the number
5441   of threads used to run tests, and which acts the same as the
5442   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5443 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5444 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5445 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5446 * [Rust releases now come with source packages that can be installed by rustup
5447   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5448   The resulting source code can be used by tools and IDES, located in the
5449   sysroot under `lib/rustlib/src`.
5450
5451 Misc
5452 ----
5453
5454 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5455 * Many minor improvements to the documentation.
5456 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5457
5458 Compatibility Notes
5459 -------------------
5460
5461 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5462   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5463 * [When formatting strings, if "precision" is specified, the "fill",
5464   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5465 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5466
5467
5468 Version 1.11.0 (2016-08-18)
5469 ===========================
5470
5471 Language
5472 --------
5473
5474 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5475 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5476 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5477 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5478
5479 Stabilized APIs
5480 ---------------
5481
5482 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5483 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5484 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5485 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5486 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5487 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5488   (in libcore - previously stabilized in libstd)
5489 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5490   (in libcore - previously stabilized in libstd)
5491 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5492   (in libcore - previously stabilized in libstd)
5493 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5494   (in libcore - previously stabilized in libstd)
5495 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5496 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5497 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5498 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5499
5500 Libraries
5501 ---------
5502
5503 * [The `thread_local!` macro supports multiple definitions in a single
5504    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5505 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5506 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5507   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5508 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5509 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5510 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5511 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5512
5513 Cargo
5514 -----
5515
5516 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5517 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5518 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5519 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5520 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5521   and `-vv` prints warnings for all crates.
5522 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5523 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5524   This provides room for expansion by arbitrary tools.
5525 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5526 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5527 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5528 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5529 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5530 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5531 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5532
5533 Performance
5534 -----------
5535
5536 * [Caching projections speeds up type check dramatically for some
5537   workloads](https://github.com/rust-lang/rust/pull/33816)
5538 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5539   This hasher is faster, but is believed to provide sufficient
5540   protection from collision attacks.
5541 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5542
5543 Rustdoc
5544 -------
5545
5546 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5547 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5548 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5549 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5550 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5551
5552 Tooling
5553 -------
5554
5555 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5556 * [When emitting debug info, rustc emits frame pointers for closures,
5557   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5558 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5559 * Many more errors have been given error codes and extended
5560   explanations
5561 * API documentation continues to be improved, with many new examples
5562
5563 Misc
5564 ----
5565
5566 * [rustc no longer hangs when dependencies recursively re-export
5567   submodules](https://github.com/rust-lang/rust/pull/34542)
5568 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5569 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5570   rewritten](https://github.com/rust-lang/rust/pull/33895)
5571 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5572   No targets use this yet, but it works toward AVR support.
5573
5574 Compatibility Notes
5575 -------------------
5576
5577 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5578 * [The new follow-set rules that place restrictions on `macro_rules!`
5579   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5580   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5581   and has been a warning since 1.10.
5582 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5583   This causes breakage in some corner cases.
5584
5585
5586 Version 1.10.0 (2016-07-07)
5587 ===========================
5588
5589 Language
5590 --------
5591
5592 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5593   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5594 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5595 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5596 * [`panic!` can be converted to a runtime abort with the
5597   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5598   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5599 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5600   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5601   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5602   Note that Cargo does not yet directly support cdylibs.
5603
5604 Stabilized APIs
5605 ---------------
5606
5607 * `os::windows::fs::OpenOptionsExt::access_mode`
5608 * `os::windows::fs::OpenOptionsExt::share_mode`
5609 * `os::windows::fs::OpenOptionsExt::custom_flags`
5610 * `os::windows::fs::OpenOptionsExt::attributes`
5611 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5612 * `os::unix::fs::OpenOptionsExt::custom_flags`
5613 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5614 * `Default for sync::Weak`
5615 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5616 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5617 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5618 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5619 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5620 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5621 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5622 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5623 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5624 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5625 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5626 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5627 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5628 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5629 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5630 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5631 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5632 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5633 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5634 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5635 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5636 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5637 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5638 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5639 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5640 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5641 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5642 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5643 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5644 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5645 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5646 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5647 * Read/Write/RawFd impls for `UnixStream`
5648 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5649 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5650 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5651 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5652 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5653 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5654 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5655 * RawFd impls for `UnixListener`
5656 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5657 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5658 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5659 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5660 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5661 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5662 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5663 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5664 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5665 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5666 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5667 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5668 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5669 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5670 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5671 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5672 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5673 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5674 * RawFd impls for `UnixDatagram`
5675 * `{BTree,Hash}Map::values_mut`
5676 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5677
5678 Libraries
5679 ---------
5680
5681 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5682   The semantics of this minor method are subtle and probably not what
5683   most people want.
5684 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5685 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5686   will fall back to `/dev/urandom` temporarily to avoid blocking
5687   during early boot](https://github.com/rust-lang/rust/pull/33086).
5688 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5689 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5690 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5691 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5692 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5693 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5694   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5695
5696 Cargo
5697 -----
5698 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5699   This controls the runtime behavior of the `panic!` macro
5700   and can be either "unwind" (the default), or "abort".
5701   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5702 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5703 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5704 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5705   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5706 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5707 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5708 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5709   By default they are retried twice, which can be customized with the
5710   `net.retry` value in `.cargo/config`.
5711 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5712 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5713 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5714 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5715   Makes it possible to install multiple crates in parallel.
5716 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5717 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5718 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5719 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5720 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5721 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5722
5723 Performance
5724 -----------
5725
5726 * [rustc memory usage was reduced by refactoring the context used for
5727   type checking](https://github.com/rust-lang/rust/pull/33425).
5728 * [Speed up creation of `HashMap`s by caching the random keys used
5729   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5730 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5731 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5732 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5733   10x faster than the previous lookup tables.
5734 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5735
5736 Usability
5737 ---------
5738
5739 * Many incremental improvements to documentation and rustdoc.
5740 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5741 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5742 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5743 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5744 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5745 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5746 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5747
5748 Misc
5749 ----
5750
5751 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5752 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5753 * [`std` no longer prints backtraces on platforms where the running
5754   module must be loaded with `env::current_exe`, which can't be relied
5755   on](https://github.com/rust-lang/rust/pull/33554).
5756 * This release includes std binaries for the i586-unknown-linux-gnu,
5757   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5758   i586 target is for old x86 hardware without SSE2, and the armv7
5759   target is for Android running on modern ARM architectures.
5760 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5761   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5762 * [On Unix the runtime aborts by calling `libc::abort` instead of
5763   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5764 * [Rust is now bootstrapped from the previous release of Rust,
5765   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5766
5767 Compatibility Notes
5768 -------------------
5769
5770 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5771 * [`target_env` for Linux ARM targets is just `gnu`, not
5772   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5773 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5774 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5775 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5776   Affects how macros are parsed.
5777 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5778 * [Feature-gated attributes on macro-generated macro invocations are
5779   now rejected](https://github.com/rust-lang/rust/pull/32791).
5780 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5781   This caused some minor changes to type inference.
5782
5783
5784 Version 1.9.0 (2016-05-26)
5785 ==========================
5786
5787 Language
5788 --------
5789
5790 * The `#[deprecated]` attribute when applied to an API will generate
5791   warnings when used. The warnings may be suppressed with
5792   `#[allow(deprecated)]`. [RFC 1270].
5793 * [`fn` item types are zero sized, and each `fn` names a unique
5794   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5795   `transmute` on a `fn` type will generate a warning for a few cycles,
5796   then will be converted to an error.
5797 * [Field and method resolution understand visibility, so private
5798   fields and methods cannot prevent the proper use of public fields
5799   and methods][1.9fv].
5800 * [The parser considers unicode codepoints in the
5801   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5802
5803 Stabilized APIs
5804 ---------------
5805
5806 * [`std::panic`]
5807 * [`std::panic::catch_unwind`] (renamed from `recover`)
5808 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5809 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5810 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5811 * [`str::is_char_boundary`]
5812 * [`<*const T>::as_ref`]
5813 * [`<*mut T>::as_ref`]
5814 * [`<*mut T>::as_mut`]
5815 * [`AsciiExt::make_ascii_uppercase`]
5816 * [`AsciiExt::make_ascii_lowercase`]
5817 * [`char::decode_utf16`]
5818 * [`char::DecodeUtf16`]
5819 * [`char::DecodeUtf16Error`]
5820 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5821 * [`BTreeSet::take`]
5822 * [`BTreeSet::replace`]
5823 * [`BTreeSet::get`]
5824 * [`HashSet::take`]
5825 * [`HashSet::replace`]
5826 * [`HashSet::get`]
5827 * [`OsString::with_capacity`]
5828 * [`OsString::clear`]
5829 * [`OsString::capacity`]
5830 * [`OsString::reserve`]
5831 * [`OsString::reserve_exact`]
5832 * [`OsStr::is_empty`]
5833 * [`OsStr::len`]
5834 * [`std::os::unix::thread`]
5835 * [`RawPthread`]
5836 * [`JoinHandleExt`]
5837 * [`JoinHandleExt::as_pthread_t`]
5838 * [`JoinHandleExt::into_pthread_t`]
5839 * [`HashSet::hasher`]
5840 * [`HashMap::hasher`]
5841 * [`CommandExt::exec`]
5842 * [`File::try_clone`]
5843 * [`SocketAddr::set_ip`]
5844 * [`SocketAddr::set_port`]
5845 * [`SocketAddrV4::set_ip`]
5846 * [`SocketAddrV4::set_port`]
5847 * [`SocketAddrV6::set_ip`]
5848 * [`SocketAddrV6::set_port`]
5849 * [`SocketAddrV6::set_flowinfo`]
5850 * [`SocketAddrV6::set_scope_id`]
5851 * [`slice::copy_from_slice`]
5852 * [`ptr::read_volatile`]
5853 * [`ptr::write_volatile`]
5854 * [`OpenOptions::create_new`]
5855 * [`TcpStream::set_nodelay`]
5856 * [`TcpStream::nodelay`]
5857 * [`TcpStream::set_ttl`]
5858 * [`TcpStream::ttl`]
5859 * [`TcpStream::set_only_v6`]
5860 * [`TcpStream::only_v6`]
5861 * [`TcpStream::take_error`]
5862 * [`TcpStream::set_nonblocking`]
5863 * [`TcpListener::set_ttl`]
5864 * [`TcpListener::ttl`]
5865 * [`TcpListener::set_only_v6`]
5866 * [`TcpListener::only_v6`]
5867 * [`TcpListener::take_error`]
5868 * [`TcpListener::set_nonblocking`]
5869 * [`UdpSocket::set_broadcast`]
5870 * [`UdpSocket::broadcast`]
5871 * [`UdpSocket::set_multicast_loop_v4`]
5872 * [`UdpSocket::multicast_loop_v4`]
5873 * [`UdpSocket::set_multicast_ttl_v4`]
5874 * [`UdpSocket::multicast_ttl_v4`]
5875 * [`UdpSocket::set_multicast_loop_v6`]
5876 * [`UdpSocket::multicast_loop_v6`]
5877 * [`UdpSocket::set_multicast_ttl_v6`]
5878 * [`UdpSocket::multicast_ttl_v6`]
5879 * [`UdpSocket::set_ttl`]
5880 * [`UdpSocket::ttl`]
5881 * [`UdpSocket::set_only_v6`]
5882 * [`UdpSocket::only_v6`]
5883 * [`UdpSocket::join_multicast_v4`]
5884 * [`UdpSocket::join_multicast_v6`]
5885 * [`UdpSocket::leave_multicast_v4`]
5886 * [`UdpSocket::leave_multicast_v6`]
5887 * [`UdpSocket::take_error`]
5888 * [`UdpSocket::connect`]
5889 * [`UdpSocket::send`]
5890 * [`UdpSocket::recv`]
5891 * [`UdpSocket::set_nonblocking`]
5892
5893 Libraries
5894 ---------
5895
5896 * [`std::sync::Once` is poisoned if its initialization function
5897   fails][1.9o].
5898 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5899 * [Most types implement `fmt::Debug`][1.9db].
5900 * [The default buffer size used by `BufReader` and `BufWriter` was
5901   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5902   used by other languages.
5903 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5904   `Duration` additionally implements `*=` and `/=`][1.9ta].
5905 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5906 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5907 * [`Chain` implements `BufRead`][1.9ch].
5908 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5909
5910 Cargo
5911 -----
5912
5913 * [Cargo can now run concurrently][1.9cc].
5914 * [Top-level overrides allow specific revisions of crates to be
5915   overridden through the entire crate graph][1.9ct].  This is intended
5916   to make upgrades easier for large projects, by allowing crates to be
5917   forked temporarily until they've been upgraded and republished.
5918 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5919 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5920   on the commandline][1.9cf]. `rustc` arguments can also be specified
5921   in the `build.rustflags` configuration key.
5922
5923 Performance
5924 -----------
5925
5926 * [The time complexity of comparing variables for equivalence during type
5927   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5928   to major compilation time improvement in some scenarios.
5929 * [`ToString` is specialized for `str`, giving it the same performance
5930   as `to_owned`][1.9ts].
5931 * [Spawning processes with `Command::output` no longer creates extra
5932   threads][1.9sp].
5933 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5934   for C-like enums][1.9cl].
5935
5936 Misc
5937 ----
5938
5939 * [Passing the `--quiet` flag to a test runner will produce
5940   much-abbreviated output][1.9q].
5941 * The Rust Project now publishes std binaries for the
5942   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5943   `i586-pc-windows-msvc` targets.
5944
5945 Compatibility Notes
5946 -------------------
5947
5948 * [`std::sync::Once` is poisoned if its initialization function
5949   fails][1.9o].
5950 * [It is illegal to define methods with the same name in overlapping
5951   inherent `impl` blocks][1.9sn].
5952 * [`fn` item types are zero sized, and each `fn` names a unique
5953   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5954   `transmute` on a `fn` type will generate a warning for a few cycles,
5955   then will be converted to an error.
5956 * [Improvements to const evaluation may trigger new errors when integer
5957   literals are out of range][1.9ce].
5958
5959
5960 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5961 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5962 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5963 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5964 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5965 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5966 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5967 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5968 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5969 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5970 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5971 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5972 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5973 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5974 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5975 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5976 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5977 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5978 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5979 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5980 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5981 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5982 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5983 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5984 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5985 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5986 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5987 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5988 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5989 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5990 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5991 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5992 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5993 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5994 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5995 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5996 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5997 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5998 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5999 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6000 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6001 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6002 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6003 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6004 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6005 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6006 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6007 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6008 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6009 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6010 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6011 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6012 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6013 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6014 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6015 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6016 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6017 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6018 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6019 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6020 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6021 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6022 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6023 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6024 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6025 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6026 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6027 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6028 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6029 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6030 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6031 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6032 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6033 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6034 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6035 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6036 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6037 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6038 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6039 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6040 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6041 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6042 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6043 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6044 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6045 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6046 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6047 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6048 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6049 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6050 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6051 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6052 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6053 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6054 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6055 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6056 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6057 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6058 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6059 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6060 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6061 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6062 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6063 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6064 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6065 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6066 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6067 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6068 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6069 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6070
6071
6072 Version 1.8.0 (2016-04-14)
6073 ==========================
6074
6075 Language
6076 --------
6077
6078 * Rust supports overloading of compound assignment statements like
6079   `+=` by implementing the [`AddAssign`], [`SubAssign`],
6080   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6081   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6082   traits. [RFC 953].
6083 * Empty structs can be defined with braces, as in `struct Foo { }`, in
6084   addition to the non-braced form, `struct Foo;`. [RFC 218].
6085
6086 Libraries
6087 ---------
6088
6089 * Stabilized APIs:
6090   * [`str::encode_utf16`] (renamed from `utf16_units`)
6091   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
6092   * [`Ref::map`]
6093   * [`RefMut::map`]
6094   * [`ptr::drop_in_place`]
6095   * [`time::Instant`]
6096   * [`time::SystemTime`]
6097   * [`Instant::now`]
6098   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
6099   * [`Instant::elapsed`]
6100   * [`SystemTime::now`]
6101   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
6102   * [`SystemTime::elapsed`]
6103   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
6104   * [`SystemTimeError`]
6105   * [`SystemTimeError::duration`]
6106   * Various impls for `SystemTimeError`
6107   * [`UNIX_EPOCH`]
6108   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
6109     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
6110     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
6111 * [The `write!` and `writeln!` macros correctly emit errors if any of
6112   their arguments can't be formatted][1.8w].
6113 * [Various I/O functions support large files on 32-bit Linux][1.8l].
6114 * [The Unix-specific `raw` modules, which contain a number of
6115   redefined C types are deprecated][1.8r], including `os::raw::unix`,
6116   `os::raw::macos`, and `os::raw::linux`. These modules defined types
6117   such as `ino_t` and `dev_t`. The inconsistency of these definitions
6118   across platforms was making it difficult to implement `std`
6119   correctly. Those that need these definitions should use the `libc`
6120   crate. [RFC 1415].
6121 * The Unix-specific `MetadataExt` traits, including
6122   `os::unix::fs::MetadataExt`, which expose values such as inode
6123   numbers [no longer return platform-specific types][1.8r], but
6124   instead return widened integers. [RFC 1415].
6125 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
6126 * [Atomic loads and stores are not volatile][1.8a].
6127 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
6128
6129 Performance
6130 -----------
6131
6132 * [Inlining hash functions lead to a 3% compile-time improvement in
6133   some workloads][1.8h].
6134 * When using jemalloc, its symbols are [unprefixed so that it
6135   overrides the libc malloc implementation][1.8h]. This means that for
6136   rustc, LLVM is now using jemalloc, which results in a 6%
6137   compile-time improvement on a specific workload.
6138 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
6139
6140 Misc
6141 ----
6142
6143 * [32-bit MSVC builds finally implement unwinding][1.8ms].
6144   i686-pc-windows-msvc is now considered a tier-1 platform.
6145 * [The `--print targets` flag prints a list of supported targets][1.8t].
6146 * [The `--print cfg` flag prints the `cfg`s defined for the current
6147   target][1.8cf].
6148 * [`rustc` can be built with an new Cargo-based build system, written
6149   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6150   build system. To enable it configure with `configure --rustbuild`.
6151 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6152   variants while also indicating the total number of missing variants
6153   if more than 3][1.8m].
6154 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6155 * The Rust Project now publishes binary releases of the standard
6156   library for a number of tier-2 targets:
6157   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6158   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6159   `x86_64-rumprun-netbsd`. These can be installed with
6160   tools such as [multirust][1.8mr].
6161
6162 Cargo
6163 -----
6164
6165 * [`cargo init` creates a new Cargo project in the current
6166   directory][1.8ci].  It is otherwise like `cargo new`.
6167 * [Cargo has configuration keys for `-v` and
6168   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6169   `[term]` section of `.cargo/config`.
6170 * [Configuration keys that evaluate to strings or integers can be set
6171   via environment variables][1.8ce]. For example the `build.jobs` key
6172   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6173   precedence over config files.
6174 * [Target-specific dependencies support Rust `cfg` syntax for
6175   describing targets][1.8cfg] so that dependencies for multiple
6176   targets can be specified together. [RFC 1361].
6177 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6178   `RUSTDOC` take precedence over the `build.target-dir`,
6179   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6180 * [The child process tree is killed on Windows when Cargo is
6181   killed][1.8ck].
6182 * [The `build.target` configuration value sets the target platform,
6183   like `--target`][1.8ct].
6184
6185 Compatibility Notes
6186 -------------------
6187
6188 * [Unstable compiler flags have been further restricted][1.8u]. Since
6189   1.0 `-Z` flags have been considered unstable, and other flags that
6190   were considered unstable additionally required passing `-Z
6191   unstable-options` to access. Unlike unstable language and library
6192   features though, these options have been accessible on the stable
6193   release channel. Going forward, *new unstable flags will not be
6194   available on the stable release channel*, and old unstable flags
6195   will warn about their usage. In the future, all unstable flags will
6196   be unavailable on the stable release channel.
6197 * [It is no longer possible to `match` on empty enum variants using
6198   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6199 * The Unix-specific `MetadataExt` traits, including
6200   `os::unix::fs::MetadataExt`, which expose values such as inode
6201   numbers [no longer return platform-specific types][1.8r], but
6202   instead return widened integers. [RFC 1415].
6203 * [Modules sourced from the filesystem cannot appear within arbitrary
6204   blocks, but only within other modules][1.8mf].
6205 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6206 * On Unix, [stack overflow triggers a runtime abort instead of a
6207   SIGSEGV][1.8so].
6208 * [`Command::spawn` and its equivalents return an error if any of
6209   its command-line arguments contain interior `NUL`s][1.8n].
6210 * [Tuple and unit enum variants from other crates are in the type
6211   namespace][1.8tn].
6212 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6213   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6214   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6215   instead of `foo.lib`.
6216
6217
6218 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6219 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6220 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6221 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6222 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6223 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6224 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6225 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6226 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6227 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6228 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6229 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6230 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6231 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6232 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6233 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6234 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6235 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6236 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6237 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6238 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6239 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6240 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6241 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6242 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6243 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6244 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6245 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6246 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6247 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6248 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6249 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6250 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6251 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6252 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6253 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6254 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6255 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6256 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6257 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6258 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6259 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6260 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6261 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6262 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6263 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6264 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6265 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6266 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6267 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6268 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6269 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6270 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6271 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6272 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6273 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6274 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6275 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6276 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6277 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6278
6279
6280 Version 1.7.0 (2016-03-03)
6281 ==========================
6282
6283 Libraries
6284 ---------
6285
6286 * Stabilized APIs
6287   * `Path`
6288     * [`Path::strip_prefix`] (renamed from relative_from)
6289     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
6290   * `Ipv4Addr`
6291     * [`Ipv4Addr::is_loopback`]
6292     * [`Ipv4Addr::is_private`]
6293     * [`Ipv4Addr::is_link_local`]
6294     * [`Ipv4Addr::is_multicast`]
6295     * [`Ipv4Addr::is_broadcast`]
6296     * [`Ipv4Addr::is_documentation`]
6297   * `Ipv6Addr`
6298     * [`Ipv6Addr::is_unspecified`]
6299     * [`Ipv6Addr::is_loopback`]
6300     * [`Ipv6Addr::is_multicast`]
6301   * `Vec`
6302     * [`Vec::as_slice`]
6303     * [`Vec::as_mut_slice`]
6304   * `String`
6305     * [`String::as_str`]
6306     * [`String::as_mut_str`]
6307   * Slices
6308     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6309     be the same length
6310     * `<[T]>::`[`sort_by_key`]
6311   * checked, saturated, and overflowing operations
6312     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6313     * [`i32::saturating_mul`]
6314     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6315     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6316     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6317     * [`u32::saturating_mul`]
6318     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6319     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6320     * and checked, saturated, and overflowing operations for other primitive types
6321   * FFI
6322     * [`ffi::IntoStringError`]
6323     * [`CString::into_string`]
6324     * [`CString::into_bytes`]
6325     * [`CString::into_bytes_with_nul`]
6326     * `From<CString> for Vec<u8>`
6327   * `IntoStringError`
6328     * [`IntoStringError::into_cstring`]
6329     * [`IntoStringError::utf8_error`]
6330     * `Error for IntoStringError`
6331   * Hashing
6332     * [`std::hash::BuildHasher`]
6333     * [`BuildHasher::Hasher`]
6334     * [`BuildHasher::build_hasher`]
6335     * [`std::hash::BuildHasherDefault`]
6336     * [`HashMap::with_hasher`]
6337     * [`HashMap::with_capacity_and_hasher`]
6338     * [`HashSet::with_hasher`]
6339     * [`HashSet::with_capacity_and_hasher`]
6340     * [`std::collections::hash_map::RandomState`]
6341     * [`RandomState::new`]
6342 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6343   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6344   from bytes is faster.
6345 * [The performance of `LineWriter` (and thus `io::stdout`) was
6346   improved by using `memchr` to search for newlines][1.7m].
6347 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6348   `f64` variants were stabilized previously.
6349 * [`BTreeMap` was rewritten to use less memory and improve the performance
6350   of insertion and iteration, the latter by as much as 5x][1.7bm].
6351 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6352   covariant over their contained type][1.7bt].
6353 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6354   over their contained type][1.7ll].
6355 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6356   searching methods.
6357 * [`Any` is implemented for unsized types][1.7a].
6358 * [`Hash` is implemented for `Duration`][1.7h].
6359
6360 Misc
6361 ----
6362
6363 * [When running tests with `--test`, rustdoc will pass `--cfg`
6364   arguments to the compiler][1.7dt].
6365 * [The compiler is built with RPATH information by default][1.7rpa].
6366   This means that it will be possible to run `rustc` when installed in
6367   unusual configurations without configuring the dynamic linker search
6368   path explicitly.
6369 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6370   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6371   over `LD_LIBRARY_PATH`.
6372
6373 Cargo
6374 -----
6375
6376 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6377   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6378 * [The `rerun-if-changed` build script directive no longer causes the
6379   build script to incorrectly run twice in certain scenarios][1.7rr].
6380
6381 Compatibility Notes
6382 -------------------
6383
6384 * Soundness fixes to the interactions between associated types and
6385   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6386   code that violates the new rules. This is a significant change that
6387   is known to break existing code, so it has emitted warnings for the
6388   new error cases since 1.4 to give crate authors time to adapt. The
6389   details of what is changing are subtle; read the RFC for more.
6390 * [Several bugs in the compiler's visibility calculations were
6391   fixed][1.7v]. Since this was found to break significant amounts of
6392   code, the new errors will be emitted as warnings for several release
6393   cycles, under the `private_in_public` lint.
6394 * Defaulted type parameters were accidentally accepted in positions
6395   that were not intended. In this release, [defaulted type parameters
6396   appearing outside of type definitions will generate a
6397   warning][1.7d], which will become an error in future releases.
6398 * [Parsing "." as a float results in an error instead of 0][1.7p].
6399   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6400 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6401
6402 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6403 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6404 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6405 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6406 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6407 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6408 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6409 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6410 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6411 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6412 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6413 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6414 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6415 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6416 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6417 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6418 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6419 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6420 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6421 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6422 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6423 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6424 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6425 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6426 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6427 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6428 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6429 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6430 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6431 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6432 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6433 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6434 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6435 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6436 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6437 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6438 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6439 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6440 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6441 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6442 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6443 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6444 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6445 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6446 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6447 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6448 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6449 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6450 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6451 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6452 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6453 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6454 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6455 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6456 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6457 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6458 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6459 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6460 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6461 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6462 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6463 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6464 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6465 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6466 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6467 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6468 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6469 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6470 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6471 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6472 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6473 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6474 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6475 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6476 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6477 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6478 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6479 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6480 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6481
6482
6483 Version 1.6.0 (2016-01-21)
6484 ==========================
6485
6486 Language
6487 --------
6488
6489 * The `#![no_std]` attribute causes a crate to not be linked to the
6490   standard library, but only the [core library][1.6co], as described
6491   in [RFC 1184]. The core library defines common types and traits but
6492   has no platform dependencies whatsoever, and is the basis for Rust
6493   software in environments that cannot support a full port of the
6494   standard library, such as operating systems. Most of the core
6495   library is now stable.
6496
6497 Libraries
6498 ---------
6499
6500 * Stabilized APIs:
6501   [`Read::read_exact`],
6502   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6503   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6504   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6505   [`os::unix::fs::DirBuilderExt`],
6506   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6507   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6508   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6509   [`collections::hash_map::Drain`],
6510   [`collections::hash_map::HashMap::drain`],
6511   [`collections::hash_set::Drain`],
6512   [`collections::hash_set::HashSet::drain`],
6513   [`collections::binary_heap::Drain`],
6514   [`collections::binary_heap::BinaryHeap::drain`],
6515   [`Vec::extend_from_slice`] (renamed from `push_all`),
6516   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6517   [`RwLock::into_inner`],
6518   [`Iterator::min_by_key`] (renamed from `min_by`),
6519   [`Iterator::max_by_key`] (renamed from `max_by`).
6520 * The [core library][1.6co] is stable, as are most of its APIs.
6521 * [The `assert_eq!` macro supports arguments that don't implement
6522   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6523   `assert!`.
6524 * Several timer functions that take duration in milliseconds [are
6525   deprecated in favor of those that take `Duration`][1.6ms]. These
6526   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6527   `thread::park_timeout_ms`.
6528 * The algorithm by which `Vec` reserves additional elements was
6529   [tweaked to not allocate excessive space][1.6a] while still growing
6530   exponentially.
6531 * `From` conversions are [implemented from integers to floats][1.6f]
6532   in cases where the conversion is lossless. Thus they are not
6533   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6534   or `f64`. They are also not implemented for `isize` and `usize`
6535   because the implementations would be platform-specific. `From` is
6536   also implemented from `f32` to `f64`.
6537 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6538 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6539 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6540 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6541   improvements.
6542 * Sorting slices that are already sorted [is 50% faster in some
6543   cases][1.6s].
6544
6545 Cargo
6546 -----
6547
6548 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6549 * Cargo build scripts can specify their dependencies by emitting the
6550   [`rerun-if-changed`][1.6rr] key.
6551 * crates.io will reject publication of crates with dependencies that
6552   have a wildcard version constraint. Crates with wildcard
6553   dependencies were seen to cause a variety of problems, as described
6554   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6555   warning.
6556 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6557   release folder.  A variety of artifacts that Cargo failed to clean
6558   are now correctly deleted.
6559
6560 Misc
6561 ----
6562
6563 * The `unreachable_code` lint [warns when a function call's argument
6564   diverges][1.6dv].
6565 * The parser indicates [failures that may be caused by
6566   confusingly-similar Unicode characters][1.6uc]
6567 * Certain macro errors [are reported at definition time][1.6m], not
6568   expansion.
6569
6570 Compatibility Notes
6571 -------------------
6572
6573 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6574   environment variable when locating crates. This was a pre-cargo
6575   feature for integrating with the package manager that was
6576   accidentally never removed.
6577 * [A number of bugs were fixed in the privacy checker][1.6p] that
6578   could cause previously-accepted code to break.
6579 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6580 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6581   struct pattern syntax (`Foo(..)`) can no longer be used to match
6582   unit structs. This is a warning now, but will become an error in
6583   future releases. Patterns that share the same name as a const are
6584   now an error.
6585 * A bug was fixed that causes [rustc not to apply default type
6586   parameters][1.6xc] when resolving certain method implementations of
6587   traits defined in other crates.
6588
6589 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6590 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6591 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6592 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6593 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6594 [1.6co]: http://doc.rust-lang.org/core/index.html
6595 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6596 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6597 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6598 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6599 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6600 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6601 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6602 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6603 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6604 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6605 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6606 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6607 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6608 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6609 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6610 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6611 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6612 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6613 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6614 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6615 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6616 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6617 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6618 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6619 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6620 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6621 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6622 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6623 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6624 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6625 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6626 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6627 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6628 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6629 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6630 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6631 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6632 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6633 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6634 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6635 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6636
6637
6638 Version 1.5.0 (2015-12-10)
6639 ==========================
6640
6641 * ~700 changes, numerous bugfixes
6642
6643 Highlights
6644 ----------
6645
6646 * Stabilized APIs:
6647   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6648   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6649   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6650   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6651   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6652   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6653   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6654   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6655   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6656   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6657   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6658   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6659   [`Path::read_link`], [`Path::symlink_metadata`],
6660   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6661   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6662   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6663   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6664   [`slice::split_first_mut`], [`slice::split_first`],
6665   [`slice::split_last_mut`], [`slice::split_last`],
6666   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6667   [`str::MatchIndices`], [`str::RMatchIndices`],
6668   [`str::match_indices`], [`str::rmatch_indices`],
6669   [`str::slice_mut_unchecked`], [`string::ParseError`].
6670 * Rust applications hosted on crates.io can be installed locally to
6671   `~/.cargo/bin` with the [`cargo install`] command. Among other
6672   things this makes it easier to augment Cargo with new subcommands:
6673   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6674   invoked as `cargo foo`.
6675 * Crates with wildcard (`*`) dependencies will [emit warnings when
6676   published][1.5w]. In 1.6 it will no longer be possible to publish
6677   crates with wildcard dependencies.
6678
6679 Breaking Changes
6680 ----------------
6681
6682 * The rules determining when a particular lifetime must outlive
6683   a particular value (known as '[dropck]') have been [modified
6684   to not rely on parametricity][1.5p].
6685 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6686   and `Arc`][1.5a]. Because these smart pointer types implement
6687   `Deref`, this causes breakage in cases where the interior type
6688   contains methods of the same name.
6689 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6690   that they could drop their content. Soundness fix.
6691 * All method invocations are [properly checked][1.5wf1] for
6692   [well-formedness][1.5wf2]. Soundness fix.
6693 * Traits whose supertraits contain `Self` are [not object
6694   safe][1.5o]. Soundness fix.
6695 * Target specifications support a [`no_default_libraries`][1.5nd]
6696   setting that controls whether `-nodefaultlibs` is passed to the
6697   linker, and in turn the `is_like_windows` setting no longer affects
6698   the `-nodefaultlibs` flag.
6699 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6700 * The `#[inline]` and `#[repr]` attributes [can only appear
6701   in valid locations][1.5at].
6702 * Native libraries linked from the local crate are [passed to
6703   the linker before native libraries from upstream crates][1.5nl].
6704 * Two rarely-used attributes, `#[no_debug]` and
6705   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6706 * Negation of unsigned integers, which has been a warning for
6707   several releases, [is now behind a feature gate and will
6708   generate errors][1.5nu].
6709 * The parser accidentally accepted visibility modifiers on
6710   enum variants, a bug [which has been fixed][1.5ev].
6711 * [A bug was fixed that allowed `use` statements to import unstable
6712   features][1.5use].
6713
6714 Language
6715 --------
6716
6717 * When evaluating expressions at compile-time that are not
6718   compile-time constants (const-evaluating expressions in non-const
6719   contexts), incorrect code such as overlong bitshifts and arithmetic
6720   overflow will [generate a warning instead of an error][1.5ce],
6721   delaying the error until runtime. This will allow the
6722   const-evaluator to be expanded in the future backwards-compatibly.
6723 * The `improper_ctypes` lint [no longer warns about using `isize` and
6724   `usize` in FFI][1.5ict].
6725
6726 Libraries
6727 ---------
6728
6729 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6730   invariant][1.5c].
6731 * `Default` is [implemented for mutable slices][1.5d].
6732 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6733 * There are now `From` conversions [between floating point
6734   types][1.5f] where the conversions are lossless.
6735 * There are now `From` conversions [between integer types][1.5i] where
6736   the conversions are lossless.
6737 * [`fs::Metadata` implements `Clone`][1.5fs].
6738 * The `parse` method [accepts a leading "+" when parsing
6739   integers][1.5pi].
6740 * [`AsMut` is implemented for `Vec`][1.5am].
6741 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6742   been optimized][1.5cf] and no longer rely on the default impl.
6743 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6744   `unsafe extern "C"` function types now [implement `Clone`,
6745   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6746   `fmt::Debug` for up to 12 arguments][1.5fp].
6747 * [Dropping `Vec`s is much faster in unoptimized builds when the
6748   element types don't implement `Drop`][1.5dv].
6749 * A bug that caused in incorrect behavior when [combining `VecDeque`
6750   with zero-sized types][1.5vdz] was resolved.
6751 * [`PartialOrd` for slices is faster][1.5po].
6752
6753 Miscellaneous
6754 -------------
6755
6756 * [Crate metadata size was reduced by 20%][1.5md].
6757 * [Improvements to code generation reduced the size of libcore by 3.3
6758   MB and rustc's memory usage by 18MB][1.5m].
6759 * [Improvements to deref translation increased performance in
6760   unoptimized builds][1.5dr].
6761 * Various errors in trait resolution [are deduplicated to only be
6762   reported once][1.5te].
6763 * Rust has preliminary [support for rumprun kernels][1.5rr].
6764 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6765
6766 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6767 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6768 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6769 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6770 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6771 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6772 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6773 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6774 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6775 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6776 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6777 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6778 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6779 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6780 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6781 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6782 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6783 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6784 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6785 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6786 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6787 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6788 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6789 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6790 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6791 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6792 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6793 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6794 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6795 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6796 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6797 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6798 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6799 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6800 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6801 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6802 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6803 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6804 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6805 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6806 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6807 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6808 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6809 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6810 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6811 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6812 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6813 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6814 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6815 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6816 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6817 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6818 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6819 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6820 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6821 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6822 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6823 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6824 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6825 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6826 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6827 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6828 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6829 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6830 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6831 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6832 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6833 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6834 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6835 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6836 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6837 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6838 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6839 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6840 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6841 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6842 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6843 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6844 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6845 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6846 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6847 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6848 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6849 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6850 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6851 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6852 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6853 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6854 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6855
6856 Version 1.4.0 (2015-10-29)
6857 ==========================
6858
6859 * ~1200 changes, numerous bugfixes
6860
6861 Highlights
6862 ----------
6863
6864 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6865   GNU) are now supported and recommended for use.
6866
6867 Breaking Changes
6868 ----------------
6869
6870 * [Several changes have been made to fix type soundness and improve
6871   the behavior of associated types][sound]. See [RFC 1214]. Although
6872   we have mostly introduced these changes as warnings this release, to
6873   become errors next release, there are still some scenarios that will
6874   see immediate breakage.
6875 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6876   line breaks in addition to `\n`][crlf].
6877 * [Loans of `'static` lifetime extend to the end of a function][stat].
6878 * [`str::parse` no longer introduces avoidable rounding error when
6879   parsing floating point numbers. Together with earlier changes to
6880   float formatting/output, "round trips" like f.to_string().parse()
6881   now preserve the value of f exactly. Additionally, leading plus
6882   signs are now accepted][fp3].
6883
6884
6885 Language
6886 --------
6887
6888 * `use` statements that import multiple items [can now rename
6889   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6890 * [Binops work correctly on fat pointers][binfat].
6891 * `pub extern crate`, which does not behave as expected, [issues a
6892   warning][pec] until a better solution is found.
6893
6894 Libraries
6895 ---------
6896
6897 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6898   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6899   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6900   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6901   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6902   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6903   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6904   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6905   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6906   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6907   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6908   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6909   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6910   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6911   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6912   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6913   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6914   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6915   [`thread::sleep`].
6916 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6917   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6918   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6919   `f64::from_str_radix`.
6920 * [Reverse-searching strings is faster with the 'two-way'
6921   algorithm][s].
6922 * [`std::io::copy` allows `?Sized` arguments][cc].
6923 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6924   [override `count`, `nth` and `last` with an O(1)
6925   implementation][it].
6926 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6927 * [`IntoRawFd` has been added to the Unix-specific prelude,
6928   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6929   prelude][pr].
6930 * [`Extend<String>` and `FromIterator<String` are both implemented for
6931   `String`][es].
6932 * [`IntoIterator` is implemented for references to `Option` and
6933   `Result`][into2].
6934 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6935   Copy`][ext] as part of [RFC 839]. This will cause type inference
6936   breakage in rare situations.
6937 * [`BinaryHeap` implements `Debug`][bh2].
6938 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6939   arrays][bm].
6940 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6941   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6942 * [String comparison is faster][faststr].
6943 * `&mut T` where `T: std::fmt::Write` [also implements
6944   `std::fmt::Write`][mutw].
6945 * [A stable regression in `VecDeque::push_back` and other
6946   capacity-altering methods that caused panics for zero-sized types
6947   was fixed][vd].
6948 * [Function pointers implement traits for up to 12 parameters][fp2].
6949
6950 Miscellaneous
6951 -------------
6952
6953 * The compiler [no longer uses the 'morestack' feature to prevent
6954   stack overflow][mm]. Instead it uses guard pages and stack
6955   probes (though stack probes are not yet implemented on any platform
6956   but Windows).
6957 * [The compiler matches traits faster when projections are involved][p].
6958 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6959   `usize`][ffi].
6960 * [Cargo now displays useful information about what its doing during
6961   `cargo update`][cu].
6962
6963 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6964 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6965 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6966 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6967 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6968 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6969 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6970 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6971 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6972 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6973 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6974 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6975 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6976 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6977 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6978 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6979 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6980 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6981 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6982 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6983 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6984 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6985 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6986 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6987 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6988 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6989 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6990 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6991 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6992 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6993 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6994 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6995 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6996 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6997 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6998 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6999 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7000 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7001 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7002 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7003 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7004 [bh2]: https://github.com/rust-lang/rust/pull/28156
7005 [binfat]: https://github.com/rust-lang/rust/pull/28270
7006 [bm]: https://github.com/rust-lang/rust/pull/28197
7007 [cc]: https://github.com/rust-lang/rust/pull/27531
7008 [crlf]: https://github.com/rust-lang/rust/pull/28034
7009 [cu]: https://github.com/rust-lang/cargo/pull/1931
7010 [d]: https://github.com/rust-lang/rust/pull/27825
7011 [dep]: https://github.com/rust-lang/rust/pull/28339
7012 [es]: https://github.com/rust-lang/rust/pull/27956
7013 [ext]: https://github.com/rust-lang/rust/pull/28094
7014 [faststr]: https://github.com/rust-lang/rust/pull/28338
7015 [ffi]: https://github.com/rust-lang/rust/pull/28779
7016 [fp]: https://github.com/rust-lang/rust/pull/28268
7017 [fp2]: https://github.com/rust-lang/rust/pull/28560
7018 [fp3]: https://github.com/rust-lang/rust/pull/27307
7019 [i]: https://github.com/rust-lang/rust/pull/27451
7020 [into2]: https://github.com/rust-lang/rust/pull/28039
7021 [it]: https://github.com/rust-lang/rust/pull/27652
7022 [mm]: https://github.com/rust-lang/rust/pull/27338
7023 [mutw]: https://github.com/rust-lang/rust/pull/28368
7024 [sound]: https://github.com/rust-lang/rust/pull/27641
7025 [p]: https://github.com/rust-lang/rust/pull/27866
7026 [pec]: https://github.com/rust-lang/rust/pull/28486
7027 [pr]: https://github.com/rust-lang/rust/pull/27896
7028 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7029 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7030 [s]: https://github.com/rust-lang/rust/pull/27474
7031 [stab]: https://github.com/rust-lang/rust/pull/28339
7032 [stat]: https://github.com/rust-lang/rust/pull/28321
7033 [vd]: https://github.com/rust-lang/rust/pull/28494
7034
7035 Version 1.3.0 (2015-09-17)
7036 ==============================
7037
7038 * ~900 changes, numerous bugfixes
7039
7040 Highlights
7041 ----------
7042
7043 * The [new object lifetime defaults][nold] have been [turned
7044   on][nold2] after a cycle of warnings about the change. Now types
7045   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7046   being interpreted as `&'a Box<Trait+'a>` to `&'a
7047   Box<Trait+'static>`.
7048 * [The Rustonomicon][nom] is a new book in the official documentation
7049   that dives into writing unsafe Rust.
7050 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7051   timekeeping is employed by other std APIs, as well as out-of-tree
7052   time crates.
7053
7054 Breaking Changes
7055 ----------------
7056
7057 * The [new object lifetime defaults][nold] have been [turned
7058   on][nold2] after a cycle of warnings about the change.
7059 * There is a known [regression][lr] in how object lifetime elision is
7060   interpreted, the proper solution for which is undetermined.
7061 * The `#[prelude_import]` attribute, an internal implementation
7062   detail, was accidentally stabilized previously. [It has been put
7063   behind the `prelude_import` feature gate][pi]. This change is
7064   believed to break no existing code.
7065 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7066   [more sane for dynamically sized types][dst3]. Code that relied on
7067   the previous behavior is thought to be broken.
7068 * The `dropck` rules, which checks that destructors can't access
7069   destroyed values, [have been updated][dropck] to match the
7070   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7071   cause some previously-compiling code to no longer build.
7072
7073 Language
7074 --------
7075
7076 * The [new object lifetime defaults][nold] have been [turned
7077   on][nold2] after a cycle of warnings about the change.
7078 * Semicolons may [now follow types and paths in
7079   macros](https://github.com/rust-lang/rust/pull/27000).
7080 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7081   [more sane for dynamically sized types][dst3]. Code that relied on
7082   the previous behavior is not known to exist, and suspected to be
7083   broken.
7084 * `'static` variables [may now be recursive][st].
7085 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
7086   implementations correctly.
7087 * The `dropck` rules, which checks that destructors can't access
7088   destroyed values, [have been updated][dropck] to match the
7089   [RFC][dropckrfc].
7090
7091 Libraries
7092 ---------
7093
7094 * The [`Duration`] API, [has been stabilized][ds], as well as the
7095   `std::time` module, which presently contains only `Duration`.
7096 * `Box<str>` and `Box<[T]>` both implement `Clone`.
7097 * The owned C string, [`CString`], implements [`Borrow`] and the
7098   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7099   these allow C strings to be borrowed and cloned in generic code.
7100 * [`CStr`] implements [`Debug`].
7101 * [`AtomicPtr`] implements [`Debug`].
7102 * [`Error`] trait objects [can be downcast to their concrete types][e]
7103   in many common configurations, using the [`is`], [`downcast`],
7104   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
7105   [`Any`] trait.
7106 * Searching for substrings now [employs the two-way algorithm][search]
7107   instead of doing a naive search. This gives major speedups to a
7108   number of methods, including [`contains`][sc], [`find`][sf],
7109   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
7110   [`ends_with`][sew] are also faster.
7111 * The performance of `PartialEq` for slices is [much faster][ps].
7112 * The [`Hash`] trait offers the default method, [`hash_slice`], which
7113   is overridden and optimized by the implementations for scalars.
7114 * The [`Hasher`] trait now has a number of specialized `write_*`
7115   methods for primitive types, for efficiency.
7116 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
7117   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
7118   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
7119   of [`std::error::Error::cause`][iec] also delegates to the inner
7120   error.
7121 * [`process::Child`][pc] gained the [`id`] method, which returns a
7122   `u32` representing the platform-specific process identifier.
7123 * The [`connect`] method on slices is deprecated, replaced by the new
7124   [`join`] method (note that both of these are on the *unstable*
7125   [`SliceConcatExt`] trait, but through the magic of the prelude are
7126   available to stable code anyway).
7127 * The [`Div`] operator is implemented for [`Wrapping`] types.
7128 * [`DerefMut` is implemented for `String`][dms].
7129 * Performance of SipHash (the default hasher for `HashMap`) is
7130   [better for long data][sh].
7131 * [`AtomicPtr`] implements [`Send`].
7132 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
7133   are now [specialized to use uninitialized buffers for increased
7134   performance][rte].
7135 * Lifetime parameters of foreign functions [are now resolved
7136   properly][f].
7137
7138 Misc
7139 ----
7140
7141 * Rust can now, with some coercion, [produce programs that run on
7142   Windows XP][xp], though XP is not considered a supported platform.
7143 * Porting Rust on Windows from the GNU toolchain to MSVC continues
7144   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7145   recommended for use in 1.3, though should be fully-functional
7146   in the [64-bit 1.4 beta][b14].
7147 * On Fedora-based systems installation will [properly configure the
7148   dynamic linker][fl].
7149 * The compiler gained many new extended error descriptions, which can
7150   be accessed with the `--explain` flag.
7151 * The `dropck` pass, which checks that destructors can't access
7152   destroyed values, [has been rewritten][dropck]. This fixes some
7153   soundness holes, and as such will cause some previously-compiling
7154   code to no longer build.
7155 * `rustc` now uses [LLVM to write archive files where possible][ar].
7156   Eventually this will eliminate the compiler's dependency on the ar
7157   utility.
7158 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7159   supported FreeBSD on x86_64).
7160 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7161   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7162   more strict.
7163 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7164   will kill the process instead of leaking][nlp].
7165
7166 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7167 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7168 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7169 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7170 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7171 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7172 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7173 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7174 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7175 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7176 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7177 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7178 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7179 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7180 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7181 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7182 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7183 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7184 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7185 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7186 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7187 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7188 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7189 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7190 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7191 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7192 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7193 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7194 [ar]: https://github.com/rust-lang/rust/pull/26926
7195 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7196 [dms]: https://github.com/rust-lang/rust/pull/26241
7197 [dropck]: https://github.com/rust-lang/rust/pull/27261
7198 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7199 [ds]: https://github.com/rust-lang/rust/pull/26818
7200 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7201 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7202 [dst3]: https://github.com/rust-lang/rust/pull/27351
7203 [e]: https://github.com/rust-lang/rust/pull/24793
7204 [f]: https://github.com/rust-lang/rust/pull/26588
7205 [fb]: https://github.com/rust-lang/rust/pull/26959
7206 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7207 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7208 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7209 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7210 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7211 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7212 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7213 [lic]: https://github.com/rust-lang/rust/pull/26583
7214 [lnu]: https://github.com/rust-lang/rust/pull/27026
7215 [lr]: https://github.com/rust-lang/rust/issues/27248
7216 [lum]: https://github.com/rust-lang/rust/pull/26378
7217 [lur]: https://github.com/rust-lang/rust/pull/26783
7218 [nlp]: https://github.com/rust-lang/rust/pull/27176
7219 [nold2]: https://github.com/rust-lang/rust/pull/27045
7220 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7221 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7222 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7223 [pi]: https://github.com/rust-lang/rust/pull/26699
7224 [ps]: https://github.com/rust-lang/rust/pull/26884
7225 [rte]: https://github.com/rust-lang/rust/pull/26950
7226 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7227 [search]: https://github.com/rust-lang/rust/pull/26327
7228 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7229 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7230 [sh]: https://github.com/rust-lang/rust/pull/27280
7231 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7232 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7233 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7234 [st]: https://github.com/rust-lang/rust/pull/26630
7235 [win1]: https://github.com/rust-lang/rust/pull/26569
7236 [win2]: https://github.com/rust-lang/rust/pull/26741
7237 [win3]: https://github.com/rust-lang/rust/pull/26741
7238 [win4]: https://github.com/rust-lang/rust/pull/27210
7239 [xp]: https://github.com/rust-lang/rust/pull/26569
7240
7241 Version 1.2.0 (2015-08-07)
7242 ==========================
7243
7244 * ~1200 changes, numerous bugfixes
7245
7246 Highlights
7247 ----------
7248
7249 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7250   like `Rc` to contain types without a fixed size, arrays and trait
7251   objects, finally enabling use of `Rc<[T]>` and completing the
7252   implementation of DST.
7253 * [Parallel codegen][parcodegen] is now working again, which can
7254   substantially speed up large builds in debug mode; It also gets
7255   another ~33% speedup when bootstrapping on a 4 core machine (using 8
7256   jobs). It's not enabled by default, but will be "in the near
7257   future". It can be activated with the `-C codegen-units=N` flag to
7258   `rustc`.
7259 * This is the first release with [experimental support for linking
7260   with the MSVC linker and lib C on Windows (instead of using the GNU
7261   variants via MinGW)][win]. It is yet recommended only for the most
7262   intrepid Rustaceans.
7263 * Benchmark compilations are showing a 30% improvement in
7264   bootstrapping over 1.1.
7265
7266 Breaking Changes
7267 ----------------
7268
7269 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7270   unicode case mapping, which is a previously-planned change in
7271   behavior and considered a bugfix.
7272 * [`mem::align_of`] now specifies [the *minimum alignment* for
7273   T][align], which is usually the alignment programs are interested
7274   in, and the same value reported by clang's
7275   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7276   break real code.
7277 * [The `#[packed]` attribute is no longer silently accepted by the
7278   compiler][packed]. This attribute did nothing and code that
7279   mentioned it likely did not work as intended.
7280 * Associated type defaults are [now behind the
7281   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7282   defaults *did not work*, but could be mentioned syntactically. As
7283   such this breakage has minimal impact.
7284
7285 Language
7286 --------
7287
7288 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
7289   matching against dereferenceable values.
7290
7291 Libraries
7292 ---------
7293
7294 * The [`Extend`] trait, which grows a collection from an iterator, is
7295   implemented over iterators of references, for `String`, `Vec`,
7296   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7297   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7298 * The [`iter::once`] function returns an iterator that yields a single
7299   element, and [`iter::empty`] returns an iterator that yields no
7300   elements.
7301 * The [`matches`] and [`rmatches`] methods on `str` return iterators
7302   over substring matches.
7303 * [`Cell`] and [`RefCell`] both implement `Eq`.
7304 * A number of methods for wrapping arithmetic are added to the
7305   integral types, [`wrapping_div`], [`wrapping_rem`],
7306   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7307   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7308   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7309   type.. It is illegal for the default arithmetic operations in Rust
7310   to overflow; the desire to wrap must be explicit.
7311 * The `{:#?}` formatting specifier [displays the alternate,
7312   pretty-printed][debugfmt] form of the `Debug` formatter. This
7313   feature was actually introduced prior to 1.0 with little
7314   fanfare.
7315 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7316   for writing data to formatted strings, similar to [`io::Write`].
7317 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7318   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7319   are used by code generators to emit implementations of [`Debug`].
7320 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7321   methods that convert case, following Unicode case mapping.
7322 * It is now easier to handle poisoned locks. The [`PoisonError`]
7323   type, returned by failing lock operations, exposes `into_inner`,
7324   `get_ref`, and `get_mut`, which all give access to the inner lock
7325   guard, and allow the poisoned lock to continue to operate. The
7326   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7327   poisoned lock without attempting to take the lock.
7328 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7329   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7330   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7331   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7332   `ChildStderr`.
7333 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7334   malformed input.
7335
7336 Misc
7337 ----
7338
7339 * `rustc` employs smarter heuristics for guessing at [typos].
7340 * `rustc` emits more efficient code for [no-op conversions between
7341   unsafe pointers][nop].
7342 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7343   resulting in faster compile times and smaller code.
7344
7345 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7346 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7347 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7348 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7349 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7350 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7351 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7352 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7353 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7354 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7355 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7356 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7357 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7358 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7359 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7360 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7361 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7362 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7363 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7364 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7365 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7366 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7367 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7368 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7369 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7370 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7371 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7372 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7373 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7374 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7375 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7376 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7377 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7378 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7379 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7380 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7381 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7382 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7383 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7384 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7385 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7386 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7387 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7388 [align]: https://github.com/rust-lang/rust/pull/25646
7389 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7390 [typos]: https://github.com/rust-lang/rust/pull/26087
7391 [nop]: https://github.com/rust-lang/rust/pull/26336
7392 [fat]: https://github.com/rust-lang/rust/pull/26411
7393 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7394 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7395 [packed]: https://github.com/rust-lang/rust/pull/25541
7396 [ad]: https://github.com/rust-lang/rust/pull/27382
7397 [win]: https://github.com/rust-lang/rust/pull/25350
7398
7399 Version 1.1.0 (2015-06-25)
7400 =========================
7401
7402 * ~850 changes, numerous bugfixes
7403
7404 Highlights
7405 ----------
7406
7407 * The [`std::fs` module has been expanded][fs] to expand the set of
7408   functionality exposed:
7409   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7410     don't incur a syscall on some platforms.
7411   * A `symlink_metadata` function has been added.
7412   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7413     access to all underlying information.
7414 * The compiler now contains extended explanations of many errors. When an error
7415   with an explanation occurs the compiler suggests using the `--explain` flag
7416   to read the explanation. Error explanations are also [available online][err-index].
7417 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7418   well as other work, the time to bootstrap the compiler decreased by
7419   32%.
7420
7421 Libraries
7422 ---------
7423
7424 * The [`str::split_whitespace`] method splits a string on unicode
7425   whitespace boundaries.
7426 * On both Windows and Unix, new extension traits provide conversion of
7427   I/O types to and from the underlying system handles. On Unix, these
7428   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7429   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7430   `TcpListener`, and `UpdSocket`. Further implementations for
7431   `std::process` will be stabilized later.
7432 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7433   Windows, symlinks can be created with
7434   `std::os::windows::symlink_dir` and
7435   `std::os::windows::symlink_file`.
7436 * The `mpsc::Receiver` type can now be converted into an iterator with
7437   `into_iter` on the [`IntoIterator`] trait.
7438 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7439   implementation of the [`From`] trait.
7440 * The `Debug` implementation for `RangeFull` [creates output that is
7441   more consistent with other implementations][rf].
7442 * [`Debug` is implemented for `File`][file].
7443 * The `Default` implementation for `Arc` [no longer requires `Sync +
7444   Send`][arc].
7445 * [The `Iterator` methods `count`, `nth`, and `last` have been
7446   overridden for slices to have O(1) performance instead of O(n)][si].
7447 * Incorrect handling of paths on Windows has been improved in both the
7448   compiler and the standard library.
7449 * [`AtomicPtr` gained a `Default` implementation][ap].
7450 * In accordance with Rust's policy on arithmetic overflow `abs` now
7451   [panics on overflow when debug assertions are enabled][abs].
7452 * The [`Cloned`] iterator, which was accidentally left unstable for
7453   1.0 [has been stabilized][c].
7454 * The [`Incoming`] iterator, which iterates over incoming TCP
7455   connections, and which was accidentally unnamable in 1.0, [is now
7456   properly exported][inc].
7457 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7458   `sift_up` or `sift_down` panic][bh].
7459 * The [`split_off`] method of `LinkedList` [no longer corrupts
7460   the list in certain scenarios][ll].
7461
7462 Misc
7463 ----
7464
7465 * Type checking performance [has improved notably][sk] with
7466   [multiple improvements][pre].
7467 * The compiler [suggests code changes][ch] for more errors.
7468 * rustc and it's build system have experimental support for [building
7469   toolchains against MUSL][m] instead of glibc on Linux.
7470 * The compiler defines the `target_env` cfg value, which is used for
7471   distinguishing toolchains that are otherwise for the same
7472   platform. Presently this is set to `gnu` for common GNU Linux
7473   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7474 * The [`cargo rustc`][crc] command invokes a build with custom flags
7475   to rustc.
7476 * [Android executables are always position independent][pie].
7477 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7478   with `Drop`][drop].
7479
7480 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7481 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7482 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7483 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7484 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7485 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7486 [rf]: https://github.com/rust-lang/rust/pull/24491
7487 [err-index]: https://doc.rust-lang.org/error-index.html
7488 [sk]: https://github.com/rust-lang/rust/pull/24615
7489 [pre]: https://github.com/rust-lang/rust/pull/25323
7490 [file]: https://github.com/rust-lang/rust/pull/24598
7491 [ch]: https://github.com/rust-lang/rust/pull/24683
7492 [arc]: https://github.com/rust-lang/rust/pull/24695
7493 [si]: https://github.com/rust-lang/rust/pull/24701
7494 [ap]: https://github.com/rust-lang/rust/pull/24834
7495 [m]: https://github.com/rust-lang/rust/pull/24777
7496 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7497 [crc]: https://github.com/rust-lang/cargo/pull/1568
7498 [pie]: https://github.com/rust-lang/rust/pull/24953
7499 [abs]: https://github.com/rust-lang/rust/pull/25441
7500 [c]: https://github.com/rust-lang/rust/pull/25496
7501 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7502 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7503 [inc]: https://github.com/rust-lang/rust/pull/25522
7504 [bh]: https://github.com/rust-lang/rust/pull/25856
7505 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7506 [ll]: https://github.com/rust-lang/rust/pull/26022
7507 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7508 [drop]: https://github.com/rust-lang/rust/pull/24935
7509
7510 Version 1.0.0 (2015-05-15)
7511 ========================
7512
7513 * ~1500 changes, numerous bugfixes
7514
7515 Highlights
7516 ----------
7517
7518 * The vast majority of the standard library is now `#[stable]`. It is
7519   no longer possible to use unstable features with a stable build of
7520   the compiler.
7521 * Many popular crates on [crates.io] now work on the stable release
7522   channel.
7523 * Arithmetic on basic integer types now [checks for overflow in debug
7524   builds][overflow].
7525
7526 Language
7527 --------
7528
7529 * Several [restrictions have been added to trait coherence][coh] in
7530   order to make it easier for upstream authors to change traits
7531   without breaking downstream code.
7532 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7533   improve error messages and macro behavior. For example, `0b1234` is
7534   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7535 * Trait bounds [are always invariant][inv], eliminating the need for
7536   the `PhantomFn` and `MarkerTrait` lang items, which have been
7537   removed.
7538 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7539   "foo" as bar` syntax has been replaced with `extern crate foo as
7540   bar`, and Cargo now automatically translates "-" in *package* names
7541   to underscore for the crate name.
7542 * [Lifetime shadowing is an error][lt].
7543 * [`Send` no longer implies `'static`][send-rfc].
7544 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7545   `MyType::default()`.
7546 * Primitive types [now have inherent methods][prim-inherent],
7547   obviating the need for extension traits like `SliceExt`.
7548 * Methods with `Self: Sized` in their `where` clause are [considered
7549   object-safe][self-sized], allowing many extension traits like
7550   `IteratorExt` to be merged into the traits they extended.
7551 * You can now [refer to associated types][assoc-where] whose
7552   corresponding trait bounds appear only in a `where` clause.
7553 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7554   like `Send` and `Sync` are now library-defined.
7555 * A [Reflect trait][reflect] was introduced, which means that
7556   downcasting via the `Any` trait is effectively limited to concrete
7557   types. This helps retain the potentially-important "parametricity"
7558   property: generic code cannot behave differently for different type
7559   arguments except in minor ways.
7560 * The `unsafe_destructor` feature is now deprecated in favor of the
7561   [new `dropck`][dropck]. This change is a major reduction in unsafe
7562   code.
7563
7564 Libraries
7565 ---------
7566
7567 * The `thread_local` module [has been renamed to `std::thread`][th].
7568 * The methods of `IteratorExt` [have been moved to the `Iterator`
7569   trait itself][ie].
7570 * Several traits that implement Rust's conventions for type
7571   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7572   [centralized in the `std::convert` module][con].
7573 * The `FromError` trait [was removed in favor of `From`][fe].
7574 * The basic sleep function [has moved to
7575   `std::thread::sleep_ms`][slp].
7576 * The `splitn` function now takes an `n` parameter that represents the
7577   number of items yielded by the returned iterator [instead of the
7578   number of 'splits'][spl].
7579 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7580 * [Derived implementations of `PartialOrd` now order enums according
7581   to their explicitly-assigned discriminants][po].
7582 * [Methods for searching strings are generic over `Pattern`s][pat],
7583   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7584   some others.
7585 * [In method resolution, object methods are resolved before inherent
7586   methods][meth].
7587 * [`String::from_str` has been deprecated in favor of the `From` impl,
7588   `String::from`][sf].
7589 * [`io::Error` implements `Sync`][ios].
7590 * [The `words` method on `&str` has been replaced with
7591   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7592   a word?'
7593 * The new path and IO modules are complete and `#[stable]`. This
7594   was the major library focus for this cycle.
7595 * The path API was [revised][path-normalize] to normalize `.`,
7596   adjusting the tradeoffs in favor of the most common usage.
7597 * A large number of remaining APIs in `std` were also stabilized
7598   during this cycle; about 75% of the non-deprecated API surface
7599   is now stable.
7600 * The new [string pattern API][string-pattern] landed, which makes
7601   the string slice API much more internally consistent and flexible.
7602 * A new set of [generic conversion traits][conversion] replaced
7603   many existing ad hoc traits.
7604 * Generic numeric traits were [completely removed][num-traits]. This
7605   was made possible thanks to inherent methods for primitive types,
7606   and the removal gives maximal flexibility for designing a numeric
7607   hierarchy in the future.
7608 * The `Fn` traits are now related via [inheritance][fn-inherit]
7609   and provide ergonomic [blanket implementations][fn-blanket].
7610 * The `Index` and `IndexMut` traits were changed to
7611   [take the index by value][index-value], enabling code like
7612   `hash_map["string"]` to work.
7613 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7614   `Copy` data is known to be `Clone` as well.
7615
7616 Misc
7617 ----
7618
7619 * Many errors now have extended explanations that can be accessed with
7620   the `--explain` flag to `rustc`.
7621 * Many new examples have been added to the standard library
7622   documentation.
7623 * rustdoc has received a number of improvements focused on completion
7624   and polish.
7625 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7626 * Much headway was made on ecosystem-wide CI, making it possible
7627   to [compare builds for breakage][ci-compare].
7628
7629
7630 [crates.io]: http://crates.io
7631 [clo]: https://github.com/rust-lang/rust/pull/24034
7632 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7633 [con]: https://github.com/rust-lang/rust/pull/23875
7634 [cr]: https://github.com/rust-lang/rust/pull/23419
7635 [fe]: https://github.com/rust-lang/rust/pull/23879
7636 [ie]: https://github.com/rust-lang/rust/pull/23300
7637 [inv]: https://github.com/rust-lang/rust/pull/23938
7638 [ios]: https://github.com/rust-lang/rust/pull/24133
7639 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7640 [lt]: https://github.com/rust-lang/rust/pull/24057
7641 [meth]: https://github.com/rust-lang/rust/pull/24056
7642 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7643 [po]: https://github.com/rust-lang/rust/pull/24270
7644 [sf]: https://github.com/rust-lang/rust/pull/24517
7645 [slp]: https://github.com/rust-lang/rust/pull/23949
7646 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7647 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7648 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7649 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7650 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7651 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7652 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7653 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7654 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7655 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7656 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7657 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7658 [reflect]: https://github.com/rust-lang/rust/pull/23712
7659 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7660 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7661 [index-value]: https://github.com/rust-lang/rust/pull/23601
7662 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7663 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7664 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7665 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7666 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7667 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7668
7669
7670 Version 1.0.0-alpha.2 (2015-02-20)
7671 =====================================
7672
7673 * ~1300 changes, numerous bugfixes
7674
7675 * Highlights
7676
7677     * The various I/O modules were [overhauled][io-rfc] to reduce
7678       unnecessary abstractions and provide better interoperation with
7679       the underlying platform. The old `io` module remains temporarily
7680       at `std::old_io`.
7681     * The standard library now [participates in feature gating][feat],
7682       so use of unstable libraries now requires a `#![feature(...)]`
7683       attribute. The impact of this change is [described on the
7684       forum][feat-forum]. [RFC][feat-rfc].
7685
7686 * Language
7687
7688     * `for` loops [now operate on the `IntoIterator` trait][into],
7689       which eliminates the need to call `.iter()`, etc. to iterate
7690       over collections. There are some new subtleties to remember
7691       though regarding what sort of iterators various types yield, in
7692       particular that `for foo in bar { }` yields values from a move
7693       iterator, destroying the original collection. [RFC][into-rfc].
7694     * Objects now have [default lifetime bounds][obj], so you don't
7695       have to write `Box<Trait+'static>` when you don't care about
7696       storing references. [RFC][obj-rfc].
7697     * In types that implement `Drop`, [lifetimes must outlive the
7698       value][drop]. This will soon make it possible to safely
7699       implement `Drop` for types where `#[unsafe_destructor]` is now
7700       required. Read the [gorgeous RFC][drop-rfc] for details.
7701     * The fully qualified <T as Trait>::X syntax lets you set the Self
7702       type for a trait method or associated type. [RFC][ufcs-rfc].
7703     * References to types that implement `Deref<U>` now [automatically
7704       coerce to references][deref] to the dereferenced type `U`,
7705       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7706       should eliminate many unsightly uses of `&*`, as when converting
7707       from references to vectors into references to
7708       slices. [RFC][deref-rfc].
7709     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7710       `|:|`) is obsolete and closure kind is inferred from context.
7711     * [`Self` is a keyword][Self].
7712
7713 * Libraries
7714
7715     * The `Show` and `String` formatting traits [have been
7716       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7717       their related purposes. Automatically getting a string
7718       conversion to use with `format!("{:?}", something_to_debug)` is
7719       now written `#[derive(Debug)]`.
7720     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7721       OsStr}`, provide strings in platform-specific encodings for easier
7722       interop with system APIs. [RFC][osstr-rfc].
7723     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7724       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7725       creating raw pointers.
7726
7727 * Tooling
7728
7729     * Certain long error messages of the form 'expected foo found bar'
7730       are now [split neatly across multiple
7731       lines][multiline]. Examples in the PR.
7732     * On Unix Rust can be [uninstalled][un] by running
7733       `/usr/local/lib/rustlib/uninstall.sh`.
7734     * The `#[rustc_on_unimplemented]` attribute, requiring the
7735       'on_unimplemented' feature, lets rustc [display custom error
7736       messages when a trait is expected to be implemented for a type
7737       but is not][onun].
7738
7739 * Misc
7740
7741     * Rust is tested against a [LALR grammar][lalr], which parses
7742       almost all the Rust files that rustc does.
7743
7744 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7745 [close]: https://github.com/rust-lang/rust/pull/21843
7746 [deref]: https://github.com/rust-lang/rust/pull/21351
7747 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7748 [drop]: https://github.com/rust-lang/rust/pull/21972
7749 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7750 [feat]: https://github.com/rust-lang/rust/pull/21248
7751 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7752 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7753 [fmt]: https://github.com/rust-lang/rust/pull/21457
7754 [into]: https://github.com/rust-lang/rust/pull/20790
7755 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7756 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7757 [lalr]: https://github.com/rust-lang/rust/pull/21452
7758 [multiline]: https://github.com/rust-lang/rust/pull/19870
7759 [obj]: https://github.com/rust-lang/rust/pull/22230
7760 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7761 [onun]: https://github.com/rust-lang/rust/pull/20889
7762 [osstr]: https://github.com/rust-lang/rust/pull/21488
7763 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7764 [Self]: https://github.com/rust-lang/rust/pull/22158
7765 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7766 [un]: https://github.com/rust-lang/rust/pull/22256
7767
7768
7769 Version 1.0.0-alpha (2015-01-09)
7770 ==================================
7771
7772   * ~2400 changes, numerous bugfixes
7773
7774   * Highlights
7775
7776     * The language itself is considered feature complete for 1.0,
7777       though there will be many usability improvements and bugfixes
7778       before the final release.
7779     * Nearly 50% of the public API surface of the standard library has
7780       been declared 'stable'. Those interfaces are unlikely to change
7781       before 1.0.
7782     * The long-running debate over integer types has been
7783       [settled][ints]: Rust will ship with types named `isize` and
7784       `usize`, rather than `int` and `uint`, for pointer-sized
7785       integers. Guidelines will be rolled out during the alpha cycle.
7786     * Most crates that are not `std` have been moved out of the Rust
7787       distribution into the Cargo ecosystem so they can evolve
7788       separately and don't need to be stabilized as quickly, including
7789       'time', 'getopts', 'num', 'regex', and 'term'.
7790     * Documentation continues to be expanded with more API coverage, more
7791       examples, and more in-depth explanations. The guides have been
7792       consolidated into [The Rust Programming Language][trpl].
7793     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7794     * All official Rust binary installers now come with [Cargo], the
7795       Rust package manager.
7796
7797 * Language
7798
7799     * Closures have been [completely redesigned][unboxed] to be
7800       implemented in terms of traits, can now be used as generic type
7801       bounds and thus monomorphized and inlined, or via an opaque
7802       pointer (boxed) as in the old system. The new system is often
7803       referred to as 'unboxed' closures.
7804     * Traits now support [associated types][assoc], allowing families
7805       of related types to be defined together and used generically in
7806       powerful ways.
7807     * Enum variants are [namespaced by their type names][enum].
7808     * [`where` clauses][where] provide a more versatile and attractive
7809       syntax for specifying generic bounds, though the previous syntax
7810       remains valid.
7811     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7812       numeric types.
7813     * Rust [no longer has a runtime][rt] of any description, and only
7814       supports OS threads, not green threads.
7815     * At long last, Rust has been overhauled for 'dynamically-sized
7816       types' ([DST]), which integrates 'fat pointers' (object types,
7817       arrays, and `str`) more deeply into the type system, making it
7818       more consistent.
7819     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7820       `..j` that produce range types and which, when combined with the
7821       `Index` operator and multidispatch, leads to a convenient slice
7822       notation, `[i..j]`.
7823     * The new range syntax revealed an ambiguity in the fixed-length
7824       array syntax, so now fixed length arrays [are written `[T;
7825       N]`][arrays].
7826     * The `Copy` trait is no longer implemented automatically. Unsafe
7827       pointers no longer implement `Sync` and `Send` so types
7828       containing them don't automatically either. `Sync` and `Send`
7829       are now 'unsafe traits' so one can "forcibly" implement them via
7830       `unsafe impl` if a type confirms to the requirements for them
7831       even though the internals do not (e.g. structs containing unsafe
7832       pointers like `Arc`). These changes are intended to prevent some
7833       footguns and are collectively known as [opt-in built-in
7834       traits][oibit] (though `Sync` and `Send` will soon become pure
7835       library types unknown to the compiler).
7836     * Operator traits now take their operands [by value][ops], and
7837       comparison traits can use multidispatch to compare one type
7838       against multiple other types, allowing e.g. `String` to be
7839       compared with `&str`.
7840     * `if let` and `while let` are no longer feature-gated.
7841     * Rust has adopted a more [uniform syntax for escaping unicode
7842       characters][unicode].
7843     * `macro_rules!` [has been declared stable][mac]. Though it is a
7844       flawed system it is sufficiently popular that it must be usable
7845       for 1.0. Effort has gone into [future-proofing][mac-future] it
7846       in ways that will allow other macro systems to be developed in
7847       parallel, and won't otherwise impact the evolution of the
7848       language.
7849     * The prelude has been [pared back significantly][prelude] such
7850       that it is the minimum necessary to support the most pervasive
7851       code patterns, and through [generalized where clauses][where]
7852       many of the prelude extension traits have been consolidated.
7853     * Rust's rudimentary reflection [has been removed][refl], as it
7854       incurred too much code generation for little benefit.
7855     * [Struct variants][structvars] are no longer feature-gated.
7856     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7857       known as 'higher-ranked trait bounds', this crucially allows
7858       unboxed closures to work.
7859     * Macros invocations surrounded by parens or square brackets and
7860       not terminated by a semicolon are [parsed as
7861       expressions][macros], which makes expressions like `vec![1i32,
7862       2, 3].len()` work as expected.
7863     * Trait objects now implement their traits automatically, and
7864       traits that can be coerced to objects now must be [object
7865       safe][objsafe].
7866     * Automatically deriving traits is now done with `#[derive(...)]`
7867       not `#[deriving(...)]` for [consistency with other naming
7868       conventions][derive].
7869     * Importing the containing module or enum at the same time as
7870       items or variants they contain is [now done with `self` instead
7871       of `mod`][self], as in use `foo::{self, bar}`
7872     * Glob imports are no longer feature-gated.
7873     * The `box` operator and `box` patterns have been feature-gated
7874       pending a redesign. For now unique boxes should be allocated
7875       like other containers, with `Box::new`.
7876
7877 * Libraries
7878
7879     * A [series][coll1] of [efforts][coll2] to establish
7880       [conventions][coll3] for collections types has resulted in API
7881       improvements throughout the standard library.
7882     * New [APIs for error handling][err] provide ergonomic interop
7883       between error types, and [new conventions][err-conv] describe
7884       more clearly the recommended error handling strategies in Rust.
7885     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7886       it is easier to discuss failure in the context of error handling
7887       without making clarifications as to whether you are referring to
7888       the 'fail' macro or failure more generally.
7889     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7890       syscall when available.
7891     * The 'serialize' crate has been renamed 'rustc-serialize' and
7892       moved out of the distribution to Cargo. Although it is widely
7893       used now, it is expected to be superseded in the near future.
7894     * The `Show` formatter, typically implemented with
7895       `#[derive(Show)]` is [now requested with the `{:?}`
7896       specifier][show] and is intended for use by all types, for uses
7897       such as `println!` debugging. The new `String` formatter must be
7898       implemented by hand, uses the `{}` specifier, and is intended
7899       for full-fidelity conversions of things that can logically be
7900       represented as strings.
7901
7902 * Tooling
7903
7904     * [Flexible target specification][flex] allows rustc's code
7905       generation to be configured to support otherwise-unsupported
7906       platforms.
7907     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7908       respective debuggers with Rust-appropriate pretty-printing.
7909     * The Windows installation of Rust is distributed with the
7910       MinGW components currently required to link binaries on that
7911       platform.
7912
7913 * Misc
7914
7915     * Nullable enum optimizations have been extended to more types so
7916       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7917       space than the inner types themselves.
7918     * Work has begun on supporting AArch64.
7919
7920 [Cargo]: https://crates.io
7921 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7922 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7923 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7924 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7925 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7926 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7927 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7928 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7929 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7930 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7931 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7932 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7933 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7934 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7935 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7936 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7937 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7938 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7939 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7940 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7941 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7942 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7943 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7944 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7945 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7946 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7947 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7948 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7949 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7950 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7951 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7952 [trpl]: https://doc.rust-lang.org/book/index.html
7953 [rbe]: http://rustbyexample.com/
7954
7955
7956 Version 0.12.0 (2014-10-09)
7957 =============================
7958
7959   * ~1900 changes, numerous bugfixes
7960
7961   * Highlights
7962
7963     * The introductory documentation (now called The Rust Guide) has
7964       been completely rewritten, as have a number of supplementary
7965       guides.
7966     * Rust's package manager, Cargo, continues to improve and is
7967       sometimes considered to be quite awesome.
7968     * Many API's in `std` have been reviewed and updated for
7969       consistency with the in-development Rust coding
7970       guidelines. The standard library documentation tracks
7971       stabilization progress.
7972     * Minor libraries have been moved out-of-tree to the rust-lang org
7973       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7974       be installed with Cargo.
7975     * Lifetime elision allows lifetime annotations to be left off of
7976       function declarations in many common scenarios.
7977     * Rust now works on 64-bit Windows.
7978
7979   * Language
7980     * Indexing can be overloaded with the `Index` and `IndexMut`
7981       traits.
7982     * The `if let` construct takes a branch only if the `let` pattern
7983       matches, currently behind the 'if_let' feature gate.
7984     * 'where clauses', a more flexible syntax for specifying trait
7985       bounds that is more aesthetic, have been added for traits and
7986       free functions. Where clauses will in the future make it
7987       possible to constrain associated types, which would be
7988       impossible with the existing syntax.
7989     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7990       the 'slicing_syntax' feature gate, and can be overloaded with
7991       the `Slice` or `SliceMut` traits.
7992     * The syntax for matching of sub-slices has been changed to use a
7993       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7994       consistency with other uses of `..` and to future-proof
7995       potential additional uses of the syntax.
7996     * The syntax for matching inclusive ranges in patterns has changed
7997       from `0..3` to `0...4` to be consistent with the exclusive range
7998       syntax for slicing.
7999     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
8000       c]`) has been put behind the 'advanced_slice_patterns' feature
8001       gate and may be removed in the future.
8002     * Components of tuples and tuple structs can be extracted using
8003       the `value.0` syntax, currently behind the `tuple_indexing`
8004       feature gate.
8005     * The `#[crate_id]` attribute is no longer supported; versioning
8006       is handled by the package manager.
8007     * Renaming crate imports are now written `extern crate foo as bar`
8008       instead of `extern crate bar = foo`.
8009     * Renaming use statements are now written `use foo as bar` instead
8010       of `use bar = foo`.
8011     * `let` and `match` bindings and argument names in macros are now
8012       hygienic.
8013     * The new, more efficient, closure types ('unboxed closures') have
8014       been added under a feature gate, 'unboxed_closures'. These will
8015       soon replace the existing closure types, once higher-ranked
8016       trait lifetimes are added to the language.
8017     * `move` has been added as a keyword, for indicating closures
8018       that capture by value.
8019     * Mutation and assignment is no longer allowed in pattern guards.
8020     * Generic structs and enums can now have trait bounds.
8021     * The `Share` trait is now called `Sync` to free up the term
8022       'shared' to refer to 'shared reference' (the default reference
8023       type.
8024     * Dynamically-sized types have been mostly implemented,
8025       unifying the behavior of fat-pointer types with the rest of the
8026       type system.
8027     * As part of dynamically-sized types, the `Sized` trait has been
8028       introduced, which qualifying types implement by default, and
8029       which type parameters expect by default. To specify that a type
8030       parameter does not need to be sized, write `<Sized? T>`. Most
8031       types are `Sized`, notable exceptions being unsized arrays
8032       (`[T]`) and trait types.
8033     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8034     * Lifetime bounds can now be applied to type parameters and object
8035       types.
8036     * The old, reference counted GC type, `Gc<T>` which was once
8037       denoted by the `@` sigil, has finally been removed. GC will be
8038       revisited in the future.
8039
8040   * Libraries
8041     * Library documentation has been improved for a number of modules.
8042     * Bit-vectors, collections::bitv has been modernized.
8043     * The url crate is deprecated in favor of
8044       http://github.com/servo/rust-url, which can be installed with
8045       Cargo.
8046     * Most I/O stream types can be cloned and subsequently closed from
8047       a different thread.
8048     * A `std::time::Duration` type has been added for use in I/O
8049       methods that rely on timers, as well as in the 'time' crate's
8050       `Timespec` arithmetic.
8051     * The runtime I/O abstraction layer that enabled the green thread
8052       scheduler to do non-thread-blocking I/O has been removed, along
8053       with the libuv-based implementation employed by the green thread
8054       scheduler. This will greatly simplify the future I/O work.
8055     * `collections::btree` has been rewritten to have a more
8056       idiomatic and efficient design.
8057
8058   * Tooling
8059     * rustdoc output now indicates the stability levels of API's.
8060     * The `--crate-name` flag can specify the name of the crate
8061       being compiled, like `#[crate_name]`.
8062     * The `-C metadata` specifies additional metadata to hash into
8063       symbol names, and `-C extra-filename` specifies additional
8064       information to put into the output filename, for use by the
8065       package manager for versioning.
8066     * debug info generation has continued to improve and should be
8067       more reliable under both gdb and lldb.
8068     * rustc has experimental support for compiling in parallel
8069       using the `-C codegen-units` flag.
8070     * rustc no longer encodes rpath information into binaries by
8071       default.
8072
8073   * Misc
8074     * Stack usage has been optimized with LLVM lifetime annotations.
8075     * Official Rust binaries on Linux are more compatible with older
8076       kernels and distributions, built on CentOS 5.10.
8077
8078
8079 Version 0.11.0 (2014-07-02)
8080 ==========================
8081
8082   * ~1700 changes, numerous bugfixes
8083
8084   * Language
8085     * ~[T] has been removed from the language. This type is superseded by
8086       the Vec<T> type.
8087     * ~str has been removed from the language. This type is superseded by
8088       the String type.
8089     * ~T has been removed from the language. This type is superseded by the
8090       Box<T> type.
8091     * @T has been removed from the language. This type is superseded by the
8092       standard library's std::gc::Gc<T> type.
8093     * Struct fields are now all private by default.
8094     * Vector indices and shift amounts are both required to be a `uint`
8095       instead of any integral type.
8096     * Byte character, byte string, and raw byte string literals are now all
8097       supported by prefixing the normal literal with a `b`.
8098     * Multiple ABIs are no longer allowed in an ABI string
8099     * The syntax for lifetimes on closures/procedures has been tweaked
8100       slightly: `<'a>|A, B|: 'b + K -> T`
8101     * Floating point modulus has been removed from the language; however it
8102       is still provided by a library implementation.
8103     * Private enum variants are now disallowed.
8104     * The `priv` keyword has been removed from the language.
8105     * A closure can no longer be invoked through a &-pointer.
8106     * The `use foo, bar, baz;` syntax has been removed from the language.
8107     * The transmute intrinsic no longer works on type parameters.
8108     * Statics now allow blocks/items in their definition.
8109     * Trait bounds are separated from objects with + instead of : now.
8110     * Objects can no longer be read while they are mutably borrowed.
8111     * The address of a static is now marked as insignificant unless the
8112       #[inline(never)] attribute is placed it.
8113     * The #[unsafe_destructor] attribute is now behind a feature gate.
8114     * Struct literals are no longer allowed in ambiguous positions such as
8115       if, while, match, and for..in.
8116     * Declaration of lang items and intrinsics are now feature-gated by
8117       default.
8118     * Integral literals no longer default to `int`, and floating point
8119       literals no longer default to `f64`. Literals must be suffixed with an
8120       appropriate type if inference cannot determine the type of the
8121       literal.
8122     * The Box<T> type is no longer implicitly borrowed to &mut T.
8123     * Procedures are now required to not capture borrowed references.
8124
8125   * Libraries
8126     * The standard library is now a "facade" over a number of underlying
8127       libraries. This means that development on the standard library should
8128       be speedier due to smaller crates, as well as a clearer line between
8129       all dependencies.
8130     * A new library, libcore, lives under the standard library's facade
8131       which is Rust's "0-assumption" library, suitable for embedded and
8132       kernel development for example.
8133     * A regex crate has been added to the standard distribution. This crate
8134       includes statically compiled regular expressions.
8135     * The unwrap/unwrap_err methods on Result require a Show bound for
8136       better error messages.
8137     * The return types of the std::comm primitives have been centralized
8138       around the Result type.
8139     * A number of I/O primitives have gained the ability to time out their
8140       operations.
8141     * A number of I/O primitives have gained the ability to close their
8142       reading/writing halves to cancel pending operations.
8143     * Reverse iterator methods have been removed in favor of `rev()` on
8144       their forward-iteration counterparts.
8145     * A bitflags! macro has been added to enable easy interop with C and
8146       management of bit flags.
8147     * A debug_assert! macro is now provided which is disabled when
8148       `--cfg ndebug` is passed to the compiler.
8149     * A graphviz crate has been added for creating .dot files.
8150     * The std::cast module has been migrated into std::mem.
8151     * The std::local_data api has been migrated from freestanding functions
8152       to being based on methods.
8153     * The Pod trait has been renamed to Copy.
8154     * jemalloc has been added as the default allocator for types.
8155     * The API for allocating memory has been changed to use proper alignment
8156       and sized deallocation
8157     * Connecting a TcpStream or binding a TcpListener is now based on a
8158       string address and a u16 port. This allows connecting to a hostname as
8159       opposed to an IP.
8160     * The Reader trait now contains a core method, read_at_least(), which
8161       correctly handles many repeated 0-length reads.
8162     * The process-spawning API is now centered around a builder-style
8163       Command struct.
8164     * The :? printing qualifier has been moved from the standard library to
8165       an external libdebug crate.
8166     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8167       have been renamed to Eq/Ord.
8168     * The select/plural methods have been removed from format!. The escapes
8169       for { and } have also changed from \{ and \} to {{ and }},
8170       respectively.
8171     * The TaskBuilder API has been re-worked to be a true builder, and
8172       extension traits for spawning native/green tasks have been added.
8173
8174   * Tooling
8175     * All breaking changes to the language or libraries now have their
8176       commit message annotated with `[breaking-change]` to allow for easy
8177       discovery of breaking changes.
8178     * The compiler will now try to suggest how to annotate lifetimes if a
8179       lifetime-related error occurs.
8180     * Debug info continues to be improved greatly with general bug fixes and
8181       better support for situations like link time optimization (LTO).
8182     * Usage of syntax extensions when cross-compiling has been fixed.
8183     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8184       -fdata-sections and --gc-sections has been enabled by default
8185     * The compiler is now stricter about where it will load module files
8186       from when a module is declared via `mod foo;`.
8187     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8188       Syntax extensions are now discovered via a "plugin registrar" type
8189       which will be extended in the future to other various plugins.
8190     * Lints have been restructured to allow for dynamically loadable lints.
8191     * A number of rustdoc improvements:
8192       * The HTML output has been visually redesigned.
8193       * Markdown is now powered by hoedown instead of sundown.
8194       * Searching heuristics have been greatly improved.
8195       * The search index has been reduced in size by a great amount.
8196       * Cross-crate documentation via `pub use` has been greatly improved.
8197       * Primitive types are now hyperlinked and documented.
8198     * Documentation has been moved from static.rust-lang.org/doc to
8199       doc.rust-lang.org
8200     * A new sandbox, play.rust-lang.org, is available for running and
8201       sharing rust code examples on-line.
8202     * Unused attributes are now more robustly warned about.
8203     * The dead_code lint now warns about unused struct fields.
8204     * Cross-compiling to iOS is now supported.
8205     * Cross-compiling to mipsel is now supported.
8206     * Stability attributes are now inherited by default and no longer apply
8207       to intra-crate usage, only inter-crate usage.
8208     * Error message related to non-exhaustive match expressions have been
8209       greatly improved.
8210
8211
8212 Version 0.10 (2014-04-03)
8213 =========================
8214
8215   * ~1500 changes, numerous bugfixes
8216
8217   * Language
8218     * A new RFC process is now in place for modifying the language.
8219     * Patterns with `@`-pointers have been removed from the language.
8220     * Patterns with unique vectors (`~[T]`) have been removed from the
8221       language.
8222     * Patterns with unique strings (`~str`) have been removed from the
8223       language.
8224     * `@str` has been removed from the language.
8225     * `@[T]` has been removed from the language.
8226     * `@self` has been removed from the language.
8227     * `@Trait` has been removed from the language.
8228     * Headers on `~` allocations which contain `@` boxes inside the type for
8229       reference counting have been removed.
8230     * The semantics around the lifetimes of temporary expressions have changed,
8231       see #3511 and #11585 for more information.
8232     * Cross-crate syntax extensions are now possible, but feature gated. See
8233       #11151 for more information. This includes both `macro_rules!` macros as
8234       well as syntax extensions such as `format!`.
8235     * New lint modes have been added, and older ones have been turned on to be
8236       warn-by-default.
8237       * Unnecessary parentheses
8238       * Uppercase statics
8239       * Camel Case types
8240       * Uppercase variables
8241       * Publicly visible private types
8242       * `#[deriving]` with raw pointers
8243     * Unsafe functions can no longer be coerced to closures.
8244     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8245     * The `#[simd]` attribute is now behind a feature gate.
8246     * Visibility is no longer allowed on `extern crate` statements, and
8247       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8248     * Trailing commas are now allowed in argument lists and tuple patterns.
8249     * The `do` keyword has been removed, it is now a reserved keyword.
8250     * Default type parameters have been implemented, but are feature gated.
8251     * Borrowed variables through captures in closures are now considered soundly.
8252     * `extern mod` is now `extern crate`
8253     * The `Freeze` trait has been removed.
8254     * The `Share` trait has been added for types that can be shared among
8255       threads.
8256     * Labels in macros are now hygienic.
8257     * Expression/statement macro invocations can be delimited with `{}` now.
8258     * Treatment of types allowed in `static mut` locations has been tweaked.
8259     * The `*` and `.` operators are now overloadable through the `Deref` and
8260       `DerefMut` traits.
8261     * `~Trait` and `proc` no longer have `Send` bounds by default.
8262     * Partial type hints are now supported with the `_` type marker.
8263     * An `Unsafe` type was introduced for interior mutability. It is now
8264       considered undefined to transmute from `&T` to `&mut T` without using the
8265       `Unsafe` type.
8266     * The #[linkage] attribute was implemented for extern statics/functions.
8267     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8268     * `Pod` was renamed to `Copy`.
8269
8270   * Libraries
8271     * The `libextra` library has been removed. It has now been decomposed into
8272       component libraries with smaller and more focused nuggets of
8273       functionality. The full list of libraries can be found on the
8274       documentation index page.
8275     * std: `std::condition` has been removed. All I/O errors are now propagated
8276       through the `Result` type. In order to assist with error handling, a
8277       `try!` macro for unwrapping errors with an early return and a lint for
8278       unused results has been added. See #12039 for more information.
8279     * std: The `vec` module has been renamed to `slice`.
8280     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8281       This will become the only growable vector in the future.
8282     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
8283       are now found at `std::io::BufferedReader` instead of
8284       `std::io::buffered::BufferedReader`.
8285     * std: `print` and `println` are no longer in the prelude, the `print!` and
8286       `println!` macros are intended to be used instead.
8287     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8288       attempts to statically prevent cycles.
8289     * std: The standard distribution is adopting the policy of pushing failure
8290       to the user rather than failing in libraries. Many functions (such as
8291       `slice::last()`) now return `Option<T>` instead of `T` + failing.
8292     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8293       deriving mode: `#[deriving(Show)]`.
8294     * std: `ToStr` is now implemented for all types implementing `Show`.
8295     * std: The formatting trait methods now take `&self` instead of `&T`
8296     * std: The `invert()` method on iterators has been renamed to `rev()`
8297     * std: `std::num` has seen a reduction in the genericity of its traits,
8298       consolidating functionality into a few core traits.
8299     * std: Backtraces are now printed on task failure if the environment
8300       variable `RUST_BACKTRACE` is present.
8301     * std: Naming conventions for iterators have been standardized. More details
8302       can be found on the wiki's style guide.
8303     * std: `eof()` has been removed from the `Reader` trait. Specific types may
8304       still implement the function.
8305     * std: Networking types are now cloneable to allow simultaneous reads/writes.
8306     * std: `assert_approx_eq!` has been removed
8307     * std: The `e` and `E` formatting specifiers for floats have been added to
8308       print them in exponential notation.
8309     * std: The `Times` trait has been removed
8310     * std: Indications of variance and opting out of builtin bounds is done
8311       through marker types in `std::kinds::marker` now
8312     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8313       `#[deriving(Hash)]` is now possible.
8314     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8315     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8316     * std: `Chan::new` is now `channel()`.
8317     * std: A new synchronous channel type has been implemented.
8318     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8319     * std: `hashmap` and `trie` have been moved to `libcollections`
8320     * std: `run` has been rolled into `io::process`
8321     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8322     * std: The equality and comparison traits have seen some reorganization.
8323     * std: `rand` has moved to `librand`.
8324     * std: `to_{lower,upper}case` has been implemented for `char`.
8325     * std: Logging has been moved to `liblog`.
8326     * collections: `HashMap` has been rewritten for higher performance and less
8327       memory usage.
8328     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8329       it can be booted manually. The runtime guide has more information and
8330       examples.
8331     * native: All I/O functionality except signals has been implemented.
8332     * green: Task spawning with `libgreen` has been optimized with stack caching
8333       and various trimming of code.
8334     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8335     * sync: The `extra::sync` module has been updated to modern rust (and moved
8336       to the `sync` library), tweaking and improving various interfaces while
8337       dropping redundant functionality.
8338     * sync: A new `Barrier` type has been added to the `sync` library.
8339     * sync: An efficient mutex for native and green tasks has been implemented.
8340     * serialize: The `base64` module has seen some improvement. It treats
8341       newlines better, has non-string error values, and has seen general
8342       cleanup.
8343     * fourcc: A `fourcc!` macro was introduced
8344     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8345       hexadecimal literal.
8346
8347   * Tooling
8348     * `rustpkg` has been deprecated and removed from the main repository. Its
8349       replacement, `cargo`, is under development.
8350     * Nightly builds of rust are now available
8351     * The memory usage of rustc has been improved many times throughout this
8352       release cycle.
8353     * The build process supports disabling rpath support for the rustc binary
8354       itself.
8355     * Code generation has improved in some cases, giving more information to the
8356       LLVM optimization passes to enable more extensive optimizations.
8357     * Debuginfo compatibility with lldb on OSX has been restored.
8358     * The master branch is now gated on an android bot, making building for
8359       android much more reliable.
8360     * Output flags have been centralized into one `--emit` flag.
8361     * Crate type flags have been centralized into one `--crate-type` flag.
8362     * Codegen flags have been consolidated behind a `-C` flag.
8363     * Linking against outdated crates now has improved error messages.
8364     * Error messages with lifetimes will often suggest how to annotate the
8365       function to fix the error.
8366     * Many more types are documented in the standard library, and new guides
8367       were written.
8368     * Many `rustdoc` improvements:
8369       * code blocks are syntax highlighted.
8370       * render standalone markdown files.
8371       * the --test flag tests all code blocks by default.
8372       * exported macros are displayed.
8373       * re-exported types have their documentation inlined at the location of the
8374         first re-export.
8375       * search works across crates that have been rendered to the same output
8376         directory.
8377
8378
8379 Version 0.9 (2014-01-09)
8380 ==========================
8381
8382    * ~1800 changes, numerous bugfixes
8383
8384    * Language
8385       * The `float` type has been removed. Use `f32` or `f64` instead.
8386       * A new facility for enabling experimental features (feature gating) has
8387         been added, using the crate-level `#[feature(foo)]` attribute.
8388       * Managed boxes (@) are now behind a feature gate
8389         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8390         standard library's `Gc` or `Rc` types instead.
8391       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8392       * Jumping back to the top of a loop is now done with `continue` instead of
8393         `loop`.
8394       * Strings can no longer be mutated through index assignment.
8395       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8396         hash delimiters, as in `r###"foo"###`.
8397       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8398         called once.
8399       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8400       * `@fn`s have been removed.
8401       * `do` only works with procs in order to make it obvious what the cost
8402         of `do` is.
8403       * Single-element tuple-like structs can no longer be dereferenced to
8404         obtain the inner value. A more comprehensive solution for overloading
8405         the dereference operator will be provided in the future.
8406       * The `#[link(...)]` attribute has been replaced with
8407         `#[crate_id = "name#vers"]`.
8408       * Empty `impl`s must be terminated with empty braces and may not be
8409         terminated with a semicolon.
8410       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8411         no longer has any special meaning.
8412       * The old `fmt!` string formatting macro has been removed.
8413       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8414         `print!` and `println!`.
8415       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8416       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8417         `extern mod foo = "bar"` instead.
8418       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8419       * Macros can have attributes.
8420       * Macros can expand to items with attributes.
8421       * Macros can expand to multiple items.
8422       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8423       * Comments may be nested.
8424       * Values automatically coerce to trait objects they implement, without
8425         an explicit `as`.
8426       * Enum discriminants are no longer an entire word but as small as needed to
8427         contain all the variants. The `repr` attribute can be used to override
8428         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8429         `#[repr(C)]` to match C enums.
8430       * Non-string literals are not allowed in attributes (they never worked).
8431       * The FFI now supports variadic functions.
8432       * Octal numeric literals, as in `0o7777`.
8433       * The `concat!` syntax extension performs compile-time string concatenation.
8434       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8435         removed as Rust no longer uses segmented stacks.
8436       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8437       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8438         not `*`; ignoring remaining fields of a struct is also done with `..`,
8439         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8440       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8441       * `rustc` supports the "system" calling convention, which defaults to the
8442         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8443         "C" elsewhere.
8444       * The `type_overflow` lint (default: warn) checks literals for overflow.
8445       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8446       * The `attribute_usage` lint (default: warn) warns about unknown
8447         attributes.
8448       * The `unknown_features` lint (default: warn) warns about unknown
8449         feature gates.
8450       * The `dead_code` lint (default: warn) checks for dead code.
8451       * Rust libraries can be linked statically to one another
8452       * `#[link_args]` is behind the `link_args` feature gate.
8453       * Native libraries are now linked with `#[link(name = "foo")]`
8454       * Native libraries can be statically linked to a rust crate
8455         (`#[link(name = "foo", kind = "static")]`).
8456       * Native OS X frameworks are now officially supported
8457         (`#[link(name = "foo", kind = "framework")]`).
8458       * The `#[thread_local]` attribute creates thread-local (not task-local)
8459         variables. Currently behind the `thread_local` feature gate.
8460       * The `return` keyword may be used in closures.
8461       * Types that can be copied via a memcpy implement the `Pod` kind.
8462       * The `cfg` attribute can now be used on struct fields and enum variants.
8463
8464    * Libraries
8465       * std: The `option` and `result` API's have been overhauled to make them
8466         simpler, more consistent, and more composable.
8467       * std: The entire `std::io` module has been replaced with one that is
8468         more comprehensive and that properly interfaces with the underlying
8469         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8470         implemented.
8471       * std: `io::util` contains a number of useful implementations of
8472         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8473         `ZeroReader`, `TeeReader`.
8474       * std: The reference counted pointer type `extra::rc` moved into std.
8475       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8476         just a wrapper around it).
8477       * std: The `Either` type has been removed.
8478       * std: `fmt::Default` can be implemented for any type to provide default
8479         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8480       * std: The `rand` API continues to be tweaked.
8481       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8482         on failure in gdb, is now named `rust_fail`.
8483       * std: The `each_key` and `each_value` methods on `HashMap` have been
8484         replaced by the `keys` and `values` iterators.
8485       * std: Functions dealing with type size and alignment have moved from the
8486         `sys` module to the `mem` module.
8487       * std: The `path` module was written and API changed.
8488       * std: `str::from_utf8` has been changed to cast instead of allocate.
8489       * std: `starts_with` and `ends_with` methods added to vectors via the
8490         `ImmutableEqVector` trait, which is in the prelude.
8491       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8492         if the index is out of bounds.
8493       * std: Task failure no longer propagates between tasks, as the model was
8494         complex, expensive, and incompatible with thread-based tasks.
8495       * std: The `Any` type can be used for dynamic typing.
8496       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8497         `task::try`.
8498       * std: Methods that produce iterators generally do not have an `_iter`
8499         suffix now.
8500       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8501         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8502       * std: `util::ignore` renamed to `prelude::drop`.
8503       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8504         trait.
8505       * std: `vec::raw` has seen a lot of cleanup and API changes.
8506       * std: The standard library no longer includes any C++ code, and very
8507         minimal C, eliminating the dependency on libstdc++.
8508       * std: Runtime scheduling and I/O functionality has been factored out into
8509         extensible interfaces and is now implemented by two different crates:
8510         libnative, for native threading and I/O; and libgreen, for green threading
8511         and I/O. This paves the way for using the standard library in more limited
8512         embedded environments.
8513       * std: The `comm` module has been rewritten to be much faster, have a
8514         simpler, more consistent API, and to work for both native and green
8515         threading.
8516       * std: All libuv dependencies have been moved into the rustuv crate.
8517       * native: New implementations of runtime scheduling on top of OS threads.
8518       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8519         and other I/O.
8520       * green: The green thread scheduler and message passing types are almost
8521         entirely lock-free.
8522       * extra: The `flatpipes` module had bitrotted and was removed.
8523       * extra: All crypto functions have been removed and Rust now has a policy of
8524         not reimplementing crypto in the standard library. In the future crypto
8525         will be provided by external crates with bindings to established libraries.
8526       * extra: `c_vec` has been modernized.
8527       * extra: The `sort` module has been removed. Use the `sort` method on
8528         mutable slices.
8529
8530    * Tooling
8531       * The `rust` and `rusti` commands have been removed, due to lack of
8532         maintenance.
8533       * `rustdoc` was completely rewritten.
8534       * `rustdoc` can test code examples in documentation.
8535       * `rustpkg` can test packages with the argument, 'test'.
8536       * `rustpkg` supports arbitrary dependencies, including C libraries.
8537       * `rustc`'s support for generating debug info is improved again.
8538       * `rustc` has better error reporting for unbalanced delimiters.
8539       * `rustc`'s JIT support was removed due to bitrot.
8540       * Executables and static libraries can be built with LTO (-Z lto)
8541       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8542         build tools.
8543
8544
8545 Version 0.8 (2013-09-26)
8546 ============================
8547
8548    * ~2200 changes, numerous bugfixes
8549
8550    * Language
8551       * The `for` loop syntax has changed to work with the `Iterator` trait.
8552       * At long last, unwinding works on Windows.
8553       * Default methods are ready for use.
8554       * Many trait inheritance bugs fixed.
8555       * Owned and borrowed trait objects work more reliably.
8556       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8557       * rustc can omit emission of code for the `debug!` macro if it is passed
8558         `--cfg ndebug`
8559       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8560         for foo.rs, then foo/mod.rs, and will generate an error when both are
8561         present.
8562       * Strings no longer contain trailing nulls. The new `std::c_str` module
8563         provides new mechanisms for converting to C strings.
8564       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8565       * The FFI has been overhauled such that foreign functions are called directly,
8566         instead of through a stack-switching wrapper.
8567       * Calling a foreign function must be done through a Rust function with the
8568         `#[fixed_stack_segment]` attribute.
8569       * The `externfn!` macro can be used to declare both a foreign function and
8570         a `#[fixed_stack_segment]` wrapper at once.
8571       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8572       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8573       * `priv` is disallowed everywhere except for struct fields and enum variants.
8574       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8575       * `ref` bindings in irrefutable patterns work correctly now.
8576       * `char` is now prevented from containing invalid code points.
8577       * Casting to `bool` is no longer allowed.
8578       * `\0` is now accepted as an escape in chars and strings.
8579       * `yield` is a reserved keyword.
8580       * `typeof` is a reserved keyword.
8581       * Crates may be imported by URL with `extern mod foo = "url";`.
8582       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8583       * Static vectors can be initialized with repeating elements,
8584         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8585       * Static structs can be initialized with functional record update,
8586         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8587       * `cfg!` can be used to conditionally execute code based on the crate
8588         configuration, similarly to `#[cfg(...)]`.
8589       * The `unnecessary_qualification` lint detects unneeded module
8590         prefixes (default: allow).
8591       * Arithmetic operations have been implemented on the SIMD types in
8592         `std::unstable::simd`.
8593       * Exchange allocation headers were removed, reducing memory usage.
8594       * `format!` implements a completely new, extensible, and higher-performance
8595         string formatting system. It will replace `fmt!`.
8596       * `print!` and `println!` write formatted strings (using the `format!`
8597         extension) to stdout.
8598       * `write!` and `writeln!` write formatted strings (using the `format!`
8599         extension) to the new Writers in `std::rt::io`.
8600       * The library section in which a function or static is placed may
8601         be specified with `#[link_section = "..."]`.
8602       * The `proto!` syntax extension for defining bounded message protocols
8603         was removed.
8604       * `macro_rules!` is hygienic for `let` declarations.
8605       * The `#[export_name]` attribute specifies the name of a symbol.
8606       * `unreachable!` can be used to indicate unreachable code, and fails
8607         if executed.
8608
8609    * Libraries
8610       * std: Transitioned to the new runtime, written in Rust.
8611       * std: Added an experimental I/O library, `rt::io`, based on the new
8612         runtime.
8613       * std: A new generic `range` function was added to the prelude, replacing
8614         `uint::range` and friends.
8615       * std: `range_rev` no longer exists. Since range is an iterator it can be
8616         reversed with `range(lo, hi).invert()`.
8617       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8618         renamed to `unwrap_or`.
8619       * std: The `iterator` module was renamed to `iter`.
8620       * std: Integral types now support the `checked_add`, `checked_sub`, and
8621         `checked_mul` operations for detecting overflow.
8622       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8623         consistency.
8624       * std: Methods are standardizing on conventions for casting methods:
8625         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8626         and cheap casts.
8627       * std: The `CString` type in `c_str` provides new ways to convert to and
8628         from C strings.
8629       * std: `DoubleEndedIterator` can yield elements in two directions.
8630       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8631         two splices.
8632       * std: `str::from_bytes` renamed to `str::from_utf8`.
8633       * std: `pop_opt` and `shift_opt` methods added to vectors.
8634       * std: The task-local data interface no longer uses @, and keys are
8635         no longer function pointers.
8636       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8637       * std: Added `SharedPort` to `comm`.
8638       * std: `Eq` has a default method for `ne`; only `eq` is required
8639         in implementations.
8640       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8641         is required in implementations.
8642       * std: `is_utf8` performance is improved, impacting many string functions.
8643       * std: `os::MemoryMap` provides cross-platform mmap.
8644       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8645         are not 'in-bounds' are considered undefined.
8646       * std: Many freestanding functions in `vec` removed in favor of methods.
8647       * std: Many freestanding functions on scalar types removed in favor of
8648         methods.
8649       * std: Many options to task builders were removed since they don't make
8650         sense in the new scheduler design.
8651       * std: More containers implement `FromIterator` so can be created by the
8652         `collect` method.
8653       * std: More complete atomic types in `unstable::atomics`.
8654       * std: `comm::PortSet` removed.
8655       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8656         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8657         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8658         default implementations.
8659       * std: Various `from_str` functions were removed in favor of a generic
8660         `from_str` which is available in the prelude.
8661       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8662       * extra: `dlist`, the doubly-linked list was modernized.
8663       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8664       * extra: Added `glob` module, replacing `std::os::glob`.
8665       * extra: `rope` was removed.
8666       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8667       * extra: `net`, and `timer` were removed. The experimental replacements
8668         are `std::rt::io::net` and `std::rt::io::timer`.
8669       * extra: Iterators implemented for `SmallIntMap`.
8670       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8671       * extra: `SmallIntSet` removed. Use `BitvSet`.
8672       * extra: Performance of JSON parsing greatly improved.
8673       * extra: `semver` updated to SemVer 2.0.0.
8674       * extra: `term` handles more terminals correctly.
8675       * extra: `dbg` module removed.
8676       * extra: `par` module removed.
8677       * extra: `future` was cleaned up, with some method renames.
8678       * extra: Most free functions in `getopts` were converted to methods.
8679
8680    * Other
8681       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8682       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8683         similarly to gcc's `--march` flag.
8684       * rustc's performance compiling small crates is much better.
8685       * rustpkg has received many improvements.
8686       * rustpkg supports git tags as package IDs.
8687       * rustpkg builds into target-specific directories so it can be used for
8688         cross-compiling.
8689       * The number of concurrent test tasks is controlled by the environment
8690         variable RUST_TEST_TASKS.
8691       * The test harness can now report metrics for benchmarks.
8692       * All tools have man pages.
8693       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8694       * The runtime uses jemalloc for allocations.
8695       * Segmented stacks are temporarily disabled as part of the transition to
8696         the new runtime. Stack overflows are possible!
8697       * A new documentation backend, rustdoc_ng, is available for use. It is
8698         still invoked through the normal `rustdoc` command.
8699
8700
8701 Version 0.7 (2013-07-03)
8702 =======================
8703
8704    * ~2000 changes, numerous bugfixes
8705
8706    * Language
8707       * `impl`s no longer accept a visibility qualifier. Put them on methods
8708         instead.
8709       * The borrow checker has been rewritten with flow-sensitivity, fixing
8710         many bugs and inconveniences.
8711       * The `self` parameter no longer implicitly means `&'self self`,
8712         and can be explicitly marked with a lifetime.
8713       * Overloadable compound operators (`+=`, etc.) have been temporarily
8714         removed due to bugs.
8715       * The `for` loop protocol now requires `for`-iterators to return `bool`
8716         so they compose better.
8717       * The `Durable` trait is replaced with the `'static` bounds.
8718       * Trait default methods work more often.
8719       * Structs with the `#[packed]` attribute have byte alignment and
8720         no padding between fields.
8721       * Type parameters bound by `Copy` must now be copied explicitly with
8722         the `copy` keyword.
8723       * It is now illegal to move out of a dereferenced unsafe pointer.
8724       * `Option<~T>` is now represented as a nullable pointer.
8725       * `@mut` does dynamic borrow checks correctly.
8726       * The `main` function is only detected at the topmost level of the crate.
8727         The `#[main]` attribute is still valid anywhere.
8728       * Struct fields may no longer be mutable. Use inherited mutability.
8729       * The `#[no_send]` attribute makes a type that would otherwise be
8730         `Send`, not.
8731       * The `#[no_freeze]` attribute makes a type that would otherwise be
8732         `Freeze`, not.
8733       * Unbounded recursion will abort the process after reaching the limit
8734         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8735       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8736         are never implicitly copyable.
8737       * `#[static_assert]` makes compile-time assertions about static bools.
8738       * At long last, 'argument modes' no longer exist.
8739       * The rarely used `use mod` statement no longer exists.
8740
8741    * Syntax extensions
8742       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8743         argument list.
8744       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8745         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8746         `#[deriving(...)]`.
8747       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8748         and unsuffixed integer literals.
8749
8750    * Libraries
8751       * The `core` crate was renamed to `std`.
8752       * The `std` crate was renamed to `extra`.
8753       * More and improved documentation.
8754       * std: `iterator` module for external iterator objects.
8755       * Many old-style (internal, higher-order function) iterators replaced by
8756         implementations of `Iterator`.
8757       * std: Many old internal vector and string iterators,
8758         incl. `any`, `all`. removed.
8759       * std: The `finalize` method of `Drop` renamed to `drop`.
8760       * std: The `drop` method now takes `&mut self` instead of `&self`.
8761       * std: The prelude no longer re-exports any modules, only types and traits.
8762       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8763         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8764       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8765         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8766       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8767         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8768       * std: Many types implement `Clone`.
8769       * std: `path` type renamed to `Path`.
8770       * std: `mut` module and `Mut` type removed.
8771       * std: Many standalone functions removed in favor of methods and iterators
8772         in `vec`, `str`. In the future methods will also work as functions.
8773       * std: `reinterpret_cast` removed. Use `transmute`.
8774       * std: ascii string handling in `std::ascii`.
8775       * std: `Rand` is implemented for ~/@.
8776       * std: `run` module for spawning processes overhauled.
8777       * std: Various atomic types added to `unstable::atomic`.
8778       * std: Various types implement `Zero`.
8779       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8780       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8781       * std: Added `os::mkdir_recursive`.
8782       * std: Added `os::glob` function performs filesystems globs.
8783       * std: `FuzzyEq` renamed to `ApproxEq`.
8784       * std: `Map` now defines `pop` and `swap` methods.
8785       * std: `Cell` constructors converted to static methods.
8786       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8787       * extra: `flate` module moved from `std` to `extra`.
8788       * extra: `fileinput` module for iterating over a series of files.
8789       * extra: `Complex` number type and `complex` module.
8790       * extra: `Rational` number type and `rational` module.
8791       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8792       * extra: `term` uses terminfo now, is more correct.
8793       * extra: `arc` functions converted to methods.
8794       * extra: Implementation of fixed output size variations of SHA-2.
8795
8796    * Tooling
8797       * `unused_variables` lint mode for unused variables (default: warn).
8798       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8799         (default: warn).
8800       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8801         (default: warn).
8802       * `dead_assignment` lint mode for unread variables (default: warn).
8803       * `unnecessary_allocation` lint mode detects some heap allocations that are
8804         immediately borrowed so could be written without allocating (default: warn).
8805       * `missing_doc` lint mode (default: allow).
8806       * `unreachable_code` lint mode (default: warn).
8807       * The `rusti` command has been rewritten and a number of bugs addressed.
8808       * rustc outputs in color on more terminals.
8809       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8810       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8811       * Compiling with `-g` will make the binary record information about
8812         dynamic borrowcheck failures for debugging.
8813       * rustdoc has a nicer stylesheet.
8814       * Various improvements to rustdoc.
8815       * Improvements to rustpkg (see the detailed release notes).
8816
8817
8818 Version 0.6 (2013-04-03)
8819 ========================
8820
8821    * ~2100 changes, numerous bugfixes
8822
8823    * Syntax changes
8824       * The self type parameter in traits is now spelled `Self`
8825       * The `self` parameter in trait and impl methods must now be explicitly
8826         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8827       * Static methods no longer require the `static` keyword and instead
8828         are distinguished by the lack of a `self` parameter
8829       * Replaced the `Durable` trait with the `'static` lifetime
8830       * The old closure type syntax with the trailing sigil has been
8831         removed in favor of the more consistent leading sigil
8832       * `super` is a keyword, and may be prefixed to paths
8833       * Trait bounds are separated with `+` instead of whitespace
8834       * Traits are implemented with `impl Trait for Type`
8835         instead of `impl Type: Trait`
8836       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8837       * The `export` keyword has finally been removed
8838       * The `move` keyword has been removed (see "Semantic changes")
8839       * The interior mutability qualifier on vectors, `[mut T]`, has been
8840         removed. Use `&mut [T]`, etc.
8841       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8842       * `fail` is no longer a keyword. Use `fail!()`
8843       * `assert` is no longer a keyword. Use `assert!()`
8844       * `log` is no longer a keyword. use `debug!`, etc.
8845       * 1-tuples may be represented as `(T,)`
8846       * Struct fields may no longer be `mut`. Use inherited mutability,
8847         `@mut T`, `core::mut` or `core::cell`
8848       * `extern mod { ... }` is no longer valid syntax for foreign
8849         function modules. Use extern blocks: `extern { ... }`
8850       * Newtype enums removed. Use tuple-structs.
8851       * Trait implementations no longer support visibility modifiers
8852       * Pattern matching over vectors improved and expanded
8853       * `const` renamed to `static` to correspond to lifetime name,
8854         and make room for future `static mut` unsafe mutable globals.
8855       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8856       * `Clone` implementations can be automatically generated with
8857         `#[deriving(Clone)]`
8858       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8859         instead of `foo as Bar`.
8860       * Fixed length vector types are now written as `[int, .. 3]`
8861         instead of `[int * 3]`.
8862       * Fixed length vector types can express the length as a constant
8863         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8864
8865    * Semantic changes
8866       * Types with owned pointers or custom destructors move by default,
8867         eliminating the `move` keyword
8868       * All foreign functions are considered unsafe
8869       * &mut is now unaliasable
8870       * Writes to borrowed @mut pointers are prevented dynamically
8871       * () has size 0
8872       * The name of the main function can be customized using #[main]
8873       * The default type of an inferred closure is &fn instead of @fn
8874       * `use` statements may no longer be "chained" - they cannot import
8875         identifiers imported by previous `use` statements
8876       * `use` statements are crate relative, importing from the "top"
8877         of the crate by default. Paths may be prefixed with `super::`
8878         or `self::` to change the search behavior.
8879       * Method visibility is inherited from the implementation declaration
8880       * Structural records have been removed
8881       * Many more types can be used in static items, including enums
8882         'static-lifetime pointers and vectors
8883       * Pattern matching over vectors improved and expanded
8884       * Typechecking of closure types has been overhauled to
8885         improve inference and eliminate unsoundness
8886       * Macros leave scope at the end of modules, unless that module is
8887         tagged with #[macro_escape]
8888
8889    * Libraries
8890       * Added big integers to `std::bigint`
8891       * Removed `core::oldcomm` module
8892       * Added pipe-based `core::comm` module
8893       * Numeric traits have been reorganized under `core::num`
8894       * `vec::slice` finally returns a slice
8895       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8896       * Containers reorganized around traits in `core::container`
8897       * `core::dvec` removed, `~[T]` is a drop-in replacement
8898       * `core::send_map` renamed to `core::hashmap`
8899       * `std::map` removed; replaced with `core::hashmap`
8900       * `std::treemap` reimplemented as an owned balanced tree
8901       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8902       * `core::trie` added as a fast ordered map for integer keys
8903       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8904       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8905         overload the comparison operators, whereas `TotalOrd` is used
8906         by certain container types
8907
8908    * Other
8909       * Replaced the 'cargo' package manager with 'rustpkg'
8910       * Added all-purpose 'rust' tool
8911       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8912       * rustc now *attempts* to offer spelling suggestions
8913       * Improved support for ARM and Android
8914       * Preliminary MIPS backend
8915       * Improved foreign function ABI implementation for x86, x86_64
8916       * Various memory usage improvements
8917       * Rust code may be embedded in foreign code under limited circumstances
8918       * Inline assembler supported by new asm!() syntax extension.
8919
8920
8921 Version 0.5 (2012-12-21)
8922 ===========================
8923
8924    * ~900 changes, numerous bugfixes
8925
8926    * Syntax changes
8927       * Removed `<-` move operator
8928       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8929       * Removed old fixed length vector syntax - `[T]/N`
8930       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8931       * Macros may now expand to items and statements
8932       * `a.b()` is always parsed as a method call, never as a field projection
8933       * `Eq` and `IterBytes` implementations can be automatically generated
8934         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8935       * Removed the special crate language for `.rc` files
8936       * Function arguments may consist of any irrefutable pattern
8937
8938    * Semantic changes
8939       * `&` and `~` pointers may point to objects
8940       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8941       * Enum variants may be structs
8942       * Destructors can be added to all nominal types with the Drop trait
8943       * Structs and nullary enum variants may be constants
8944       * Values that cannot be implicitly copied are now automatically moved
8945         without writing `move` explicitly
8946       * `&T` may now be coerced to `*T`
8947       * Coercions happen in `let` statements as well as function calls
8948       * `use` statements now take crate-relative paths
8949       * The module and type namespaces have been merged so that static
8950         method names can be resolved under the trait in which they are
8951         declared
8952
8953    * Improved support for language features
8954       * Trait inheritance works in many scenarios
8955       * More support for explicit self arguments in methods - `self`, `&self`
8956         `@self`, and `~self` all generally work as expected
8957       * Static methods work in more situations
8958       * Experimental: Traits may declare default methods for the implementations
8959         to use
8960
8961    * Libraries
8962       * New condition handling system in `core::condition`
8963       * Timsort added to `std::sort`
8964       * New priority queue, `std::priority_queue`
8965       * Pipes for serializable types, `std::flatpipes'
8966       * Serialization overhauled to be trait-based
8967       * Expanded `getopts` definitions
8968       * Moved futures to `std`
8969       * More functions are pure now
8970       * `core::comm` renamed to `oldcomm`. Still deprecated
8971       * `rustdoc` and `cargo` are libraries now
8972
8973    * Misc
8974       * Added a preliminary REPL, `rusti`
8975       * License changed from MIT to dual MIT/APL2
8976
8977
8978 Version 0.4 (2012-10-15)
8979 ==========================
8980
8981    * ~2000 changes, numerous bugfixes
8982
8983    * Syntax
8984       * All keywords are now strict and may not be used as identifiers anywhere
8985       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8986         'of', 'with', 'to', 'class'.
8987       * Classes are replaced with simpler structs
8988       * Explicit method self types
8989       * `ret` became `return` and `alt` became `match`
8990       * `import` is now `use`; `use is now `extern mod`
8991       * `extern mod { ... }` is now `extern { ... }`
8992       * `use mod` is the recommended way to import modules
8993       * `pub` and `priv` replace deprecated export lists
8994       * The syntax of `match` pattern arms now uses fat arrow (=>)
8995       * `main` no longer accepts an args vector; use `os::args` instead
8996
8997    * Semantics
8998       * Trait implementations are now coherent, ala Haskell typeclasses
8999       * Trait methods may be static
9000       * Argument modes are deprecated
9001       * Borrowed pointers are much more mature and recommended for use
9002       * Strings and vectors in the static region are stored in constant memory
9003       * Typestate was removed
9004       * Resolution rewritten to be more reliable
9005       * Support for 'dual-mode' data structures (freezing and thawing)
9006
9007    * Libraries
9008       * Most binary operators can now be overloaded via the traits in
9009         `core::ops'
9010       * `std::net::url` for representing URLs
9011       * Sendable hash maps in `core::send_map`
9012       * `core::task' gained a (currently unsafe) task-local storage API
9013
9014    * Concurrency
9015       * An efficient new intertask communication primitive called the pipe,
9016         along with a number of higher-level channel types, in `core::pipes`
9017       * `std::arc`, an atomically reference counted, immutable, shared memory
9018         type
9019       * `std::sync`, various exotic synchronization tools based on arcs and pipes
9020       * Futures are now based on pipes and sendable
9021       * More robust linked task failure
9022       * Improved task builder API
9023
9024    * Other
9025       * Improved error reporting
9026       * Preliminary JIT support
9027       * Preliminary work on precise GC
9028       * Extensive architectural improvements to rustc
9029       * Begun a transition away from buggy C++-based reflection (shape) code to
9030         Rust-based (visitor) code
9031       * All hash functions and tables converted to secure, randomized SipHash
9032
9033
9034 Version 0.3  (2012-07-12)
9035 ========================
9036
9037    * ~1900 changes, numerous bugfixes
9038
9039    * New coding conveniences
9040       * Integer-literal suffix inference
9041       * Per-item control over warnings, errors
9042       * #[cfg(windows)] and #[cfg(unix)] attributes
9043       * Documentation comments
9044       * More compact closure syntax
9045       * 'do' expressions for treating higher-order functions as
9046         control structures
9047       * *-patterns (wildcard extended to all constructor fields)
9048
9049    * Semantic cleanup
9050       * Name resolution pass and exhaustiveness checker rewritten
9051       * Region pointers and borrow checking supersede alias
9052         analysis
9053       * Init-ness checking is now provided by a region-based liveness
9054         pass instead of the typestate pass; same for last-use analysis
9055       * Extensive work on region pointers
9056
9057    * Experimental new language features
9058       * Slices and fixed-size, interior-allocated vectors
9059       * #!-comments for lang versioning, shell execution
9060       * Destructors and iface implementation for classes;
9061         type-parameterized classes and class methods
9062       * 'const' type kind for types that can be used to implement
9063         shared-memory concurrency patterns
9064
9065    * Type reflection
9066
9067    * Removal of various obsolete features
9068       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9069                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
9070
9071       * Constructs: do-while loops ('do' repurposed), fn binding,
9072                     resources (replaced by destructors)
9073
9074    * Compiler reorganization
9075       * Syntax-layer of compiler split into separate crate
9076       * Clang (from LLVM project) integrated into build
9077       * Typechecker split into sub-modules
9078
9079    * New library code
9080       * New time functions
9081       * Extension methods for many built-in types
9082       * Arc: atomic-refcount read-only / exclusive-use shared cells
9083       * Par: parallel map and search routines
9084       * Extensive work on libuv interface
9085       * Much vector code moved to libraries
9086       * Syntax extensions: #line, #col, #file, #mod, #stringify,
9087         #include, #include_str, #include_bin
9088
9089    * Tool improvements
9090       * Cargo automatically resolves dependencies
9091
9092
9093 Version 0.2  (2012-03-29)
9094 =========================
9095
9096    * >1500 changes, numerous bugfixes
9097
9098    * New docs and doc tooling
9099
9100    * New port: FreeBSD x86_64
9101
9102    * Compilation model enhancements
9103       * Generics now specialized, multiply instantiated
9104       * Functions now inlined across separate crates
9105
9106    * Scheduling, stack and threading fixes
9107       * Noticeably improved message-passing performance
9108       * Explicit schedulers
9109       * Callbacks from C
9110       * Helgrind clean
9111
9112    * Experimental new language features
9113       * Operator overloading
9114       * Region pointers
9115       * Classes
9116
9117    * Various language extensions
9118       * C-callback function types: 'crust fn ...'
9119       * Infinite-loop construct: 'loop { ... }'
9120       * Shorten 'mutable' to 'mut'
9121       * Required mutable-local qualifier: 'let mut ...'
9122       * Basic glob-exporting: 'export foo::*;'
9123       * Alt now exhaustive, 'alt check' for runtime-checked
9124       * Block-function form of 'for' loop, with 'break' and 'ret'.
9125
9126    * New library code
9127       * AST quasi-quote syntax extension
9128       * Revived libuv interface
9129       * New modules: core::{future, iter}, std::arena
9130       * Merged per-platform std::{os*, fs*} to core::{libc, os}
9131       * Extensive cleanup, regularization in libstd, libcore
9132
9133
9134 Version 0.1  (2012-01-20)
9135 ===============================
9136
9137    * Most language features work, including:
9138       * Unique pointers, unique closures, move semantics
9139       * Interface-constrained generics
9140       * Static interface dispatch
9141       * Stack growth
9142       * Multithread task scheduling
9143       * Typestate predicates
9144       * Failure unwinding, destructors
9145       * Pattern matching and destructuring assignment
9146       * Lightweight block-lambda syntax
9147       * Preliminary macro-by-example
9148
9149    * Compiler works with the following configurations:
9150       * Linux: x86 and x86_64 hosts and targets
9151       * macOS: x86 and x86_64 hosts and targets
9152       * Windows: x86 hosts and targets
9153
9154    * Cross compilation / multi-target configuration supported.
9155
9156    * Preliminary API-documentation and package-management tools included.
9157
9158 Known issues:
9159
9160    * Documentation is incomplete.
9161
9162    * Performance is below intended target.
9163
9164    * Standard library APIs are subject to extensive change, reorganization.
9165
9166    * Language-level versioning is not yet operational - future code will
9167      break unexpectedly.