]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Update RELEASES.md
[rust.git] / RELEASES.md
1 Version 1.44.0 (2020-06-04)
2 ==========================
3
4 Language
5 --------
6 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
7 - [Added the `unused_braces` lint.][70081]
8
9 **Syntax-only changes**
10
11 - [Expansion-driven outline module parsing][69838]
12
13 These are still rejected semantically, so you will likely receive an error but
14 these changes can be seen and parsed by macros and conditional compilation.
15
16 Compiler
17 --------
18 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
19   Additionally when in incremental mode rustc defaults to 256 codegen units.
20 - [Refactored `catch_unwind`, to have zero-cost unless unwinding is enabled and
21   a panic is thrown.][67502]
22 - [Added tier 3\* support for the `aarch64-unknown-none` and
23   `aarch64-unknown-none-softfloat` targets.][68334]
24 - [Added tier 3 support for `arm64-apple-tvos` and
25   `x86_64-apple-tvos` targets.][68191]
26
27
28 Libraries
29 ---------
30 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
31   `vec![]` to be able to be used in `const` contexts.
32 - [`convert::Infallible` now implements `Hash`.][70281]
33 - [`OsString` now implements `DerefMut` and `IndexMut` returning
34   a `&mut OsStr`.][70048]
35 - [Unicode 13 is now supported.][69929]
36 - [`String` now implements `From<&mut str>`.][69661]
37 - [`IoSlice` now implements `Copy`.][69403]
38 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is less than 32.
39 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
40 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, and `to_be_bytes` methods are
41   now `const` for all integer types.][69373]
42
43 Stabilized APIs
44 ---------------
45 - [`PathBuf::with_capacity`]
46 - [`PathBuf::capacity`]
47 - [`PathBuf::clear`]
48 - [`PathBuf::reserve`]
49 - [`PathBuf::reserve_exact`]
50 - [`PathBuf::shrink_to_fit`]
51 - [`f32::to_int_unchecked`]
52 - [`f64::to_int_unchecked`]
53 - [`Layout::align_to`]
54 - [`Layout::pad_to_align`]
55 - [`Layout::array`]
56
57 Cargo
58 -----
59 - [Added the `cargo tree` command which will print a tree graph of
60   your dependencies.][cargo/8062] E.g.
61   ```
62     mdbook v0.3.2 (/Users/src/rust/mdbook)
63   ├── ammonia v3.0.0
64   │   ├── html5ever v0.24.0
65   │   │   ├── log v0.4.8
66   │   │   │   └── cfg-if v0.1.9
67   │   │   ├── mac v0.1.1
68   │   │   └── markup5ever v0.9.0
69   │   │       ├── log v0.4.8 (*)
70   │   │       ├── phf v0.7.24
71   │   │       │   └── phf_shared v0.7.24
72   │   │       │       ├── siphasher v0.2.3
73   │   │       │       └── unicase v1.4.2
74   │   │       │           [build-dependencies]
75   │   │       │           └── version_check v0.1.5
76   ...
77   ```
78
79 Misc
80 ----
81 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
82   the version in the sidebar.][69494]
83
84 Compatibility Notes
85 -------------------
86 - [Rustc now correctly generates static libraries on Windows GNU targets with
87   the `.a` extension, rather than the previous `.lib`.][70937]
88 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
89 - [The `file_name` property in JSON output of macro errors now points the actual
90   source file rather than the previous format of `<NAME macros>`.][70969]
91   **Note:** this may not point a file that actually exists on the user's system.
92 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
93 - [`mem::{zeroed, uninitialised, MaybeUninit}` will now panic when used with types
94   that do not allow zero initialization such as `NonZeroU8`.][66059] This was
95   previously a warning.
96
97 Internal Only
98 -------------
99 These changes provide no direct user facing benefits, but represent significant
100 improvements to the internals and overall performance of rustc and
101 related tools.
102
103 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
104 - [Replace big JS dict with JSON parsing.][71250]
105
106 [69373]: https://github.com/rust-lang/rust/pull/69373/
107 [66059]: https://github.com/rust-lang/rust/pull/66059/
108 [68191]: https://github.com/rust-lang/rust/pull/68191/
109 [68899]: https://github.com/rust-lang/rust/pull/68899/
110 [71147]: https://github.com/rust-lang/rust/pull/71147/
111 [71250]: https://github.com/rust-lang/rust/pull/71250/
112 [70937]: https://github.com/rust-lang/rust/pull/70937/
113 [70969]: https://github.com/rust-lang/rust/pull/70969/
114 [70632]: https://github.com/rust-lang/rust/pull/70632/
115 [70281]: https://github.com/rust-lang/rust/pull/70281/
116 [70345]: https://github.com/rust-lang/rust/pull/70345/
117 [70048]: https://github.com/rust-lang/rust/pull/70048/
118 [70081]: https://github.com/rust-lang/rust/pull/70081/
119 [70156]: https://github.com/rust-lang/rust/pull/70156/
120 [69838]: https://github.com/rust-lang/rust/pull/69838/
121 [69929]: https://github.com/rust-lang/rust/pull/69929/
122 [69661]: https://github.com/rust-lang/rust/pull/69661/
123 [69778]: https://github.com/rust-lang/rust/pull/69778/
124 [69494]: https://github.com/rust-lang/rust/pull/69494/
125 [69403]: https://github.com/rust-lang/rust/pull/69403/
126 [69033]: https://github.com/rust-lang/rust/pull/69033/
127 [68692]: https://github.com/rust-lang/rust/pull/68692/
128 [68334]: https://github.com/rust-lang/rust/pull/68334/
129 [67502]: https://github.com/rust-lang/rust/pull/67502/
130 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
131 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/beta/std/path/struct.PathBuf.html#method.with_capacity
132 [`PathBuf::capacity`]: https://doc.rust-lang.org/beta/std/path/struct.PathBuf.html#method.capacity
133 [`PathBuf::clear`]: https://doc.rust-lang.org/beta/std/path/struct.PathBuf.html#method.clear
134 [`PathBuf::reserve`]: https://doc.rust-lang.org/beta/std/path/struct.PathBuf.html#method.reserve
135 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/beta/std/path/struct.PathBuf.html#method.reserve_exact
136 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/beta/std/path/struct.PathBuf.html#method.shrink_to_fit
137 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/beta/std/primitive.f32.html#method.to_int_unchecked
138 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/beta/std/primitive.f64.html#method.to_int_unchecked
139 [`Layout::align_to`]: https://doc.rust-lang.org/beta/std/alloc/struct.Layout.html#method.align_to
140 [`Layout::pad_to_align`]: https://doc.rust-lang.org/beta/std/alloc/struct.Layout.html#method.pad_to_align
141 [`Layout::array`]: https://doc.rust-lang.org/beta/std/alloc/struct.Layout.html#method.array
142
143
144 Version 1.43.1 (2020-05-07)
145 ===========================
146
147 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
148 * [Fixed the stabilization of AVX-512 features.][71473]
149 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
150
151 [71430]: https://github.com/rust-lang/rust/pull/71430
152 [71473]: https://github.com/rust-lang/rust/issues/71473
153 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
154
155
156 Version 1.43.0 (2020-04-23)
157 ==========================
158
159 Language
160 --------
161 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
162   the type inferred correctly.][68129]
163 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
164
165 **Syntax only changes**
166 - [Allow `type Foo: Ord` syntactically.][69361]
167 - [Fuse associated and extern items up to defaultness.][69194]
168 - [Syntactically allow `self` in all `fn` contexts.][68764]
169 - [Merge `fn` syntax + cleanup item parsing.][68728]
170 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
171   For example, you may now write:
172   ```rust
173   macro_rules! mac_trait {
174       ($i:item) => {
175           trait T { $i }
176       }
177   }
178   mac_trait! {
179       fn foo() {}
180   }
181   ```
182
183 These are still rejected *semantically*, so you will likely receive an error but
184 these changes can be seen and parsed by macros and
185 conditional compilation.
186
187
188 Compiler
189 --------
190 - [You can now pass multiple lint flags to rustc to override the previous
191   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
192   everything in the `unused` lint group except `unused-variables` which
193   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
194   everything in the `unused` lint group **including** `unused-variables` since
195   the allow flag is specified before the deny flag (and therefore overridden).
196 - [rustc will now prefer your system MinGW libraries over its bundled libraries
197   if they are available on `windows-gnu`.][67429]
198 - [rustc now buffers errors/warnings printed in JSON.][69227]
199
200 Libraries
201 ---------
202 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
203   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
204   respectively.][69538] **Note** These conversions are only available when `N`
205   is `0..=32`.
206 - [You can now use associated constants on floats and integers directly, rather
207   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
208   `f32::NAN` with no imports.
209 - [`u8::is_ascii` is now `const`.][68984]
210 - [`String` now implements `AsMut<str>`.][68742]
211 - [Added the `primitive` module to `std` and `core`.][67637] This module
212   reexports Rust's primitive types. This is mainly useful in macros
213   where you want avoid these types being shadowed.
214 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
215 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
216
217 Stabilized APIs
218 ---------------
219 - [`Once::is_completed`]
220 - [`f32::LOG10_2`]
221 - [`f32::LOG2_10`]
222 - [`f64::LOG10_2`]
223 - [`f64::LOG2_10`]
224 - [`iter::once_with`]
225
226 Cargo
227 -----
228 - [You can now set config `[profile]`s in your `.cargo/config`, or through
229   your environment.][cargo/7823]
230 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
231   executable path when running integration tests or benchmarks.][cargo/7697]
232   `<name>` is the name of your binary as-is e.g. If you wanted the executable
233   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
234
235 Misc
236 ----
237 - [Certain checks in the `const_err` lint were deemed unrelated to const
238   evaluation][69185], and have been moved to the `unconditional_panic` and
239   `arithmetic_overflow` lints.
240
241 Compatibility Notes
242 -------------------
243
244 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
245   has been a warning since 1.36.0.
246 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
247   led to some instances being accepted, and now correctly emits a hard error.
248
249 [69340]: https://github.com/rust-lang/rust/pull/69340
250
251 Internal Only
252 -------------
253 These changes provide no direct user facing benefits, but represent significant
254 improvements to the internals and overall performance of `rustc` and
255 related tools.
256
257 - [All components are now built with `opt-level=3` instead of `2`.][67878]
258 - [Improved how rustc generates drop code.][67332]
259 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
260 - [traits: preallocate 2 Vecs of known initial size][69022]
261 - [Avoid exponential behaviour when relating types][68772]
262 - [Skip `Drop` terminators for enum variants without drop glue][68943]
263 - [Improve performance of coherence checks][68966]
264 - [Deduplicate types in the generator witness][68672]
265 - [Invert control in struct_lint_level.][68725]
266
267 [67332]: https://github.com/rust-lang/rust/pull/67332/
268 [67429]: https://github.com/rust-lang/rust/pull/67429/
269 [67637]: https://github.com/rust-lang/rust/pull/67637/
270 [67642]: https://github.com/rust-lang/rust/pull/67642/
271 [67878]: https://github.com/rust-lang/rust/pull/67878/
272 [67885]: https://github.com/rust-lang/rust/pull/67885/
273 [68129]: https://github.com/rust-lang/rust/pull/68129/
274 [68672]: https://github.com/rust-lang/rust/pull/68672/
275 [68725]: https://github.com/rust-lang/rust/pull/68725/
276 [68728]: https://github.com/rust-lang/rust/pull/68728/
277 [68738]: https://github.com/rust-lang/rust/pull/68738/
278 [68742]: https://github.com/rust-lang/rust/pull/68742/
279 [68764]: https://github.com/rust-lang/rust/pull/68764/
280 [68772]: https://github.com/rust-lang/rust/pull/68772/
281 [68943]: https://github.com/rust-lang/rust/pull/68943/
282 [68952]: https://github.com/rust-lang/rust/pull/68952/
283 [68966]: https://github.com/rust-lang/rust/pull/68966/
284 [68984]: https://github.com/rust-lang/rust/pull/68984/
285 [69022]: https://github.com/rust-lang/rust/pull/69022/
286 [69185]: https://github.com/rust-lang/rust/pull/69185/
287 [69194]: https://github.com/rust-lang/rust/pull/69194/
288 [69201]: https://github.com/rust-lang/rust/pull/69201/
289 [69227]: https://github.com/rust-lang/rust/pull/69227/
290 [69548]: https://github.com/rust-lang/rust/pull/69548/
291 [69256]: https://github.com/rust-lang/rust/pull/69256/
292 [69361]: https://github.com/rust-lang/rust/pull/69361/
293 [69366]: https://github.com/rust-lang/rust/pull/69366/
294 [69538]: https://github.com/rust-lang/rust/pull/69538/
295 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
296 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
297 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
298 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
299 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
300 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
301 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
302 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
303
304
305 Version 1.42.0 (2020-03-12)
306 ==========================
307
308 Language
309 --------
310 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
311   ```rust
312   fn foo(words: &[&str]) {
313       match words {
314           ["Hello", "World", "!", ..] => println!("Hello World!"),
315           ["Foo", "Bar", ..] => println!("Baz"),
316           rest => println!("{:?}", rest),
317       }
318   }
319   ```
320 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
321   that you can create an enum that has the exact layout and ABI of the type
322   it contains.
323 - [There are some *syntax-only* changes:][67131]
324    - `default` is syntactically allowed before items in `trait` definitions.
325    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
326      leave out their bodies in favor of `;`.
327    - Bounds on associated types in `impl`s are now syntactically allowed
328      (e.g. `type Foo: Ord;`).
329    - `...` (the C-variadic type) may occur syntactically directly as the type of
330       any function parameter.
331
332   These are still rejected *semantically*, so you will likely receive an error
333   but these changes can be seen and parsed by procedural macros and
334   conditional compilation.
335
336 Compiler
337 --------
338 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
339 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
340 - [`Option::{expect,unwrap}` and
341    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
342    pointing to the location where they were called, rather than
343    `core`'s internals. ][67887]
344
345 \* Refer to Rust's [platform support page][forge-platform-support] for more
346 information on Rust's tiered platform support.
347
348 Libraries
349 ---------
350 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
351 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
352    to implement `Sized`.][67935]
353 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
354 - [`Layout::new` is now `const`.][66254]
355 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
356
357
358 Stabilized APIs
359 ---------------
360 - [`CondVar::wait_while`]
361 - [`CondVar::wait_timeout_while`]
362 - [`DebugMap::key`]
363 - [`DebugMap::value`]
364 - [`ManuallyDrop::take`]
365 - [`matches!`]
366 - [`ptr::slice_from_raw_parts_mut`]
367 - [`ptr::slice_from_raw_parts`]
368
369 Cargo
370 -----
371 - [You no longer need to include `extern crate proc_macro;` to be able to
372   `use proc_macro;` in the `2018` edition.][cargo/7700]
373
374 Compatibility Notes
375 -------------------
376 - [`Error::description` has been deprecated, and its use will now produce a
377   warning.][66919] It's recommended to use `Display`/`to_string` instead.
378
379 [68253]: https://github.com/rust-lang/rust/pull/68253/
380 [68348]: https://github.com/rust-lang/rust/pull/68348/
381 [67935]: https://github.com/rust-lang/rust/pull/67935/
382 [68339]: https://github.com/rust-lang/rust/pull/68339/
383 [68122]: https://github.com/rust-lang/rust/pull/68122/
384 [67712]: https://github.com/rust-lang/rust/pull/67712/
385 [67887]: https://github.com/rust-lang/rust/pull/67887/
386 [67131]: https://github.com/rust-lang/rust/pull/67131/
387 [67233]: https://github.com/rust-lang/rust/pull/67233/
388 [66899]: https://github.com/rust-lang/rust/pull/66899/
389 [66919]: https://github.com/rust-lang/rust/pull/66919/
390 [66254]: https://github.com/rust-lang/rust/pull/66254/
391 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
392 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
393 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
394 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
395 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
396 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
397 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
398 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
399 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
400
401
402 Version 1.41.1 (2020-02-27)
403 ===========================
404
405 * [Always check types of static items][69145]
406 * [Always check lifetime bounds of `Copy` impls][69145]
407 * [Fix miscompilation in callers of `Layout::repeat`][69225]
408
409 [69225]: https://github.com/rust-lang/rust/issues/69225
410 [69145]: https://github.com/rust-lang/rust/pull/69145
411
412
413 Version 1.41.0 (2020-01-30)
414 ===========================
415
416 Language
417 --------
418
419 - [You can now pass type parameters to foreign items when implementing
420   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
421 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
422   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
423   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
424 - [You can now use any valid identifier in a `format_args` macro.][66847]
425   Previously identifiers starting with an underscore were not allowed.
426 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
427   enum variants.][66183] These are still rejected semantically, but
428   can be seen and parsed by procedural macros and conditional compilation.
429
430 Compiler
431 --------
432
433 - [Rustc will now warn if you have unused loop `'label`s.][66325]
434 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
435 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
436 - [You can now pass an arguments file passing the `@path` syntax
437   to rustc.][66172] Note that the format differs somewhat from what is
438   found in other tooling; please see [the documentation][argfile-docs] for
439   more information.
440 - [You can now provide `--extern` flag without a path, indicating that it is
441   available from the search path or specified with an `-L` flag.][64882]
442
443 \* Refer to Rust's [platform support page][forge-platform-support] for more
444 information on Rust's tiered platform support.
445
446 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
447
448 Libraries
449 ---------
450
451 - [The `core::panic` module is now stable.][66771] It was already stable
452   through `std`.
453 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
454   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
455 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
456
457 Stabilized APIs
458 ---------------
459
460 - [`Result::map_or`]
461 - [`Result::map_or_else`]
462 - [`std::rc::Weak::weak_count`]
463 - [`std::rc::Weak::strong_count`]
464 - [`std::sync::Weak::weak_count`]
465 - [`std::sync::Weak::strong_count`]
466
467 Cargo
468 -----
469
470 - [Cargo will now document all the private items for binary crates
471   by default.][cargo/7593]
472 - [`cargo-install` will now reinstall the package if it detects that it is out
473   of date.][cargo/7560]
474 - [Cargo.lock now uses a more git friendly format that should help to reduce
475   merge conflicts.][cargo/7579]
476 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
477   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
478   optimisation level to `2` for debug builds. You can also use
479   `[profile.<profile>.build-override]` to override build scripts and
480   their dependencies.
481
482 Misc
483 ----
484
485 - [You can now specify `edition` in documentation code blocks to compile the block
486   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
487   should be compiled the 2018 edition of Rust.
488 - [You can now provide custom themes to rustdoc with `--theme`, and check the
489   current theme with `--check-theme`.][54733]
490 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
491
492 Compatibility Notes
493 -------------------
494
495 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
496   Apple targets.][apple-32bit-drop] This means that the source code is still
497   available to build, but the targets are no longer being tested and release
498   binaries for those platforms will no longer be distributed by the Rust project.
499   Please refer to the linked blog post for more information.
500
501 [54733]: https://github.com/rust-lang/rust/pull/54733/
502 [61351]: https://github.com/rust-lang/rust/pull/61351/
503 [67255]: https://github.com/rust-lang/rust/pull/67255/
504 [66661]: https://github.com/rust-lang/rust/pull/66661/
505 [66771]: https://github.com/rust-lang/rust/pull/66771/
506 [66847]: https://github.com/rust-lang/rust/pull/66847/
507 [66238]: https://github.com/rust-lang/rust/pull/66238/
508 [66277]: https://github.com/rust-lang/rust/pull/66277/
509 [66325]: https://github.com/rust-lang/rust/pull/66325/
510 [66172]: https://github.com/rust-lang/rust/pull/66172/
511 [66183]: https://github.com/rust-lang/rust/pull/66183/
512 [65879]: https://github.com/rust-lang/rust/pull/65879/
513 [65013]: https://github.com/rust-lang/rust/pull/65013/
514 [64882]: https://github.com/rust-lang/rust/pull/64882/
515 [64325]: https://github.com/rust-lang/rust/pull/64325/
516 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
517 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
518 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
519 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
520 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
521 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
522 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
523 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
524 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
525 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
526 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
527
528 Version 1.40.0 (2019-12-19)
529 ===========================
530
531 Language
532 --------
533 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
534   `const` contexts.][65188] e.g.
535
536   ```rust
537   pub struct Point(i32, i32);
538
539   const ORIGIN: Point = {
540       let constructor = Point;
541
542       constructor(0, 0)
543   };
544   ```
545
546 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
547   indicate that there may be variants or fields added in the future.][64639]
548   For example this requires adding a wild-card branch (`_ => {}`) to any match
549   statements on a non-exhaustive `enum`. [(RFC 2008)]
550 - [You can now use function-like procedural macros in `extern` blocks and in
551   type positions.][63931] e.g. `type Generated = macro!();`
552 - [Function-like and attribute procedural macros can now emit
553   `macro_rules!` items, so you can now have your macros generate macros.][64035]
554 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
555   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
556   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
557
558 Compiler
559 --------
560 - [Added tier 3 support\* for the
561   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
562 - [Added tier 3 support for the
563   `aarch64-unknown-none-softfloat` target.][64589]
564 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
565   `mips64el-unknown-linux-muslabi64` targets.][65843]
566
567 \* Refer to Rust's [platform support page][forge-platform-support] for more
568   information on Rust's tiered platform support.
569
570 Libraries
571 ---------
572 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
573
574 Stabilized APIs
575 ---------------
576 - [`BTreeMap::get_key_value`]
577 - [`HashMap::get_key_value`]
578 - [`Option::as_deref_mut`]
579 - [`Option::as_deref`]
580 - [`Option::flatten`]
581 - [`UdpSocket::peer_addr`]
582 - [`f32::to_be_bytes`]
583 - [`f32::to_le_bytes`]
584 - [`f32::to_ne_bytes`]
585 - [`f64::to_be_bytes`]
586 - [`f64::to_le_bytes`]
587 - [`f64::to_ne_bytes`]
588 - [`f32::from_be_bytes`]
589 - [`f32::from_le_bytes`]
590 - [`f32::from_ne_bytes`]
591 - [`f64::from_be_bytes`]
592 - [`f64::from_le_bytes`]
593 - [`f64::from_ne_bytes`]
594 - [`mem::take`]
595 - [`slice::repeat`]
596 - [`todo!`]
597
598 Cargo
599 -----
600 - [Cargo will now always display warnings, rather than only on
601   fresh builds.][cargo/7450]
602 - [Feature flags (except `--all-features`) passed to a virtual workspace will
603   now produce an error.][cargo/7507] Previously these flags were ignored.
604 - [You can now publish `dev-dependencies` without including
605   a `version`.][cargo/7333]
606
607 Misc
608 ----
609 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
610   when running documentation tests with `rustdoc`.][63803]
611
612 Compatibility Notes
613 -------------------
614 - [As previously announced, any previous NLL warnings in the 2015 edition are
615   now hard errors.][64221]
616 - [The `include!` macro will now warn if it failed to include the
617   entire file.][64284] The `include!` macro unintentionally only includes the
618   first _expression_ in a file, and this can be unintuitive. This will become
619   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
620 - [Using `#[inline]` on function prototypes and consts now emits a warning under
621   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
622   or `extern` blocks now correctly emits a hard error.
623
624 [65294]: https://github.com/rust-lang/rust/pull/65294/
625 [66103]: https://github.com/rust-lang/rust/pull/66103/
626 [65843]: https://github.com/rust-lang/rust/pull/65843/
627 [65188]: https://github.com/rust-lang/rust/pull/65188/
628 [65092]: https://github.com/rust-lang/rust/pull/65092/
629 [64589]: https://github.com/rust-lang/rust/pull/64589/
630 [64639]: https://github.com/rust-lang/rust/pull/64639/
631 [64221]: https://github.com/rust-lang/rust/pull/64221/
632 [64284]: https://github.com/rust-lang/rust/pull/64284/
633 [63931]: https://github.com/rust-lang/rust/pull/63931/
634 [64035]: https://github.com/rust-lang/rust/pull/64035/
635 [63674]: https://github.com/rust-lang/rust/pull/63674/
636 [63803]: https://github.com/rust-lang/rust/pull/63803/
637 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
638 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
639 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
640 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
641 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
642 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
643 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
644 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
645 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
646 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
647 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
648 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
649 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
650 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
651 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
652 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
653 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
654 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
655 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
656 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
657 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
658 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
659 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
660 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
661 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
662 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
663
664
665 Version 1.39.0 (2019-11-07)
666 ===========================
667
668 Language
669 --------
670 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
671   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
672 - [You can now use certain attributes on function, closure, and function pointer
673   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
674   `deny`, `forbid` as well as inert helper attributes used by procedural macro
675   attributes applied to items. e.g.
676   ```rust
677   fn len(
678       #[cfg(windows)] slice: &[u16],
679       #[cfg(not(windows))] slice: &[u8],
680   ) -> usize {
681       slice.len()
682   }
683   ```
684 - [You can now take shared references to bind-by-move patterns in the `if` guards
685   of `match` arms.][63118] e.g.
686   ```rust
687   fn main() {
688       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
689
690       match array {
691           nums
692   //      ---- `nums` is bound by move.
693               if nums.iter().sum::<u8>() == 10
694   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
695           => {
696               drop(nums);
697   //          ----------- Legal as `nums` was bound by move and so we have ownership.
698           }
699           _ => unreachable!(),
700       }
701   }
702   ```
703
704
705
706 Compiler
707 --------
708 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
709 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
710 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
711   **Note** Cargo currently doesn't use this feature. Refer to
712   [cargo#7315][cargo/7315] to track this feature's progress.
713 - [You can now pass `--show-output` argument to test binaries to print the
714   output of successful tests.][62600]
715
716
717 \* Refer to Rust's [platform support page][forge-platform-support] for more
718 information on Rust's tiered platform support.
719
720 Libraries
721 ---------
722 - [`Vec::new` and `String::new` are now `const` functions.][64028]
723 - [`LinkedList::new` is now a `const` function.][63684]
724 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
725 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
726   now `const`.][63786]
727
728 Stabilized APIs
729 ---------------
730 - [`Pin::into_inner`]
731 - [`Instant::checked_duration_since`]
732 - [`Instant::saturating_duration_since`]
733
734 Cargo
735 -----
736 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
737 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
738   `--all` is now deprecated.
739
740 Misc
741 ----
742 - [You can now pass `-Clinker` to rustdoc to control the linker used
743   for compiling doctests.][63834]
744
745 Compatibility Notes
746 -------------------
747 - [Code that was previously accepted by the old borrow checker, but rejected by
748   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
749   previously a warning, and will also become a hard error in the Rust 2015
750   edition in the 1.40.0 release.
751 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
752   run tests.][63827] This should improve performance when running a large
753   amount of doctests.
754 - [The `try!` macro will now issue a deprecation warning.][62672] It is
755   recommended to use the `?` operator instead.
756 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
757   returned `0.0`.
758
759 [62600]: https://github.com/rust-lang/rust/pull/62600/
760 [62672]: https://github.com/rust-lang/rust/pull/62672/
761 [63118]: https://github.com/rust-lang/rust/pull/63118/
762 [63209]: https://github.com/rust-lang/rust/pull/63209/
763 [63402]: https://github.com/rust-lang/rust/pull/63402/
764 [63565]: https://github.com/rust-lang/rust/pull/63565/
765 [63595]: https://github.com/rust-lang/rust/pull/63595/
766 [63684]: https://github.com/rust-lang/rust/pull/63684/
767 [63698]: https://github.com/rust-lang/rust/pull/63698/
768 [63770]: https://github.com/rust-lang/rust/pull/63770/
769 [63786]: https://github.com/rust-lang/rust/pull/63786/
770 [63827]: https://github.com/rust-lang/rust/pull/63827/
771 [63834]: https://github.com/rust-lang/rust/pull/63834/
772 [63927]: https://github.com/rust-lang/rust/pull/63927/
773 [63933]: https://github.com/rust-lang/rust/pull/63933/
774 [63934]: https://github.com/rust-lang/rust/pull/63934/
775 [63938]: https://github.com/rust-lang/rust/pull/63938/
776 [63940]: https://github.com/rust-lang/rust/pull/63940/
777 [63941]: https://github.com/rust-lang/rust/pull/63941/
778 [63945]: https://github.com/rust-lang/rust/pull/63945/
779 [64010]: https://github.com/rust-lang/rust/pull/64010/
780 [64028]: https://github.com/rust-lang/rust/pull/64028/
781 [64334]: https://github.com/rust-lang/rust/pull/64334/
782 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
783 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
784 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
785 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
786 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
787 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
788
789 Version 1.38.0 (2019-09-26)
790 ==========================
791
792 Language
793 --------
794 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
795 - [The `#[deprecated]` attribute can now be used on macros.][62042]
796
797 Compiler
798 --------
799 - [Added pipelined compilation support to `rustc`.][62766] This will
800   improve compilation times in some cases. For further information please refer
801   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
802 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
803   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
804   `x86_64-uwp-windows-msvc` targets.][60260]
805 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
806   `armv7-unknown-linux-musleabi` targets.][63107]
807 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
808 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
809
810 \* Refer to Rust's [platform support page][forge-platform-support] for more
811 information on Rust's tiered platform support.
812
813 Libraries
814 ---------
815 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
816 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
817   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
818   is available at `std::clone::Clone`). This also makes all built-in macros
819   available in `std`/`core` root. e.g. `std::include_bytes!`.
820 - [`str::Chars` now implements `Debug`.][63000]
821 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
822 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
823 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
824 - [Added euclidean remainder and division operations (`div_euclid`,
825   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
826   `overflowing`, and `wrapping` versions are available for all
827   integer primitives.
828 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
829   `PartialEq`.][61491]
830 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
831
832 Stabilized APIs
833 ---------------
834 - [`<*const T>::cast`]
835 - [`<*mut T>::cast`]
836 - [`Duration::as_secs_f32`]
837 - [`Duration::as_secs_f64`]
838 - [`Duration::div_f32`]
839 - [`Duration::div_f64`]
840 - [`Duration::from_secs_f32`]
841 - [`Duration::from_secs_f64`]
842 - [`Duration::mul_f32`]
843 - [`Duration::mul_f64`]
844 - [`any::type_name`]
845
846 Cargo
847 -----
848 - [Added pipelined compilation support to `cargo`.][cargo/7143]
849 - [You can now pass the `--features` option multiple times to enable
850   multiple features.][cargo/7084]
851
852 Misc
853 ----
854 - [`rustc` will now warn about some incorrect uses of
855   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
856
857 Compatibility Notes
858 -------------------
859 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
860   1.38.0.
861 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
862   issues][62896] with certain crates such as libc.
863
864 [60260]: https://github.com/rust-lang/rust/pull/60260/
865 [61457]: https://github.com/rust-lang/rust/pull/61457/
866 [61491]: https://github.com/rust-lang/rust/pull/61491/
867 [61884]: https://github.com/rust-lang/rust/pull/61884/
868 [61953]: https://github.com/rust-lang/rust/pull/61953/
869 [62042]: https://github.com/rust-lang/rust/pull/62042/
870 [62528]: https://github.com/rust-lang/rust/pull/62528/
871 [62583]: https://github.com/rust-lang/rust/pull/62583/
872 [62735]: https://github.com/rust-lang/rust/pull/62735/
873 [62766]: https://github.com/rust-lang/rust/pull/62766/
874 [62784]: https://github.com/rust-lang/rust/pull/62784/
875 [62785]: https://github.com/rust-lang/rust/issues/62785/
876 [62814]: https://github.com/rust-lang/rust/pull/62814/
877 [62896]: https://github.com/rust-lang/rust/issues/62896/
878 [63000]: https://github.com/rust-lang/rust/pull/63000/
879 [63056]: https://github.com/rust-lang/rust/pull/63056/
880 [63107]: https://github.com/rust-lang/rust/pull/63107/
881 [63346]: https://github.com/rust-lang/rust/pull/63346/
882 [63421]: https://github.com/rust-lang/rust/pull/63421/
883 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
884 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
885 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
886 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
887 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
888 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
889 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
890 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
891 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
892 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
893 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
894 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
895 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
896 [forge-platform-support]: https://forge.rust-lang.org/platform-support.html
897 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
898
899 Version 1.37.0 (2019-08-15)
900 ==========================
901
902 Language
903 --------
904 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
905   [`Box`][62228], or an [array][62235] and unused.
906 - [You can now use the `cfg` and `cfg_attr` attributes on
907   generic parameters.][61547]
908 - [You can now use enum variants through type alias.][61682] e.g. You can
909   write the following:
910   ```rust
911   type MyOption = Option<u8>;
912
913   fn increment_or_zero(x: MyOption) -> u8 {
914       match x {
915           MyOption::Some(y) => y + 1,
916           MyOption::None => 0,
917       }
918   }
919   ```
920 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
921   `const _: u32 = 5;`.
922 - [You can now use `#[repr(align(X)]` on enums.][61229]
923 - [The  `?` Kleene macro operator is now available in the
924   2015 edition.][60932]
925
926 Compiler
927 --------
928 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
929   and `-C profile-use` flags.][61268] For more information on how to use profile
930   guided optimization, please refer to the [rustc book][rustc-book-pgo].
931 - [The `rust-lldb` wrapper script should now work again.][61827]
932
933 Libraries
934 ---------
935 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
936
937 Stabilized APIs
938 ---------------
939 - [`BufReader::buffer`]
940 - [`BufWriter::buffer`]
941 - [`Cell::from_mut`]
942 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
943 - [`DoubleEndedIterator::nth_back`]
944 - [`Option::xor`]
945 - [`Wrapping::reverse_bits`]
946 - [`i128::reverse_bits`]
947 - [`i16::reverse_bits`]
948 - [`i32::reverse_bits`]
949 - [`i64::reverse_bits`]
950 - [`i8::reverse_bits`]
951 - [`isize::reverse_bits`]
952 - [`slice::copy_within`]
953 - [`u128::reverse_bits`]
954 - [`u16::reverse_bits`]
955 - [`u32::reverse_bits`]
956 - [`u64::reverse_bits`]
957 - [`u8::reverse_bits`]
958 - [`usize::reverse_bits`]
959
960 Cargo
961 -----
962 - [`Cargo.lock` files are now included by default when publishing executable crates
963   with executables.][cargo/7026]
964 - [You can now specify `default-run="foo"` in `[package]` to specify the
965   default executable to use for `cargo run`.][cargo/7056]
966
967 Misc
968 ----
969
970 Compatibility Notes
971 -------------------
972 - [Using `...` for inclusive range patterns will now warn by default.][61342]
973   Please transition your code to using the `..=` syntax for inclusive
974   ranges instead.
975 - [Using a trait object without the `dyn` will now warn by default.][61203]
976   Please transition your code to use `dyn Trait` for trait objects instead.
977
978 [62228]: https://github.com/rust-lang/rust/pull/62228/
979 [62235]: https://github.com/rust-lang/rust/pull/62235/
980 [61802]: https://github.com/rust-lang/rust/pull/61802/
981 [61827]: https://github.com/rust-lang/rust/pull/61827/
982 [61547]: https://github.com/rust-lang/rust/pull/61547/
983 [61682]: https://github.com/rust-lang/rust/pull/61682/
984 [61268]: https://github.com/rust-lang/rust/pull/61268/
985 [61342]: https://github.com/rust-lang/rust/pull/61342/
986 [61347]: https://github.com/rust-lang/rust/pull/61347/
987 [61100]: https://github.com/rust-lang/rust/pull/61100/
988 [61203]: https://github.com/rust-lang/rust/pull/61203/
989 [61229]: https://github.com/rust-lang/rust/pull/61229/
990 [60932]: https://github.com/rust-lang/rust/pull/60932/
991 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
992 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
993 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
994 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
995 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
996 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
997 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
998 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
999 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1000 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1001 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1002 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1003 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1004 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1005 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1006 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1007 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1008 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1009 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1010 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1011 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1012 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1013 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1014 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1015
1016
1017 Version 1.36.0 (2019-07-04)
1018 ==========================
1019
1020 Language
1021 --------
1022 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1023 - [The order of traits in trait objects no longer affects the semantics of that
1024   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1025   `dyn fmt::Debug + Send`, where this was previously not the case.
1026
1027 Libraries
1028 ---------
1029 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1030 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1031 - [`mem::needs_drop` is now available as a const fn.][60364]
1032 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1033 - [`String` now implements `BorrowMut<str>`.][60404]
1034 - [`io::Cursor` now implements `Default`.][60234]
1035 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1036 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1037   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1038   environment has access to heap memory allocation.
1039 - [`String` now implements `From<&String>`.][59825]
1040 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1041   return a tuple of each argument when there is multiple arguments.
1042 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1043   not used.][59648]
1044
1045 Stabilized APIs
1046 ---------------
1047 - [`VecDeque::rotate_left`]
1048 - [`VecDeque::rotate_right`]
1049 - [`Iterator::copied`]
1050 - [`io::IoSlice`]
1051 - [`io::IoSliceMut`]
1052 - [`Read::read_vectored`]
1053 - [`Write::write_vectored`]
1054 - [`str::as_mut_ptr`]
1055 - [`mem::MaybeUninit`]
1056 - [`pointer::align_offset`]
1057 - [`future::Future`]
1058 - [`task::Context`]
1059 - [`task::RawWaker`]
1060 - [`task::RawWakerVTable`]
1061 - [`task::Waker`]
1062 - [`task::Poll`]
1063
1064 Cargo
1065 -----
1066 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1067 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1068
1069 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1070
1071 Clippy
1072 ------
1073 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1074
1075 Misc
1076 ----
1077
1078 Compatibility Notes
1079 -------------------
1080 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1081   longer recommended, and will be deprecated in 1.39.0.
1082
1083 [60318]: https://github.com/rust-lang/rust/pull/60318/
1084 [60364]: https://github.com/rust-lang/rust/pull/60364/
1085 [60370]: https://github.com/rust-lang/rust/pull/60370/
1086 [60404]: https://github.com/rust-lang/rust/pull/60404/
1087 [60234]: https://github.com/rust-lang/rust/pull/60234/
1088 [60244]: https://github.com/rust-lang/rust/pull/60244/
1089 [58623]: https://github.com/rust-lang/rust/pull/58623/
1090 [59648]: https://github.com/rust-lang/rust/pull/59648/
1091 [59675]: https://github.com/rust-lang/rust/pull/59675/
1092 [59825]: https://github.com/rust-lang/rust/pull/59825/
1093 [59826]: https://github.com/rust-lang/rust/pull/59826/
1094 [59445]: https://github.com/rust-lang/rust/pull/59445/
1095 [59114]: https://github.com/rust-lang/rust/pull/59114/
1096 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1097 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1098 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1099 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1100 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1101 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1102 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1103 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1104 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1105 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1106 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1107 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1108 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1109 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1110 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1111 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1112 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1113 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1114 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1115 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1116
1117
1118 Version 1.35.0 (2019-05-23)
1119 ==========================
1120
1121 Language
1122 --------
1123 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1124   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1125 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1126   ```rust
1127   unsafe fn call_unsafe(func: unsafe fn()) {
1128       func()
1129   }
1130
1131   pub fn main() {
1132       unsafe { call_unsafe(|| {}); }
1133   }
1134   ```
1135
1136
1137 Compiler
1138 --------
1139 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1140   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1141 - [Added the `wasm32-unknown-wasi` target.][59464]
1142
1143
1144 Libraries
1145 ---------
1146 - [`Thread` will now show its ID in `Debug` output.][59460]
1147 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1148 - [`alloc::System` now implements `Default`.][59451]
1149 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1150   last field.][59076]
1151 - [`char::{ToLowercase, ToUppercase}` now
1152   implement `ExactSizeIterator`.][58778]
1153 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1154 - [Removed the `Read` trait bounds
1155   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1156 - [You can now call the `dbg!` macro without any parameters to print the file
1157   and line where it is called.][57847]
1158 - [In place ASCII case conversions are now up to 4× faster.][59283]
1159   e.g. `str::make_ascii_lowercase`
1160 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1161   and `Send`.][58369]
1162
1163 Stabilized APIs
1164 ---------------
1165 - [`f32::copysign`]
1166 - [`f64::copysign`]
1167 - [`RefCell::replace_with`]
1168 - [`RefCell::map_split`]
1169 - [`ptr::hash`]
1170 - [`Range::contains`]
1171 - [`RangeFrom::contains`]
1172 - [`RangeTo::contains`]
1173 - [`RangeInclusive::contains`]
1174 - [`RangeToInclusive::contains`]
1175 - [`Option::copied`]
1176
1177 Cargo
1178 -----
1179 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1180   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1181   platform specific.
1182
1183 Misc
1184 ----
1185 - [The Rust toolchain is now available natively for musl based distros.][58575]
1186
1187 [59460]: https://github.com/rust-lang/rust/pull/59460/
1188 [59464]: https://github.com/rust-lang/rust/pull/59464/
1189 [59500]: https://github.com/rust-lang/rust/pull/59500/
1190 [59512]: https://github.com/rust-lang/rust/pull/59512/
1191 [59580]: https://github.com/rust-lang/rust/pull/59580/
1192 [59283]: https://github.com/rust-lang/rust/pull/59283/
1193 [59451]: https://github.com/rust-lang/rust/pull/59451/
1194 [59076]: https://github.com/rust-lang/rust/pull/59076/
1195 [58778]: https://github.com/rust-lang/rust/pull/58778/
1196 [58717]: https://github.com/rust-lang/rust/pull/58717/
1197 [58369]: https://github.com/rust-lang/rust/pull/58369/
1198 [58423]: https://github.com/rust-lang/rust/pull/58423/
1199 [58080]: https://github.com/rust-lang/rust/pull/58080/
1200 [57847]: https://github.com/rust-lang/rust/pull/57847/
1201 [58575]: https://github.com/rust-lang/rust/pull/58575
1202 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1203 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1204 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1205 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1206 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1207 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1208 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1209 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1210 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1211 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1212 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1213 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1214
1215 Version 1.34.2 (2019-05-14)
1216 ===========================
1217
1218 * [Destabilize the `Error::type_id` function due to a security
1219    vulnerability][60785] ([CVE-2019-12083])
1220
1221 [60785]: https://github.com/rust-lang/rust/pull/60785
1222 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1223
1224 Version 1.34.1 (2019-04-25)
1225 ===========================
1226
1227 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1228 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1229 * [Fix Clippy panic when checking some macros][clippy/3805]
1230
1231 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1232 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1233 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1234
1235 Version 1.34.0 (2019-04-11)
1236 ==========================
1237
1238 Language
1239 --------
1240 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1241   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1242   but had no effect.
1243 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1244   `#[attr{}]` procedural macros.][57367]
1245 - [You can now write `extern crate self as foo;`][57407] to import your
1246   crate's root into the extern prelude.
1247
1248
1249 Compiler
1250 --------
1251 - [You can now target `riscv64imac-unknown-none-elf` and
1252   `riscv64gc-unknown-none-elf`.][58406]
1253 - [You can now enable linker plugin LTO optimisations with
1254   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1255   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1256   boundaries.
1257 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1258
1259
1260 Libraries
1261 ---------
1262 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1263   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1264   the `Hash` trait to create an iterator.
1265 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1266   methods.][58421] Most notably you no longer require the `Ord` trait to create
1267   an iterator.
1268 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1269   for all numeric types.][58044]
1270 - [Indexing a `str` is now generic over all types that
1271   implement `SliceIndex<str>`.][57604]
1272 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1273   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1274   produce a warning if their returning type is unused.
1275 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1276   `overflowing_pow` are now available for all numeric types.][57873] These are
1277   equivalent to methods such as `wrapping_add` for the `pow` operation.
1278
1279
1280 Stabilized APIs
1281 ---------------
1282
1283 #### std & core
1284 * [`Any::type_id`]
1285 * [`Error::type_id`]
1286 * [`atomic::AtomicI16`]
1287 * [`atomic::AtomicI32`]
1288 * [`atomic::AtomicI64`]
1289 * [`atomic::AtomicI8`]
1290 * [`atomic::AtomicU16`]
1291 * [`atomic::AtomicU32`]
1292 * [`atomic::AtomicU64`]
1293 * [`atomic::AtomicU8`]
1294 * [`convert::Infallible`]
1295 * [`convert::TryFrom`]
1296 * [`convert::TryInto`]
1297 * [`iter::from_fn`]
1298 * [`iter::successors`]
1299 * [`num::NonZeroI128`]
1300 * [`num::NonZeroI16`]
1301 * [`num::NonZeroI32`]
1302 * [`num::NonZeroI64`]
1303 * [`num::NonZeroI8`]
1304 * [`num::NonZeroIsize`]
1305 * [`slice::sort_by_cached_key`]
1306 * [`str::escape_debug`]
1307 * [`str::escape_default`]
1308 * [`str::escape_unicode`]
1309 * [`str::split_ascii_whitespace`]
1310
1311 #### std
1312 * [`Instant::checked_add`]
1313 * [`Instant::checked_sub`]
1314 * [`SystemTime::checked_add`]
1315 * [`SystemTime::checked_sub`]
1316
1317 Cargo
1318 -----
1319 - [You can now use alternative registries to crates.io.][cargo/6654]
1320
1321 Misc
1322 ----
1323 - [You can now use the `?` operator in your documentation tests without manually
1324   adding `fn main() -> Result<(), _> {}`.][56470]
1325
1326 Compatibility Notes
1327 -------------------
1328 - [`Command::before_exec` is being replaced by the unsafe method
1329   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1330 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1331   can now use `const` functions in `static` variables.
1332
1333 [58370]: https://github.com/rust-lang/rust/pull/58370/
1334 [58406]: https://github.com/rust-lang/rust/pull/58406/
1335 [58421]: https://github.com/rust-lang/rust/pull/58421/
1336 [58166]: https://github.com/rust-lang/rust/pull/58166/
1337 [58044]: https://github.com/rust-lang/rust/pull/58044/
1338 [58057]: https://github.com/rust-lang/rust/pull/58057/
1339 [58059]: https://github.com/rust-lang/rust/pull/58059/
1340 [57809]: https://github.com/rust-lang/rust/pull/57809/
1341 [57873]: https://github.com/rust-lang/rust/pull/57873/
1342 [57604]: https://github.com/rust-lang/rust/pull/57604/
1343 [57367]: https://github.com/rust-lang/rust/pull/57367/
1344 [57407]: https://github.com/rust-lang/rust/pull/57407/
1345 [57425]: https://github.com/rust-lang/rust/pull/57425/
1346 [57106]: https://github.com/rust-lang/rust/pull/57106/
1347 [56470]: https://github.com/rust-lang/rust/pull/56470/
1348 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1349 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1350 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1351 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1352 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1353 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1354 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1355 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1356 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1357 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1358 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1359 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1360 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1361 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1362 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1363 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1364 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1365 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1366 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1367 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1368 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1369 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1370 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1371 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1372 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1373 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1374 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1375 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1376 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1377 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1378 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1379
1380
1381 Version 1.33.0 (2019-02-28)
1382 ==========================
1383
1384 Language
1385 --------
1386 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1387   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1388 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1389   E.g. You can have match statement on a `u8` that covers `0..=255` and
1390   you would no longer be required to have a `_ => unreachable!()` case.
1391 - [You can now have multiple patterns in `if let` and `while let`
1392   expressions.][57532] You can do this with the same syntax as a `match`
1393   expression. E.g.
1394   ```rust
1395   enum Creature {
1396       Crab(String),
1397       Lobster(String),
1398       Person(String),
1399   }
1400
1401   fn main() {
1402       let state = Creature::Crab("Ferris");
1403
1404       if let Creature::Crab(name) | Creature::Person(name) = state {
1405           println!("This creature's name is: {}", name);
1406       }
1407   }
1408   ```
1409 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1410   this feature will by default produce a warning as this behaviour can be
1411   unintuitive. E.g. `if let _ = 5 {}`
1412 - [You can now use `let` bindings, assignments, expression statements,
1413   and irrefutable pattern destructuring in const functions.][57175]
1414 - [You can now call unsafe const functions.][57067] E.g.
1415   ```rust
1416   const unsafe fn foo() -> i32 { 5 }
1417   const fn bar() -> i32 {
1418       unsafe { foo() }
1419   }
1420   ```
1421 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1422   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1423 - [You can now specify a specific alignment with the `#[repr(packed)]`
1424   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1425   with an alignment of 2 bytes and a size of 6 bytes.
1426 - [You can now import an item from a module as an `_`.][56303] This allows you to
1427   import a trait's impls, and not have the name in the namespace. E.g.
1428   ```rust
1429   use std::io::Read as _;
1430
1431   // Allowed as there is only one `Read` in the module.
1432   pub trait Read {}
1433   ```
1434 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1435
1436 Compiler
1437 --------
1438 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1439   command line argument.][56351]
1440 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1441 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1442 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1443   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1444   information on Rust's platform support.
1445 - [Added support for the `thumbv7neon-linux-androideabi` and
1446   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1447 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1448
1449 Libraries
1450 ---------
1451 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1452   functions for all numeric types.][57566]
1453 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1454   are now `const` functions for all numeric types.][57105]
1455 - [The methods `is_positive` and `is_negative` are now `const` functions for
1456   all signed numeric types.][57105]
1457 - [The `get` method for all `NonZero` types is now `const`.][57167]
1458 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1459   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1460   numeric types.][57234]
1461 - [`Ipv4Addr::new` is now a `const` function][57234]
1462
1463 Stabilized APIs
1464 ---------------
1465 - [`unix::FileExt::read_exact_at`]
1466 - [`unix::FileExt::write_all_at`]
1467 - [`Option::transpose`]
1468 - [`Result::transpose`]
1469 - [`convert::identity`]
1470 - [`pin::Pin`]
1471 - [`marker::Unpin`]
1472 - [`marker::PhantomPinned`]
1473 - [`Vec::resize_with`]
1474 - [`VecDeque::resize_with`]
1475 - [`Duration::as_millis`]
1476 - [`Duration::as_micros`]
1477 - [`Duration::as_nanos`]
1478
1479
1480 Cargo
1481 -----
1482 - [You can now publish crates that require a feature flag to compile with
1483   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1484 - [Cargo should now rebuild a crate if a file was modified during the initial
1485   build.][cargo/6484]
1486
1487 Compatibility Notes
1488 -------------------
1489 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1490   are now deprecated in the standard library, and their usage will now produce a warning.
1491   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1492   methods instead.
1493 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1494   downcasting.
1495 - [Libtest no longer creates a new thread for each test when
1496   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1497
1498 [55982]: https://github.com/rust-lang/rust/pull/55982/
1499 [56243]: https://github.com/rust-lang/rust/pull/56243
1500 [56303]: https://github.com/rust-lang/rust/pull/56303/
1501 [56351]: https://github.com/rust-lang/rust/pull/56351/
1502 [56362]: https://github.com/rust-lang/rust/pull/56362
1503 [56642]: https://github.com/rust-lang/rust/pull/56642/
1504 [56769]: https://github.com/rust-lang/rust/pull/56769/
1505 [56805]: https://github.com/rust-lang/rust/pull/56805
1506 [56947]: https://github.com/rust-lang/rust/pull/56947/
1507 [57049]: https://github.com/rust-lang/rust/pull/57049/
1508 [57067]: https://github.com/rust-lang/rust/pull/57067/
1509 [57105]: https://github.com/rust-lang/rust/pull/57105
1510 [57130]: https://github.com/rust-lang/rust/pull/57130/
1511 [57167]: https://github.com/rust-lang/rust/pull/57167/
1512 [57175]: https://github.com/rust-lang/rust/pull/57175/
1513 [57234]: https://github.com/rust-lang/rust/pull/57234/
1514 [57332]: https://github.com/rust-lang/rust/pull/57332/
1515 [57465]: https://github.com/rust-lang/rust/pull/57465/
1516 [57532]: https://github.com/rust-lang/rust/pull/57532/
1517 [57535]: https://github.com/rust-lang/rust/pull/57535/
1518 [57566]: https://github.com/rust-lang/rust/pull/57566/
1519 [57615]: https://github.com/rust-lang/rust/pull/57615/
1520 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1521 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1522 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1523 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1524 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1525 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1526 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1527 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1528 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1529 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1530 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1531 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1532 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1533 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1534 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1535 [platform-support]: https://forge.rust-lang.org/platform-support.html
1536
1537 Version 1.32.0 (2019-01-17)
1538 ==========================
1539
1540 Language
1541 --------
1542 #### 2018 edition
1543 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1544   operator allows you to specify zero or one repetitions similar to the `*` and
1545   `+` operators.
1546 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1547   now always resolve to the item (`enum`, `struct`, etc.) available in the
1548   module if present, before resolving to a external crate or an item the prelude.][56759]
1549   E.g.
1550   ```rust
1551   enum Color { Red, Green, Blue }
1552
1553   use Color::*;
1554   ```
1555
1556 #### All editions
1557 - [You can now match against `PhantomData<T>` types.][55837]
1558 - [You can now match against literals in macros with the `literal`
1559   specifier.][56072] This will match against a literal of any type.
1560   E.g. `1`, `'A'`, `"Hello World"`
1561 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1562   ```rust
1563   struct Point(i32, i32);
1564
1565   impl Point {
1566       pub fn new(x: i32, y: i32) -> Self {
1567           Self(x, y)
1568       }
1569
1570       pub fn is_origin(&self) -> bool {
1571           match self {
1572               Self(0, 0) => true,
1573               _ => false,
1574           }
1575       }
1576   }
1577   ```
1578 - [Self can also now be used in type definitions.][56366] E.g.
1579   ```rust
1580   enum List<T>
1581   where
1582       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1583   {
1584       Nil,
1585       Cons(T, Box<Self>) // likewise here
1586   }
1587   ```
1588 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1589   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1590
1591 Compiler
1592 --------
1593 - [The default allocator has changed from jemalloc to the default allocator on
1594   your system.][55238] The compiler itself on Linux & macOS will still use
1595   jemalloc, but programs compiled with it will use the system allocator.
1596 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1597
1598 Libraries
1599 ---------
1600 - [`PathBuf` now implements `FromStr`.][55148]
1601 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1602 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1603   easily debug expressions in your rust program. E.g.
1604   ```rust
1605   let a = 2;
1606   let b = dbg!(a * 2) + 1;
1607   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1608   assert_eq!(b, 5);
1609   ```
1610
1611 The following APIs are now `const` functions and can be used in a
1612 `const` context.
1613
1614 - [`Cell::as_ptr`]
1615 - [`UnsafeCell::get`]
1616 - [`char::is_ascii`]
1617 - [`iter::empty`]
1618 - [`ManuallyDrop::new`]
1619 - [`ManuallyDrop::into_inner`]
1620 - [`RangeInclusive::start`]
1621 - [`RangeInclusive::end`]
1622 - [`NonNull::as_ptr`]
1623 - [`slice::as_ptr`]
1624 - [`str::as_ptr`]
1625 - [`Duration::as_secs`]
1626 - [`Duration::subsec_millis`]
1627 - [`Duration::subsec_micros`]
1628 - [`Duration::subsec_nanos`]
1629 - [`CStr::as_ptr`]
1630 - [`Ipv4Addr::is_unspecified`]
1631 - [`Ipv6Addr::new`]
1632 - [`Ipv6Addr::octets`]
1633
1634 Stabilized APIs
1635 ---------------
1636 - [`i8::to_be_bytes`]
1637 - [`i8::to_le_bytes`]
1638 - [`i8::to_ne_bytes`]
1639 - [`i8::from_be_bytes`]
1640 - [`i8::from_le_bytes`]
1641 - [`i8::from_ne_bytes`]
1642 - [`i16::to_be_bytes`]
1643 - [`i16::to_le_bytes`]
1644 - [`i16::to_ne_bytes`]
1645 - [`i16::from_be_bytes`]
1646 - [`i16::from_le_bytes`]
1647 - [`i16::from_ne_bytes`]
1648 - [`i32::to_be_bytes`]
1649 - [`i32::to_le_bytes`]
1650 - [`i32::to_ne_bytes`]
1651 - [`i32::from_be_bytes`]
1652 - [`i32::from_le_bytes`]
1653 - [`i32::from_ne_bytes`]
1654 - [`i64::to_be_bytes`]
1655 - [`i64::to_le_bytes`]
1656 - [`i64::to_ne_bytes`]
1657 - [`i64::from_be_bytes`]
1658 - [`i64::from_le_bytes`]
1659 - [`i64::from_ne_bytes`]
1660 - [`i128::to_be_bytes`]
1661 - [`i128::to_le_bytes`]
1662 - [`i128::to_ne_bytes`]
1663 - [`i128::from_be_bytes`]
1664 - [`i128::from_le_bytes`]
1665 - [`i128::from_ne_bytes`]
1666 - [`isize::to_be_bytes`]
1667 - [`isize::to_le_bytes`]
1668 - [`isize::to_ne_bytes`]
1669 - [`isize::from_be_bytes`]
1670 - [`isize::from_le_bytes`]
1671 - [`isize::from_ne_bytes`]
1672 - [`u8::to_be_bytes`]
1673 - [`u8::to_le_bytes`]
1674 - [`u8::to_ne_bytes`]
1675 - [`u8::from_be_bytes`]
1676 - [`u8::from_le_bytes`]
1677 - [`u8::from_ne_bytes`]
1678 - [`u16::to_be_bytes`]
1679 - [`u16::to_le_bytes`]
1680 - [`u16::to_ne_bytes`]
1681 - [`u16::from_be_bytes`]
1682 - [`u16::from_le_bytes`]
1683 - [`u16::from_ne_bytes`]
1684 - [`u32::to_be_bytes`]
1685 - [`u32::to_le_bytes`]
1686 - [`u32::to_ne_bytes`]
1687 - [`u32::from_be_bytes`]
1688 - [`u32::from_le_bytes`]
1689 - [`u32::from_ne_bytes`]
1690 - [`u64::to_be_bytes`]
1691 - [`u64::to_le_bytes`]
1692 - [`u64::to_ne_bytes`]
1693 - [`u64::from_be_bytes`]
1694 - [`u64::from_le_bytes`]
1695 - [`u64::from_ne_bytes`]
1696 - [`u128::to_be_bytes`]
1697 - [`u128::to_le_bytes`]
1698 - [`u128::to_ne_bytes`]
1699 - [`u128::from_be_bytes`]
1700 - [`u128::from_le_bytes`]
1701 - [`u128::from_ne_bytes`]
1702 - [`usize::to_be_bytes`]
1703 - [`usize::to_le_bytes`]
1704 - [`usize::to_ne_bytes`]
1705 - [`usize::from_be_bytes`]
1706 - [`usize::from_le_bytes`]
1707 - [`usize::from_ne_bytes`]
1708
1709 Cargo
1710 -----
1711 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1712 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1713
1714 Misc
1715 ----
1716 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1717
1718 Compatibility Notes
1719 -------------------
1720 - [The argument types for AVX's
1721   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1722   been changed from `*const` to `*mut` as the previous implementation
1723   was unsound.
1724
1725
1726 [55148]: https://github.com/rust-lang/rust/pull/55148/
1727 [55238]: https://github.com/rust-lang/rust/pull/55238/
1728 [55280]: https://github.com/rust-lang/rust/pull/55280/
1729 [55610]: https://github.com/rust-lang/rust/pull/55610/
1730 [55663]: https://github.com/rust-lang/rust/pull/55663/
1731 [55702]: https://github.com/rust-lang/rust/pull/55702/
1732 [55837]: https://github.com/rust-lang/rust/pull/55837/
1733 [55843]: https://github.com/rust-lang/rust/pull/55843/
1734 [56072]: https://github.com/rust-lang/rust/pull/56072/
1735 [56245]: https://github.com/rust-lang/rust/pull/56245/
1736 [56365]: https://github.com/rust-lang/rust/pull/56365/
1737 [56366]: https://github.com/rust-lang/rust/pull/56366/
1738 [56395]: https://github.com/rust-lang/rust/pull/56395/
1739 [56759]: https://github.com/rust-lang/rust/pull/56759/
1740 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1741 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1742 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1743 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1744 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1745 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1746 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1747 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1748 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1749 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1750 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1751 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1752 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1753 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1754 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1755 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1756 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1757 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1758 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1759 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1760 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1761 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1762 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1763 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1764 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1765 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1766 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1767 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1768 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1769 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1770 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1771 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1772 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1773 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1774 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1775 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1776 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1777 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1778 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1779 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1780 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1781 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1782 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1783 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1784 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1785 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1786 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1787 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1788 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1789 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1790 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1791 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1792 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1793 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1794 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1795 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1796 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1797 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1798 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1799 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1800 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1801 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1802 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1803 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1804 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1805 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1806 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1807 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1808 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1809 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1810 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1811 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1812 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1813 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1814 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1815 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1816 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1817 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1818 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1819 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1820 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1821 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1822 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1823 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1824 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1825 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1826 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1827 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1828 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1829 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1830 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1831 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1832 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1833
1834
1835 Version 1.31.1 (2018-12-20)
1836 ===========================
1837
1838 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1839 - [Fix broken go-to-definition in RLS][rls/1171]
1840 - [Fix infinite loop on hover in RLS][rls/1170]
1841
1842 [56562]: https://github.com/rust-lang/rust/pull/56562
1843 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1844 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1845
1846 Version 1.31.0 (2018-12-06)
1847 ==========================
1848
1849 Language
1850 --------
1851 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1852 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1853   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1854   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1855   in structs.
1856 - [You can now define and use `const` functions.][54835] These are currently
1857   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1858   [language reference][const-reference] for what exactly is available.
1859 - [You can now use tool lints, which allow you to scope lints from external
1860   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1861 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1862   a crate, not just in exported functions.][54451]
1863 - [You can now use parentheses in pattern matches.][54497]
1864
1865 Compiler
1866 --------
1867 - [Updated musl to 1.1.20][54430]
1868
1869 Libraries
1870 ---------
1871 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1872   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1873 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1874   into `Option<&mut T>` using the `From` trait.][53218]
1875 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1876
1877
1878 Stabilized APIs
1879 ---------------
1880 - [`slice::align_to`]
1881 - [`slice::align_to_mut`]
1882 - [`slice::chunks_exact`]
1883 - [`slice::chunks_exact_mut`]
1884 - [`slice::rchunks`]
1885 - [`slice::rchunks_mut`]
1886 - [`slice::rchunks_exact`]
1887 - [`slice::rchunks_exact_mut`]
1888 - [`Option::replace`]
1889
1890 Cargo
1891 -----
1892 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1893 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1894   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1895
1896 [52813]: https://github.com/rust-lang/rust/pull/52813/
1897 [53218]: https://github.com/rust-lang/rust/pull/53218/
1898 [53555]: https://github.com/rust-lang/rust/issues/53555/
1899 [54057]: https://github.com/rust-lang/rust/pull/54057/
1900 [54240]: https://github.com/rust-lang/rust/pull/54240/
1901 [54430]: https://github.com/rust-lang/rust/pull/54430/
1902 [54451]: https://github.com/rust-lang/rust/pull/54451/
1903 [54497]: https://github.com/rust-lang/rust/pull/54497/
1904 [54778]: https://github.com/rust-lang/rust/pull/54778/
1905 [54835]: https://github.com/rust-lang/rust/pull/54835/
1906 [54870]: https://github.com/rust-lang/rust/pull/54870/
1907 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1908 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1909 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1910 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1911 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1912 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1913 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1914 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1915 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1916 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1917 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1918 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1919 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1920 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1921
1922 Version 1.30.1 (2018-11-08)
1923 ===========================
1924
1925 - [Fixed overflow ICE in rustdoc][54199]
1926 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1927
1928 [54199]: https://github.com/rust-lang/rust/pull/54199
1929 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1930
1931 Version 1.30.0 (2018-10-25)
1932 ==========================
1933
1934 Language
1935 --------
1936 - [Procedural macros are now available.][52081] These kinds of macros allow for
1937   more powerful code generation. There is a [new chapter available][proc-macros]
1938   in the Rust Programming Language book that goes further in depth.
1939 - [You can now use keywords as identifiers using the raw identifiers
1940   syntax (`r#`),][53236] e.g. `let r#for = true;`
1941 - [Using anonymous parameters in traits is now deprecated with a warning and
1942   will be a hard error in the 2018 edition.][53272]
1943 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1944   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1945 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1946   Previously, using a external crate in a module without a use statement
1947   required `let json = ::serde_json::from_str(foo);` but can now be written
1948   as `let json = serde_json::from_str(foo);`.
1949 - [You can now apply the `#[used]` attribute to static items to prevent the
1950   compiler from optimising them away, even if they appear to be unused,][51363]
1951   e.g. `#[used] static FOO: u32 = 1;`
1952 - [You can now import and reexport macros from other crates with the `use`
1953   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1954   the root module of the crate. If your macro relies on calling other local
1955   macros, it is recommended to export with the
1956   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1957   those macros.
1958 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1959   using the `vis` specifier.][53370]
1960 - [Non-macro attributes now allow all forms of literals, not just
1961   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1962   write `#[attr(true)]`.
1963 - [You can now specify a function to handle a panic in the Rust runtime with the
1964   `#[panic_handler]` attribute.][51366]
1965
1966 Compiler
1967 --------
1968 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1969 - [Added the `aarch64-unknown-netbsd` target][53165]
1970
1971 Libraries
1972 ---------
1973 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1974
1975 Stabilized APIs
1976 ---------------
1977 - [`Ipv4Addr::BROADCAST`]
1978 - [`Ipv4Addr::LOCALHOST`]
1979 - [`Ipv4Addr::UNSPECIFIED`]
1980 - [`Ipv6Addr::LOCALHOST`]
1981 - [`Ipv6Addr::UNSPECIFIED`]
1982 - [`Iterator::find_map`]
1983
1984   The following methods are replacement methods for `trim_left`, `trim_right`,
1985   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
1986   in 1.33.0:
1987 - [`str::trim_end_matches`]
1988 - [`str::trim_end`]
1989 - [`str::trim_start_matches`]
1990 - [`str::trim_start`]
1991
1992 Cargo
1993 ----
1994 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
1995 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
1996   equivalent to calling `rustdoc --error-format=json`.
1997 - [Cargo will now provide a progress bar for builds.][cargo/5995]
1998
1999 Misc
2000 ----
2001 - [`rustdoc` allows you to specify what edition to treat your code as with the
2002   `--edition` option.][54057]
2003 - [`rustdoc` now has the `--color` (specify whether to output color) and
2004   `--error-format` (specify error format, e.g. `json`) options.][53003]
2005 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2006   debug symbols.][53774]
2007 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2008   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2009
2010 [50911]: https://github.com/rust-lang/rust/pull/50911/
2011 [51363]: https://github.com/rust-lang/rust/pull/51363/
2012 [51366]: https://github.com/rust-lang/rust/pull/51366/
2013 [52081]: https://github.com/rust-lang/rust/pull/52081/
2014 [53003]: https://github.com/rust-lang/rust/pull/53003/
2015 [53033]: https://github.com/rust-lang/rust/pull/53033/
2016 [53044]: https://github.com/rust-lang/rust/pull/53044/
2017 [53165]: https://github.com/rust-lang/rust/pull/53165/
2018 [53213]: https://github.com/rust-lang/rust/pull/53213/
2019 [53236]: https://github.com/rust-lang/rust/pull/53236/
2020 [53272]: https://github.com/rust-lang/rust/pull/53272/
2021 [53370]: https://github.com/rust-lang/rust/pull/53370/
2022 [53459]: https://github.com/rust-lang/rust/pull/53459/
2023 [53774]: https://github.com/rust-lang/rust/pull/53774/
2024 [53822]: https://github.com/rust-lang/rust/pull/53822/
2025 [54057]: https://github.com/rust-lang/rust/pull/54057/
2026 [54146]: https://github.com/rust-lang/rust/pull/54146/
2027 [54404]: https://github.com/rust-lang/rust/pull/54404/
2028 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2029 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2030 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2031 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2032
2033 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2034 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2035 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2036 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2037 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2038 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2039 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2040 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2041 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2042 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2043
2044
2045 Version 1.29.2 (2018-10-11)
2046 ===========================
2047
2048 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2049 - The `rls-preview` component on the windows-gnu targets has been restored.
2050
2051 [54639]: https://github.com/rust-lang/rust/pull/54639
2052
2053
2054 Version 1.29.1 (2018-09-25)
2055 ===========================
2056
2057 Security Notes
2058 --------------
2059
2060 - The standard library's `str::repeat` function contained an out of bounds write
2061   caused by an integer overflow. This has been fixed by deterministically
2062   panicking when an overflow happens.
2063
2064   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2065   us.
2066
2067
2068 Version 1.29.0 (2018-09-13)
2069 ==========================
2070
2071 Compiler
2072 --------
2073 - [Bumped minimum LLVM version to 5.0.][51899]
2074 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2075 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2076
2077 Libraries
2078 ---------
2079 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2080 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2081 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2082 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2083   for `&str`.][51178]
2084 - [`Cell<T>` now allows `T` to be unsized.][50494]
2085 - [`SocketAddr` is now stable on Redox.][52656]
2086
2087 Stabilized APIs
2088 ---------------
2089 - [`Arc::downcast`]
2090 - [`Iterator::flatten`]
2091 - [`Rc::downcast`]
2092
2093 Cargo
2094 -----
2095 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2096   `--locked` to disable this behavior.
2097 - [`cargo-install` will now allow you to cross compile an install
2098   using `--target`.][cargo/5614]
2099 - [Added the `cargo-fix` subcommand to automatically move project code from
2100   2015 edition to 2018.][cargo/5723]
2101 - [`cargo doc` can now optionally document private types using the
2102   `--document-private-items` flag.][cargo/5543]
2103
2104 Misc
2105 ----
2106 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2107   the specified level to that level.][52354] For example `--cap-lints warn`
2108   will demote `deny` and `forbid` lints to `warn`.
2109 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2110   fails and `101` if there is a panic.][52197]
2111 - [A preview of clippy has been made available through rustup.][51122]
2112   You can install the preview with `rustup component add clippy-preview`.
2113
2114 Compatibility Notes
2115 -------------------
2116 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2117   Use `str::get_unchecked(begin..end)` instead.
2118 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2119   Consider using the `home_dir` function from
2120   https://crates.io/crates/dirs instead.
2121 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2122 - [`cfg` attributes and `--cfg` command line flags are now more
2123   strictly validated.][53893]
2124
2125 [53893]: https://github.com/rust-lang/rust/pull/53893/
2126 [52861]: https://github.com/rust-lang/rust/pull/52861/
2127 [52656]: https://github.com/rust-lang/rust/pull/52656/
2128 [52239]: https://github.com/rust-lang/rust/pull/52239/
2129 [52330]: https://github.com/rust-lang/rust/pull/52330/
2130 [52354]: https://github.com/rust-lang/rust/pull/52354/
2131 [52402]: https://github.com/rust-lang/rust/pull/52402/
2132 [52103]: https://github.com/rust-lang/rust/pull/52103/
2133 [52197]: https://github.com/rust-lang/rust/pull/52197/
2134 [51807]: https://github.com/rust-lang/rust/pull/51807/
2135 [51899]: https://github.com/rust-lang/rust/pull/51899/
2136 [51912]: https://github.com/rust-lang/rust/pull/51912/
2137 [51511]: https://github.com/rust-lang/rust/pull/51511/
2138 [51619]: https://github.com/rust-lang/rust/pull/51619/
2139 [51656]: https://github.com/rust-lang/rust/pull/51656/
2140 [51178]: https://github.com/rust-lang/rust/pull/51178/
2141 [51122]: https://github.com/rust-lang/rust/pull/51122
2142 [50494]: https://github.com/rust-lang/rust/pull/50494/
2143 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2144 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2145 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2146 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2147 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2148 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2149 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2150
2151
2152 Version 1.28.0 (2018-08-02)
2153 ===========================
2154
2155 Language
2156 --------
2157 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2158   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2159   the inner type across Foreign Function Interface (FFI) boundaries.
2160 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2161   and can now be used as identifiers.][51196]
2162 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2163   stable.][51241] This will allow users to specify a global allocator for
2164   their program.
2165 - [Unit test functions marked with the `#[test]` attribute can now return
2166   `Result<(), E: Debug>` in addition to `()`.][51298]
2167 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2168   allows macros to easily target lifetimes.
2169
2170 Compiler
2171 --------
2172 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2173   prioritise making smaller binary sizes. `z` is the same as `s` with the
2174   exception that it does not vectorise loops, which typically results in an even
2175   smaller binary.
2176 - [The short error format is now stable.][49546] Specified with
2177   `--error-format=short` this option will provide a more compressed output of
2178   rust error messages.
2179 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2180 - [Reduced the number of allocations in the macro parser.][50855] This can
2181   improve compile times of macro heavy crates on average by 5%.
2182
2183 Libraries
2184 ---------
2185 - [Implemented `Default` for `&mut str`.][51306]
2186 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2187 - [Implemented `Extend` for `()`.][50234]
2188 - [The `Debug` implementation of `time::Duration` should now be more easily
2189   human readable.][50364] Previously a `Duration` of one second would printed as
2190   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2191 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2192   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2193   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2194   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2195   for `PathBuf`.][50170]
2196 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2197   and `Wrapping<i128>`.][50465]
2198 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2199   possible.][51050] This can provide up to a 40% speed increase.
2200 - [Improved error messages when using `format!`.][50610]
2201
2202 Stabilized APIs
2203 ---------------
2204 - [`Iterator::step_by`]
2205 - [`Path::ancestors`]
2206 - [`SystemTime::UNIX_EPOCH`]
2207 - [`alloc::GlobalAlloc`]
2208 - [`alloc::Layout`]
2209 - [`alloc::LayoutErr`]
2210 - [`alloc::System`]
2211 - [`alloc::alloc`]
2212 - [`alloc::alloc_zeroed`]
2213 - [`alloc::dealloc`]
2214 - [`alloc::realloc`]
2215 - [`alloc::handle_alloc_error`]
2216 - [`btree_map::Entry::or_default`]
2217 - [`fmt::Alignment`]
2218 - [`hash_map::Entry::or_default`]
2219 - [`iter::repeat_with`]
2220 - [`num::NonZeroUsize`]
2221 - [`num::NonZeroU128`]
2222 - [`num::NonZeroU16`]
2223 - [`num::NonZeroU32`]
2224 - [`num::NonZeroU64`]
2225 - [`num::NonZeroU8`]
2226 - [`ops::RangeBounds`]
2227 - [`slice::SliceIndex`]
2228 - [`slice::from_mut`]
2229 - [`slice::from_ref`]
2230 - [`{Any + Send + Sync}::downcast_mut`]
2231 - [`{Any + Send + Sync}::downcast_ref`]
2232 - [`{Any + Send + Sync}::is`]
2233
2234 Cargo
2235 -----
2236 - [Cargo will now no longer allow you to publish crates with build scripts that
2237   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2238   considered to be immutable.
2239
2240 Misc
2241 ----
2242 - [The `suggestion_applicability` field in `rustc`'s json output is now
2243   stable.][50486] This will allow dev tools to check whether a code suggestion
2244   would apply to them.
2245
2246 Compatibility Notes
2247 -------------------
2248 - [Rust will consider trait objects with duplicated constraints to be the same
2249   type as without the duplicated constraint.][51276] For example the below code will
2250   now fail to compile.
2251   ```rust
2252   trait Trait {}
2253
2254   impl Trait + Send {
2255       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2256   }
2257
2258   impl Trait + Send + Send {
2259       fn test(&self) { println!("two"); }
2260   }
2261   ```
2262
2263 [49546]: https://github.com/rust-lang/rust/pull/49546/
2264 [50143]: https://github.com/rust-lang/rust/pull/50143/
2265 [50170]: https://github.com/rust-lang/rust/pull/50170/
2266 [50234]: https://github.com/rust-lang/rust/pull/50234/
2267 [50265]: https://github.com/rust-lang/rust/pull/50265/
2268 [50364]: https://github.com/rust-lang/rust/pull/50364/
2269 [50385]: https://github.com/rust-lang/rust/pull/50385/
2270 [50465]: https://github.com/rust-lang/rust/pull/50465/
2271 [50486]: https://github.com/rust-lang/rust/pull/50486/
2272 [50554]: https://github.com/rust-lang/rust/pull/50554/
2273 [50610]: https://github.com/rust-lang/rust/pull/50610/
2274 [50855]: https://github.com/rust-lang/rust/pull/50855/
2275 [51050]: https://github.com/rust-lang/rust/pull/51050/
2276 [51196]: https://github.com/rust-lang/rust/pull/51196/
2277 [51200]: https://github.com/rust-lang/rust/pull/51200/
2278 [51241]: https://github.com/rust-lang/rust/pull/51241/
2279 [51276]: https://github.com/rust-lang/rust/pull/51276/
2280 [51298]: https://github.com/rust-lang/rust/pull/51298/
2281 [51306]: https://github.com/rust-lang/rust/pull/51306/
2282 [51562]: https://github.com/rust-lang/rust/pull/51562/
2283 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2284 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2285 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2286 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2287 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2288 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2289 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2290 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2291 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2292 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2293 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2294 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2295 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2296 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2297 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2298 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2299 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2300 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2301 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2302 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2303 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2304 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2305 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2306 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2307 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2308 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2309 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2310 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2311 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2312 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2313
2314 Version 1.27.2 (2018-07-20)
2315 ===========================
2316
2317 Compatibility Notes
2318 -------------------
2319
2320 - The borrow checker was fixed to avoid potential unsoundness when using
2321   match ergonomics: [#52213][52213].
2322
2323 [52213]: https://github.com/rust-lang/rust/issues/52213
2324
2325 Version 1.27.1 (2018-07-10)
2326 ===========================
2327
2328 Security Notes
2329 --------------
2330
2331 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2332   when running, which enabled executing code as some other user on a
2333   given machine. This release fixes that vulnerability; you can read
2334   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2335
2336   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2337
2338 Compatibility Notes
2339 -------------------
2340
2341 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2342   match ergonomics: [#51415][51415], [#49534][49534].
2343
2344 [51415]: https://github.com/rust-lang/rust/issues/51415
2345 [49534]: https://github.com/rust-lang/rust/issues/49534
2346 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2347 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2348
2349 Version 1.27.0 (2018-06-21)
2350 ==========================
2351
2352 Language
2353 --------
2354 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2355   be used as an identifier.
2356 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2357   bare `Trait` syntax, and should make it clearer when being used in tandem with
2358   `impl Trait` because it is equivalent to the following syntax:
2359   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2360   `Box<Trait> == Box<dyn Trait>`.
2361 - [Attributes on generic parameters such as types and lifetimes are
2362   now stable.][48851] e.g.
2363   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2364 - [The `#[must_use]` attribute can now also be used on functions as well as
2365   types.][48925] It provides a lint that by default warns users when the
2366   value returned by a function has not been used.
2367
2368 Compiler
2369 --------
2370 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2371
2372 Libraries
2373 ---------
2374 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2375   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2376   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2377   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2378   the `cfg` attribute.
2379 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2380   std are now available in core.][49896]
2381 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2382   to `Self`.][49630]
2383 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2384   that the operation isn't done in place.
2385 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2386   the `#[must_use]` attribute][49533] to warn about unused potentially
2387   expensive allocations.
2388
2389 Stabilized APIs
2390 ---------------
2391 - [`DoubleEndedIterator::rfind`]
2392 - [`DoubleEndedIterator::rfold`]
2393 - [`DoubleEndedIterator::try_rfold`]
2394 - [`Duration::from_micros`]
2395 - [`Duration::from_nanos`]
2396 - [`Duration::subsec_micros`]
2397 - [`Duration::subsec_millis`]
2398 - [`HashMap::remove_entry`]
2399 - [`Iterator::try_fold`]
2400 - [`Iterator::try_for_each`]
2401 - [`NonNull::cast`]
2402 - [`Option::filter`]
2403 - [`String::replace_range`]
2404 - [`Take::set_limit`]
2405 - [`hint::unreachable_unchecked`]
2406 - [`os::unix::process::parent_id`]
2407 - [`ptr::swap_nonoverlapping`]
2408 - [`slice::rsplit_mut`]
2409 - [`slice::rsplit`]
2410 - [`slice::swap_with_slice`]
2411
2412 Cargo
2413 -----
2414 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2415   `readme`, and `repository` fields.][cargo/5386]
2416 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2417 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2418   a different directory than `target` for placing compilation artifacts.
2419 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2420   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2421   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2422   where cargo would infer a binary, Cargo will produce a warning. You can
2423   disable this feature ahead of time by setting any of the following to false:
2424   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2425 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2426   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2427
2428 Misc
2429 ----
2430 - [Added “The Rustc book” into the official documentation.][49707]
2431   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2432 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2433
2434 Compatibility Notes
2435 -------------------
2436 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2437   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2438   compile, `"".is_empty()` will still compile.
2439 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2440   will only print the inner type.][48553] E.g.
2441   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2442   not `AtomicBool(true)`.
2443 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2444   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2445   alignment should cover all use cases.
2446 - The `.description()` method on the `std::error::Error` trait
2447   [has been soft-deprecated][50163]. It is no longer required to implement it.
2448
2449 [48553]: https://github.com/rust-lang/rust/pull/48553/
2450 [48851]: https://github.com/rust-lang/rust/pull/48851/
2451 [48925]: https://github.com/rust-lang/rust/pull/48925/
2452 [49533]: https://github.com/rust-lang/rust/pull/49533/
2453 [49623]: https://github.com/rust-lang/rust/pull/49623/
2454 [49630]: https://github.com/rust-lang/rust/pull/49630/
2455 [49664]: https://github.com/rust-lang/rust/pull/49664/
2456 [49699]: https://github.com/rust-lang/rust/pull/49699/
2457 [49707]: https://github.com/rust-lang/rust/pull/49707/
2458 [49719]: https://github.com/rust-lang/rust/pull/49719/
2459 [49896]: https://github.com/rust-lang/rust/pull/49896/
2460 [49968]: https://github.com/rust-lang/rust/pull/49968/
2461 [50163]: https://github.com/rust-lang/rust/pull/50163
2462 [50177]: https://github.com/rust-lang/rust/pull/50177/
2463 [50378]: https://github.com/rust-lang/rust/pull/50378/
2464 [50398]: https://github.com/rust-lang/rust/pull/50398/
2465 [50423]: https://github.com/rust-lang/rust/pull/50423/
2466 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2467 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2468 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2469 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2470 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2471 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2472 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2473 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2474 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2475 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2476 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2477 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2478 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2479 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2480 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2481 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2482 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2483 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2484 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2485 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2486 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2487 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2488 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2489 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2490 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2491 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2492 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2493 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2494 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2495 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2496
2497
2498 Version 1.26.2 (2018-06-05)
2499 ==========================
2500
2501 Compatibility Notes
2502 -------------------
2503
2504 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2505
2506 [51117]: https://github.com/rust-lang/rust/issues/51117
2507
2508
2509 Version 1.26.1 (2018-05-29)
2510 ==========================
2511
2512 Tools
2513 -----
2514
2515 - [RLS now works on Windows.][50646]
2516 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2517
2518
2519 Compatibility Notes
2520 --------
2521
2522 - [`fn main() -> impl Trait` no longer works for non-Termination
2523   trait.][50656]
2524   This reverts an accidental stabilization.
2525 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2526 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2527
2528 [50646]: https://github.com/rust-lang/rust/issues/50646
2529 [50656]: https://github.com/rust-lang/rust/pull/50656
2530 [50812]: https://github.com/rust-lang/rust/pull/50812
2531 [50950]: https://github.com/rust-lang/rust/issues/50950
2532 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2533
2534 Version 1.26.0 (2018-05-10)
2535 ==========================
2536
2537 Language
2538 --------
2539 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2540   implement either or both traits.][49299]
2541 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2542 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2543   lifetime can be elided.][49458]
2544 - [`impl Trait` is now stable allowing you to have abstract types in returns
2545    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2546   `fn open(path: impl AsRef<Path>)`.
2547 - [Pattern matching will now automatically apply dereferences.][49394]
2548 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2549 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2550 - [A lot of operations are now available in a const context.][46882] E.g. You
2551   can now index into constant arrays, reference and dereference into constants,
2552   and use tuple struct constructors.
2553 - [Fixed entry slice patterns are now stable.][48516] E.g.
2554   ```rust
2555   let points = [1, 2, 3, 4];
2556   match points {
2557       [1, 2, 3, 4] => println!("All points were sequential."),
2558       _ => println!("Not all points were sequential."),
2559   }
2560   ```
2561
2562
2563 Compiler
2564 --------
2565 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2566 - [Fixed exponential projection complexity on nested types.][48296]
2567   This can provide up to a ~12% reduction in compile times for certain crates.
2568 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2569   to remap path prefixes outputted by the compiler.
2570 - [Added `powerpc-unknown-netbsd` target.][48281]
2571
2572 Libraries
2573 ---------
2574 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2575 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2576   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2577 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2578 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2579 - [`ascii::escape_default` is now available in libcore.][48735]
2580 - [Trailing commas are now supported in std and core macros.][48056]
2581 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2582 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2583
2584 Stabilized APIs
2585 ---------------
2586 - [`*const T::add`]
2587 - [`*const T::copy_to_nonoverlapping`]
2588 - [`*const T::copy_to`]
2589 - [`*const T::read_unaligned`]
2590 - [`*const T::read_volatile`]
2591 - [`*const T::read`]
2592 - [`*const T::sub`]
2593 - [`*const T::wrapping_add`]
2594 - [`*const T::wrapping_sub`]
2595 - [`*mut T::add`]
2596 - [`*mut T::copy_to_nonoverlapping`]
2597 - [`*mut T::copy_to`]
2598 - [`*mut T::read_unaligned`]
2599 - [`*mut T::read_volatile`]
2600 - [`*mut T::read`]
2601 - [`*mut T::replace`]
2602 - [`*mut T::sub`]
2603 - [`*mut T::swap`]
2604 - [`*mut T::wrapping_add`]
2605 - [`*mut T::wrapping_sub`]
2606 - [`*mut T::write_bytes`]
2607 - [`*mut T::write_unaligned`]
2608 - [`*mut T::write_volatile`]
2609 - [`*mut T::write`]
2610 - [`Box::leak`]
2611 - [`FromUtf8Error::as_bytes`]
2612 - [`LocalKey::try_with`]
2613 - [`Option::cloned`]
2614 - [`btree_map::Entry::and_modify`]
2615 - [`fs::read_to_string`]
2616 - [`fs::read`]
2617 - [`fs::write`]
2618 - [`hash_map::Entry::and_modify`]
2619 - [`iter::FusedIterator`]
2620 - [`ops::RangeInclusive`]
2621 - [`ops::RangeToInclusive`]
2622 - [`process::id`]
2623 - [`slice::rotate_left`]
2624 - [`slice::rotate_right`]
2625 - [`String::retain`]
2626
2627
2628 Cargo
2629 -----
2630 - [Cargo will now output path to custom commands when `-v` is
2631   passed with `--list`][cargo/5041]
2632 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2633
2634 Misc
2635 ----
2636 - [The second edition of "The Rust Programming Language" book is now recommended
2637   over the first.][48404]
2638
2639 Compatibility Notes
2640 -------------------
2641
2642 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2643   syntax is now invalid.
2644   ```
2645   use std::ops::Fn as dyn;
2646   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2647   ```
2648 - [The result of dereferences are no longer promoted to `'static`.][47408]
2649   e.g.
2650   ```rust
2651   fn main() {
2652       const PAIR: &(i32, i32) = &(0, 1);
2653       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2654   }
2655   ```
2656 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2657 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2658   an error.][48235]
2659 - [Removed hoedown from rustdoc.][48274]
2660 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2661
2662 [46882]: https://github.com/rust-lang/rust/pull/46882
2663 [47379]: https://github.com/rust-lang/rust/pull/47379
2664 [47408]: https://github.com/rust-lang/rust/pull/47408
2665 [47813]: https://github.com/rust-lang/rust/pull/47813
2666 [48056]: https://github.com/rust-lang/rust/pull/48056
2667 [48125]: https://github.com/rust-lang/rust/pull/48125
2668 [48166]: https://github.com/rust-lang/rust/pull/48166
2669 [48235]: https://github.com/rust-lang/rust/pull/48235
2670 [48274]: https://github.com/rust-lang/rust/pull/48274
2671 [48281]: https://github.com/rust-lang/rust/pull/48281
2672 [48296]: https://github.com/rust-lang/rust/pull/48296
2673 [48326]: https://github.com/rust-lang/rust/pull/48326
2674 [48359]: https://github.com/rust-lang/rust/pull/48359
2675 [48404]: https://github.com/rust-lang/rust/pull/48404
2676 [48481]: https://github.com/rust-lang/rust/pull/48481
2677 [48516]: https://github.com/rust-lang/rust/pull/48516
2678 [48628]: https://github.com/rust-lang/rust/pull/48628
2679 [48629]: https://github.com/rust-lang/rust/pull/48629
2680 [48657]: https://github.com/rust-lang/rust/pull/48657
2681 [48735]: https://github.com/rust-lang/rust/pull/48735
2682 [48978]: https://github.com/rust-lang/rust/pull/48978
2683 [49101]: https://github.com/rust-lang/rust/pull/49101
2684 [49109]: https://github.com/rust-lang/rust/pull/49109
2685 [49121]: https://github.com/rust-lang/rust/pull/49121
2686 [49162]: https://github.com/rust-lang/rust/pull/49162
2687 [49184]: https://github.com/rust-lang/rust/pull/49184
2688 [49234]: https://github.com/rust-lang/rust/pull/49234
2689 [49255]: https://github.com/rust-lang/rust/pull/49255
2690 [49299]: https://github.com/rust-lang/rust/pull/49299
2691 [49305]: https://github.com/rust-lang/rust/pull/49305
2692 [49394]: https://github.com/rust-lang/rust/pull/49394
2693 [49458]: https://github.com/rust-lang/rust/pull/49458
2694 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2695 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2696 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2697 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2698 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2699 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2700 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2701 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2702 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2703 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2704 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2705 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2706 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2707 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2708 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2709 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2710 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2711 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2712 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2713 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2714 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2715 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2716 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2717 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2718 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2719 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2720 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2721 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2722 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2723 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2724 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2725 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2726 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2727 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2728 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2729 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2730 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2731 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2732 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2733 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2734 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2735 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2736
2737
2738 Version 1.25.0 (2018-03-29)
2739 ==========================
2740
2741 Language
2742 --------
2743 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2744 - [You can now use nested groups of imports.][47948]
2745   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2746 - [You can now have `|` at the start of a match arm.][47947] e.g.
2747 ```rust
2748 enum Foo { A, B, C }
2749
2750 fn main() {
2751     let x = Foo::A;
2752     match x {
2753         | Foo::A
2754         | Foo::B => println!("AB"),
2755         | Foo::C => println!("C"),
2756     }
2757 }
2758 ```
2759
2760 Compiler
2761 --------
2762 - [Upgraded to LLVM 6.][47828]
2763 - [Added `-C lto=val` option.][47521]
2764 - [Added `i586-unknown-linux-musl` target][47282]
2765
2766 Libraries
2767 ---------
2768 - [Impl Send for `process::Command` on Unix.][47760]
2769 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2770 - [`UnsafeCell::into_inner` is now safe.][47204]
2771 - [Implement libstd for CloudABI.][47268]
2772 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2773 - [Implement `AsRef<Path>` for Component][46985]
2774 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2775 - [Moved `Duration` to libcore.][46666]
2776
2777 Stabilized APIs
2778 ---------------
2779 - [`Location::column`]
2780 - [`ptr::NonNull`]
2781
2782 The following functions can now be used in a constant expression.
2783 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2784 - [`Duration::new`][47300]
2785 - [`Duration::from_secs`][47300]
2786 - [`Duration::from_millis`][47300]
2787
2788 Cargo
2789 -----
2790 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2791 - [`cargo new` now defaults to creating a binary crate, instead of a
2792   library crate.][cargo/5029]
2793
2794 Misc
2795 ----
2796 - [Rust by example is now shipped with new releases][46196]
2797
2798 Compatibility Notes
2799 -------------------
2800 - [Deprecated `net::lookup_host`.][47510]
2801 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2802 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2803   around indexing operations (see [#47349][47349]). This has been fixed (which also
2804   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2805 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2806
2807 [33903]: https://github.com/rust-lang/rust/pull/33903
2808 [47947]: https://github.com/rust-lang/rust/pull/47947
2809 [47948]: https://github.com/rust-lang/rust/pull/47948
2810 [47760]: https://github.com/rust-lang/rust/pull/47760
2811 [47790]: https://github.com/rust-lang/rust/pull/47790
2812 [47828]: https://github.com/rust-lang/rust/pull/47828
2813 [47398]: https://github.com/rust-lang/rust/pull/47398
2814 [47510]: https://github.com/rust-lang/rust/pull/47510
2815 [47521]: https://github.com/rust-lang/rust/pull/47521
2816 [47204]: https://github.com/rust-lang/rust/pull/47204
2817 [47251]: https://github.com/rust-lang/rust/pull/47251
2818 [47268]: https://github.com/rust-lang/rust/pull/47268
2819 [47282]: https://github.com/rust-lang/rust/pull/47282
2820 [47300]: https://github.com/rust-lang/rust/pull/47300
2821 [47349]: https://github.com/rust-lang/rust/pull/47349
2822 [46931]: https://github.com/rust-lang/rust/pull/46931
2823 [46985]: https://github.com/rust-lang/rust/pull/46985
2824 [47006]: https://github.com/rust-lang/rust/pull/47006
2825 [46830]: https://github.com/rust-lang/rust/pull/46830
2826 [46095]: https://github.com/rust-lang/rust/pull/46095
2827 [46666]: https://github.com/rust-lang/rust/pull/46666
2828 [46196]: https://github.com/rust-lang/rust/pull/46196
2829 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2830 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2831 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2832 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2833 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2834
2835
2836 Version 1.24.1 (2018-03-01)
2837 ==========================
2838
2839  - [Do not abort when unwinding through FFI][48251]
2840  - [Emit UTF-16 files for linker arguments on Windows][48318]
2841  - [Make the error index generator work again][48308]
2842  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2843
2844 [48251]: https://github.com/rust-lang/rust/issues/48251
2845 [48308]: https://github.com/rust-lang/rust/issues/48308
2846 [48318]: https://github.com/rust-lang/rust/issues/48318
2847 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2848
2849
2850 Version 1.24.0 (2018-02-15)
2851 ==========================
2852
2853 Language
2854 --------
2855 - [External `sysv64` ffi is now available.][46528]
2856   eg. `extern "sysv64" fn foo () {}`
2857
2858 Compiler
2859 --------
2860 - [rustc now uses 16 codegen units by default for release builds.][46910]
2861   For the fastest builds, utilize `codegen-units=1`.
2862 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2863 - [Add `aarch64-unknown-openbsd` support][46760]
2864
2865 Libraries
2866 ---------
2867 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2868   improvement in performance in the majority of cases.
2869 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2870   with Windows.][46798]
2871 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2872 - [impl `From<bool>` for `AtomicBool`][46293]
2873 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2874 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2875 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2876 - [float::from_bits now just uses transmute.][46012] This provides
2877   some optimisations from LLVM.
2878 - [Copied `AsciiExt` methods onto `char`][46077]
2879 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2880 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2881 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2882 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2883
2884 Stabilized APIs
2885 ---------------
2886 - [`RefCell::replace`]
2887 - [`RefCell::swap`]
2888 - [`atomic::spin_loop_hint`]
2889
2890 The following functions can now be used in a constant expression.
2891 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2892
2893 - [`AtomicBool::new`][46287]
2894 - [`AtomicUsize::new`][46287]
2895 - [`AtomicIsize::new`][46287]
2896 - [`AtomicPtr::new`][46287]
2897 - [`Cell::new`][46287]
2898 - [`{integer}::min_value`][46287]
2899 - [`{integer}::max_value`][46287]
2900 - [`mem::size_of`][46287]
2901 - [`mem::align_of`][46287]
2902 - [`ptr::null`][46287]
2903 - [`ptr::null_mut`][46287]
2904 - [`RefCell::new`][46287]
2905 - [`UnsafeCell::new`][46287]
2906
2907 Cargo
2908 -----
2909 - [Added a `workspace.default-members` config that
2910   overrides implied `--all` in virtual workspaces.][cargo/4743]
2911 - [Enable incremental by default on development builds.][cargo/4817] Also added
2912   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2913   per-project or global basis respectively.
2914
2915 Misc
2916 ----
2917
2918 Compatibility Notes
2919 -------------------
2920 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2921 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2922   in accordance with IETF RFC 4291 §2.2.
2923 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2924 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2925   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2926 - [Leading zeros in tuple struct members is now an error][47084]
2927 - [`column!()` macro is one-based instead of zero-based][46977]
2928 - [`fmt::Arguments` can no longer be shared across threads][45198]
2929 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2930 - [Cargo sets a different working directory for the compiler][cargo/4788]
2931
2932 [44884]: https://github.com/rust-lang/rust/pull/44884
2933 [45198]: https://github.com/rust-lang/rust/pull/45198
2934 [45506]: https://github.com/rust-lang/rust/pull/45506
2935 [45904]: https://github.com/rust-lang/rust/pull/45904
2936 [45990]: https://github.com/rust-lang/rust/pull/45990
2937 [46012]: https://github.com/rust-lang/rust/pull/46012
2938 [46077]: https://github.com/rust-lang/rust/pull/46077
2939 [46094]: https://github.com/rust-lang/rust/pull/46094
2940 [46284]: https://github.com/rust-lang/rust/pull/46284
2941 [46287]: https://github.com/rust-lang/rust/pull/46287
2942 [46293]: https://github.com/rust-lang/rust/pull/46293
2943 [46528]: https://github.com/rust-lang/rust/pull/46528
2944 [46671]: https://github.com/rust-lang/rust/pull/46671
2945 [46713]: https://github.com/rust-lang/rust/pull/46713
2946 [46735]: https://github.com/rust-lang/rust/pull/46735
2947 [46749]: https://github.com/rust-lang/rust/pull/46749
2948 [46760]: https://github.com/rust-lang/rust/pull/46760
2949 [46798]: https://github.com/rust-lang/rust/pull/46798
2950 [46828]: https://github.com/rust-lang/rust/pull/46828
2951 [46831]: https://github.com/rust-lang/rust/pull/46831
2952 [46833]: https://github.com/rust-lang/rust/pull/46833
2953 [46910]: https://github.com/rust-lang/rust/pull/46910
2954 [46977]: https://github.com/rust-lang/rust/pull/46977
2955 [47018]: https://github.com/rust-lang/rust/pull/47018
2956 [47080]: https://github.com/rust-lang/rust/pull/47080
2957 [47084]: https://github.com/rust-lang/rust/pull/47084
2958 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2959 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2960 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2961 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2962 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2963 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2964
2965
2966 Version 1.23.0 (2018-01-04)
2967 ==========================
2968
2969 Language
2970 --------
2971 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2972 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2973   Which should fix some confusing errors in some operations.
2974
2975 Compiler
2976 --------
2977 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2978   undefined behavior.][45920]
2979 - [rustc now suggests renaming import if names clash.][45660]
2980 - [Display errors/warnings correctly when there are zero-width or
2981   wide characters.][45711]
2982 - [rustc now avoids unnecessary copies of arguments that are
2983   simple bindings][45380] This should improve memory usage on average by 5-10%.
2984 - [Updated musl used to build musl rustc to 1.1.17][45393]
2985
2986 Libraries
2987 ---------
2988 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
2989 - [Implement Hash for raw pointers to unsized types][45483]
2990 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
2991 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
2992 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
2993 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
2994   and `<*mut T>::as_mut`][44932]
2995 - [Optimized `Thread::{park, unpark}` implementation][45524]
2996 - [Improved `SliceExt::binary_search` performance.][45333]
2997 - [impl `FromIterator<()>` for `()`][45379]
2998 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
2999   is now deprecated.
3000
3001 Stabilized APIs
3002 ---------------
3003
3004 Cargo
3005 -----
3006 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3007   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3008 - [Added unit test checking to `cargo check`][cargo/4592]
3009 - [Cargo now lets you install a specific version
3010   using `cargo install --version`][cargo/4637]
3011
3012 Misc
3013 ----
3014 - [Releases now ship with the Cargo book documentation.][45692]
3015 - [rustdoc now prints rendering warnings on every run.][45324]
3016
3017 Compatibility Notes
3018 -------------------
3019 - [Changes have been made to type equality to make it more correct,
3020   in rare cases this could break some code.][45853] [Tracking issue for
3021   further information][45852]
3022 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3023 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3024   Android 9, the minimum supported version is Android 14.
3025 - [Bumped the minimum LLVM to 3.9][45326]
3026
3027 [44042]: https://github.com/rust-lang/rust/pull/44042
3028 [44932]: https://github.com/rust-lang/rust/pull/44932
3029 [45267]: https://github.com/rust-lang/rust/pull/45267
3030 [45324]: https://github.com/rust-lang/rust/pull/45324
3031 [45326]: https://github.com/rust-lang/rust/pull/45326
3032 [45333]: https://github.com/rust-lang/rust/pull/45333
3033 [45379]: https://github.com/rust-lang/rust/pull/45379
3034 [45380]: https://github.com/rust-lang/rust/pull/45380
3035 [45393]: https://github.com/rust-lang/rust/pull/45393
3036 [45435]: https://github.com/rust-lang/rust/pull/45435
3037 [45483]: https://github.com/rust-lang/rust/pull/45483
3038 [45524]: https://github.com/rust-lang/rust/pull/45524
3039 [45571]: https://github.com/rust-lang/rust/pull/45571
3040 [45580]: https://github.com/rust-lang/rust/pull/45580
3041 [45610]: https://github.com/rust-lang/rust/pull/45610
3042 [45660]: https://github.com/rust-lang/rust/pull/45660
3043 [45692]: https://github.com/rust-lang/rust/pull/45692
3044 [45711]: https://github.com/rust-lang/rust/pull/45711
3045 [45772]: https://github.com/rust-lang/rust/pull/45772
3046 [45852]: https://github.com/rust-lang/rust/issues/45852
3047 [45853]: https://github.com/rust-lang/rust/pull/45853
3048 [45887]: https://github.com/rust-lang/rust/pull/45887
3049 [45920]: https://github.com/rust-lang/rust/pull/45920
3050 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3051 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3052 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3053
3054
3055 Version 1.22.1 (2017-11-22)
3056 ==========================
3057
3058 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3059
3060 [46183]: https://github.com/rust-lang/rust/pull/46183
3061
3062 Version 1.22.0 (2017-11-22)
3063 ==========================
3064
3065 Language
3066 --------
3067 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3068 - [Now accepts underscores in unicode escapes][43716]
3069 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3070 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3071
3072 Compiler
3073 --------
3074 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3075 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3076   This should decrease compile times for debug builds.
3077 - [strict memory alignment now enabled on ARMv6][45094]
3078 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3079
3080 Libraries
3081 ---------
3082 - [Allow atomic operations up to 32 bits
3083   on `armv5te_unknown_linux_gnueabi`][44978]
3084 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3085 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3086 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3087 - [Properly detect overflow in `Instant += Duration`.][44220]
3088 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3089 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3090 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3091
3092 Stabilized APIs
3093 ---------------
3094
3095 Cargo
3096 -----
3097 - [Cargo will now build multi file examples in subdirectories of the `examples`
3098   folder that have a `main.rs` file.][cargo/4496]
3099 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3100   the old format will continue to work and can be updated with `cargo update`.
3101 - [Now supports vendoring git repositories][cargo/3992]
3102
3103 Misc
3104 ----
3105 - [`libbacktrace` is now available on Apple platforms.][44251]
3106 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3107   This now lets you specify that a given code example will fail to compile.
3108
3109 Compatibility Notes
3110 -------------------
3111 - [The minimum Android version that rustc can build for has been bumped
3112   to `4.0` from `2.3`][45656]
3113 - [Allowing `T op= &T` for numeric types has broken some type
3114   inference cases][45480]
3115
3116
3117 [42526]: https://github.com/rust-lang/rust/pull/42526
3118 [43017]: https://github.com/rust-lang/rust/pull/43017
3119 [43716]: https://github.com/rust-lang/rust/pull/43716
3120 [43949]: https://github.com/rust-lang/rust/pull/43949
3121 [44015]: https://github.com/rust-lang/rust/pull/44015
3122 [44220]: https://github.com/rust-lang/rust/pull/44220
3123 [44251]: https://github.com/rust-lang/rust/pull/44251
3124 [44287]: https://github.com/rust-lang/rust/pull/44287
3125 [44303]: https://github.com/rust-lang/rust/pull/44303
3126 [44456]: https://github.com/rust-lang/rust/pull/44456
3127 [44466]: https://github.com/rust-lang/rust/pull/44466
3128 [44895]: https://github.com/rust-lang/rust/pull/44895
3129 [44966]: https://github.com/rust-lang/rust/pull/44966
3130 [44978]: https://github.com/rust-lang/rust/pull/44978
3131 [45041]: https://github.com/rust-lang/rust/pull/45041
3132 [45064]: https://github.com/rust-lang/rust/pull/45064
3133 [45075]: https://github.com/rust-lang/rust/pull/45075
3134 [45094]: https://github.com/rust-lang/rust/pull/45094
3135 [45095]: https://github.com/rust-lang/rust/pull/45095
3136 [45480]: https://github.com/rust-lang/rust/issues/45480
3137 [45656]: https://github.com/rust-lang/rust/pull/45656
3138 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3139 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3140 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3141
3142
3143
3144
3145
3146
3147 Version 1.21.0 (2017-10-12)
3148 ==========================
3149
3150 Language
3151 --------
3152 - [You can now use static references for literals.][43838]
3153   Example:
3154   ```rust
3155   fn main() {
3156       let x: &'static u32 = &0;
3157   }
3158   ```
3159 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3160   Example:
3161   ```rust
3162   my_macro!(Vec<i32>::new); // Always worked
3163   my_macro!(Vec::<i32>::new); // Now works
3164   ```
3165
3166 Compiler
3167 --------
3168 - [Upgraded jemalloc to 4.5.0][43911]
3169 - [Enabled unwinding panics on Redox][43917]
3170 - [Now runs LLVM in parallel during translation phase.][43506]
3171   This should reduce peak memory usage.
3172
3173 Libraries
3174 ---------
3175 - [Generate builtin impls for `Clone` for all arrays and tuples that
3176   are `T: Clone`][43690]
3177 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3178 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3179   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3180
3181 Stabilized APIs
3182 ---------------
3183
3184 [`std::mem::discriminant`]
3185
3186 Cargo
3187 -----
3188 - [You can now call `cargo install` with multiple package names][cargo/4216]
3189 - [Cargo commands inside a virtual workspace will now implicitly
3190   pass `--all`][cargo/4335]
3191 - [Added a `[patch]` section to `Cargo.toml` to handle
3192   prepublication dependencies][cargo/4123] [RFC 1969]
3193 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3194   like patterns][cargo/4270]
3195 - [Added the `--all-targets` option][cargo/4400]
3196 - [Using required dependencies as a feature is now deprecated and emits
3197   a warning][cargo/4364]
3198
3199
3200 Misc
3201 ----
3202 - [Cargo docs are moving][43916]
3203   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3204 - [The rustdoc book is now available][43863]
3205   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3206 - [Added a preview of RLS has been made available through rustup][44204]
3207   Install with `rustup component add rls-preview`
3208 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3209   Previously only showed `std::os::unix`.
3210
3211 Compatibility Notes
3212 -------------------
3213 - [Changes in method matching against higher-ranked types][43880] This may cause
3214   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3215 - [rustc's JSON error output's byte position start at top of file.][42973]
3216   Was previously relative to the rustc's internal `CodeMap` struct which
3217   required the unstable library `libsyntax` to correctly use.
3218 - [`unused_results` lint no longer ignores booleans][43728]
3219
3220 [42565]: https://github.com/rust-lang/rust/pull/42565
3221 [42973]: https://github.com/rust-lang/rust/pull/42973
3222 [43348]: https://github.com/rust-lang/rust/pull/43348
3223 [43459]: https://github.com/rust-lang/rust/pull/43459
3224 [43506]: https://github.com/rust-lang/rust/pull/43506
3225 [43540]: https://github.com/rust-lang/rust/pull/43540
3226 [43690]: https://github.com/rust-lang/rust/pull/43690
3227 [43728]: https://github.com/rust-lang/rust/pull/43728
3228 [43838]: https://github.com/rust-lang/rust/pull/43838
3229 [43863]: https://github.com/rust-lang/rust/pull/43863
3230 [43880]: https://github.com/rust-lang/rust/pull/43880
3231 [43911]: https://github.com/rust-lang/rust/pull/43911
3232 [43916]: https://github.com/rust-lang/rust/pull/43916
3233 [43917]: https://github.com/rust-lang/rust/pull/43917
3234 [44204]: https://github.com/rust-lang/rust/pull/44204
3235 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3236 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3237 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3238 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3239 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3240 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3241 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3242 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3243 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3244
3245 Version 1.20.0 (2017-08-31)
3246 ===========================
3247
3248 Language
3249 --------
3250 - [Associated constants are now stabilised.][42809]
3251 - [A lot of macro bugs are now fixed.][42913]
3252
3253 Compiler
3254 --------
3255
3256 - [Struct fields are now properly coerced to the expected field type.][42807]
3257 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3258   `wasm32-experimental-emscripten` target.
3259 - [Changed some of the error messages to be more helpful.][42033]
3260 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3261   it.][43170]
3262 - [rustc now reports the total number of errors on compilation failure][43015]
3263   previously this was only the number of errors in the pass that failed.
3264 - [Expansion in rustc has been sped up 29x.][42533]
3265 - [added `msp430-none-elf` target.][43099]
3266 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3267   applicable][43178]
3268 - [Fixes backtraces on Redox][43228]
3269 - [rustc now identifies different versions of same crate when absolute paths of
3270   different types match in an error message.][42826]
3271
3272 Libraries
3273 ---------
3274
3275
3276 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3277 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3278   tuples.][43011]
3279 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3280   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3281 - [Impl `Clone` for `DefaultHasher`.][42799]
3282 - [Impl `Sync` for `SyncSender`.][42397]
3283 - [Impl `FromStr` for `char`][42271]
3284 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3285   NaN.][42431]
3286 - [allow messages in the `unimplemented!()` macro.][42155]
3287   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3288 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3289 - [Upgrade to Unicode 10.0.0][42999]
3290 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3291 - [Skip the main thread's manual stack guard on Linux][43072]
3292 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3293 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3294   previously 2^15.
3295 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3296
3297 Stabilized APIs
3298 ---------------
3299
3300 - [`CStr::into_c_string`]
3301 - [`CString::as_c_str`]
3302 - [`CString::into_boxed_c_str`]
3303 - [`Chain::get_mut`]
3304 - [`Chain::get_ref`]
3305 - [`Chain::into_inner`]
3306 - [`Option::get_or_insert_with`]
3307 - [`Option::get_or_insert`]
3308 - [`OsStr::into_os_string`]
3309 - [`OsString::into_boxed_os_str`]
3310 - [`Take::get_mut`]
3311 - [`Take::get_ref`]
3312 - [`Utf8Error::error_len`]
3313 - [`char::EscapeDebug`]
3314 - [`char::escape_debug`]
3315 - [`compile_error!`]
3316 - [`f32::from_bits`]
3317 - [`f32::to_bits`]
3318 - [`f64::from_bits`]
3319 - [`f64::to_bits`]
3320 - [`mem::ManuallyDrop`]
3321 - [`slice::sort_unstable_by_key`]
3322 - [`slice::sort_unstable_by`]
3323 - [`slice::sort_unstable`]
3324 - [`str::from_boxed_utf8_unchecked`]
3325 - [`str::as_bytes_mut`]
3326 - [`str::as_bytes_mut`]
3327 - [`str::from_utf8_mut`]
3328 - [`str::from_utf8_unchecked_mut`]
3329 - [`str::get_mut`]
3330 - [`str::get_unchecked_mut`]
3331 - [`str::get_unchecked`]
3332 - [`str::get`]
3333 - [`str::into_boxed_bytes`]
3334
3335
3336 Cargo
3337 -----
3338 - [Cargo API token location moved from `~/.cargo/config` to
3339   `~/.cargo/credentials`.][cargo/3978]
3340 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3341   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3342   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3343 - [You can now specify version of a binary when installed through
3344   `cargo install` using `--vers`.][cargo/4229]
3345 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3346   failure.][cargo/4248]
3347 - [Changed the convention around which file is the crate root.][cargo/4259]
3348 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3349   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3350
3351 Compatibility Notes
3352 -------------------
3353
3354 - [Functions with `'static` in their return types will now not be as usable as
3355   if they were using lifetime parameters instead.][42417]
3356 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3357   takes the sign of NaN into account where previously didn't.][42430]
3358
3359 [42033]: https://github.com/rust-lang/rust/pull/42033
3360 [42155]: https://github.com/rust-lang/rust/pull/42155
3361 [42271]: https://github.com/rust-lang/rust/pull/42271
3362 [42397]: https://github.com/rust-lang/rust/pull/42397
3363 [42417]: https://github.com/rust-lang/rust/pull/42417
3364 [42430]: https://github.com/rust-lang/rust/pull/42430
3365 [42431]: https://github.com/rust-lang/rust/pull/42431
3366 [42533]: https://github.com/rust-lang/rust/pull/42533
3367 [42571]: https://github.com/rust-lang/rust/pull/42571
3368 [42613]: https://github.com/rust-lang/rust/pull/42613
3369 [42799]: https://github.com/rust-lang/rust/pull/42799
3370 [42807]: https://github.com/rust-lang/rust/pull/42807
3371 [42809]: https://github.com/rust-lang/rust/pull/42809
3372 [42822]: https://github.com/rust-lang/rust/pull/42822
3373 [42826]: https://github.com/rust-lang/rust/pull/42826
3374 [42854]: https://github.com/rust-lang/rust/pull/42854
3375 [42913]: https://github.com/rust-lang/rust/pull/42913
3376 [42999]: https://github.com/rust-lang/rust/pull/42999
3377 [43011]: https://github.com/rust-lang/rust/pull/43011
3378 [43015]: https://github.com/rust-lang/rust/pull/43015
3379 [43072]: https://github.com/rust-lang/rust/pull/43072
3380 [43077]: https://github.com/rust-lang/rust/pull/43077
3381 [43097]: https://github.com/rust-lang/rust/pull/43097
3382 [43099]: https://github.com/rust-lang/rust/pull/43099
3383 [43170]: https://github.com/rust-lang/rust/pull/43170
3384 [43178]: https://github.com/rust-lang/rust/pull/43178
3385 [43185]: https://github.com/rust-lang/rust/pull/43185
3386 [43228]: https://github.com/rust-lang/rust/pull/43228
3387 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3388 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3389 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3390 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3391 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3392 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3393 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3394 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3395 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3396 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3397 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3398 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3399 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3400 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3401 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3402 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3403 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3404 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3405 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3406 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3407 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3408 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3409 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3410 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3411 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3412 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3413 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3414 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3415 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3416 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3417 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3418 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3419 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3420 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3421 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3422 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3423 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3424 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3425 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3426
3427
3428 Version 1.19.0 (2017-07-20)
3429 ===========================
3430
3431 Language
3432 --------
3433
3434 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3435   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3436 - [Macro recursion limit increased to 1024 from 64.][41676]
3437 - [Added lint for detecting unused macros.][41907]
3438 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3439   For example: `let x = loop { break 7; };`
3440 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3441   contain `Copy` types and cannot have a `Drop` implementation.
3442   Example: `union Foo { bar: u8, baz: usize }`
3443 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3444   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3445
3446 Compiler
3447 --------
3448
3449 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3450 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3451   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3452   you should use `--target armv7-linux-androideabi`.
3453 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3454 - [Minor optimisation of string operations.][42037]
3455 - [Compiler error message is now `aborting due to previous error(s)` instead of
3456   `aborting due to N previous errors`][42150] This was previously inaccurate and
3457   would only count certain kinds of errors.
3458 - [The compiler now supports Visual Studio 2017][42225]
3459 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3460 - [Added a lot][42264] of [new error codes][42302]
3461 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3462   libraries with C Run-time Libraries(CRT) to be statically linked.
3463 - [Fixed various ARM codegen bugs][42740]
3464
3465 Libraries
3466 ---------
3467
3468 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3469   `Extend<Cow<'a, str>>`][41449]
3470 - [`Vec` now implements `From<&mut [T]>`][41530]
3471 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3472 - [`SplitWhitespace` now implements `Clone`][41659]
3473 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3474   1.5x faster][41764]
3475 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3476   macros, but for printing to stderr.
3477
3478 Stabilized APIs
3479 ---------------
3480
3481 - [`OsString::shrink_to_fit`]
3482 - [`cmp::Reverse`]
3483 - [`Command::envs`]
3484 - [`thread::ThreadId`]
3485
3486 Cargo
3487 -----
3488
3489 - [Build scripts can now add environment variables to the environment
3490   the crate is being compiled in.
3491   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3492 - [Subcommands now replace the current process rather than spawning a new
3493   child process][cargo/3970]
3494 - [Workspace members can now accept glob file patterns][cargo/3979]
3495 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3496   the members in a given workspace.][cargo/3988]
3497 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3498 - [Target directory path is now in the cargo metadata][cargo/4022]
3499 - [Cargo no longer checks out a local working directory for the
3500   crates.io index][cargo/4026] This should provide smaller file size for the
3501   registry, and improve cloning times, especially on Windows machines.
3502 - [Added an `--exclude` option for excluding certain packages when using the
3503   `--all` option][cargo/4031]
3504 - [Cargo will now automatically retry when receiving a 5xx error
3505   from crates.io][cargo/4032]
3506 - [The `--features` option now accepts multiple comma or space
3507   delimited values.][cargo/4084]
3508 - [Added support for custom target specific runners][cargo/3954]
3509
3510 Misc
3511 ----
3512
3513 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3514   Windows Debugger.
3515 - [Rust will now release XZ compressed packages][rust-installer/57]
3516 - [rustup will now prefer to download rust packages with
3517   XZ compression][rustup/1100] over GZip packages.
3518 - [Added the ability to escape `#` in rust documentation][41785] By adding
3519   additional `#`'s ie. `##` is now `#`
3520
3521 Compatibility Notes
3522 -------------------
3523
3524 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3525 - [`-Z` flags are now no longer allowed to be used on the stable
3526   compiler.][41751] This has been a warning for a year previous to this.
3527 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3528   longer works][42844]. Users should migrate to the built-in `check`
3529   command, which has been available since 1.16.
3530 - [Ending a float literal with `._` is now a hard error.
3531   Example: `42._` .][41946]
3532 - [Any use of a private `extern crate` outside of its module is now a
3533   hard error.][36886] This was previously a warning.
3534 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3535   relative while the `::` prefix makes a path absolute, but was ignored and the
3536   path was relative regardless.
3537 - [Floating point constants in match patterns is now a hard error][36890]
3538   This was previously a warning.
3539 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3540   match patterns is now a hard error][36891] This was previously a warning.
3541 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3542   a warning.
3543 - [From the pound escape, lines consisting of multiple `#`s are
3544   now visible][41785]
3545 - [It is an error to re-export private enum variants][42460]. This is
3546   known to break a number of crates that depend on an older version of
3547   mustache.
3548 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3549   to use it to find the linker, and the build will fail where it did
3550   not previously][42607]
3551
3552 [36886]: https://github.com/rust-lang/rust/issues/36886
3553 [36888]: https://github.com/rust-lang/rust/issues/36888
3554 [36890]: https://github.com/rust-lang/rust/issues/36890
3555 [36891]: https://github.com/rust-lang/rust/issues/36891
3556 [36892]: https://github.com/rust-lang/rust/issues/36892
3557 [37406]: https://github.com/rust-lang/rust/issues/37406
3558 [39983]: https://github.com/rust-lang/rust/pull/39983
3559 [41145]: https://github.com/rust-lang/rust/pull/41145
3560 [41192]: https://github.com/rust-lang/rust/pull/41192
3561 [41258]: https://github.com/rust-lang/rust/pull/41258
3562 [41370]: https://github.com/rust-lang/rust/pull/41370
3563 [41449]: https://github.com/rust-lang/rust/pull/41449
3564 [41530]: https://github.com/rust-lang/rust/pull/41530
3565 [41624]: https://github.com/rust-lang/rust/pull/41624
3566 [41656]: https://github.com/rust-lang/rust/pull/41656
3567 [41659]: https://github.com/rust-lang/rust/pull/41659
3568 [41676]: https://github.com/rust-lang/rust/pull/41676
3569 [41751]: https://github.com/rust-lang/rust/pull/41751
3570 [41764]: https://github.com/rust-lang/rust/pull/41764
3571 [41785]: https://github.com/rust-lang/rust/pull/41785
3572 [41873]: https://github.com/rust-lang/rust/pull/41873
3573 [41907]: https://github.com/rust-lang/rust/pull/41907
3574 [41946]: https://github.com/rust-lang/rust/pull/41946
3575 [42016]: https://github.com/rust-lang/rust/pull/42016
3576 [42037]: https://github.com/rust-lang/rust/pull/42037
3577 [42068]: https://github.com/rust-lang/rust/pull/42068
3578 [42150]: https://github.com/rust-lang/rust/pull/42150
3579 [42162]: https://github.com/rust-lang/rust/pull/42162
3580 [42225]: https://github.com/rust-lang/rust/pull/42225
3581 [42264]: https://github.com/rust-lang/rust/pull/42264
3582 [42302]: https://github.com/rust-lang/rust/pull/42302
3583 [42460]: https://github.com/rust-lang/rust/issues/42460
3584 [42607]: https://github.com/rust-lang/rust/issues/42607
3585 [42740]: https://github.com/rust-lang/rust/pull/42740
3586 [42844]: https://github.com/rust-lang/rust/issues/42844
3587 [42948]: https://github.com/rust-lang/rust/pull/42948
3588 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3589 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3590 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3591 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3592 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3593 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3594 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3595 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3596 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3597 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3598 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3599 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3600 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3601 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3602 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3603 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3604 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3605 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3606 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3607 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3608 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3609 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3610
3611
3612 Version 1.18.0 (2017-06-08)
3613 ===========================
3614
3615 Language
3616 --------
3617
3618 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3619   make the item visible to just that module tree. Also accepts the keyword
3620   `crate` to make something public to the whole crate but not users of the
3621   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3622 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3623   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3624 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3625   types like `Write + Send`, trailing `+` are now supported in trait objects,
3626   and better error reporting for trait objects starting with `?Sized`.
3627 - [0e+10 is now a valid floating point literal][40589]
3628 - [Now warns if you bind a lifetime parameter to 'static][40734]
3629 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3630   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3631   representation in some cases.][40377]
3632
3633 Compiler
3634 --------
3635
3636 - [rustc can now emit mir with `--emit mir`][39891]
3637 - [Improved LLVM IR for trivial functions][40367]
3638 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3639 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3640   opportunities found through profiling
3641 - [Improved backtrace formatting when panicking][38165]
3642
3643 Libraries
3644 ---------
3645
3646 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3647   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3648   iteration or reallocation.
3649 - [Simplified HashMap Bucket interface][40561] provides performance
3650   improvements for iterating and cloning.
3651 - [Specialize Vec::from_elem to use calloc][40409]
3652 - [Fixed Race condition in fs::create_dir_all][39799]
3653 - [No longer caching stdio on Windows][40516]
3654 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3655   2.50%~ faster and in one case now 12.50% faster.
3656 - [Optimized `AtomicBool::fetch_nand`][41143]
3657
3658 Stabilized APIs
3659 ---------------
3660
3661 - [`Child::try_wait`]
3662 - [`HashMap::retain`]
3663 - [`HashSet::retain`]
3664 - [`PeekMut::pop`]
3665 - [`TcpStream::peek`]
3666 - [`UdpSocket::peek`]
3667 - [`UdpSocket::peek_from`]
3668
3669 Cargo
3670 -----
3671
3672 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3673   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3674 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3675 - [Added Android build support][cargo/3885]
3676 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3677   of a certain type, for example `cargo build --bins` will build all
3678   binaries.
3679 - [Added support for haiku][cargo/3952]
3680
3681 Misc
3682 ----
3683
3684 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3685 - [Added rust-windbg script for better debugging on Windows][39983]
3686 - [Rust now uses the official cross compiler for NetBSD][40612]
3687 - [rustdoc now accepts `#` at the start of files][40828]
3688 - [Fixed jemalloc support for musl][41168]
3689
3690 Compatibility Notes
3691 -------------------
3692
3693 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3694   always placed after the sign if it exists and before the digits. With the `#`
3695   flag the zeroes are placed after the prefix and before the digits.
3696 - [Due to the struct field optimisation][40377], using `transmute` on structs
3697   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3698   always been undefined behavior, but is now more likely to break in practice.
3699 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3700   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3701   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3702 - [Overlapping inherent `impl`s are now a hard error][40728]
3703 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3704 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3705   `out.asm` and `out.ll` instead of only one of the filetypes.
3706 - [ calling a function that returns `Self` will no longer work][41805] when
3707   the size of `Self` cannot be statically determined.
3708 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3709   this has caused a few regressions namely:
3710
3711   - Changed the link order of local static/dynamic libraries (respecting the
3712     order on given rather than having the compiler reorder).
3713   - Changed how MinGW is linked, native code linked to dynamic libraries
3714     may require manually linking to the gcc support library (for the native
3715     code itself)
3716
3717 [38165]: https://github.com/rust-lang/rust/pull/38165
3718 [39799]: https://github.com/rust-lang/rust/pull/39799
3719 [39891]: https://github.com/rust-lang/rust/pull/39891
3720 [39983]: https://github.com/rust-lang/rust/pull/39983
3721 [40043]: https://github.com/rust-lang/rust/pull/40043
3722 [40241]: https://github.com/rust-lang/rust/pull/40241
3723 [40338]: https://github.com/rust-lang/rust/pull/40338
3724 [40367]: https://github.com/rust-lang/rust/pull/40367
3725 [40377]: https://github.com/rust-lang/rust/pull/40377
3726 [40409]: https://github.com/rust-lang/rust/pull/40409
3727 [40516]: https://github.com/rust-lang/rust/pull/40516
3728 [40556]: https://github.com/rust-lang/rust/pull/40556
3729 [40561]: https://github.com/rust-lang/rust/pull/40561
3730 [40589]: https://github.com/rust-lang/rust/pull/40589
3731 [40612]: https://github.com/rust-lang/rust/pull/40612
3732 [40723]: https://github.com/rust-lang/rust/pull/40723
3733 [40728]: https://github.com/rust-lang/rust/pull/40728
3734 [40731]: https://github.com/rust-lang/rust/pull/40731
3735 [40734]: https://github.com/rust-lang/rust/pull/40734
3736 [40805]: https://github.com/rust-lang/rust/pull/40805
3737 [40807]: https://github.com/rust-lang/rust/pull/40807
3738 [40828]: https://github.com/rust-lang/rust/pull/40828
3739 [40870]: https://github.com/rust-lang/rust/pull/40870
3740 [41085]: https://github.com/rust-lang/rust/pull/41085
3741 [41143]: https://github.com/rust-lang/rust/pull/41143
3742 [41168]: https://github.com/rust-lang/rust/pull/41168
3743 [41270]: https://github.com/rust-lang/rust/issues/41270
3744 [41469]: https://github.com/rust-lang/rust/pull/41469
3745 [41805]: https://github.com/rust-lang/rust/issues/41805
3746 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3747 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3748 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3749 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3750 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3751 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3752 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3753 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3754 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3755 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3756 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3757 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3758 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3759 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3760
3761
3762 Version 1.17.0 (2017-04-27)
3763 ===========================
3764
3765 Language
3766 --------
3767
3768 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3769 * [Fields of structs may be initialized without duplicating the field/variable
3770   names][39761]. [RFC 1682]
3771 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3772 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3773   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3774   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3775   `'b`. Soundness fix.
3776 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3777 * [Static variables may contain references to other statics][40027]
3778
3779 Compiler
3780 --------
3781
3782 * [Exit quickly on only `--emit dep-info`][40336]
3783 * [Make `-C relocation-model` more correctly determine whether the linker
3784   creates a position-independent executable][40245]
3785 * [Add `-C overflow-checks` to directly control whether integer overflow
3786   panics][40037]
3787 * [The rustc type checker now checks items on demand instead of in a single
3788   in-order pass][40008]. This is mostly an internal refactoring in support of
3789   future work, including incremental type checking, but also resolves [RFC
3790   1647], allowing `Self` to appear in `impl` `where` clauses.
3791 * [Optimize vtable loads][39995]
3792 * [Turn off vectorization for Emscripten targets][39990]
3793 * [Provide suggestions for unknown macros imported with `use`][39953]
3794 * [Fix ICEs in path resolution][39939]
3795 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3796 * [Add clearer error message using `&str + &str`][39116]
3797
3798 Stabilized APIs
3799 ---------------
3800
3801 * [`Arc::into_raw`]
3802 * [`Arc::from_raw`]
3803 * [`Arc::ptr_eq`]
3804 * [`Rc::into_raw`]
3805 * [`Rc::from_raw`]
3806 * [`Rc::ptr_eq`]
3807 * [`Ordering::then`]
3808 * [`Ordering::then_with`]
3809 * [`BTreeMap::range`]
3810 * [`BTreeMap::range_mut`]
3811 * [`collections::Bound`]
3812 * [`process::abort`]
3813 * [`ptr::read_unaligned`]
3814 * [`ptr::write_unaligned`]
3815 * [`Result::expect_err`]
3816 * [`Cell::swap`]
3817 * [`Cell::replace`]
3818 * [`Cell::into_inner`]
3819 * [`Cell::take`]
3820
3821 Libraries
3822 ---------
3823
3824 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3825 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3826 * [`String` implements `FromIterator<&char>`][40028]
3827 * `Box` [implements][40009] a number of new conversions:
3828   `From<Box<str>> for String`,
3829   `From<Box<[T]>> for Vec<T>`,
3830   `From<Box<CStr>> for CString`,
3831   `From<Box<OsStr>> for OsString`,
3832   `From<Box<Path>> for PathBuf`,
3833   `Into<Box<str>> for String`,
3834   `Into<Box<[T]>> for Vec<T>`,
3835   `Into<Box<CStr>> for CString`,
3836   `Into<Box<OsStr>> for OsString`,
3837   `Into<Box<Path>> for PathBuf`,
3838   `Default for Box<str>`,
3839   `Default for Box<CStr>`,
3840   `Default for Box<OsStr>`,
3841   `From<&CStr> for Box<CStr>`,
3842   `From<&OsStr> for Box<OsStr>`,
3843   `From<&Path> for Box<Path>`
3844 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3845 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3846 * [Slightly optimize `slice::sort`][39538]
3847 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3848 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3849   `Box<str>` implements `From<&str>`][39438]
3850 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3851   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3852 * [`format!` estimates the needed capacity before writing a string][39356]
3853 * [Support unprivileged symlink creation in Windows][38921]
3854 * [`PathBuf` implements `Default`][38764]
3855 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3856 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3857   and poor hash functions.
3858
3859 Cargo
3860 -----
3861
3862 * [Add `cargo check --all`][cargo/3731]
3863 * [Add an option to ignore SSL revocation checking][cargo/3699]
3864 * [Add `cargo run --package`][cargo/3691]
3865 * [Add `required_features`][cargo/3667]
3866 * [Assume `build.rs` is a build script][cargo/3664]
3867 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3868
3869 Misc
3870 ----
3871
3872 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3873   `rustbook`][39633]
3874 * [The "Unstable Book" documents nightly-only features][ubook]
3875 * [Improve the style of the sidebar in rustdoc output][40265]
3876 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3877 * [Fix MSP430 breakage due to `i128`][40257]
3878 * [Preliminary Solaris/SPARCv9 support][39903]
3879 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3880   run without installing the MSVC runtime.
3881 * [`rustdoc --test` includes file names in test names][39788]
3882 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3883   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3884 * [Initial support for `aarch64-unknown-freebsd`][39491]
3885 * [Initial support for `i686-unknown-netbsd`][39426]
3886 * [This release no longer includes the old makefile build system][39431]. Rust
3887   is built with a custom build system, written in Rust, and with Cargo.
3888 * [Add Debug implementations for libcollection structs][39002]
3889 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3890 * [`--test-threads=0` produces an error][38945]
3891 * [`rustup` installs documentation by default][40526]
3892 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3893   WinDbg and Visual Studio to improve the debugging experience.
3894
3895 Compatibility Notes
3896 -------------------
3897
3898 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3899   workaround, either use MSVC 2015 or run vcvars.bat.
3900 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3901   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3902   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3903   fix.
3904 * [`format!` and `Display::to_string` panic if an underlying formatting
3905   implementation returns an error][40117]. Previously the error was silently
3906   ignored. It is incorrect for `write_fmt` to return an error when writing
3907   to a string.
3908 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3909   crates were marked stable and could be accessed from the stable toolchain.
3910 * [Rust git source no longer includes vendored crates][39728]. Those that need
3911   to build with vendored crates should build from release tarballs.
3912 * [Fix inert attributes from `proc_macro_derives`][39572]
3913 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3914   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3915   build system.
3916 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3917   existing code generally ignores the type of dead-code unless a type-hint is
3918   provided; this can cause surprising inference interactions particularly around
3919   defaulting. The new code uniformly ignores the result type of dead-code.
3920 * [Tuple-struct constructors with private fields are no longer visible][38932]
3921 * [Lifetime parameters that do not appear in the arguments are now considered
3922   early-bound][38897], resolving a soundness bug (#[32330]). The
3923   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3924   April of 2016.
3925 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3926 * [Make transmuting from fn item types to pointer-sized types a hard
3927   error][34198]
3928
3929 [27787]: https://github.com/rust-lang/rust/issues/27787
3930 [32330]: https://github.com/rust-lang/rust/issues/32330
3931 [34198]: https://github.com/rust-lang/rust/pull/34198
3932 [38161]: https://github.com/rust-lang/rust/pull/38161
3933 [38368]: https://github.com/rust-lang/rust/pull/38368
3934 [38584]: https://github.com/rust-lang/rust/issues/38584
3935 [38661]: https://github.com/rust-lang/rust/pull/38661
3936 [38764]: https://github.com/rust-lang/rust/pull/38764
3937 [38864]: https://github.com/rust-lang/rust/issues/38864
3938 [38897]: https://github.com/rust-lang/rust/pull/38897
3939 [38921]: https://github.com/rust-lang/rust/pull/38921
3940 [38932]: https://github.com/rust-lang/rust/pull/38932
3941 [38945]: https://github.com/rust-lang/rust/pull/38945
3942 [38981]: https://github.com/rust-lang/rust/pull/38981
3943 [39002]: https://github.com/rust-lang/rust/pull/39002
3944 [39116]: https://github.com/rust-lang/rust/pull/39116
3945 [39193]: https://github.com/rust-lang/rust/pull/39193
3946 [39265]: https://github.com/rust-lang/rust/pull/39265
3947 [39356]: https://github.com/rust-lang/rust/pull/39356
3948 [39372]: https://github.com/rust-lang/rust/pull/39372
3949 [39426]: https://github.com/rust-lang/rust/pull/39426
3950 [39431]: https://github.com/rust-lang/rust/pull/39431
3951 [39438]: https://github.com/rust-lang/rust/pull/39438
3952 [39440]: https://github.com/rust-lang/rust/pull/39440
3953 [39485]: https://github.com/rust-lang/rust/pull/39485
3954 [39491]: https://github.com/rust-lang/rust/pull/39491
3955 [39518]: https://github.com/rust-lang/rust/pull/39518
3956 [39538]: https://github.com/rust-lang/rust/pull/39538
3957 [39572]: https://github.com/rust-lang/rust/pull/39572
3958 [39633]: https://github.com/rust-lang/rust/pull/39633
3959 [39642]: https://github.com/rust-lang/rust/pull/39642
3960 [39728]: https://github.com/rust-lang/rust/pull/39728
3961 [39761]: https://github.com/rust-lang/rust/pull/39761
3962 [39788]: https://github.com/rust-lang/rust/pull/39788
3963 [39793]: https://github.com/rust-lang/rust/pull/39793
3964 [39837]: https://github.com/rust-lang/rust/pull/39837
3965 [39843]: https://github.com/rust-lang/rust/pull/39843
3966 [39851]: https://github.com/rust-lang/rust/pull/39851
3967 [39903]: https://github.com/rust-lang/rust/pull/39903
3968 [39939]: https://github.com/rust-lang/rust/pull/39939
3969 [39953]: https://github.com/rust-lang/rust/pull/39953
3970 [39960]: https://github.com/rust-lang/rust/pull/39960
3971 [39990]: https://github.com/rust-lang/rust/pull/39990
3972 [39995]: https://github.com/rust-lang/rust/pull/39995
3973 [40008]: https://github.com/rust-lang/rust/pull/40008
3974 [40009]: https://github.com/rust-lang/rust/pull/40009
3975 [40027]: https://github.com/rust-lang/rust/pull/40027
3976 [40028]: https://github.com/rust-lang/rust/pull/40028
3977 [40037]: https://github.com/rust-lang/rust/pull/40037
3978 [40117]: https://github.com/rust-lang/rust/pull/40117
3979 [40166]: https://github.com/rust-lang/rust/pull/40166
3980 [40245]: https://github.com/rust-lang/rust/pull/40245
3981 [40257]: https://github.com/rust-lang/rust/pull/40257
3982 [40261]: https://github.com/rust-lang/rust/pull/40261
3983 [40265]: https://github.com/rust-lang/rust/pull/40265
3984 [40319]: https://github.com/rust-lang/rust/pull/40319
3985 [40336]: https://github.com/rust-lang/rust/pull/40336
3986 [40526]: https://github.com/rust-lang/rust/pull/40526
3987 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3988 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
3989 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
3990 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
3991 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
3992 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
3993 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
3994 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
3995 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
3996 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
3997 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
3998 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
3999 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4000 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4001 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4002 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4003 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4004 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4005 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4006 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4007 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4008 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4009 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4010 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4011 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4012 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4013 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4014 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4015 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4016 [mdbook]: https://crates.io/crates/mdbook
4017 [ubook]: https://doc.rust-lang.org/unstable-book/
4018
4019
4020 Version 1.16.0 (2017-03-16)
4021 ===========================
4022
4023 Language
4024 --------
4025
4026 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4027 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4028   match patterns][38069]
4029 * [Clean up semantics of `self` in an import list][38313]
4030 * [`Self` may appear in `impl` headers][38920]
4031 * [`Self` may appear in struct expressions][39282]
4032
4033 Compiler
4034 --------
4035
4036 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4037   a `.rmeta` file containing only crate metadata][38571]. This can be
4038   used by tools like the Rust Language Service to perform
4039   metadata-only builds.
4040 * [Levenshtein based typo suggestions now work in most places, while
4041   previously they worked only for fields and sometimes for local
4042   variables][38927]. Together with the overhaul of "no
4043   resolution"/"unexpected resolution" errors (#[38154]) they result in
4044   large and systematic improvement in resolution diagnostics.
4045 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4046   `U`][38670]
4047 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4048 * [`rustc` no longer attempts to provide "consider using an explicit
4049   lifetime" suggestions][37057]. They were inaccurate.
4050
4051 Stabilized APIs
4052 ---------------
4053
4054 * [`VecDeque::truncate`]
4055 * [`VecDeque::resize`]
4056 * [`String::insert_str`]
4057 * [`Duration::checked_add`]
4058 * [`Duration::checked_sub`]
4059 * [`Duration::checked_div`]
4060 * [`Duration::checked_mul`]
4061 * [`str::replacen`]
4062 * [`str::repeat`]
4063 * [`SocketAddr::is_ipv4`]
4064 * [`SocketAddr::is_ipv6`]
4065 * [`IpAddr::is_ipv4`]
4066 * [`IpAddr::is_ipv6`]
4067 * [`Vec::dedup_by`]
4068 * [`Vec::dedup_by_key`]
4069 * [`Result::unwrap_or_default`]
4070 * [`<*const T>::wrapping_offset`]
4071 * [`<*mut T>::wrapping_offset`]
4072 * `CommandExt::creation_flags`
4073 * [`File::set_permissions`]
4074 * [`String::split_off`]
4075
4076 Libraries
4077 ---------
4078
4079 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4080   their argument by `Borrow` parameter][37761]
4081 * [All public types in std implement `Debug`][38006]
4082 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4083 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4084 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4085   Windows][38274]
4086 * [std: Fix partial writes in `LineWriter`][38062]
4087 * [std: Clamp max read/write sizes on Unix][38062]
4088 * [Use more specific panic message for `&str` slicing errors][38066]
4089 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4090   functionality cannot be achieved in std currently.
4091 * [`writeln!`, like `println!`, now accepts a form with no string
4092   or formatting arguments, to just print a newline][38469]
4093 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4094 * [Reduce the size of static data in `std_unicode::tables`][38781]
4095 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4096   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4097   `Display`][38909]
4098 * [`Duration` implements `Sum`][38712]
4099 * [`String` implements `ToSocketAddrs`][39048]
4100
4101 Cargo
4102 -----
4103
4104 * [The `cargo check` command does a type check of a project without
4105   building it][cargo/3296]
4106 * [crates.io will display CI badges from Travis and AppVeyor, if
4107   specified in Cargo.toml][cargo/3546]
4108 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4109 * [Compilation profiles accept integer values for `debug`, in addition
4110   to `true` and `false`. These are passed to `rustc` as the value to
4111   `-C debuginfo`][cargo/3534]
4112 * [Implement `cargo --version --verbose`][cargo/3604]
4113 * [All builds now output 'dep-info' build dependencies compatible with
4114   make and ninja][cargo/3557]
4115 * [Build all workspace members with `build --all`][cargo/3511]
4116 * [Document all workspace members with `doc --all`][cargo/3515]
4117 * [Path deps outside workspace are not members][cargo/3443]
4118
4119 Misc
4120 ----
4121
4122 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4123   the path to the Rust implementation][38589]
4124 * [The `armv7-linux-androideabi` target no longer enables NEON
4125   extensions, per Google's ABI guide][38413]
4126 * [The stock standard library can be compiled for Redox OS][38401]
4127 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4128   available.
4129 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4130   builds available.
4131 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4132
4133 Compatibility Notes
4134 -------------------
4135
4136 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4137   match patterns][38069]
4138 * In this release, references to uninhabited types can not be
4139   pattern-matched. This was accidentally allowed in 1.15.
4140 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4141 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4142   Windows][38274]
4143 * [Clean up semantics of `self` in an import list][38313]
4144 * Reimplemented lifetime elision. This change was almost entirely compatible
4145   with existing code, but it did close a number of small bugs and loopholes,
4146   as well as being more accepting in some other [cases][41105].
4147
4148 [37057]: https://github.com/rust-lang/rust/pull/37057
4149 [37761]: https://github.com/rust-lang/rust/pull/37761
4150 [38006]: https://github.com/rust-lang/rust/pull/38006
4151 [38051]: https://github.com/rust-lang/rust/pull/38051
4152 [38062]: https://github.com/rust-lang/rust/pull/38062
4153 [38062]: https://github.com/rust-lang/rust/pull/38622
4154 [38066]: https://github.com/rust-lang/rust/pull/38066
4155 [38069]: https://github.com/rust-lang/rust/pull/38069
4156 [38131]: https://github.com/rust-lang/rust/pull/38131
4157 [38154]: https://github.com/rust-lang/rust/pull/38154
4158 [38274]: https://github.com/rust-lang/rust/pull/38274
4159 [38304]: https://github.com/rust-lang/rust/pull/38304
4160 [38313]: https://github.com/rust-lang/rust/pull/38313
4161 [38314]: https://github.com/rust-lang/rust/pull/38314
4162 [38327]: https://github.com/rust-lang/rust/pull/38327
4163 [38401]: https://github.com/rust-lang/rust/pull/38401
4164 [38413]: https://github.com/rust-lang/rust/pull/38413
4165 [38469]: https://github.com/rust-lang/rust/pull/38469
4166 [38559]: https://github.com/rust-lang/rust/pull/38559
4167 [38571]: https://github.com/rust-lang/rust/pull/38571
4168 [38580]: https://github.com/rust-lang/rust/pull/38580
4169 [38589]: https://github.com/rust-lang/rust/pull/38589
4170 [38670]: https://github.com/rust-lang/rust/pull/38670
4171 [38712]: https://github.com/rust-lang/rust/pull/38712
4172 [38726]: https://github.com/rust-lang/rust/pull/38726
4173 [38781]: https://github.com/rust-lang/rust/pull/38781
4174 [38798]: https://github.com/rust-lang/rust/pull/38798
4175 [38909]: https://github.com/rust-lang/rust/pull/38909
4176 [38920]: https://github.com/rust-lang/rust/pull/38920
4177 [38927]: https://github.com/rust-lang/rust/pull/38927
4178 [39048]: https://github.com/rust-lang/rust/pull/39048
4179 [39282]: https://github.com/rust-lang/rust/pull/39282
4180 [39379]: https://github.com/rust-lang/rust/pull/39379
4181 [41105]: https://github.com/rust-lang/rust/issues/41105
4182 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4183 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4184 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4185 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4186 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4187 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4188 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4189 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4190 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4191 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4192 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4193 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4194 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4195 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4196 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4197 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4198 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4199 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4200 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4201 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4202 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4203 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4204 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4205 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4206 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4207 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4208 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4209 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4210 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4211 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4212
4213
4214 Version 1.15.1 (2017-02-09)
4215 ===========================
4216
4217 * [Fix IntoIter::as_mut_slice's signature][39466]
4218 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4219
4220 [39466]: https://github.com/rust-lang/rust/pull/39466
4221 [39523]: https://github.com/rust-lang/rust/pull/39523
4222
4223
4224 Version 1.15.0 (2017-02-02)
4225 ===========================
4226
4227 Language
4228 --------
4229
4230 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4231   stable. This allows popular code-generating crates like Serde and Diesel to
4232   work ergonomically. [RFC 1681].
4233 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4234   with curly braces][36868]. Part of [RFC 1506].
4235 * [A number of minor changes to name resolution have been activated][37127].
4236   They add up to more consistent semantics, allowing for future evolution of
4237   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4238   details of what is different. The breaking changes here have been transitioned
4239   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4240 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4241   bounds][38279]
4242 * [`?Sized` can be used in `where` clauses][37791]
4243 * [There is now a limit on the size of monomorphized types and it can be
4244   modified with the `#![type_size_limit]` crate attribute, similarly to
4245   the `#![recursion_limit]` attribute][37789]
4246
4247 Compiler
4248 --------
4249
4250 * [On Windows, the compiler will apply dllimport attributes when linking to
4251   extern functions][37973]. Additional attributes and flags can control which
4252   library kind is linked and its name. [RFC 1717].
4253 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4254 * [The `--test` flag works with procedural macro crates][38107]
4255 * [Fix `extern "aapcs" fn` ABI][37814]
4256 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4257 * [The `format!` expander recognizes incorrect `printf` and shell-style
4258   formatting directives and suggests the correct format][37613].
4259 * [Only report one error for all unused imports in an import list][37456]
4260
4261 Compiler Performance
4262 --------------------
4263
4264 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4265 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4266 * [Don't clone in `UnificationTable::probe`][37848]
4267 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4268 * [Use small vectors in type walker][37760]
4269 * [Macro expansion performance was improved][37701]
4270 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4271 * [Replace FNV with a faster hash function][37229]
4272
4273 Stabilized APIs
4274 ---------------
4275
4276 * [`std::iter::Iterator::min_by`]
4277 * [`std::iter::Iterator::max_by`]
4278 * [`std::os::*::fs::FileExt`]
4279 * [`std::sync::atomic::Atomic*::get_mut`]
4280 * [`std::sync::atomic::Atomic*::into_inner`]
4281 * [`std::vec::IntoIter::as_slice`]
4282 * [`std::vec::IntoIter::as_mut_slice`]
4283 * [`std::sync::mpsc::Receiver::try_iter`]
4284 * [`std::os::unix::process::CommandExt::before_exec`]
4285 * [`std::rc::Rc::strong_count`]
4286 * [`std::rc::Rc::weak_count`]
4287 * [`std::sync::Arc::strong_count`]
4288 * [`std::sync::Arc::weak_count`]
4289 * [`std::char::encode_utf8`]
4290 * [`std::char::encode_utf16`]
4291 * [`std::cell::Ref::clone`]
4292 * [`std::io::Take::into_inner`]
4293
4294 Libraries
4295 ---------
4296
4297 * [The standard sorting algorithm has been rewritten for dramatic performance
4298   improvements][38192]. It is a hybrid merge sort, drawing influences from
4299   Timsort. Previously it was a naive merge sort.
4300 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4301 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4302   performance.
4303 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4304   and `char_indices().last()`][37882]
4305 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4306 * [Chinese characters display correctly in `fmt::Debug`][37855]
4307 * [Derive `Default` for `Duration`][37699]
4308 * [Support creation of anonymous pipes on WinXP/2k][37677]
4309 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4310 * [Don't pass overlapped handles to processes][38835]
4311
4312 Cargo
4313 -----
4314
4315 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4316   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4317   should instead check the variable at runtime with `std::env`. That the value
4318   was set at build time was a bug, and incorrect when cross-compiling. This
4319   change is known to cause breakage.
4320 * [Add `--all` flag to `cargo test`][cargo/3221]
4321 * [Compile statically against the MSVC CRT][cargo/3363]
4322 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4323 * [Link OpenSSL statically on OSX][cargo/3311]
4324 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4325 * [Test for bad path overrides with summaries][cargo/3336]
4326 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4327 * [Fix retrying crate downloads for network errors][cargo/3348]
4328 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4329 * [Emit more info on --message-format=json][cargo/3319]
4330 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4331 * [Don't ignore errors in workspace manifest][cargo/3409]
4332 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4333
4334 Tooling
4335 -------
4336
4337 * [Test runners (binaries built with `--test`) now support a `--list` argument
4338   that lists the tests it contains][38185]
4339 * [Test runners now support a `--exact` argument that makes the test filter
4340   match exactly, instead of matching only a substring of the test name][38181]
4341 * [rustdoc supports a `--playground-url` flag][37763]
4342 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4343
4344 Misc
4345 ----
4346
4347 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4348   continue to be used in this release by passing `--disable-rustbuild` to the
4349   configure script, but they will be deleted soon. Note that the new build
4350   system uses a different on-disk layout that will likely affect any scripts
4351   building Rust.
4352 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4353   releases.
4354 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4355 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4356   releases.
4357
4358 Compatibility Notes
4359 -------------------
4360
4361 * [A number of minor changes to name resolution have been activated][37127].
4362   They add up to more consistent semantics, allowing for future evolution of
4363   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4364   details of what is different. The breaking changes here have been transitioned
4365   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4366 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4367   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4368   should instead check the variable at runtime with `std::env`. That the value
4369   was set at build time was a bug, and incorrect when cross-compiling. This
4370   change is known to cause breakage.
4371 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4372   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4373   1.10 and is now an error by default. It will become a hard error in the near
4374   future.
4375 * [The semantics relating modules to file system directories are changing in
4376   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4377   lint, which is a warning in this release, and will become a hard error in the
4378   future.
4379 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4380 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4381   the underlying iterator][37834]
4382
4383 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4384 [33685]: https://github.com/rust-lang/rust/issues/33685
4385 [36868]: https://github.com/rust-lang/rust/pull/36868
4386 [37127]: https://github.com/rust-lang/rust/pull/37127
4387 [37229]: https://github.com/rust-lang/rust/pull/37229
4388 [37456]: https://github.com/rust-lang/rust/pull/37456
4389 [37527]: https://github.com/rust-lang/rust/pull/37527
4390 [37602]: https://github.com/rust-lang/rust/pull/37602
4391 [37613]: https://github.com/rust-lang/rust/pull/37613
4392 [37615]: https://github.com/rust-lang/rust/pull/37615
4393 [37636]: https://github.com/rust-lang/rust/pull/37636
4394 [37627]: https://github.com/rust-lang/rust/pull/37627
4395 [37642]: https://github.com/rust-lang/rust/pull/37642
4396 [37677]: https://github.com/rust-lang/rust/pull/37677
4397 [37699]: https://github.com/rust-lang/rust/pull/37699
4398 [37701]: https://github.com/rust-lang/rust/pull/37701
4399 [37705]: https://github.com/rust-lang/rust/pull/37705
4400 [37749]: https://github.com/rust-lang/rust/pull/37749
4401 [37760]: https://github.com/rust-lang/rust/pull/37760
4402 [37763]: https://github.com/rust-lang/rust/pull/37763
4403 [37764]: https://github.com/rust-lang/rust/pull/37764
4404 [37789]: https://github.com/rust-lang/rust/pull/37789
4405 [37791]: https://github.com/rust-lang/rust/pull/37791
4406 [37814]: https://github.com/rust-lang/rust/pull/37814
4407 [37817]: https://github.com/rust-lang/rust/pull/37817
4408 [37834]: https://github.com/rust-lang/rust/pull/37834
4409 [37848]: https://github.com/rust-lang/rust/pull/37848
4410 [37855]: https://github.com/rust-lang/rust/pull/37855
4411 [37882]: https://github.com/rust-lang/rust/pull/37882
4412 [37888]: https://github.com/rust-lang/rust/pull/37888
4413 [37973]: https://github.com/rust-lang/rust/pull/37973
4414 [37979]: https://github.com/rust-lang/rust/pull/37979
4415 [38086]: https://github.com/rust-lang/rust/pull/38086
4416 [38107]: https://github.com/rust-lang/rust/pull/38107
4417 [38117]: https://github.com/rust-lang/rust/pull/38117
4418 [38134]: https://github.com/rust-lang/rust/pull/38134
4419 [38146]: https://github.com/rust-lang/rust/pull/38146
4420 [38181]: https://github.com/rust-lang/rust/pull/38181
4421 [38182]: https://github.com/rust-lang/rust/pull/38182
4422 [38185]: https://github.com/rust-lang/rust/pull/38185
4423 [38192]: https://github.com/rust-lang/rust/pull/38192
4424 [38279]: https://github.com/rust-lang/rust/pull/38279
4425 [38835]: https://github.com/rust-lang/rust/pull/38835
4426 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4427 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4428 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4429 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4430 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4431 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4432 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4433 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4434 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4435 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4436 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4437 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4438 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4439 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4440 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4441 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4442 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4443 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4444 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4445 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4446 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4447 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4448 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4449 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4450 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4451 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4452 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4453 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4454 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4455 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4456 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4457 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4458 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4459 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4460 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4461 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4462 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4463 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4464
4465
4466 Version 1.14.0 (2016-12-22)
4467 ===========================
4468
4469 Language
4470 --------
4471
4472 * [`..` matches multiple tuple fields in enum variants, structs
4473   and tuples][36843]. [RFC 1492].
4474 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4475 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4476 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4477   dereferencing][36822]
4478
4479 Compiler
4480 --------
4481
4482 * [Mark enums with non-zero discriminant as non-zero][37224]
4483 * [Lower-case `static mut` names are linted like other
4484   statics and consts][37162]
4485 * [Fix ICE on some macros in const integer positions
4486    (e.g. `[u8; m!()]`)][36819]
4487 * [Improve error message and snippet for "did you mean `x`"][36798]
4488 * [Add a panic-strategy field to the target specification][36794]
4489 * [Include LLVM version in `--version --verbose`][37200]
4490
4491 Compile-time Optimizations
4492 --------------------------
4493
4494 * [Improve macro expansion performance][37569]
4495 * [Shrink `Expr_::ExprInlineAsm`][37445]
4496 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4497 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4498 * [Avoid more allocations when compiling html5ever][37373]
4499 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4500 * [Avoid some allocations in the macro parser][37318]
4501 * [Use a faster deflate setting][37298]
4502 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4503   during interning of slices][37270]
4504 * [Optimize `write_metadata`][37267]
4505 * [Don't process obligation forest cycles when stalled][37231]
4506 * [Avoid many `CrateConfig` clones][37161]
4507 * [Optimize `Substs::super_fold_with`][37108]
4508 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4509 * [Speed up `plug_leaks`][36917]
4510
4511 Libraries
4512 ---------
4513
4514 * [`println!()`, with no arguments, prints newline][36825].
4515   Previously, an empty string was required to achieve the same.
4516 * [`Wrapping` impls standard binary and unary operators, as well as
4517    the `Sum` and `Product` iterators][37356]
4518 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4519   Vec<T>`][37326]
4520 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4521   `VecDeque` iterators][37315]
4522 * [Improve `SipHasher` performance on small values][37312]
4523 * [Add Iterator trait TrustedLen to enable better FromIterator /
4524   Extend][37306]
4525 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4526 * [`ReadDir` implements `Debug`][37221]
4527 * [Implement `RefUnwindSafe` for atomic types][37178]
4528 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4529 * [Avoid allocations in `Decoder::read_str`][37064]
4530 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4531 * [Impl `Debug` for raw pointers to unsized data][36880]
4532 * [Don't reuse `HashMap` random seeds][37470]
4533 * [The internal memory layout of `HashMap` is more cache-friendly, for
4534   significant improvements in some operations][36692]
4535 * [`HashMap` uses less memory on 32-bit architectures][36595]
4536 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4537
4538 Cargo
4539 -----
4540
4541 * [Expose rustc cfg values to build scripts][cargo/3243]
4542 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4543 * [Fix passing --features when testing multiple packages][cargo/3280]
4544 * [Use a single profile set per workspace][cargo/3249]
4545 * [Load `replace` sections from lock files][cargo/3220]
4546 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4547
4548 Tooling
4549 -------
4550
4551 * [rustup is the recommended Rust installation method][1.14rustup]
4552 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4553   S390x. These are [tier 2] platforms and may have major defects. Follow the
4554   instructions on the website to install, or add the targets to an existing
4555   installation with `rustup target add`. The new target triples are:
4556   - `mips-unknown-linux-gnu`
4557   - `mipsel-unknown-linux-gnu`
4558   - `mips64-unknown-linux-gnuabi64`
4559   - `mips64el-unknown-linux-gnuabi64 `
4560   - `powerpc-unknown-linux-gnu`
4561   - `powerpc64-unknown-linux-gnu`
4562   - `powerpc64le-unknown-linux-gnu`
4563   - `s390x-unknown-linux-gnu `
4564 * This release includes target (std) builds for ARM Linux running MUSL
4565   libc. These are [tier 2] platforms and may have major defects. Add the
4566   following triples to an existing rustup installation with `rustup target add`:
4567   - `arm-unknown-linux-musleabi`
4568   - `arm-unknown-linux-musleabihf`
4569   - `armv7-unknown-linux-musleabihf`
4570 * This release includes [experimental support for WebAssembly][1.14wasm], via
4571   the `wasm32-unknown-emscripten` target. This target is known to have major
4572   defects. Please test, report, and fix.
4573 * rustup no longer installs documentation by default. Run `rustup
4574   component add rust-docs` to install.
4575 * [Fix line stepping in debugger][37310]
4576 * [Enable line number debuginfo in releases][37280]
4577
4578 Misc
4579 ----
4580
4581 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4582 * [Add support for Fuchsia OS][37313]
4583 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4584
4585 Compatibility Notes
4586 -------------------
4587
4588 * [A number of forward-compatibility lints used by the compiler
4589   to gradually introduce language changes have been converted
4590   to deny by default][36894]:
4591   - ["use of inaccessible extern crate erroneously allowed"][36886]
4592   - ["type parameter default erroneously allowed in invalid location"][36887]
4593   - ["detects super or self keywords at the beginning of global path"][36888]
4594   - ["two overlapping inherent impls define an item with the same name
4595     were erroneously allowed"][36889]
4596   - ["floating-point constants cannot be used in patterns"][36890]
4597   - ["constants of struct or enum type can only be used in a pattern if
4598      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4599   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4600 * [Prohibit patterns in trait methods without bodies][37378]
4601 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4602 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4603 * [The `$crate` macro variable is accepted in fewer locations][37213]
4604 * [Impls specifying extra region requirements beyond the trait
4605   they implement are rejected][37167]
4606 * [Enums may not be unsized][37111]. Unsized enums are intended to
4607   work but never have. For now they are forbidden.
4608 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4609
4610 [tier 2]: https://forge.rust-lang.org/platform-support.html
4611 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4612 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4613 [36430]: https://github.com/rust-lang/rust/pull/36430
4614 [36595]: https://github.com/rust-lang/rust/pull/36595
4615 [36595]: https://github.com/rust-lang/rust/pull/36595
4616 [36692]: https://github.com/rust-lang/rust/pull/36692
4617 [36767]: https://github.com/rust-lang/rust/pull/36767
4618 [36794]: https://github.com/rust-lang/rust/pull/36794
4619 [36798]: https://github.com/rust-lang/rust/pull/36798
4620 [36819]: https://github.com/rust-lang/rust/pull/36819
4621 [36822]: https://github.com/rust-lang/rust/pull/36822
4622 [36825]: https://github.com/rust-lang/rust/pull/36825
4623 [36843]: https://github.com/rust-lang/rust/pull/36843
4624 [36880]: https://github.com/rust-lang/rust/pull/36880
4625 [36886]: https://github.com/rust-lang/rust/issues/36886
4626 [36887]: https://github.com/rust-lang/rust/issues/36887
4627 [36888]: https://github.com/rust-lang/rust/issues/36888
4628 [36889]: https://github.com/rust-lang/rust/issues/36889
4629 [36890]: https://github.com/rust-lang/rust/issues/36890
4630 [36891]: https://github.com/rust-lang/rust/issues/36891
4631 [36892]: https://github.com/rust-lang/rust/issues/36892
4632 [36894]: https://github.com/rust-lang/rust/pull/36894
4633 [36917]: https://github.com/rust-lang/rust/pull/36917
4634 [36993]: https://github.com/rust-lang/rust/pull/36993
4635 [37037]: https://github.com/rust-lang/rust/pull/37037
4636 [37064]: https://github.com/rust-lang/rust/pull/37064
4637 [37094]: https://github.com/rust-lang/rust/pull/37094
4638 [37108]: https://github.com/rust-lang/rust/pull/37108
4639 [37111]: https://github.com/rust-lang/rust/pull/37111
4640 [37161]: https://github.com/rust-lang/rust/pull/37161
4641 [37162]: https://github.com/rust-lang/rust/pull/37162
4642 [37167]: https://github.com/rust-lang/rust/pull/37167
4643 [37178]: https://github.com/rust-lang/rust/pull/37178
4644 [37200]: https://github.com/rust-lang/rust/pull/37200
4645 [37213]: https://github.com/rust-lang/rust/pull/37213
4646 [37221]: https://github.com/rust-lang/rust/pull/37221
4647 [37224]: https://github.com/rust-lang/rust/pull/37224
4648 [37230]: https://github.com/rust-lang/rust/pull/37230
4649 [37231]: https://github.com/rust-lang/rust/pull/37231
4650 [37247]: https://github.com/rust-lang/rust/pull/37247
4651 [37267]: https://github.com/rust-lang/rust/pull/37267
4652 [37270]: https://github.com/rust-lang/rust/pull/37270
4653 [37273]: https://github.com/rust-lang/rust/pull/37273
4654 [37280]: https://github.com/rust-lang/rust/pull/37280
4655 [37298]: https://github.com/rust-lang/rust/pull/37298
4656 [37306]: https://github.com/rust-lang/rust/pull/37306
4657 [37310]: https://github.com/rust-lang/rust/pull/37310
4658 [37312]: https://github.com/rust-lang/rust/pull/37312
4659 [37313]: https://github.com/rust-lang/rust/pull/37313
4660 [37315]: https://github.com/rust-lang/rust/pull/37315
4661 [37318]: https://github.com/rust-lang/rust/pull/37318
4662 [37322]: https://github.com/rust-lang/rust/pull/37322
4663 [37326]: https://github.com/rust-lang/rust/pull/37326
4664 [37351]: https://github.com/rust-lang/rust/pull/37351
4665 [37356]: https://github.com/rust-lang/rust/pull/37356
4666 [37367]: https://github.com/rust-lang/rust/pull/37367
4667 [37373]: https://github.com/rust-lang/rust/pull/37373
4668 [37378]: https://github.com/rust-lang/rust/pull/37378
4669 [37389]: https://github.com/rust-lang/rust/pull/37389
4670 [37392]: https://github.com/rust-lang/rust/pull/37392
4671 [37427]: https://github.com/rust-lang/rust/pull/37427
4672 [37439]: https://github.com/rust-lang/rust/pull/37439
4673 [37445]: https://github.com/rust-lang/rust/pull/37445
4674 [37470]: https://github.com/rust-lang/rust/pull/37470
4675 [37569]: https://github.com/rust-lang/rust/pull/37569
4676 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4677 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4678 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4679 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4680 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4681 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4682 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4683
4684
4685 Version 1.13.0 (2016-11-10)
4686 ===========================
4687
4688 Language
4689 --------
4690
4691 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4692   errors, like the `try!` macro, described in [RFC 0243].
4693 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4694 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4695 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4696 * [Fix lifetime rules for 'if' conditions][36029]
4697 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4698
4699 Compiler
4700 --------
4701
4702 * [Add the `-C link-arg` argument][36574]
4703 * [Remove the old AST-based backend from rustc_trans][35764]
4704 * [Don't enable NEON by default on armv7 Linux][35814]
4705 * [Fix debug line number info for macro expansions][35238]
4706 * [Do not emit "class method" debuginfo for types that are not
4707   DICompositeType][36008]
4708 * [Warn about multiple conflicting #[repr] hints][34623]
4709 * [When sizing DST, don't double-count nested struct prefixes][36351]
4710 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4711 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4712 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4713 * [Expand macros without recursing to avoid stack overflows][36214]
4714
4715 Diagnostics
4716 -----------
4717
4718 * [Replace macro backtraces with labeled local uses][35702]
4719 * [Improve error message for misplaced doc comments][33922]
4720 * [Buffer unix and lock windows to prevent message interleaving][35975]
4721 * [Update lifetime errors to specifically note temporaries][36171]
4722 * [Special case a few colors for Windows][36178]
4723 * [Suggest `use self` when such an import resolves][36289]
4724 * [Be more specific when type parameter shadows primitive type][36338]
4725 * Many minor improvements
4726
4727 Compile-time Optimizations
4728 --------------------------
4729
4730 * [Compute and cache HIR hashes at beginning][35854]
4731 * [Don't hash types in loan paths][36004]
4732 * [Cache projections in trans][35761]
4733 * [Optimize the parser's last token handling][36527]
4734 * [Only instantiate #[inline] functions in codegen units referencing
4735   them][36524]. This leads to big improvements in cases where crates export
4736   define many inline functions without using them directly.
4737 * [Lazily allocate TypedArena's first chunk][36592]
4738 * [Don't allocate during default HashSet creation][36734]
4739
4740 Stabilized APIs
4741 ---------------
4742
4743 * [`checked_abs`]
4744 * [`wrapping_abs`]
4745 * [`overflowing_abs`]
4746 * [`RefCell::try_borrow`]
4747 * [`RefCell::try_borrow_mut`]
4748
4749 Libraries
4750 ---------
4751
4752 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4753 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4754   covariant][35354]
4755 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4756 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4757 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4758 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4759 * [Use arc4rand on FreeBSD][35884]
4760 * [memrchr: Correct aligned offset computation][35969]
4761 * [Improve Demangling of Rust Symbols][36059]
4762 * [Use monotonic time in condition variables][35048]
4763 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4764 * [Implement conversion traits for `char`][35755]
4765 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4766 * [Zero first byte of CString on drop][36264]
4767 * [Inherit overflow checks for sum and product][36372]
4768 * [Add missing Eq implementations][36423]
4769 * [Implement `Debug` for `DirEntry`][36631]
4770 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4771   `errno`][36754]
4772 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4773 * [Implement more traits for `std::io::ErrorKind`][35911]
4774 * [Optimize BinaryHeap bounds checking][36072]
4775 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4776   `extend_with_element`][36355]
4777 * [Fix overflow checking in unsigned pow()][34942]
4778
4779 Cargo
4780 -----
4781
4782 * This release includes security fixes to both curl and OpenSSL.
4783 * [Fix transitive doctests when panic=abort][cargo/3021]
4784 * [Add --all-features flag to cargo][cargo/3038]
4785 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4786 * [Don't parse the home directory more than once][cargo/3078]
4787 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4788 * [Update OpenSSL to 1.0.2j][cargo/3121]
4789 * [Add license and license_file to cargo metadata output][cargo/3110]
4790 * [Make crates-io registry URL optional in config; ignore all changes to
4791   source.crates-io][cargo/3089]
4792 * [Don't download dependencies from other platforms][cargo/3123]
4793 * [Build transitive dev-dependencies when needed][cargo/3125]
4794 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4795 * [Avoid updating registry when adding existing deps][cargo/3144]
4796 * [Warn about path overrides that won't work][cargo/3136]
4797 * [Use workspaces during `cargo install`][cargo/3146]
4798 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4799 * [Add --message-format flag][cargo/3000]
4800 * [Pass target environment for rustdoc][cargo/3205]
4801 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4802 * [Update curl and curl-sys][cargo/3241]
4803 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4804
4805 Tooling
4806 -------
4807
4808 * [rustdoc: Add the `--sysroot` argument][36586]
4809 * [rustdoc: Fix a couple of issues with the search results][35655]
4810 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4811 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4812 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4813
4814 Misc
4815 ----
4816
4817 * [Remove unmaintained style guide][35124]
4818 * [Add s390x support][36369]
4819 * [Initial work at Haiku OS support][36727]
4820 * [Add mips-uclibc targets][35734]
4821 * [Crate-ify compiler-rt into compiler-builtins][35021]
4822 * [Add rustc version info (git hash + date) to dist tarball][36213]
4823 * Many documentation improvements
4824
4825 Compatibility Notes
4826 -------------------
4827
4828 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4829 * [Deny (by default) transmuting from fn item types to pointer-sized
4830   types][34923]. Continuing the long transition to zero-sized fn items,
4831   per [RFC 401].
4832 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4833   Part of [RFC 1506].
4834 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4835 * [Fix lifetime rules for 'if' conditions][36029].
4836 * [Inherit overflow checks for sum and product][36372].
4837 * [Forbid user-defined macros named "macro_rules"][36730].
4838
4839 [33922]: https://github.com/rust-lang/rust/pull/33922
4840 [34623]: https://github.com/rust-lang/rust/pull/34623
4841 [34923]: https://github.com/rust-lang/rust/pull/34923
4842 [34942]: https://github.com/rust-lang/rust/pull/34942
4843 [34982]: https://github.com/rust-lang/rust/pull/34982
4844 [35021]: https://github.com/rust-lang/rust/pull/35021
4845 [35048]: https://github.com/rust-lang/rust/pull/35048
4846 [35074]: https://github.com/rust-lang/rust/pull/35074
4847 [35124]: https://github.com/rust-lang/rust/pull/35124
4848 [35234]: https://github.com/rust-lang/rust/pull/35234
4849 [35238]: https://github.com/rust-lang/rust/pull/35238
4850 [35354]: https://github.com/rust-lang/rust/pull/35354
4851 [35559]: https://github.com/rust-lang/rust/pull/35559
4852 [35585]: https://github.com/rust-lang/rust/pull/35585
4853 [35627]: https://github.com/rust-lang/rust/pull/35627
4854 [35655]: https://github.com/rust-lang/rust/pull/35655
4855 [35702]: https://github.com/rust-lang/rust/pull/35702
4856 [35707]: https://github.com/rust-lang/rust/pull/35707
4857 [35728]: https://github.com/rust-lang/rust/pull/35728
4858 [35734]: https://github.com/rust-lang/rust/pull/35734
4859 [35755]: https://github.com/rust-lang/rust/pull/35755
4860 [35761]: https://github.com/rust-lang/rust/pull/35761
4861 [35764]: https://github.com/rust-lang/rust/pull/35764
4862 [35814]: https://github.com/rust-lang/rust/pull/35814
4863 [35854]: https://github.com/rust-lang/rust/pull/35854
4864 [35871]: https://github.com/rust-lang/rust/pull/35871
4865 [35884]: https://github.com/rust-lang/rust/pull/35884
4866 [35911]: https://github.com/rust-lang/rust/pull/35911
4867 [35969]: https://github.com/rust-lang/rust/pull/35969
4868 [35975]: https://github.com/rust-lang/rust/pull/35975
4869 [36004]: https://github.com/rust-lang/rust/pull/36004
4870 [36008]: https://github.com/rust-lang/rust/pull/36008
4871 [36014]: https://github.com/rust-lang/rust/pull/36014
4872 [36029]: https://github.com/rust-lang/rust/pull/36029
4873 [36059]: https://github.com/rust-lang/rust/pull/36059
4874 [36072]: https://github.com/rust-lang/rust/pull/36072
4875 [36101]: https://github.com/rust-lang/rust/pull/36101
4876 [36104]: https://github.com/rust-lang/rust/pull/36104
4877 [36171]: https://github.com/rust-lang/rust/pull/36171
4878 [36173]: https://github.com/rust-lang/rust/pull/36173
4879 [36178]: https://github.com/rust-lang/rust/pull/36178
4880 [36213]: https://github.com/rust-lang/rust/pull/36213
4881 [36214]: https://github.com/rust-lang/rust/pull/36214
4882 [36264]: https://github.com/rust-lang/rust/pull/36264
4883 [36266]: https://github.com/rust-lang/rust/pull/36266
4884 [36289]: https://github.com/rust-lang/rust/pull/36289
4885 [36338]: https://github.com/rust-lang/rust/pull/36338
4886 [36351]: https://github.com/rust-lang/rust/pull/36351
4887 [36355]: https://github.com/rust-lang/rust/pull/36355
4888 [36369]: https://github.com/rust-lang/rust/pull/36369
4889 [36372]: https://github.com/rust-lang/rust/pull/36372
4890 [36423]: https://github.com/rust-lang/rust/pull/36423
4891 [36482]: https://github.com/rust-lang/rust/pull/36482
4892 [36505]: https://github.com/rust-lang/rust/pull/36505
4893 [36524]: https://github.com/rust-lang/rust/pull/36524
4894 [36527]: https://github.com/rust-lang/rust/pull/36527
4895 [36551]: https://github.com/rust-lang/rust/pull/36551
4896 [36574]: https://github.com/rust-lang/rust/pull/36574
4897 [36586]: https://github.com/rust-lang/rust/pull/36586
4898 [36592]: https://github.com/rust-lang/rust/pull/36592
4899 [36631]: https://github.com/rust-lang/rust/pull/36631
4900 [36639]: https://github.com/rust-lang/rust/pull/36639
4901 [36721]: https://github.com/rust-lang/rust/pull/36721
4902 [36727]: https://github.com/rust-lang/rust/pull/36727
4903 [36730]: https://github.com/rust-lang/rust/pull/36730
4904 [36734]: https://github.com/rust-lang/rust/pull/36734
4905 [36754]: https://github.com/rust-lang/rust/pull/36754
4906 [36995]: https://github.com/rust-lang/rust/pull/36995
4907 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4908 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4909 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4910 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4911 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4912 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4913 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4914 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4915 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4916 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4917 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4918 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4919 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4920 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4921 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4922 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4923 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4924 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4925 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4926 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4927 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4928 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4929 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4930 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4931 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4932 [rustup]: https://www.rustup.rs
4933 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4934 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4935 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4936 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4937 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4938 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4939 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4940
4941
4942 Version 1.12.1 (2016-10-20)
4943 ===========================
4944
4945 Regression Fixes
4946 ----------------
4947
4948 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4949 * [Confusion with double negation and booleans][36856]
4950 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4951 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4952 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4953 * [Corrupted memory after updated to 1.12][36936]
4954 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4955 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4956 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4957
4958 [36381]: https://github.com/rust-lang/rust/issues/36381
4959 [36856]: https://github.com/rust-lang/rust/issues/36856
4960 [36875]: https://github.com/rust-lang/rust/issues/36875
4961 [36924]: https://github.com/rust-lang/rust/issues/36924
4962 [36926]: https://github.com/rust-lang/rust/issues/36926
4963 [36936]: https://github.com/rust-lang/rust/issues/36936
4964 [37026]: https://github.com/rust-lang/rust/issues/37026
4965 [37112]: https://github.com/rust-lang/rust/issues/37112
4966 [37153]: https://github.com/rust-lang/rust/issues/37153
4967
4968
4969 Version 1.12.0 (2016-09-29)
4970 ===========================
4971
4972 Highlights
4973 ----------
4974
4975 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4976   This translation pass is far simpler than the previous AST->LLVM pass, and
4977   creates opportunities to perform new optimizations directly on the MIR. It
4978   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4979 * [`rustc` presents a new, more readable error format, along with
4980   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4981   Most common editors supporting Rust have been updated to work with it. It was
4982   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4983
4984 Compiler
4985 --------
4986
4987 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4988   This translation pass is far simpler than the previous AST->LLVM pass, and
4989   creates opportunities to perform new optimizations directly on the MIR. It
4990   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4991 * [Print the Rust target name, not the LLVM target name, with
4992   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
4993 * [The computation of `TypeId` is correct in some cases where it was previously
4994   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
4995 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
4996 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
4997   `--print relocation-models`, and `--print code-models` print the available
4998   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
4999   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5000 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5001   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5002   These targets produce statically-linked binaries. There are no binary release
5003   builds yet though.
5004
5005 Diagnostics
5006 -----------
5007
5008 * [`rustc` presents a new, more readable error format, along with
5009   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5010   Most common editors supporting Rust have been updated to work with it. It was
5011   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5012 * [In error descriptions, references are now described in plain English,
5013   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5014 * [In error type descriptions, unknown numeric types are named `{integer}` or
5015   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5016 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5017
5018 Language
5019 --------
5020
5021 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5022 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5023 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5024   useful](https://github.com/rust-lang/rust/pull/34908)
5025 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5026   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5027 * [Semicolons are properly required as statement delimiters inside
5028   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5029 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5030
5031 Stabilized APIs
5032 ---------------
5033
5034 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5035 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5036 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5037 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5038 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5039 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5040 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5041 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5042 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5043 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5044   Both on Unix and Windows.
5045 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5046 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5047 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5048 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5049 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5050 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5051 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5052 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5053
5054 Libraries
5055 ---------
5056
5057 * [The `format!` macro and friends now allow a single argument to be formatted
5058   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5059 * [The lifetime bounds on `[T]::binary_search_by` and
5060   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5061 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5062 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5063 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5064 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5065 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5066 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5067 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5068 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5069   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5070 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5071   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5072 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5073 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5074   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5075 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5076 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5077 * [`mpsc::sync_channel` `Receiver`s return any available message before
5078   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5079 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5080 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5081
5082 Cargo
5083 -----
5084
5085 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5086 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5087 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5088 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5089 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5090 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5091 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5092 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5093 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5094 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5095 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5096 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5097 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5098 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5099 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5100 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5101
5102 Performance
5103 -----------
5104
5105 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5106 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5107
5108 Tooling
5109 -------
5110
5111 * [Test binaries now support a `--test-threads` argument to specify the number
5112   of threads used to run tests, and which acts the same as the
5113   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5114 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5115 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5116 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5117 * [Rust releases now come with source packages that can be installed by rustup
5118   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5119   The resulting source code can be used by tools and IDES, located in the
5120   sysroot under `lib/rustlib/src`.
5121
5122 Misc
5123 ----
5124
5125 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5126 * Many minor improvements to the documentation.
5127 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5128
5129 Compatibility Notes
5130 -------------------
5131
5132 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5133   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5134 * [When formatting strings, if "precision" is specified, the "fill",
5135   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5136 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5137
5138
5139 Version 1.11.0 (2016-08-18)
5140 ===========================
5141
5142 Language
5143 --------
5144
5145 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5146 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5147 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5148 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5149
5150 Stabilized APIs
5151 ---------------
5152
5153 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5154 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5155 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5156 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5157 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5158 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5159   (in libcore - previously stabilized in libstd)
5160 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5161   (in libcore - previously stabilized in libstd)
5162 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5163   (in libcore - previously stabilized in libstd)
5164 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5165   (in libcore - previously stabilized in libstd)
5166 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5167 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5168 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5169 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5170
5171 Libraries
5172 ---------
5173
5174 * [The `thread_local!` macro supports multiple definitions in a single
5175    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5176 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5177 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5178   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5179 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5180 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5181 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5182 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5183
5184 Cargo
5185 -----
5186
5187 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5188 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5189 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5190 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5191 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5192   and `-vv` prints warnings for all crates.
5193 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5194 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5195   This provides room for expansion by arbitrary tools.
5196 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5197 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5198 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5199 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5200 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5201 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5202 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5203
5204 Performance
5205 -----------
5206
5207 * [Caching projections speeds up type check dramatically for some
5208   workloads](https://github.com/rust-lang/rust/pull/33816)
5209 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5210   This hasher is faster, but is believed to provide sufficient
5211   protection from collision attacks.
5212 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5213
5214 Rustdoc
5215 -------
5216
5217 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5218 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5219 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5220 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5221 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5222
5223 Tooling
5224 -------
5225
5226 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5227 * [When emitting debug info, rustc emits frame pointers for closures,
5228   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5229 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5230 * Many more errors have been given error codes and extended
5231   explanations
5232 * API documentation continues to be improved, with many new examples
5233
5234 Misc
5235 ----
5236
5237 * [rustc no longer hangs when dependencies recursively re-export
5238   submodules](https://github.com/rust-lang/rust/pull/34542)
5239 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5240 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5241   rewritten](https://github.com/rust-lang/rust/pull/33895)
5242 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5243   No targets use this yet, but it works toward AVR support.
5244
5245 Compatibility Notes
5246 -------------------
5247
5248 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5249 * [The new follow-set rules that place restrictions on `macro_rules!`
5250   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5251   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5252   and has been a warning since 1.10.
5253 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5254   This causes breakage in some corner cases.
5255
5256
5257 Version 1.10.0 (2016-07-07)
5258 ===========================
5259
5260 Language
5261 --------
5262
5263 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5264   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5265 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5266 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5267 * [`panic!` can be converted to a runtime abort with the
5268   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5269   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5270 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5271   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5272   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5273   Note that Cargo does not yet directly support cdylibs.
5274
5275 Stabilized APIs
5276 ---------------
5277
5278 * `os::windows::fs::OpenOptionsExt::access_mode`
5279 * `os::windows::fs::OpenOptionsExt::share_mode`
5280 * `os::windows::fs::OpenOptionsExt::custom_flags`
5281 * `os::windows::fs::OpenOptionsExt::attributes`
5282 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5283 * `os::unix::fs::OpenOptionsExt::custom_flags`
5284 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5285 * `Default for sync::Weak`
5286 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5287 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5288 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5289 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5290 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5291 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5292 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5293 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5294 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5295 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5296 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5297 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5298 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5299 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5300 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5301 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5302 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5303 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5304 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5305 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5306 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5307 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5308 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5309 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5310 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5311 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5312 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5313 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5314 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5315 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5316 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5317 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5318 * Read/Write/RawFd impls for `UnixStream`
5319 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5320 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5321 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5322 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5323 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5324 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5325 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5326 * RawFd impls for `UnixListener`
5327 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5328 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5329 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5330 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5331 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5332 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5333 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5334 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5335 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5336 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5337 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5338 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5339 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5340 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5341 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5342 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5343 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5344 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5345 * RawFd impls for `UnixDatagram`
5346 * `{BTree,Hash}Map::values_mut`
5347 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5348
5349 Libraries
5350 ---------
5351
5352 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5353   The semantics of this minor method are subtle and probably not what
5354   most people want.
5355 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5356 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5357   will fall back to `/dev/urandom` temporarily to avoid blocking
5358   during early boot](https://github.com/rust-lang/rust/pull/33086).
5359 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5360 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5361 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5362 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5363 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5364 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5365   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5366
5367 Cargo
5368 -----
5369 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5370   This controls the runtime behavior of the `panic!` macro
5371   and can be either "unwind" (the default), or "abort".
5372   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5373 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5374 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5375 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5376   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5377 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5378 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5379 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5380   By default they are retried twice, which can be customized with the
5381   `net.retry` value in `.cargo/config`.
5382 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5383 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5384 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5385 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5386   Makes it possible to install multiple crates in parallel.
5387 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5388 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5389 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5390 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5391 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5392 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5393
5394 Performance
5395 -----------
5396
5397 * [rustc memory usage was reduced by refactoring the context used for
5398   type checking](https://github.com/rust-lang/rust/pull/33425).
5399 * [Speed up creation of `HashMap`s by caching the random keys used
5400   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5401 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5402 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5403 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5404   10x faster than the previous lookup tables.
5405 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5406
5407 Usability
5408 ---------
5409
5410 * Many incremental improvements to documentation and rustdoc.
5411 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5412 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5413 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5414 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5415 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5416 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5417 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5418
5419 Misc
5420 ----
5421
5422 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5423 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5424 * [`std` no longer prints backtraces on platforms where the running
5425   module must be loaded with `env::current_exe`, which can't be relied
5426   on](https://github.com/rust-lang/rust/pull/33554).
5427 * This release includes std binaries for the i586-unknown-linux-gnu,
5428   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5429   i586 target is for old x86 hardware without SSE2, and the armv7
5430   target is for Android running on modern ARM architectures.
5431 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5432   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5433 * [On Unix the runtime aborts by calling `libc::abort` instead of
5434   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5435 * [Rust is now bootstrapped from the previous release of Rust,
5436   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5437
5438 Compatibility Notes
5439 -------------------
5440
5441 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5442 * [`target_env` for Linux ARM targets is just `gnu`, not
5443   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5444 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5445 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5446 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5447   Affects how macros are parsed.
5448 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5449 * [Feature-gated attributes on macro-generated macro invocations are
5450   now rejected](https://github.com/rust-lang/rust/pull/32791).
5451 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5452   This caused some minor changes to type inference.
5453
5454
5455 Version 1.9.0 (2016-05-26)
5456 ==========================
5457
5458 Language
5459 --------
5460
5461 * The `#[deprecated]` attribute when applied to an API will generate
5462   warnings when used. The warnings may be suppressed with
5463   `#[allow(deprecated)]`. [RFC 1270].
5464 * [`fn` item types are zero sized, and each `fn` names a unique
5465   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5466   `transmute` on a `fn` type will generate a warning for a few cycles,
5467   then will be converted to an error.
5468 * [Field and method resolution understand visibility, so private
5469   fields and methods cannot prevent the proper use of public fields
5470   and methods][1.9fv].
5471 * [The parser considers unicode codepoints in the
5472   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5473
5474 Stabilized APIs
5475 ---------------
5476
5477 * [`std::panic`]
5478 * [`std::panic::catch_unwind`] (renamed from `recover`)
5479 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5480 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5481 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5482 * [`str::is_char_boundary`]
5483 * [`<*const T>::as_ref`]
5484 * [`<*mut T>::as_ref`]
5485 * [`<*mut T>::as_mut`]
5486 * [`AsciiExt::make_ascii_uppercase`]
5487 * [`AsciiExt::make_ascii_lowercase`]
5488 * [`char::decode_utf16`]
5489 * [`char::DecodeUtf16`]
5490 * [`char::DecodeUtf16Error`]
5491 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5492 * [`BTreeSet::take`]
5493 * [`BTreeSet::replace`]
5494 * [`BTreeSet::get`]
5495 * [`HashSet::take`]
5496 * [`HashSet::replace`]
5497 * [`HashSet::get`]
5498 * [`OsString::with_capacity`]
5499 * [`OsString::clear`]
5500 * [`OsString::capacity`]
5501 * [`OsString::reserve`]
5502 * [`OsString::reserve_exact`]
5503 * [`OsStr::is_empty`]
5504 * [`OsStr::len`]
5505 * [`std::os::unix::thread`]
5506 * [`RawPthread`]
5507 * [`JoinHandleExt`]
5508 * [`JoinHandleExt::as_pthread_t`]
5509 * [`JoinHandleExt::into_pthread_t`]
5510 * [`HashSet::hasher`]
5511 * [`HashMap::hasher`]
5512 * [`CommandExt::exec`]
5513 * [`File::try_clone`]
5514 * [`SocketAddr::set_ip`]
5515 * [`SocketAddr::set_port`]
5516 * [`SocketAddrV4::set_ip`]
5517 * [`SocketAddrV4::set_port`]
5518 * [`SocketAddrV6::set_ip`]
5519 * [`SocketAddrV6::set_port`]
5520 * [`SocketAddrV6::set_flowinfo`]
5521 * [`SocketAddrV6::set_scope_id`]
5522 * [`slice::copy_from_slice`]
5523 * [`ptr::read_volatile`]
5524 * [`ptr::write_volatile`]
5525 * [`OpenOptions::create_new`]
5526 * [`TcpStream::set_nodelay`]
5527 * [`TcpStream::nodelay`]
5528 * [`TcpStream::set_ttl`]
5529 * [`TcpStream::ttl`]
5530 * [`TcpStream::set_only_v6`]
5531 * [`TcpStream::only_v6`]
5532 * [`TcpStream::take_error`]
5533 * [`TcpStream::set_nonblocking`]
5534 * [`TcpListener::set_ttl`]
5535 * [`TcpListener::ttl`]
5536 * [`TcpListener::set_only_v6`]
5537 * [`TcpListener::only_v6`]
5538 * [`TcpListener::take_error`]
5539 * [`TcpListener::set_nonblocking`]
5540 * [`UdpSocket::set_broadcast`]
5541 * [`UdpSocket::broadcast`]
5542 * [`UdpSocket::set_multicast_loop_v4`]
5543 * [`UdpSocket::multicast_loop_v4`]
5544 * [`UdpSocket::set_multicast_ttl_v4`]
5545 * [`UdpSocket::multicast_ttl_v4`]
5546 * [`UdpSocket::set_multicast_loop_v6`]
5547 * [`UdpSocket::multicast_loop_v6`]
5548 * [`UdpSocket::set_multicast_ttl_v6`]
5549 * [`UdpSocket::multicast_ttl_v6`]
5550 * [`UdpSocket::set_ttl`]
5551 * [`UdpSocket::ttl`]
5552 * [`UdpSocket::set_only_v6`]
5553 * [`UdpSocket::only_v6`]
5554 * [`UdpSocket::join_multicast_v4`]
5555 * [`UdpSocket::join_multicast_v6`]
5556 * [`UdpSocket::leave_multicast_v4`]
5557 * [`UdpSocket::leave_multicast_v6`]
5558 * [`UdpSocket::take_error`]
5559 * [`UdpSocket::connect`]
5560 * [`UdpSocket::send`]
5561 * [`UdpSocket::recv`]
5562 * [`UdpSocket::set_nonblocking`]
5563
5564 Libraries
5565 ---------
5566
5567 * [`std::sync::Once` is poisoned if its initialization function
5568   fails][1.9o].
5569 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5570 * [Most types implement `fmt::Debug`][1.9db].
5571 * [The default buffer size used by `BufReader` and `BufWriter` was
5572   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5573   used by other languages.
5574 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5575   `Duration` additionally implements `*=` and `/=`][1.9ta].
5576 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5577 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5578 * [`Chain` implements `BufRead`][1.9ch].
5579 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5580
5581 Cargo
5582 -----
5583
5584 * [Cargo can now run concurrently][1.9cc].
5585 * [Top-level overrides allow specific revisions of crates to be
5586   overridden through the entire crate graph][1.9ct].  This is intended
5587   to make upgrades easier for large projects, by allowing crates to be
5588   forked temporarily until they've been upgraded and republished.
5589 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5590 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5591   on the commandline][1.9cf]. `rustc` arguments can also be specified
5592   in the `build.rustflags` configuration key.
5593
5594 Performance
5595 -----------
5596
5597 * [The time complexity of comparing variables for equivalence during type
5598   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5599   to major compilation time improvement in some scenarios.
5600 * [`ToString` is specialized for `str`, giving it the same performance
5601   as `to_owned`][1.9ts].
5602 * [Spawning processes with `Command::output` no longer creates extra
5603   threads][1.9sp].
5604 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5605   for C-like enums][1.9cl].
5606
5607 Misc
5608 ----
5609
5610 * [Passing the `--quiet` flag to a test runner will produce
5611   much-abbreviated output][1.9q].
5612 * The Rust Project now publishes std binaries for the
5613   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5614   `i586-pc-windows-msvc` targets.
5615
5616 Compatibility Notes
5617 -------------------
5618
5619 * [`std::sync::Once` is poisoned if its initialization function
5620   fails][1.9o].
5621 * [It is illegal to define methods with the same name in overlapping
5622   inherent `impl` blocks][1.9sn].
5623 * [`fn` item types are zero sized, and each `fn` names a unique
5624   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5625   `transmute` on a `fn` type will generate a warning for a few cycles,
5626   then will be converted to an error.
5627 * [Improvements to const evaluation may trigger new errors when integer
5628   literals are out of range][1.9ce].
5629
5630
5631 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5632 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5633 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5634 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5635 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5636 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5637 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5638 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5639 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5640 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5641 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5642 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5643 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5644 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5645 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5646 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5647 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5648 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5649 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5650 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5651 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5652 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5653 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5654 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5655 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5656 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5657 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5658 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5659 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5660 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5661 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5662 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5663 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5664 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5665 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5666 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5667 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5668 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5669 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5670 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5671 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5672 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5673 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5674 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5675 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5676 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5677 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5678 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5679 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5680 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5681 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5682 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5683 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5684 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5685 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5686 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5687 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5688 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5689 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5690 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5691 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5692 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5693 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5694 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5695 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5696 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5697 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5698 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5699 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5700 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5701 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5702 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5703 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5704 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5705 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5706 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5707 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5708 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5709 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5710 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5711 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5712 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5713 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5714 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5715 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5716 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5717 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5718 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5719 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5720 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5721 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5722 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5723 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5724 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5725 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5726 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5727 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5728 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5729 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5730 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5731 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5732 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5733 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5734 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5735 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5736 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5737 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5738 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5739 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5740 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5741
5742
5743 Version 1.8.0 (2016-04-14)
5744 ==========================
5745
5746 Language
5747 --------
5748
5749 * Rust supports overloading of compound assignment statements like
5750   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5751   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5752   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5753   traits. [RFC 953].
5754 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5755   addition to the non-braced form, `struct Foo;`. [RFC 218].
5756
5757 Libraries
5758 ---------
5759
5760 * Stabilized APIs:
5761   * [`str::encode_utf16`] (renamed from `utf16_units`)
5762   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5763   * [`Ref::map`]
5764   * [`RefMut::map`]
5765   * [`ptr::drop_in_place`]
5766   * [`time::Instant`]
5767   * [`time::SystemTime`]
5768   * [`Instant::now`]
5769   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5770   * [`Instant::elapsed`]
5771   * [`SystemTime::now`]
5772   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5773   * [`SystemTime::elapsed`]
5774   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5775   * [`SystemTimeError`]
5776   * [`SystemTimeError::duration`]
5777   * Various impls for `SystemTimeError`
5778   * [`UNIX_EPOCH`]
5779   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5780     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5781     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5782 * [The `write!` and `writeln!` macros correctly emit errors if any of
5783   their arguments can't be formatted][1.8w].
5784 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5785 * [The Unix-specific `raw` modules, which contain a number of
5786   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5787   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5788   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5789   across platforms was making it difficult to implement `std`
5790   correctly. Those that need these definitions should use the `libc`
5791   crate. [RFC 1415].
5792 * The Unix-specific `MetadataExt` traits, including
5793   `os::unix::fs::MetadataExt`, which expose values such as inode
5794   numbers [no longer return platform-specific types][1.8r], but
5795   instead return widened integers. [RFC 1415].
5796 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5797 * [Atomic loads and stores are not volatile][1.8a].
5798 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5799
5800 Performance
5801 -----------
5802
5803 * [Inlining hash functions lead to a 3% compile-time improvement in
5804   some workloads][1.8h].
5805 * When using jemalloc, its symbols are [unprefixed so that it
5806   overrides the libc malloc implementation][1.8h]. This means that for
5807   rustc, LLVM is now using jemalloc, which results in a 6%
5808   compile-time improvement on a specific workload.
5809 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5810
5811 Misc
5812 ----
5813
5814 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5815   i686-pc-windows-msvc is now considered a tier-1 platform.
5816 * [The `--print targets` flag prints a list of supported targets][1.8t].
5817 * [The `--print cfg` flag prints the `cfg`s defined for the current
5818   target][1.8cf].
5819 * [`rustc` can be built with an new Cargo-based build system, written
5820   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5821   build system. To enable it configure with `configure --rustbuild`.
5822 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5823   variants while also indicating the total number of missing variants
5824   if more than 3][1.8m].
5825 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5826 * The Rust Project now publishes binary releases of the standard
5827   library for a number of tier-2 targets:
5828   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5829   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5830   `x86_64-rumprun-netbsd`. These can be installed with
5831   tools such as [multirust][1.8mr].
5832
5833 Cargo
5834 -----
5835
5836 * [`cargo init` creates a new Cargo project in the current
5837   directory][1.8ci].  It is otherwise like `cargo new`.
5838 * [Cargo has configuration keys for `-v` and
5839   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5840   `[term]` section of `.cargo/config`.
5841 * [Configuration keys that evaluate to strings or integers can be set
5842   via environment variables][1.8ce]. For example the `build.jobs` key
5843   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5844   precedence over config files.
5845 * [Target-specific dependencies support Rust `cfg` syntax for
5846   describing targets][1.8cfg] so that dependencies for multiple
5847   targets can be specified together. [RFC 1361].
5848 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5849   `RUSTDOC` take precedence over the `build.target-dir`,
5850   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5851 * [The child process tree is killed on Windows when Cargo is
5852   killed][1.8ck].
5853 * [The `build.target` configuration value sets the target platform,
5854   like `--target`][1.8ct].
5855
5856 Compatibility Notes
5857 -------------------
5858
5859 * [Unstable compiler flags have been further restricted][1.8u]. Since
5860   1.0 `-Z` flags have been considered unstable, and other flags that
5861   were considered unstable additionally required passing `-Z
5862   unstable-options` to access. Unlike unstable language and library
5863   features though, these options have been accessible on the stable
5864   release channel. Going forward, *new unstable flags will not be
5865   available on the stable release channel*, and old unstable flags
5866   will warn about their usage. In the future, all unstable flags will
5867   be unavailable on the stable release channel.
5868 * [It is no longer possible to `match` on empty enum variants using
5869   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5870 * The Unix-specific `MetadataExt` traits, including
5871   `os::unix::fs::MetadataExt`, which expose values such as inode
5872   numbers [no longer return platform-specific types][1.8r], but
5873   instead return widened integers. [RFC 1415].
5874 * [Modules sourced from the filesystem cannot appear within arbitrary
5875   blocks, but only within other modules][1.8mf].
5876 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5877 * On Unix, [stack overflow triggers a runtime abort instead of a
5878   SIGSEGV][1.8so].
5879 * [`Command::spawn` and its equivalents return an error if any of
5880   its command-line arguments contain interior `NUL`s][1.8n].
5881 * [Tuple and unit enum variants from other crates are in the type
5882   namespace][1.8tn].
5883 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5884   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5885   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5886   instead of `foo.lib`.
5887
5888
5889 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5890 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5891 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5892 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5893 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5894 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5895 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5896 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5897 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5898 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5899 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5900 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5901 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5902 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5903 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5904 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5905 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5906 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5907 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5908 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5909 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5910 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5911 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5912 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5913 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5914 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5915 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5916 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5917 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5918 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5919 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5920 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5921 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5922 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5923 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5924 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5925 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5926 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5927 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5928 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5929 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5930 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5931 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5932 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5933 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5934 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5935 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5936 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5937 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5938 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5939 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5940 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5941 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5942 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5943 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5944 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5945 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5946 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5947 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5948 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5949
5950
5951 Version 1.7.0 (2016-03-03)
5952 ==========================
5953
5954 Libraries
5955 ---------
5956
5957 * Stabilized APIs
5958   * `Path`
5959     * [`Path::strip_prefix`] (renamed from relative_from)
5960     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
5961   * `Ipv4Addr`
5962     * [`Ipv4Addr::is_loopback`]
5963     * [`Ipv4Addr::is_private`]
5964     * [`Ipv4Addr::is_link_local`]
5965     * [`Ipv4Addr::is_multicast`]
5966     * [`Ipv4Addr::is_broadcast`]
5967     * [`Ipv4Addr::is_documentation`]
5968   * `Ipv6Addr`
5969     * [`Ipv6Addr::is_unspecified`]
5970     * [`Ipv6Addr::is_loopback`]
5971     * [`Ipv6Addr::is_multicast`]
5972   * `Vec`
5973     * [`Vec::as_slice`]
5974     * [`Vec::as_mut_slice`]
5975   * `String`
5976     * [`String::as_str`]
5977     * [`String::as_mut_str`]
5978   * Slices
5979     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5980     be the same length
5981     * `<[T]>::`[`sort_by_key`]
5982   * checked, saturated, and overflowing operations
5983     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
5984     * [`i32::saturating_mul`]
5985     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
5986     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
5987     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
5988     * [`u32::saturating_mul`]
5989     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
5990     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
5991     * and checked, saturated, and overflowing operations for other primitive types
5992   * FFI
5993     * [`ffi::IntoStringError`]
5994     * [`CString::into_string`]
5995     * [`CString::into_bytes`]
5996     * [`CString::into_bytes_with_nul`]
5997     * `From<CString> for Vec<u8>`
5998   * `IntoStringError`
5999     * [`IntoStringError::into_cstring`]
6000     * [`IntoStringError::utf8_error`]
6001     * `Error for IntoStringError`
6002   * Hashing
6003     * [`std::hash::BuildHasher`]
6004     * [`BuildHasher::Hasher`]
6005     * [`BuildHasher::build_hasher`]
6006     * [`std::hash::BuildHasherDefault`]
6007     * [`HashMap::with_hasher`]
6008     * [`HashMap::with_capacity_and_hasher`]
6009     * [`HashSet::with_hasher`]
6010     * [`HashSet::with_capacity_and_hasher`]
6011     * [`std::collections::hash_map::RandomState`]
6012     * [`RandomState::new`]
6013 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6014   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6015   from bytes is faster.
6016 * [The performance of `LineWriter` (and thus `io::stdout`) was
6017   improved by using `memchr` to search for newlines][1.7m].
6018 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6019   `f64` variants were stabilized previously.
6020 * [`BTreeMap` was rewritten to use less memory and improve the performance
6021   of insertion and iteration, the latter by as much as 5x][1.7bm].
6022 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6023   covariant over their contained type][1.7bt].
6024 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6025   over their contained type][1.7ll].
6026 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6027   searching methods.
6028 * [`Any` is implemented for unsized types][1.7a].
6029 * [`Hash` is implemented for `Duration`][1.7h].
6030
6031 Misc
6032 ----
6033
6034 * [When running tests with `--test`, rustdoc will pass `--cfg`
6035   arguments to the compiler][1.7dt].
6036 * [The compiler is built with RPATH information by default][1.7rpa].
6037   This means that it will be possible to run `rustc` when installed in
6038   unusual configurations without configuring the dynamic linker search
6039   path explicitly.
6040 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6041   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6042   over `LD_LIBRARY_PATH`.
6043
6044 Cargo
6045 -----
6046
6047 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6048   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6049 * [The `rerun-if-changed` build script directive no longer causes the
6050   build script to incorrectly run twice in certain scenarios][1.7rr].
6051
6052 Compatibility Notes
6053 -------------------
6054
6055 * Soundness fixes to the interactions between associated types and
6056   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6057   code that violates the new rules. This is a significant change that
6058   is known to break existing code, so it has emitted warnings for the
6059   new error cases since 1.4 to give crate authors time to adapt. The
6060   details of what is changing are subtle; read the RFC for more.
6061 * [Several bugs in the compiler's visibility calculations were
6062   fixed][1.7v]. Since this was found to break significant amounts of
6063   code, the new errors will be emitted as warnings for several release
6064   cycles, under the `private_in_public` lint.
6065 * Defaulted type parameters were accidentally accepted in positions
6066   that were not intended. In this release, [defaulted type parameters
6067   appearing outside of type definitions will generate a
6068   warning][1.7d], which will become an error in future releases.
6069 * [Parsing "." as a float results in an error instead of 0][1.7p].
6070   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6071 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6072
6073 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6074 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6075 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6076 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6077 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6078 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6079 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6080 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6081 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6082 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6083 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6084 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6085 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6086 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6087 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6088 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6089 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6090 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6091 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6092 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6093 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6094 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6095 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6096 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6097 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6098 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6099 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6100 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6101 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6102 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6103 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6104 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6105 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6106 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6107 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6108 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6109 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6110 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6111 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6112 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6113 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6114 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6115 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6116 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6117 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6118 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6119 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6120 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6121 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6122 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6123 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6124 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6125 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6126 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6127 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6128 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6129 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6130 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6131 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6132 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6133 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6134 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6135 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6136 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6137 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6138 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6139 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6140 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6141 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6142 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6143 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6144 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6145 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6146 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6147 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6148 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6149 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6150 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6151 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6152
6153
6154 Version 1.6.0 (2016-01-21)
6155 ==========================
6156
6157 Language
6158 --------
6159
6160 * The `#![no_std]` attribute causes a crate to not be linked to the
6161   standard library, but only the [core library][1.6co], as described
6162   in [RFC 1184]. The core library defines common types and traits but
6163   has no platform dependencies whatsoever, and is the basis for Rust
6164   software in environments that cannot support a full port of the
6165   standard library, such as operating systems. Most of the core
6166   library is now stable.
6167
6168 Libraries
6169 ---------
6170
6171 * Stabilized APIs:
6172   [`Read::read_exact`],
6173   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6174   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6175   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6176   [`os::unix::fs::DirBuilderExt`],
6177   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6178   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6179   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6180   [`collections::hash_map::Drain`],
6181   [`collections::hash_map::HashMap::drain`],
6182   [`collections::hash_set::Drain`],
6183   [`collections::hash_set::HashSet::drain`],
6184   [`collections::binary_heap::Drain`],
6185   [`collections::binary_heap::BinaryHeap::drain`],
6186   [`Vec::extend_from_slice`] (renamed from `push_all`),
6187   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6188   [`RwLock::into_inner`],
6189   [`Iterator::min_by_key`] (renamed from `min_by`),
6190   [`Iterator::max_by_key`] (renamed from `max_by`).
6191 * The [core library][1.6co] is stable, as are most of its APIs.
6192 * [The `assert_eq!` macro supports arguments that don't implement
6193   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6194   `assert!`.
6195 * Several timer functions that take duration in milliseconds [are
6196   deprecated in favor of those that take `Duration`][1.6ms]. These
6197   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6198   `thread::park_timeout_ms`.
6199 * The algorithm by which `Vec` reserves additional elements was
6200   [tweaked to not allocate excessive space][1.6a] while still growing
6201   exponentially.
6202 * `From` conversions are [implemented from integers to floats][1.6f]
6203   in cases where the conversion is lossless. Thus they are not
6204   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6205   or `f64`. They are also not implemented for `isize` and `usize`
6206   because the implementations would be platform-specific. `From` is
6207   also implemented from `f32` to `f64`.
6208 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6209 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6210 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6211 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6212   improvements.
6213 * Sorting slices that are already sorted [is 50% faster in some
6214   cases][1.6s].
6215
6216 Cargo
6217 -----
6218
6219 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6220 * Cargo build scripts can specify their dependencies by emitting the
6221   [`rerun-if-changed`][1.6rr] key.
6222 * crates.io will reject publication of crates with dependencies that
6223   have a wildcard version constraint. Crates with wildcard
6224   dependencies were seen to cause a variety of problems, as described
6225   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6226   warning.
6227 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6228   release folder.  A variety of artifacts that Cargo failed to clean
6229   are now correctly deleted.
6230
6231 Misc
6232 ----
6233
6234 * The `unreachable_code` lint [warns when a function call's argument
6235   diverges][1.6dv].
6236 * The parser indicates [failures that may be caused by
6237   confusingly-similar Unicode characters][1.6uc]
6238 * Certain macro errors [are reported at definition time][1.6m], not
6239   expansion.
6240
6241 Compatibility Notes
6242 -------------------
6243
6244 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6245   environment variable when locating crates. This was a pre-cargo
6246   feature for integrating with the package manager that was
6247   accidentally never removed.
6248 * [A number of bugs were fixed in the privacy checker][1.6p] that
6249   could cause previously-accepted code to break.
6250 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6251 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6252   struct pattern syntax (`Foo(..)`) can no longer be used to match
6253   unit structs. This is a warning now, but will become an error in
6254   future releases. Patterns that share the same name as a const are
6255   now an error.
6256 * A bug was fixed that causes [rustc not to apply default type
6257   parameters][1.6xc] when resolving certain method implementations of
6258   traits defined in other crates.
6259
6260 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6261 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6262 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6263 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6264 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6265 [1.6co]: http://doc.rust-lang.org/core/index.html
6266 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6267 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6268 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6269 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6270 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6271 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6272 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6273 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6274 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6275 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6276 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6277 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6278 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6279 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6280 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6281 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6282 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6283 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6284 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6285 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6286 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6287 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6288 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6289 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6290 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6291 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6292 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6293 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6294 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6295 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6296 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6297 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6298 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6299 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6300 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6301 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6302 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6303 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6304 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6305 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6306 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6307
6308
6309 Version 1.5.0 (2015-12-10)
6310 ==========================
6311
6312 * ~700 changes, numerous bugfixes
6313
6314 Highlights
6315 ----------
6316
6317 * Stabilized APIs:
6318   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6319   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6320   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6321   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6322   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6323   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6324   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6325   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6326   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6327   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6328   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6329   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6330   [`Path::read_link`], [`Path::symlink_metadata`],
6331   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6332   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6333   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6334   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6335   [`slice::split_first_mut`], [`slice::split_first`],
6336   [`slice::split_last_mut`], [`slice::split_last`],
6337   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6338   [`str::MatchIndices`], [`str::RMatchIndices`],
6339   [`str::match_indices`], [`str::rmatch_indices`],
6340   [`str::slice_mut_unchecked`], [`string::ParseError`].
6341 * Rust applications hosted on crates.io can be installed locally to
6342   `~/.cargo/bin` with the [`cargo install`] command. Among other
6343   things this makes it easier to augment Cargo with new subcommands:
6344   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6345   invoked as `cargo foo`.
6346 * Crates with wildcard (`*`) dependencies will [emit warnings when
6347   published][1.5w]. In 1.6 it will no longer be possible to publish
6348   crates with wildcard dependencies.
6349
6350 Breaking Changes
6351 ----------------
6352
6353 * The rules determining when a particular lifetime must outlive
6354   a particular value (known as '[dropck]') have been [modified
6355   to not rely on parametricity][1.5p].
6356 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6357   and `Arc`][1.5a]. Because these smart pointer types implement
6358   `Deref`, this causes breakage in cases where the interior type
6359   contains methods of the same name.
6360 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6361   that they could drop their content. Soundness fix.
6362 * All method invocations are [properly checked][1.5wf1] for
6363   [well-formedness][1.5wf2]. Soundness fix.
6364 * Traits whose supertraits contain `Self` are [not object
6365   safe][1.5o]. Soundness fix.
6366 * Target specifications support a [`no_default_libraries`][1.5nd]
6367   setting that controls whether `-nodefaultlibs` is passed to the
6368   linker, and in turn the `is_like_windows` setting no longer affects
6369   the `-nodefaultlibs` flag.
6370 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6371 * The `#[inline]` and `#[repr]` attributes [can only appear
6372   in valid locations][1.5at].
6373 * Native libraries linked from the local crate are [passed to
6374   the linker before native libraries from upstream crates][1.5nl].
6375 * Two rarely-used attributes, `#[no_debug]` and
6376   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6377 * Negation of unsigned integers, which has been a warning for
6378   several releases, [is now behind a feature gate and will
6379   generate errors][1.5nu].
6380 * The parser accidentally accepted visibility modifiers on
6381   enum variants, a bug [which has been fixed][1.5ev].
6382 * [A bug was fixed that allowed `use` statements to import unstable
6383   features][1.5use].
6384
6385 Language
6386 --------
6387
6388 * When evaluating expressions at compile-time that are not
6389   compile-time constants (const-evaluating expressions in non-const
6390   contexts), incorrect code such as overlong bitshifts and arithmetic
6391   overflow will [generate a warning instead of an error][1.5ce],
6392   delaying the error until runtime. This will allow the
6393   const-evaluator to be expanded in the future backwards-compatibly.
6394 * The `improper_ctypes` lint [no longer warns about using `isize` and
6395   `usize` in FFI][1.5ict].
6396
6397 Libraries
6398 ---------
6399
6400 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6401   invariant][1.5c].
6402 * `Default` is [implemented for mutable slices][1.5d].
6403 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6404 * There are now `From` conversions [between floating point
6405   types][1.5f] where the conversions are lossless.
6406 * There are now `From` conversions [between integer types][1.5i] where
6407   the conversions are lossless.
6408 * [`fs::Metadata` implements `Clone`][1.5fs].
6409 * The `parse` method [accepts a leading "+" when parsing
6410   integers][1.5pi].
6411 * [`AsMut` is implemented for `Vec`][1.5am].
6412 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6413   been optimized][1.5cf] and no longer rely on the default impl.
6414 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6415   `unsafe extern "C"` function types now [implement `Clone`,
6416   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6417   `fmt::Debug` for up to 12 arguments][1.5fp].
6418 * [Dropping `Vec`s is much faster in unoptimized builds when the
6419   element types don't implement `Drop`][1.5dv].
6420 * A bug that caused in incorrect behavior when [combining `VecDeque`
6421   with zero-sized types][1.5vdz] was resolved.
6422 * [`PartialOrd` for slices is faster][1.5po].
6423
6424 Miscellaneous
6425 -------------
6426
6427 * [Crate metadata size was reduced by 20%][1.5md].
6428 * [Improvements to code generation reduced the size of libcore by 3.3
6429   MB and rustc's memory usage by 18MB][1.5m].
6430 * [Improvements to deref translation increased performance in
6431   unoptimized builds][1.5dr].
6432 * Various errors in trait resolution [are deduplicated to only be
6433   reported once][1.5te].
6434 * Rust has preliminary [support for rumprun kernels][1.5rr].
6435 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6436
6437 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6438 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6439 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6440 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6441 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6442 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6443 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6444 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6445 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6446 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6447 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6448 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6449 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6450 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6451 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6452 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6453 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6454 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6455 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6456 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6457 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6458 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6459 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6460 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6461 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6462 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6463 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6464 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6465 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6466 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6467 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6468 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6469 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6470 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6471 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6472 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6473 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6474 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6475 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6476 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6477 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6478 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6479 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6480 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6481 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6482 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6483 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6484 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6485 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6486 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6487 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6488 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6489 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6490 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6491 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6492 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6493 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6494 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6495 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6496 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6497 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6498 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6499 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6500 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6501 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6502 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6503 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6504 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6505 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6506 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6507 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6508 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6509 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6510 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6511 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6512 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6513 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6514 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6515 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6516 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6517 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6518 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6519 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6520 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6521 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6522 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6523 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6524 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6525 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6526
6527 Version 1.4.0 (2015-10-29)
6528 ==========================
6529
6530 * ~1200 changes, numerous bugfixes
6531
6532 Highlights
6533 ----------
6534
6535 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6536   GNU) are now supported and recommended for use.
6537
6538 Breaking Changes
6539 ----------------
6540
6541 * [Several changes have been made to fix type soundness and improve
6542   the behavior of associated types][sound]. See [RFC 1214]. Although
6543   we have mostly introduced these changes as warnings this release, to
6544   become errors next release, there are still some scenarios that will
6545   see immediate breakage.
6546 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6547   line breaks in addition to `\n`][crlf].
6548 * [Loans of `'static` lifetime extend to the end of a function][stat].
6549 * [`str::parse` no longer introduces avoidable rounding error when
6550   parsing floating point numbers. Together with earlier changes to
6551   float formatting/output, "round trips" like f.to_string().parse()
6552   now preserve the value of f exactly. Additionally, leading plus
6553   signs are now accepted][fp3].
6554
6555
6556 Language
6557 --------
6558
6559 * `use` statements that import multiple items [can now rename
6560   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6561 * [Binops work correctly on fat pointers][binfat].
6562 * `pub extern crate`, which does not behave as expected, [issues a
6563   warning][pec] until a better solution is found.
6564
6565 Libraries
6566 ---------
6567
6568 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6569   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6570   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6571   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6572   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6573   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6574   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6575   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6576   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6577   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6578   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6579   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6580   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6581   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6582   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6583   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6584   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6585   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6586   [`thread::sleep`].
6587 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6588   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6589   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6590   `f64::from_str_radix`.
6591 * [Reverse-searching strings is faster with the 'two-way'
6592   algorithm][s].
6593 * [`std::io::copy` allows `?Sized` arguments][cc].
6594 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6595   [override `count`, `nth` and `last` with an O(1)
6596   implementation][it].
6597 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6598 * [`IntoRawFd` has been added to the Unix-specific prelude,
6599   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6600   prelude][pr].
6601 * [`Extend<String>` and `FromIterator<String` are both implemented for
6602   `String`][es].
6603 * [`IntoIterator` is implemented for references to `Option` and
6604   `Result`][into2].
6605 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6606   Copy`][ext] as part of [RFC 839]. This will cause type inference
6607   breakage in rare situations.
6608 * [`BinaryHeap` implements `Debug`][bh2].
6609 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6610   arrays][bm].
6611 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6612   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6613 * [String comparison is faster][faststr].
6614 * `&mut T` where `T: std::fmt::Write` [also implements
6615   `std::fmt::Write`][mutw].
6616 * [A stable regression in `VecDeque::push_back` and other
6617   capacity-altering methods that caused panics for zero-sized types
6618   was fixed][vd].
6619 * [Function pointers implement traits for up to 12 parameters][fp2].
6620
6621 Miscellaneous
6622 -------------
6623
6624 * The compiler [no longer uses the 'morestack' feature to prevent
6625   stack overflow][mm]. Instead it uses guard pages and stack
6626   probes (though stack probes are not yet implemented on any platform
6627   but Windows).
6628 * [The compiler matches traits faster when projections are involved][p].
6629 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6630   `usize`][ffi].
6631 * [Cargo now displays useful information about what its doing during
6632   `cargo update`][cu].
6633
6634 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6635 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6636 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6637 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6638 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6639 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6640 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6641 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6642 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6643 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6644 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6645 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6646 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6647 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6648 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6649 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6650 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6651 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6652 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6653 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6654 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6655 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6656 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6657 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6658 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6659 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6660 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6661 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6662 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6663 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6664 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6665 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6666 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6667 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6668 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6669 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6670 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6671 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6672 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6673 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6674 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6675 [bh2]: https://github.com/rust-lang/rust/pull/28156
6676 [binfat]: https://github.com/rust-lang/rust/pull/28270
6677 [bm]: https://github.com/rust-lang/rust/pull/28197
6678 [cc]: https://github.com/rust-lang/rust/pull/27531
6679 [crlf]: https://github.com/rust-lang/rust/pull/28034
6680 [cu]: https://github.com/rust-lang/cargo/pull/1931
6681 [d]: https://github.com/rust-lang/rust/pull/27825
6682 [dep]: https://github.com/rust-lang/rust/pull/28339
6683 [es]: https://github.com/rust-lang/rust/pull/27956
6684 [ext]: https://github.com/rust-lang/rust/pull/28094
6685 [faststr]: https://github.com/rust-lang/rust/pull/28338
6686 [ffi]: https://github.com/rust-lang/rust/pull/28779
6687 [fp]: https://github.com/rust-lang/rust/pull/28268
6688 [fp2]: https://github.com/rust-lang/rust/pull/28560
6689 [fp3]: https://github.com/rust-lang/rust/pull/27307
6690 [i]: https://github.com/rust-lang/rust/pull/27451
6691 [into2]: https://github.com/rust-lang/rust/pull/28039
6692 [it]: https://github.com/rust-lang/rust/pull/27652
6693 [mm]: https://github.com/rust-lang/rust/pull/27338
6694 [mutw]: https://github.com/rust-lang/rust/pull/28368
6695 [sound]: https://github.com/rust-lang/rust/pull/27641
6696 [p]: https://github.com/rust-lang/rust/pull/27866
6697 [pec]: https://github.com/rust-lang/rust/pull/28486
6698 [pr]: https://github.com/rust-lang/rust/pull/27896
6699 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6700 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6701 [s]: https://github.com/rust-lang/rust/pull/27474
6702 [stab]: https://github.com/rust-lang/rust/pull/28339
6703 [stat]: https://github.com/rust-lang/rust/pull/28321
6704 [vd]: https://github.com/rust-lang/rust/pull/28494
6705
6706 Version 1.3.0 (2015-09-17)
6707 ==============================
6708
6709 * ~900 changes, numerous bugfixes
6710
6711 Highlights
6712 ----------
6713
6714 * The [new object lifetime defaults][nold] have been [turned
6715   on][nold2] after a cycle of warnings about the change. Now types
6716   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6717   being interpreted as `&'a Box<Trait+'a>` to `&'a
6718   Box<Trait+'static>`.
6719 * [The Rustonomicon][nom] is a new book in the official documentation
6720   that dives into writing unsafe Rust.
6721 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6722   timekeeping is employed by other std APIs, as well as out-of-tree
6723   time crates.
6724
6725 Breaking Changes
6726 ----------------
6727
6728 * The [new object lifetime defaults][nold] have been [turned
6729   on][nold2] after a cycle of warnings about the change.
6730 * There is a known [regression][lr] in how object lifetime elision is
6731   interpreted, the proper solution for which is undetermined.
6732 * The `#[prelude_import]` attribute, an internal implementation
6733   detail, was accidentally stabilized previously. [It has been put
6734   behind the `prelude_import` feature gate][pi]. This change is
6735   believed to break no existing code.
6736 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6737   [more sane for dynamically sized types][dst3]. Code that relied on
6738   the previous behavior is thought to be broken.
6739 * The `dropck` rules, which checks that destructors can't access
6740   destroyed values, [have been updated][dropck] to match the
6741   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6742   cause some previously-compiling code to no longer build.
6743
6744 Language
6745 --------
6746
6747 * The [new object lifetime defaults][nold] have been [turned
6748   on][nold2] after a cycle of warnings about the change.
6749 * Semicolons may [now follow types and paths in
6750   macros](https://github.com/rust-lang/rust/pull/27000).
6751 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6752   [more sane for dynamically sized types][dst3]. Code that relied on
6753   the previous behavior is not known to exist, and suspected to be
6754   broken.
6755 * `'static` variables [may now be recursive][st].
6756 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6757   implementations correctly.
6758 * The `dropck` rules, which checks that destructors can't access
6759   destroyed values, [have been updated][dropck] to match the
6760   [RFC][dropckrfc].
6761
6762 Libraries
6763 ---------
6764
6765 * The [`Duration`] API, [has been stabilized][ds], as well as the
6766   `std::time` module, which presently contains only `Duration`.
6767 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6768 * The owned C string, [`CString`], implements [`Borrow`] and the
6769   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6770   these allow C strings to be borrowed and cloned in generic code.
6771 * [`CStr`] implements [`Debug`].
6772 * [`AtomicPtr`] implements [`Debug`].
6773 * [`Error`] trait objects [can be downcast to their concrete types][e]
6774   in many common configurations, using the [`is`], [`downcast`],
6775   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6776   [`Any`] trait.
6777 * Searching for substrings now [employs the two-way algorithm][search]
6778   instead of doing a naive search. This gives major speedups to a
6779   number of methods, including [`contains`][sc], [`find`][sf],
6780   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6781   [`ends_with`][sew] are also faster.
6782 * The performance of `PartialEq` for slices is [much faster][ps].
6783 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6784   is overridden and optimized by the implementations for scalars.
6785 * The [`Hasher`] trait now has a number of specialized `write_*`
6786   methods for primitive types, for efficiency.
6787 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6788   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6789   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6790   of [`std::error::Error::cause`][iec] also delegates to the inner
6791   error.
6792 * [`process::Child`][pc] gained the [`id`] method, which returns a
6793   `u32` representing the platform-specific process identifier.
6794 * The [`connect`] method on slices is deprecated, replaced by the new
6795   [`join`] method (note that both of these are on the *unstable*
6796   [`SliceConcatExt`] trait, but through the magic of the prelude are
6797   available to stable code anyway).
6798 * The [`Div`] operator is implemented for [`Wrapping`] types.
6799 * [`DerefMut` is implemented for `String`][dms].
6800 * Performance of SipHash (the default hasher for `HashMap`) is
6801   [better for long data][sh].
6802 * [`AtomicPtr`] implements [`Send`].
6803 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6804   are now [specialized to use uninitialized buffers for increased
6805   performance][rte].
6806 * Lifetime parameters of foreign functions [are now resolved
6807   properly][f].
6808
6809 Misc
6810 ----
6811
6812 * Rust can now, with some coercion, [produce programs that run on
6813   Windows XP][xp], though XP is not considered a supported platform.
6814 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6815   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6816   recommended for use in 1.3, though should be fully-functional
6817   in the [64-bit 1.4 beta][b14].
6818 * On Fedora-based systems installation will [properly configure the
6819   dynamic linker][fl].
6820 * The compiler gained many new extended error descriptions, which can
6821   be accessed with the `--explain` flag.
6822 * The `dropck` pass, which checks that destructors can't access
6823   destroyed values, [has been rewritten][dropck]. This fixes some
6824   soundness holes, and as such will cause some previously-compiling
6825   code to no longer build.
6826 * `rustc` now uses [LLVM to write archive files where possible][ar].
6827   Eventually this will eliminate the compiler's dependency on the ar
6828   utility.
6829 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6830   supported FreeBSD on x86_64).
6831 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6832   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6833   more strict.
6834 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6835   will kill the process instead of leaking][nlp].
6836
6837 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6838 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6839 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6840 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6841 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6842 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6843 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6844 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6845 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6846 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6847 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6848 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6849 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6850 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6851 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6852 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6853 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6854 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6855 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6856 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6857 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6858 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6859 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6860 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6861 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6862 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6863 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6864 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6865 [ar]: https://github.com/rust-lang/rust/pull/26926
6866 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6867 [dms]: https://github.com/rust-lang/rust/pull/26241
6868 [dropck]: https://github.com/rust-lang/rust/pull/27261
6869 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6870 [ds]: https://github.com/rust-lang/rust/pull/26818
6871 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6872 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6873 [dst3]: https://github.com/rust-lang/rust/pull/27351
6874 [e]: https://github.com/rust-lang/rust/pull/24793
6875 [f]: https://github.com/rust-lang/rust/pull/26588
6876 [fb]: https://github.com/rust-lang/rust/pull/26959
6877 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6878 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6879 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6880 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6881 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6882 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6883 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6884 [lic]: https://github.com/rust-lang/rust/pull/26583
6885 [lnu]: https://github.com/rust-lang/rust/pull/27026
6886 [lr]: https://github.com/rust-lang/rust/issues/27248
6887 [lum]: https://github.com/rust-lang/rust/pull/26378
6888 [lur]: https://github.com/rust-lang/rust/pull/26783
6889 [nlp]: https://github.com/rust-lang/rust/pull/27176
6890 [nold2]: https://github.com/rust-lang/rust/pull/27045
6891 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6892 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6893 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6894 [pi]: https://github.com/rust-lang/rust/pull/26699
6895 [ps]: https://github.com/rust-lang/rust/pull/26884
6896 [rte]: https://github.com/rust-lang/rust/pull/26950
6897 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6898 [search]: https://github.com/rust-lang/rust/pull/26327
6899 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6900 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6901 [sh]: https://github.com/rust-lang/rust/pull/27280
6902 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6903 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6904 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6905 [st]: https://github.com/rust-lang/rust/pull/26630
6906 [win1]: https://github.com/rust-lang/rust/pull/26569
6907 [win2]: https://github.com/rust-lang/rust/pull/26741
6908 [win3]: https://github.com/rust-lang/rust/pull/26741
6909 [win4]: https://github.com/rust-lang/rust/pull/27210
6910 [xp]: https://github.com/rust-lang/rust/pull/26569
6911
6912 Version 1.2.0 (2015-08-07)
6913 ==========================
6914
6915 * ~1200 changes, numerous bugfixes
6916
6917 Highlights
6918 ----------
6919
6920 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6921   like `Rc` to contain types without a fixed size, arrays and trait
6922   objects, finally enabling use of `Rc<[T]>` and completing the
6923   implementation of DST.
6924 * [Parallel codegen][parcodegen] is now working again, which can
6925   substantially speed up large builds in debug mode; It also gets
6926   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6927   jobs). It's not enabled by default, but will be "in the near
6928   future". It can be activated with the `-C codegen-units=N` flag to
6929   `rustc`.
6930 * This is the first release with [experimental support for linking
6931   with the MSVC linker and lib C on Windows (instead of using the GNU
6932   variants via MinGW)][win]. It is yet recommended only for the most
6933   intrepid Rustaceans.
6934 * Benchmark compilations are showing a 30% improvement in
6935   bootstrapping over 1.1.
6936
6937 Breaking Changes
6938 ----------------
6939
6940 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6941   unicode case mapping, which is a previously-planned change in
6942   behavior and considered a bugfix.
6943 * [`mem::align_of`] now specifies [the *minimum alignment* for
6944   T][align], which is usually the alignment programs are interested
6945   in, and the same value reported by clang's
6946   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6947   break real code.
6948 * [The `#[packed]` attribute is no longer silently accepted by the
6949   compiler][packed]. This attribute did nothing and code that
6950   mentioned it likely did not work as intended.
6951 * Associated type defaults are [now behind the
6952   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6953   defaults *did not work*, but could be mentioned syntactically. As
6954   such this breakage has minimal impact.
6955
6956 Language
6957 --------
6958
6959 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6960   matching against dereferenceable values.
6961
6962 Libraries
6963 ---------
6964
6965 * The [`Extend`] trait, which grows a collection from an iterator, is
6966   implemented over iterators of references, for `String`, `Vec`,
6967   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6968   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6969 * The [`iter::once`] function returns an iterator that yields a single
6970   element, and [`iter::empty`] returns an iterator that yields no
6971   elements.
6972 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6973   over substring matches.
6974 * [`Cell`] and [`RefCell`] both implement `Eq`.
6975 * A number of methods for wrapping arithmetic are added to the
6976   integral types, [`wrapping_div`], [`wrapping_rem`],
6977   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6978   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6979   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6980   type.. It is illegal for the default arithmetic operations in Rust
6981   to overflow; the desire to wrap must be explicit.
6982 * The `{:#?}` formatting specifier [displays the alternate,
6983   pretty-printed][debugfmt] form of the `Debug` formatter. This
6984   feature was actually introduced prior to 1.0 with little
6985   fanfare.
6986 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
6987   for writing data to formatted strings, similar to [`io::Write`].
6988 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
6989   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
6990   are used by code generators to emit implementations of [`Debug`].
6991 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
6992   methods that convert case, following Unicode case mapping.
6993 * It is now easier to handle poisoned locks. The [`PoisonError`]
6994   type, returned by failing lock operations, exposes `into_inner`,
6995   `get_ref`, and `get_mut`, which all give access to the inner lock
6996   guard, and allow the poisoned lock to continue to operate. The
6997   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
6998   poisoned lock without attempting to take the lock.
6999 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7000   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7001   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7002   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7003   `ChildStderr`.
7004 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7005   malformed input.
7006
7007 Misc
7008 ----
7009
7010 * `rustc` employs smarter heuristics for guessing at [typos].
7011 * `rustc` emits more efficient code for [no-op conversions between
7012   unsafe pointers][nop].
7013 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7014   resulting in faster compile times and smaller code.
7015
7016 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7017 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7018 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7019 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7020 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7021 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7022 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7023 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7024 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7025 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7026 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7027 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7028 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7029 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7030 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7031 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7032 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7033 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7034 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7035 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7036 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7037 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7038 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7039 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7040 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7041 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7042 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7043 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7044 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7045 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7046 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7047 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7048 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7049 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7050 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7051 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7052 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7053 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7054 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7055 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7056 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7057 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7058 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7059 [align]: https://github.com/rust-lang/rust/pull/25646
7060 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7061 [typos]: https://github.com/rust-lang/rust/pull/26087
7062 [nop]: https://github.com/rust-lang/rust/pull/26336
7063 [fat]: https://github.com/rust-lang/rust/pull/26411
7064 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7065 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7066 [packed]: https://github.com/rust-lang/rust/pull/25541
7067 [ad]: https://github.com/rust-lang/rust/pull/27382
7068 [win]: https://github.com/rust-lang/rust/pull/25350
7069
7070 Version 1.1.0 (2015-06-25)
7071 =========================
7072
7073 * ~850 changes, numerous bugfixes
7074
7075 Highlights
7076 ----------
7077
7078 * The [`std::fs` module has been expanded][fs] to expand the set of
7079   functionality exposed:
7080   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7081     don't incur a syscall on some platforms.
7082   * A `symlink_metadata` function has been added.
7083   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7084     access to all underlying information.
7085 * The compiler now contains extended explanations of many errors. When an error
7086   with an explanation occurs the compiler suggests using the `--explain` flag
7087   to read the explanation. Error explanations are also [available online][err-index].
7088 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7089   well as other work, the time to bootstrap the compiler decreased by
7090   32%.
7091
7092 Libraries
7093 ---------
7094
7095 * The [`str::split_whitespace`] method splits a string on unicode
7096   whitespace boundaries.
7097 * On both Windows and Unix, new extension traits provide conversion of
7098   I/O types to and from the underlying system handles. On Unix, these
7099   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7100   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7101   `TcpListener`, and `UpdSocket`. Further implementations for
7102   `std::process` will be stabilized later.
7103 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7104   Windows, symlinks can be created with
7105   `std::os::windows::symlink_dir` and
7106   `std::os::windows::symlink_file`.
7107 * The `mpsc::Receiver` type can now be converted into an iterator with
7108   `into_iter` on the [`IntoIterator`] trait.
7109 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7110   implementation of the [`From`] trait.
7111 * The `Debug` implementation for `RangeFull` [creates output that is
7112   more consistent with other implementations][rf].
7113 * [`Debug` is implemented for `File`][file].
7114 * The `Default` implementation for `Arc` [no longer requires `Sync +
7115   Send`][arc].
7116 * [The `Iterator` methods `count`, `nth`, and `last` have been
7117   overridden for slices to have O(1) performance instead of O(n)][si].
7118 * Incorrect handling of paths on Windows has been improved in both the
7119   compiler and the standard library.
7120 * [`AtomicPtr` gained a `Default` implementation][ap].
7121 * In accordance with Rust's policy on arithmetic overflow `abs` now
7122   [panics on overflow when debug assertions are enabled][abs].
7123 * The [`Cloned`] iterator, which was accidentally left unstable for
7124   1.0 [has been stabilized][c].
7125 * The [`Incoming`] iterator, which iterates over incoming TCP
7126   connections, and which was accidentally unnamable in 1.0, [is now
7127   properly exported][inc].
7128 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7129   `sift_up` or `sift_down` panic][bh].
7130 * The [`split_off`] method of `LinkedList` [no longer corrupts
7131   the list in certain scenarios][ll].
7132
7133 Misc
7134 ----
7135
7136 * Type checking performance [has improved notably][sk] with
7137   [multiple improvements][pre].
7138 * The compiler [suggests code changes][ch] for more errors.
7139 * rustc and it's build system have experimental support for [building
7140   toolchains against MUSL][m] instead of glibc on Linux.
7141 * The compiler defines the `target_env` cfg value, which is used for
7142   distinguishing toolchains that are otherwise for the same
7143   platform. Presently this is set to `gnu` for common GNU Linux
7144   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7145 * The [`cargo rustc`][crc] command invokes a build with custom flags
7146   to rustc.
7147 * [Android executables are always position independent][pie].
7148 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7149   with `Drop`][drop].
7150
7151 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7152 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7153 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7154 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7155 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7156 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7157 [rf]: https://github.com/rust-lang/rust/pull/24491
7158 [err-index]: https://doc.rust-lang.org/error-index.html
7159 [sk]: https://github.com/rust-lang/rust/pull/24615
7160 [pre]: https://github.com/rust-lang/rust/pull/25323
7161 [file]: https://github.com/rust-lang/rust/pull/24598
7162 [ch]: https://github.com/rust-lang/rust/pull/24683
7163 [arc]: https://github.com/rust-lang/rust/pull/24695
7164 [si]: https://github.com/rust-lang/rust/pull/24701
7165 [ap]: https://github.com/rust-lang/rust/pull/24834
7166 [m]: https://github.com/rust-lang/rust/pull/24777
7167 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7168 [crc]: https://github.com/rust-lang/cargo/pull/1568
7169 [pie]: https://github.com/rust-lang/rust/pull/24953
7170 [abs]: https://github.com/rust-lang/rust/pull/25441
7171 [c]: https://github.com/rust-lang/rust/pull/25496
7172 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7173 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7174 [inc]: https://github.com/rust-lang/rust/pull/25522
7175 [bh]: https://github.com/rust-lang/rust/pull/25856
7176 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7177 [ll]: https://github.com/rust-lang/rust/pull/26022
7178 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7179 [drop]: https://github.com/rust-lang/rust/pull/24935
7180
7181 Version 1.0.0 (2015-05-15)
7182 ========================
7183
7184 * ~1500 changes, numerous bugfixes
7185
7186 Highlights
7187 ----------
7188
7189 * The vast majority of the standard library is now `#[stable]`. It is
7190   no longer possible to use unstable features with a stable build of
7191   the compiler.
7192 * Many popular crates on [crates.io] now work on the stable release
7193   channel.
7194 * Arithmetic on basic integer types now [checks for overflow in debug
7195   builds][overflow].
7196
7197 Language
7198 --------
7199
7200 * Several [restrictions have been added to trait coherence][coh] in
7201   order to make it easier for upstream authors to change traits
7202   without breaking downstream code.
7203 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7204   improve error messages and macro behavior. For example, `0b1234` is
7205   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7206 * Trait bounds [are always invariant][inv], eliminating the need for
7207   the `PhantomFn` and `MarkerTrait` lang items, which have been
7208   removed.
7209 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7210   "foo" as bar` syntax has been replaced with `extern crate foo as
7211   bar`, and Cargo now automatically translates "-" in *package* names
7212   to underscore for the crate name.
7213 * [Lifetime shadowing is an error][lt].
7214 * [`Send` no longer implies `'static`][send-rfc].
7215 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7216   `MyType::default()`.
7217 * Primitive types [now have inherent methods][prim-inherent],
7218   obviating the need for extension traits like `SliceExt`.
7219 * Methods with `Self: Sized` in their `where` clause are [considered
7220   object-safe][self-sized], allowing many extension traits like
7221   `IteratorExt` to be merged into the traits they extended.
7222 * You can now [refer to associated types][assoc-where] whose
7223   corresponding trait bounds appear only in a `where` clause.
7224 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7225   like `Send` and `Sync` are now library-defined.
7226 * A [Reflect trait][reflect] was introduced, which means that
7227   downcasting via the `Any` trait is effectively limited to concrete
7228   types. This helps retain the potentially-important "parametricity"
7229   property: generic code cannot behave differently for different type
7230   arguments except in minor ways.
7231 * The `unsafe_destructor` feature is now deprecated in favor of the
7232   [new `dropck`][dropck]. This change is a major reduction in unsafe
7233   code.
7234
7235 Libraries
7236 ---------
7237
7238 * The `thread_local` module [has been renamed to `std::thread`][th].
7239 * The methods of `IteratorExt` [have been moved to the `Iterator`
7240   trait itself][ie].
7241 * Several traits that implement Rust's conventions for type
7242   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7243   [centralized in the `std::convert` module][con].
7244 * The `FromError` trait [was removed in favor of `From`][fe].
7245 * The basic sleep function [has moved to
7246   `std::thread::sleep_ms`][slp].
7247 * The `splitn` function now takes an `n` parameter that represents the
7248   number of items yielded by the returned iterator [instead of the
7249   number of 'splits'][spl].
7250 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7251 * [Derived implementations of `PartialOrd` now order enums according
7252   to their explicitly-assigned discriminants][po].
7253 * [Methods for searching strings are generic over `Pattern`s][pat],
7254   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7255   some others.
7256 * [In method resolution, object methods are resolved before inherent
7257   methods][meth].
7258 * [`String::from_str` has been deprecated in favor of the `From` impl,
7259   `String::from`][sf].
7260 * [`io::Error` implements `Sync`][ios].
7261 * [The `words` method on `&str` has been replaced with
7262   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7263   a word?'
7264 * The new path and IO modules are complete and `#[stable]`. This
7265   was the major library focus for this cycle.
7266 * The path API was [revised][path-normalize] to normalize `.`,
7267   adjusting the tradeoffs in favor of the most common usage.
7268 * A large number of remaining APIs in `std` were also stabilized
7269   during this cycle; about 75% of the non-deprecated API surface
7270   is now stable.
7271 * The new [string pattern API][string-pattern] landed, which makes
7272   the string slice API much more internally consistent and flexible.
7273 * A new set of [generic conversion traits][conversion] replaced
7274   many existing ad hoc traits.
7275 * Generic numeric traits were [completely removed][num-traits]. This
7276   was made possible thanks to inherent methods for primitive types,
7277   and the removal gives maximal flexibility for designing a numeric
7278   hierarchy in the future.
7279 * The `Fn` traits are now related via [inheritance][fn-inherit]
7280   and provide ergonomic [blanket implementations][fn-blanket].
7281 * The `Index` and `IndexMut` traits were changed to
7282   [take the index by value][index-value], enabling code like
7283   `hash_map["string"]` to work.
7284 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7285   `Copy` data is known to be `Clone` as well.
7286
7287 Misc
7288 ----
7289
7290 * Many errors now have extended explanations that can be accessed with
7291   the `--explain` flag to `rustc`.
7292 * Many new examples have been added to the standard library
7293   documentation.
7294 * rustdoc has received a number of improvements focused on completion
7295   and polish.
7296 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7297 * Much headway was made on ecosystem-wide CI, making it possible
7298   to [compare builds for breakage][ci-compare].
7299
7300
7301 [crates.io]: http://crates.io
7302 [clo]: https://github.com/rust-lang/rust/pull/24034
7303 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7304 [con]: https://github.com/rust-lang/rust/pull/23875
7305 [cr]: https://github.com/rust-lang/rust/pull/23419
7306 [fe]: https://github.com/rust-lang/rust/pull/23879
7307 [ie]: https://github.com/rust-lang/rust/pull/23300
7308 [inv]: https://github.com/rust-lang/rust/pull/23938
7309 [ios]: https://github.com/rust-lang/rust/pull/24133
7310 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7311 [lt]: https://github.com/rust-lang/rust/pull/24057
7312 [meth]: https://github.com/rust-lang/rust/pull/24056
7313 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7314 [po]: https://github.com/rust-lang/rust/pull/24270
7315 [sf]: https://github.com/rust-lang/rust/pull/24517
7316 [slp]: https://github.com/rust-lang/rust/pull/23949
7317 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7318 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7319 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7320 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7321 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7322 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7323 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7324 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7325 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7326 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7327 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7328 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7329 [reflect]: https://github.com/rust-lang/rust/pull/23712
7330 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7331 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7332 [index-value]: https://github.com/rust-lang/rust/pull/23601
7333 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7334 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7335 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7336 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7337 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7338 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7339
7340
7341 Version 1.0.0-alpha.2 (2015-02-20)
7342 =====================================
7343
7344 * ~1300 changes, numerous bugfixes
7345
7346 * Highlights
7347
7348     * The various I/O modules were [overhauled][io-rfc] to reduce
7349       unnecessary abstractions and provide better interoperation with
7350       the underlying platform. The old `io` module remains temporarily
7351       at `std::old_io`.
7352     * The standard library now [participates in feature gating][feat],
7353       so use of unstable libraries now requires a `#![feature(...)]`
7354       attribute. The impact of this change is [described on the
7355       forum][feat-forum]. [RFC][feat-rfc].
7356
7357 * Language
7358
7359     * `for` loops [now operate on the `IntoIterator` trait][into],
7360       which eliminates the need to call `.iter()`, etc. to iterate
7361       over collections. There are some new subtleties to remember
7362       though regarding what sort of iterators various types yield, in
7363       particular that `for foo in bar { }` yields values from a move
7364       iterator, destroying the original collection. [RFC][into-rfc].
7365     * Objects now have [default lifetime bounds][obj], so you don't
7366       have to write `Box<Trait+'static>` when you don't care about
7367       storing references. [RFC][obj-rfc].
7368     * In types that implement `Drop`, [lifetimes must outlive the
7369       value][drop]. This will soon make it possible to safely
7370       implement `Drop` for types where `#[unsafe_destructor]` is now
7371       required. Read the [gorgeous RFC][drop-rfc] for details.
7372     * The fully qualified <T as Trait>::X syntax lets you set the Self
7373       type for a trait method or associated type. [RFC][ufcs-rfc].
7374     * References to types that implement `Deref<U>` now [automatically
7375       coerce to references][deref] to the dereferenced type `U`,
7376       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7377       should eliminate many unsightly uses of `&*`, as when converting
7378       from references to vectors into references to
7379       slices. [RFC][deref-rfc].
7380     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7381       `|:|`) is obsolete and closure kind is inferred from context.
7382     * [`Self` is a keyword][Self].
7383
7384 * Libraries
7385
7386     * The `Show` and `String` formatting traits [have been
7387       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7388       their related purposes. Automatically getting a string
7389       conversion to use with `format!("{:?}", something_to_debug)` is
7390       now written `#[derive(Debug)]`.
7391     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7392       OsStr}`, provide strings in platform-specific encodings for easier
7393       interop with system APIs. [RFC][osstr-rfc].
7394     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7395       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7396       creating raw pointers.
7397
7398 * Tooling
7399
7400     * Certain long error messages of the form 'expected foo found bar'
7401       are now [split neatly across multiple
7402       lines][multiline]. Examples in the PR.
7403     * On Unix Rust can be [uninstalled][un] by running
7404       `/usr/local/lib/rustlib/uninstall.sh`.
7405     * The `#[rustc_on_unimplemented]` attribute, requiring the
7406       'on_unimplemented' feature, lets rustc [display custom error
7407       messages when a trait is expected to be implemented for a type
7408       but is not][onun].
7409
7410 * Misc
7411
7412     * Rust is tested against a [LALR grammar][lalr], which parses
7413       almost all the Rust files that rustc does.
7414
7415 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7416 [close]: https://github.com/rust-lang/rust/pull/21843
7417 [deref]: https://github.com/rust-lang/rust/pull/21351
7418 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7419 [drop]: https://github.com/rust-lang/rust/pull/21972
7420 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7421 [feat]: https://github.com/rust-lang/rust/pull/21248
7422 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7423 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7424 [fmt]: https://github.com/rust-lang/rust/pull/21457
7425 [into]: https://github.com/rust-lang/rust/pull/20790
7426 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7427 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7428 [lalr]: https://github.com/rust-lang/rust/pull/21452
7429 [multiline]: https://github.com/rust-lang/rust/pull/19870
7430 [obj]: https://github.com/rust-lang/rust/pull/22230
7431 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7432 [onun]: https://github.com/rust-lang/rust/pull/20889
7433 [osstr]: https://github.com/rust-lang/rust/pull/21488
7434 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7435 [Self]: https://github.com/rust-lang/rust/pull/22158
7436 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7437 [un]: https://github.com/rust-lang/rust/pull/22256
7438
7439
7440 Version 1.0.0-alpha (2015-01-09)
7441 ==================================
7442
7443   * ~2400 changes, numerous bugfixes
7444
7445   * Highlights
7446
7447     * The language itself is considered feature complete for 1.0,
7448       though there will be many usability improvements and bugfixes
7449       before the final release.
7450     * Nearly 50% of the public API surface of the standard library has
7451       been declared 'stable'. Those interfaces are unlikely to change
7452       before 1.0.
7453     * The long-running debate over integer types has been
7454       [settled][ints]: Rust will ship with types named `isize` and
7455       `usize`, rather than `int` and `uint`, for pointer-sized
7456       integers. Guidelines will be rolled out during the alpha cycle.
7457     * Most crates that are not `std` have been moved out of the Rust
7458       distribution into the Cargo ecosystem so they can evolve
7459       separately and don't need to be stabilized as quickly, including
7460       'time', 'getopts', 'num', 'regex', and 'term'.
7461     * Documentation continues to be expanded with more API coverage, more
7462       examples, and more in-depth explanations. The guides have been
7463       consolidated into [The Rust Programming Language][trpl].
7464     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7465     * All official Rust binary installers now come with [Cargo], the
7466       Rust package manager.
7467
7468 * Language
7469
7470     * Closures have been [completely redesigned][unboxed] to be
7471       implemented in terms of traits, can now be used as generic type
7472       bounds and thus monomorphized and inlined, or via an opaque
7473       pointer (boxed) as in the old system. The new system is often
7474       referred to as 'unboxed' closures.
7475     * Traits now support [associated types][assoc], allowing families
7476       of related types to be defined together and used generically in
7477       powerful ways.
7478     * Enum variants are [namespaced by their type names][enum].
7479     * [`where` clauses][where] provide a more versatile and attractive
7480       syntax for specifying generic bounds, though the previous syntax
7481       remains valid.
7482     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7483       numeric types.
7484     * Rust [no longer has a runtime][rt] of any description, and only
7485       supports OS threads, not green threads.
7486     * At long last, Rust has been overhauled for 'dynamically-sized
7487       types' ([DST]), which integrates 'fat pointers' (object types,
7488       arrays, and `str`) more deeply into the type system, making it
7489       more consistent.
7490     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7491       `..j` that produce range types and which, when combined with the
7492       `Index` operator and multidispatch, leads to a convenient slice
7493       notation, `[i..j]`.
7494     * The new range syntax revealed an ambiguity in the fixed-length
7495       array syntax, so now fixed length arrays [are written `[T;
7496       N]`][arrays].
7497     * The `Copy` trait is no longer implemented automatically. Unsafe
7498       pointers no longer implement `Sync` and `Send` so types
7499       containing them don't automatically either. `Sync` and `Send`
7500       are now 'unsafe traits' so one can "forcibly" implement them via
7501       `unsafe impl` if a type confirms to the requirements for them
7502       even though the internals do not (e.g. structs containing unsafe
7503       pointers like `Arc`). These changes are intended to prevent some
7504       footguns and are collectively known as [opt-in built-in
7505       traits][oibit] (though `Sync` and `Send` will soon become pure
7506       library types unknown to the compiler).
7507     * Operator traits now take their operands [by value][ops], and
7508       comparison traits can use multidispatch to compare one type
7509       against multiple other types, allowing e.g. `String` to be
7510       compared with `&str`.
7511     * `if let` and `while let` are no longer feature-gated.
7512     * Rust has adopted a more [uniform syntax for escaping unicode
7513       characters][unicode].
7514     * `macro_rules!` [has been declared stable][mac]. Though it is a
7515       flawed system it is sufficiently popular that it must be usable
7516       for 1.0. Effort has gone into [future-proofing][mac-future] it
7517       in ways that will allow other macro systems to be developed in
7518       parallel, and won't otherwise impact the evolution of the
7519       language.
7520     * The prelude has been [pared back significantly][prelude] such
7521       that it is the minimum necessary to support the most pervasive
7522       code patterns, and through [generalized where clauses][where]
7523       many of the prelude extension traits have been consolidated.
7524     * Rust's rudimentary reflection [has been removed][refl], as it
7525       incurred too much code generation for little benefit.
7526     * [Struct variants][structvars] are no longer feature-gated.
7527     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7528       known as 'higher-ranked trait bounds', this crucially allows
7529       unboxed closures to work.
7530     * Macros invocations surrounded by parens or square brackets and
7531       not terminated by a semicolon are [parsed as
7532       expressions][macros], which makes expressions like `vec![1i32,
7533       2, 3].len()` work as expected.
7534     * Trait objects now implement their traits automatically, and
7535       traits that can be coerced to objects now must be [object
7536       safe][objsafe].
7537     * Automatically deriving traits is now done with `#[derive(...)]`
7538       not `#[deriving(...)]` for [consistency with other naming
7539       conventions][derive].
7540     * Importing the containing module or enum at the same time as
7541       items or variants they contain is [now done with `self` instead
7542       of `mod`][self], as in use `foo::{self, bar}`
7543     * Glob imports are no longer feature-gated.
7544     * The `box` operator and `box` patterns have been feature-gated
7545       pending a redesign. For now unique boxes should be allocated
7546       like other containers, with `Box::new`.
7547
7548 * Libraries
7549
7550     * A [series][coll1] of [efforts][coll2] to establish
7551       [conventions][coll3] for collections types has resulted in API
7552       improvements throughout the standard library.
7553     * New [APIs for error handling][err] provide ergonomic interop
7554       between error types, and [new conventions][err-conv] describe
7555       more clearly the recommended error handling strategies in Rust.
7556     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7557       it is easier to discuss failure in the context of error handling
7558       without making clarifications as to whether you are referring to
7559       the 'fail' macro or failure more generally.
7560     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7561       syscall when available.
7562     * The 'serialize' crate has been renamed 'rustc-serialize' and
7563       moved out of the distribution to Cargo. Although it is widely
7564       used now, it is expected to be superseded in the near future.
7565     * The `Show` formatter, typically implemented with
7566       `#[derive(Show)]` is [now requested with the `{:?}`
7567       specifier][show] and is intended for use by all types, for uses
7568       such as `println!` debugging. The new `String` formatter must be
7569       implemented by hand, uses the `{}` specifier, and is intended
7570       for full-fidelity conversions of things that can logically be
7571       represented as strings.
7572
7573 * Tooling
7574
7575     * [Flexible target specification][flex] allows rustc's code
7576       generation to be configured to support otherwise-unsupported
7577       platforms.
7578     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7579       respective debuggers with Rust-appropriate pretty-printing.
7580     * The Windows installation of Rust is distributed with the
7581       MinGW components currently required to link binaries on that
7582       platform.
7583
7584 * Misc
7585
7586     * Nullable enum optimizations have been extended to more types so
7587       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7588       space than the inner types themselves.
7589     * Work has begun on supporting AArch64.
7590
7591 [Cargo]: https://crates.io
7592 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7593 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7594 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7595 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7596 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7597 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7598 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7599 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7600 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7601 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7602 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7603 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7604 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7605 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7606 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7607 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7608 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7609 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7610 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7611 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7612 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7613 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7614 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7615 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7616 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7617 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7618 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7619 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7620 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7621 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7622 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7623 [trpl]: https://doc.rust-lang.org/book/index.html
7624 [rbe]: http://rustbyexample.com/
7625
7626
7627 Version 0.12.0 (2014-10-09)
7628 =============================
7629
7630   * ~1900 changes, numerous bugfixes
7631
7632   * Highlights
7633
7634     * The introductory documentation (now called The Rust Guide) has
7635       been completely rewritten, as have a number of supplementary
7636       guides.
7637     * Rust's package manager, Cargo, continues to improve and is
7638       sometimes considered to be quite awesome.
7639     * Many API's in `std` have been reviewed and updated for
7640       consistency with the in-development Rust coding
7641       guidelines. The standard library documentation tracks
7642       stabilization progress.
7643     * Minor libraries have been moved out-of-tree to the rust-lang org
7644       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7645       be installed with Cargo.
7646     * Lifetime elision allows lifetime annotations to be left off of
7647       function declarations in many common scenarios.
7648     * Rust now works on 64-bit Windows.
7649
7650   * Language
7651     * Indexing can be overloaded with the `Index` and `IndexMut`
7652       traits.
7653     * The `if let` construct takes a branch only if the `let` pattern
7654       matches, currently behind the 'if_let' feature gate.
7655     * 'where clauses', a more flexible syntax for specifying trait
7656       bounds that is more aesthetic, have been added for traits and
7657       free functions. Where clauses will in the future make it
7658       possible to constrain associated types, which would be
7659       impossible with the existing syntax.
7660     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7661       the 'slicing_syntax' feature gate, and can be overloaded with
7662       the `Slice` or `SliceMut` traits.
7663     * The syntax for matching of sub-slices has been changed to use a
7664       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7665       consistency with other uses of `..` and to future-proof
7666       potential additional uses of the syntax.
7667     * The syntax for matching inclusive ranges in patterns has changed
7668       from `0..3` to `0...4` to be consistent with the exclusive range
7669       syntax for slicing.
7670     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7671       c]`) has been put behind the 'advanced_slice_patterns' feature
7672       gate and may be removed in the future.
7673     * Components of tuples and tuple structs can be extracted using
7674       the `value.0` syntax, currently behind the `tuple_indexing`
7675       feature gate.
7676     * The `#[crate_id]` attribute is no longer supported; versioning
7677       is handled by the package manager.
7678     * Renaming crate imports are now written `extern crate foo as bar`
7679       instead of `extern crate bar = foo`.
7680     * Renaming use statements are now written `use foo as bar` instead
7681       of `use bar = foo`.
7682     * `let` and `match` bindings and argument names in macros are now
7683       hygienic.
7684     * The new, more efficient, closure types ('unboxed closures') have
7685       been added under a feature gate, 'unboxed_closures'. These will
7686       soon replace the existing closure types, once higher-ranked
7687       trait lifetimes are added to the language.
7688     * `move` has been added as a keyword, for indicating closures
7689       that capture by value.
7690     * Mutation and assignment is no longer allowed in pattern guards.
7691     * Generic structs and enums can now have trait bounds.
7692     * The `Share` trait is now called `Sync` to free up the term
7693       'shared' to refer to 'shared reference' (the default reference
7694       type.
7695     * Dynamically-sized types have been mostly implemented,
7696       unifying the behavior of fat-pointer types with the rest of the
7697       type system.
7698     * As part of dynamically-sized types, the `Sized` trait has been
7699       introduced, which qualifying types implement by default, and
7700       which type parameters expect by default. To specify that a type
7701       parameter does not need to be sized, write `<Sized? T>`. Most
7702       types are `Sized`, notable exceptions being unsized arrays
7703       (`[T]`) and trait types.
7704     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7705     * Lifetime bounds can now be applied to type parameters and object
7706       types.
7707     * The old, reference counted GC type, `Gc<T>` which was once
7708       denoted by the `@` sigil, has finally been removed. GC will be
7709       revisited in the future.
7710
7711   * Libraries
7712     * Library documentation has been improved for a number of modules.
7713     * Bit-vectors, collections::bitv has been modernized.
7714     * The url crate is deprecated in favor of
7715       http://github.com/servo/rust-url, which can be installed with
7716       Cargo.
7717     * Most I/O stream types can be cloned and subsequently closed from
7718       a different thread.
7719     * A `std::time::Duration` type has been added for use in I/O
7720       methods that rely on timers, as well as in the 'time' crate's
7721       `Timespec` arithmetic.
7722     * The runtime I/O abstraction layer that enabled the green thread
7723       scheduler to do non-thread-blocking I/O has been removed, along
7724       with the libuv-based implementation employed by the green thread
7725       scheduler. This will greatly simplify the future I/O work.
7726     * `collections::btree` has been rewritten to have a more
7727       idiomatic and efficient design.
7728
7729   * Tooling
7730     * rustdoc output now indicates the stability levels of API's.
7731     * The `--crate-name` flag can specify the name of the crate
7732       being compiled, like `#[crate_name]`.
7733     * The `-C metadata` specifies additional metadata to hash into
7734       symbol names, and `-C extra-filename` specifies additional
7735       information to put into the output filename, for use by the
7736       package manager for versioning.
7737     * debug info generation has continued to improve and should be
7738       more reliable under both gdb and lldb.
7739     * rustc has experimental support for compiling in parallel
7740       using the `-C codegen-units` flag.
7741     * rustc no longer encodes rpath information into binaries by
7742       default.
7743
7744   * Misc
7745     * Stack usage has been optimized with LLVM lifetime annotations.
7746     * Official Rust binaries on Linux are more compatible with older
7747       kernels and distributions, built on CentOS 5.10.
7748
7749
7750 Version 0.11.0 (2014-07-02)
7751 ==========================
7752
7753   * ~1700 changes, numerous bugfixes
7754
7755   * Language
7756     * ~[T] has been removed from the language. This type is superseded by
7757       the Vec<T> type.
7758     * ~str has been removed from the language. This type is superseded by
7759       the String type.
7760     * ~T has been removed from the language. This type is superseded by the
7761       Box<T> type.
7762     * @T has been removed from the language. This type is superseded by the
7763       standard library's std::gc::Gc<T> type.
7764     * Struct fields are now all private by default.
7765     * Vector indices and shift amounts are both required to be a `uint`
7766       instead of any integral type.
7767     * Byte character, byte string, and raw byte string literals are now all
7768       supported by prefixing the normal literal with a `b`.
7769     * Multiple ABIs are no longer allowed in an ABI string
7770     * The syntax for lifetimes on closures/procedures has been tweaked
7771       slightly: `<'a>|A, B|: 'b + K -> T`
7772     * Floating point modulus has been removed from the language; however it
7773       is still provided by a library implementation.
7774     * Private enum variants are now disallowed.
7775     * The `priv` keyword has been removed from the language.
7776     * A closure can no longer be invoked through a &-pointer.
7777     * The `use foo, bar, baz;` syntax has been removed from the language.
7778     * The transmute intrinsic no longer works on type parameters.
7779     * Statics now allow blocks/items in their definition.
7780     * Trait bounds are separated from objects with + instead of : now.
7781     * Objects can no longer be read while they are mutably borrowed.
7782     * The address of a static is now marked as insignificant unless the
7783       #[inline(never)] attribute is placed it.
7784     * The #[unsafe_destructor] attribute is now behind a feature gate.
7785     * Struct literals are no longer allowed in ambiguous positions such as
7786       if, while, match, and for..in.
7787     * Declaration of lang items and intrinsics are now feature-gated by
7788       default.
7789     * Integral literals no longer default to `int`, and floating point
7790       literals no longer default to `f64`. Literals must be suffixed with an
7791       appropriate type if inference cannot determine the type of the
7792       literal.
7793     * The Box<T> type is no longer implicitly borrowed to &mut T.
7794     * Procedures are now required to not capture borrowed references.
7795
7796   * Libraries
7797     * The standard library is now a "facade" over a number of underlying
7798       libraries. This means that development on the standard library should
7799       be speedier due to smaller crates, as well as a clearer line between
7800       all dependencies.
7801     * A new library, libcore, lives under the standard library's facade
7802       which is Rust's "0-assumption" library, suitable for embedded and
7803       kernel development for example.
7804     * A regex crate has been added to the standard distribution. This crate
7805       includes statically compiled regular expressions.
7806     * The unwrap/unwrap_err methods on Result require a Show bound for
7807       better error messages.
7808     * The return types of the std::comm primitives have been centralized
7809       around the Result type.
7810     * A number of I/O primitives have gained the ability to time out their
7811       operations.
7812     * A number of I/O primitives have gained the ability to close their
7813       reading/writing halves to cancel pending operations.
7814     * Reverse iterator methods have been removed in favor of `rev()` on
7815       their forward-iteration counterparts.
7816     * A bitflags! macro has been added to enable easy interop with C and
7817       management of bit flags.
7818     * A debug_assert! macro is now provided which is disabled when
7819       `--cfg ndebug` is passed to the compiler.
7820     * A graphviz crate has been added for creating .dot files.
7821     * The std::cast module has been migrated into std::mem.
7822     * The std::local_data api has been migrated from freestanding functions
7823       to being based on methods.
7824     * The Pod trait has been renamed to Copy.
7825     * jemalloc has been added as the default allocator for types.
7826     * The API for allocating memory has been changed to use proper alignment
7827       and sized deallocation
7828     * Connecting a TcpStream or binding a TcpListener is now based on a
7829       string address and a u16 port. This allows connecting to a hostname as
7830       opposed to an IP.
7831     * The Reader trait now contains a core method, read_at_least(), which
7832       correctly handles many repeated 0-length reads.
7833     * The process-spawning API is now centered around a builder-style
7834       Command struct.
7835     * The :? printing qualifier has been moved from the standard library to
7836       an external libdebug crate.
7837     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7838       have been renamed to Eq/Ord.
7839     * The select/plural methods have been removed from format!. The escapes
7840       for { and } have also changed from \{ and \} to {{ and }},
7841       respectively.
7842     * The TaskBuilder API has been re-worked to be a true builder, and
7843       extension traits for spawning native/green tasks have been added.
7844
7845   * Tooling
7846     * All breaking changes to the language or libraries now have their
7847       commit message annotated with `[breaking-change]` to allow for easy
7848       discovery of breaking changes.
7849     * The compiler will now try to suggest how to annotate lifetimes if a
7850       lifetime-related error occurs.
7851     * Debug info continues to be improved greatly with general bug fixes and
7852       better support for situations like link time optimization (LTO).
7853     * Usage of syntax extensions when cross-compiling has been fixed.
7854     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7855       -fdata-sections and --gc-sections has been enabled by default
7856     * The compiler is now stricter about where it will load module files
7857       from when a module is declared via `mod foo;`.
7858     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7859       Syntax extensions are now discovered via a "plugin registrar" type
7860       which will be extended in the future to other various plugins.
7861     * Lints have been restructured to allow for dynamically loadable lints.
7862     * A number of rustdoc improvements:
7863       * The HTML output has been visually redesigned.
7864       * Markdown is now powered by hoedown instead of sundown.
7865       * Searching heuristics have been greatly improved.
7866       * The search index has been reduced in size by a great amount.
7867       * Cross-crate documentation via `pub use` has been greatly improved.
7868       * Primitive types are now hyperlinked and documented.
7869     * Documentation has been moved from static.rust-lang.org/doc to
7870       doc.rust-lang.org
7871     * A new sandbox, play.rust-lang.org, is available for running and
7872       sharing rust code examples on-line.
7873     * Unused attributes are now more robustly warned about.
7874     * The dead_code lint now warns about unused struct fields.
7875     * Cross-compiling to iOS is now supported.
7876     * Cross-compiling to mipsel is now supported.
7877     * Stability attributes are now inherited by default and no longer apply
7878       to intra-crate usage, only inter-crate usage.
7879     * Error message related to non-exhaustive match expressions have been
7880       greatly improved.
7881
7882
7883 Version 0.10 (2014-04-03)
7884 =========================
7885
7886   * ~1500 changes, numerous bugfixes
7887
7888   * Language
7889     * A new RFC process is now in place for modifying the language.
7890     * Patterns with `@`-pointers have been removed from the language.
7891     * Patterns with unique vectors (`~[T]`) have been removed from the
7892       language.
7893     * Patterns with unique strings (`~str`) have been removed from the
7894       language.
7895     * `@str` has been removed from the language.
7896     * `@[T]` has been removed from the language.
7897     * `@self` has been removed from the language.
7898     * `@Trait` has been removed from the language.
7899     * Headers on `~` allocations which contain `@` boxes inside the type for
7900       reference counting have been removed.
7901     * The semantics around the lifetimes of temporary expressions have changed,
7902       see #3511 and #11585 for more information.
7903     * Cross-crate syntax extensions are now possible, but feature gated. See
7904       #11151 for more information. This includes both `macro_rules!` macros as
7905       well as syntax extensions such as `format!`.
7906     * New lint modes have been added, and older ones have been turned on to be
7907       warn-by-default.
7908       * Unnecessary parentheses
7909       * Uppercase statics
7910       * Camel Case types
7911       * Uppercase variables
7912       * Publicly visible private types
7913       * `#[deriving]` with raw pointers
7914     * Unsafe functions can no longer be coerced to closures.
7915     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7916     * The `#[simd]` attribute is now behind a feature gate.
7917     * Visibility is no longer allowed on `extern crate` statements, and
7918       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7919     * Trailing commas are now allowed in argument lists and tuple patterns.
7920     * The `do` keyword has been removed, it is now a reserved keyword.
7921     * Default type parameters have been implemented, but are feature gated.
7922     * Borrowed variables through captures in closures are now considered soundly.
7923     * `extern mod` is now `extern crate`
7924     * The `Freeze` trait has been removed.
7925     * The `Share` trait has been added for types that can be shared among
7926       threads.
7927     * Labels in macros are now hygienic.
7928     * Expression/statement macro invocations can be delimited with `{}` now.
7929     * Treatment of types allowed in `static mut` locations has been tweaked.
7930     * The `*` and `.` operators are now overloadable through the `Deref` and
7931       `DerefMut` traits.
7932     * `~Trait` and `proc` no longer have `Send` bounds by default.
7933     * Partial type hints are now supported with the `_` type marker.
7934     * An `Unsafe` type was introduced for interior mutability. It is now
7935       considered undefined to transmute from `&T` to `&mut T` without using the
7936       `Unsafe` type.
7937     * The #[linkage] attribute was implemented for extern statics/functions.
7938     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7939     * `Pod` was renamed to `Copy`.
7940
7941   * Libraries
7942     * The `libextra` library has been removed. It has now been decomposed into
7943       component libraries with smaller and more focused nuggets of
7944       functionality. The full list of libraries can be found on the
7945       documentation index page.
7946     * std: `std::condition` has been removed. All I/O errors are now propagated
7947       through the `Result` type. In order to assist with error handling, a
7948       `try!` macro for unwrapping errors with an early return and a lint for
7949       unused results has been added. See #12039 for more information.
7950     * std: The `vec` module has been renamed to `slice`.
7951     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7952       This will become the only growable vector in the future.
7953     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7954       are now found at `std::io::BufferedReader` instead of
7955       `std::io::buffered::BufferedReader`.
7956     * std: `print` and `println` are no longer in the prelude, the `print!` and
7957       `println!` macros are intended to be used instead.
7958     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7959       attempts to statically prevent cycles.
7960     * std: The standard distribution is adopting the policy of pushing failure
7961       to the user rather than failing in libraries. Many functions (such as
7962       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7963     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7964       deriving mode: `#[deriving(Show)]`.
7965     * std: `ToStr` is now implemented for all types implementing `Show`.
7966     * std: The formatting trait methods now take `&self` instead of `&T`
7967     * std: The `invert()` method on iterators has been renamed to `rev()`
7968     * std: `std::num` has seen a reduction in the genericity of its traits,
7969       consolidating functionality into a few core traits.
7970     * std: Backtraces are now printed on task failure if the environment
7971       variable `RUST_BACKTRACE` is present.
7972     * std: Naming conventions for iterators have been standardized. More details
7973       can be found on the wiki's style guide.
7974     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7975       still implement the function.
7976     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7977     * std: `assert_approx_eq!` has been removed
7978     * std: The `e` and `E` formatting specifiers for floats have been added to
7979       print them in exponential notation.
7980     * std: The `Times` trait has been removed
7981     * std: Indications of variance and opting out of builtin bounds is done
7982       through marker types in `std::kinds::marker` now
7983     * std: `hash` has been rewritten, `IterBytes` has been removed, and
7984       `#[deriving(Hash)]` is now possible.
7985     * std: `SharedChan` has been removed, `Sender` is now cloneable.
7986     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
7987     * std: `Chan::new` is now `channel()`.
7988     * std: A new synchronous channel type has been implemented.
7989     * std: A `select!` macro is now provided for selecting over `Receiver`s.
7990     * std: `hashmap` and `trie` have been moved to `libcollections`
7991     * std: `run` has been rolled into `io::process`
7992     * std: `assert_eq!` now uses `{}` instead of `{:?}`
7993     * std: The equality and comparison traits have seen some reorganization.
7994     * std: `rand` has moved to `librand`.
7995     * std: `to_{lower,upper}case` has been implemented for `char`.
7996     * std: Logging has been moved to `liblog`.
7997     * collections: `HashMap` has been rewritten for higher performance and less
7998       memory usage.
7999     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8000       it can be booted manually. The runtime guide has more information and
8001       examples.
8002     * native: All I/O functionality except signals has been implemented.
8003     * green: Task spawning with `libgreen` has been optimized with stack caching
8004       and various trimming of code.
8005     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8006     * sync: The `extra::sync` module has been updated to modern rust (and moved
8007       to the `sync` library), tweaking and improving various interfaces while
8008       dropping redundant functionality.
8009     * sync: A new `Barrier` type has been added to the `sync` library.
8010     * sync: An efficient mutex for native and green tasks has been implemented.
8011     * serialize: The `base64` module has seen some improvement. It treats
8012       newlines better, has non-string error values, and has seen general
8013       cleanup.
8014     * fourcc: A `fourcc!` macro was introduced
8015     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8016       hexadecimal literal.
8017
8018   * Tooling
8019     * `rustpkg` has been deprecated and removed from the main repository. Its
8020       replacement, `cargo`, is under development.
8021     * Nightly builds of rust are now available
8022     * The memory usage of rustc has been improved many times throughout this
8023       release cycle.
8024     * The build process supports disabling rpath support for the rustc binary
8025       itself.
8026     * Code generation has improved in some cases, giving more information to the
8027       LLVM optimization passes to enable more extensive optimizations.
8028     * Debuginfo compatibility with lldb on OSX has been restored.
8029     * The master branch is now gated on an android bot, making building for
8030       android much more reliable.
8031     * Output flags have been centralized into one `--emit` flag.
8032     * Crate type flags have been centralized into one `--crate-type` flag.
8033     * Codegen flags have been consolidated behind a `-C` flag.
8034     * Linking against outdated crates now has improved error messages.
8035     * Error messages with lifetimes will often suggest how to annotate the
8036       function to fix the error.
8037     * Many more types are documented in the standard library, and new guides
8038       were written.
8039     * Many `rustdoc` improvements:
8040       * code blocks are syntax highlighted.
8041       * render standalone markdown files.
8042       * the --test flag tests all code blocks by default.
8043       * exported macros are displayed.
8044       * re-exported types have their documentation inlined at the location of the
8045         first re-export.
8046       * search works across crates that have been rendered to the same output
8047         directory.
8048
8049
8050 Version 0.9 (2014-01-09)
8051 ==========================
8052
8053    * ~1800 changes, numerous bugfixes
8054
8055    * Language
8056       * The `float` type has been removed. Use `f32` or `f64` instead.
8057       * A new facility for enabling experimental features (feature gating) has
8058         been added, using the crate-level `#[feature(foo)]` attribute.
8059       * Managed boxes (@) are now behind a feature gate
8060         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8061         standard library's `Gc` or `Rc` types instead.
8062       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8063       * Jumping back to the top of a loop is now done with `continue` instead of
8064         `loop`.
8065       * Strings can no longer be mutated through index assignment.
8066       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8067         hash delimiters, as in `r###"foo"###`.
8068       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8069         called once.
8070       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8071       * `@fn`s have been removed.
8072       * `do` only works with procs in order to make it obvious what the cost
8073         of `do` is.
8074       * Single-element tuple-like structs can no longer be dereferenced to
8075         obtain the inner value. A more comprehensive solution for overloading
8076         the dereference operator will be provided in the future.
8077       * The `#[link(...)]` attribute has been replaced with
8078         `#[crate_id = "name#vers"]`.
8079       * Empty `impl`s must be terminated with empty braces and may not be
8080         terminated with a semicolon.
8081       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8082         no longer has any special meaning.
8083       * The old `fmt!` string formatting macro has been removed.
8084       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8085         `print!` and `println!`.
8086       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8087       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8088         `extern mod foo = "bar"` instead.
8089       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8090       * Macros can have attributes.
8091       * Macros can expand to items with attributes.
8092       * Macros can expand to multiple items.
8093       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8094       * Comments may be nested.
8095       * Values automatically coerce to trait objects they implement, without
8096         an explicit `as`.
8097       * Enum discriminants are no longer an entire word but as small as needed to
8098         contain all the variants. The `repr` attribute can be used to override
8099         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8100         `#[repr(C)]` to match C enums.
8101       * Non-string literals are not allowed in attributes (they never worked).
8102       * The FFI now supports variadic functions.
8103       * Octal numeric literals, as in `0o7777`.
8104       * The `concat!` syntax extension performs compile-time string concatenation.
8105       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8106         removed as Rust no longer uses segmented stacks.
8107       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8108       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8109         not `*`; ignoring remaining fields of a struct is also done with `..`,
8110         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8111       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8112       * `rustc` supports the "system" calling convention, which defaults to the
8113         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8114         "C" elsewhere.
8115       * The `type_overflow` lint (default: warn) checks literals for overflow.
8116       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8117       * The `attribute_usage` lint (default: warn) warns about unknown
8118         attributes.
8119       * The `unknown_features` lint (default: warn) warns about unknown
8120         feature gates.
8121       * The `dead_code` lint (default: warn) checks for dead code.
8122       * Rust libraries can be linked statically to one another
8123       * `#[link_args]` is behind the `link_args` feature gate.
8124       * Native libraries are now linked with `#[link(name = "foo")]`
8125       * Native libraries can be statically linked to a rust crate
8126         (`#[link(name = "foo", kind = "static")]`).
8127       * Native OS X frameworks are now officially supported
8128         (`#[link(name = "foo", kind = "framework")]`).
8129       * The `#[thread_local]` attribute creates thread-local (not task-local)
8130         variables. Currently behind the `thread_local` feature gate.
8131       * The `return` keyword may be used in closures.
8132       * Types that can be copied via a memcpy implement the `Pod` kind.
8133       * The `cfg` attribute can now be used on struct fields and enum variants.
8134
8135    * Libraries
8136       * std: The `option` and `result` API's have been overhauled to make them
8137         simpler, more consistent, and more composable.
8138       * std: The entire `std::io` module has been replaced with one that is
8139         more comprehensive and that properly interfaces with the underlying
8140         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8141         implemented.
8142       * std: `io::util` contains a number of useful implementations of
8143         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8144         `ZeroReader`, `TeeReader`.
8145       * std: The reference counted pointer type `extra::rc` moved into std.
8146       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8147         just a wrapper around it).
8148       * std: The `Either` type has been removed.
8149       * std: `fmt::Default` can be implemented for any type to provide default
8150         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8151       * std: The `rand` API continues to be tweaked.
8152       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8153         on failure in gdb, is now named `rust_fail`.
8154       * std: The `each_key` and `each_value` methods on `HashMap` have been
8155         replaced by the `keys` and `values` iterators.
8156       * std: Functions dealing with type size and alignment have moved from the
8157         `sys` module to the `mem` module.
8158       * std: The `path` module was written and API changed.
8159       * std: `str::from_utf8` has been changed to cast instead of allocate.
8160       * std: `starts_with` and `ends_with` methods added to vectors via the
8161         `ImmutableEqVector` trait, which is in the prelude.
8162       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8163         if the index is out of bounds.
8164       * std: Task failure no longer propagates between tasks, as the model was
8165         complex, expensive, and incompatible with thread-based tasks.
8166       * std: The `Any` type can be used for dynamic typing.
8167       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8168         `task::try`.
8169       * std: Methods that produce iterators generally do not have an `_iter`
8170         suffix now.
8171       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8172         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8173       * std: `util::ignore` renamed to `prelude::drop`.
8174       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8175         trait.
8176       * std: `vec::raw` has seen a lot of cleanup and API changes.
8177       * std: The standard library no longer includes any C++ code, and very
8178         minimal C, eliminating the dependency on libstdc++.
8179       * std: Runtime scheduling and I/O functionality has been factored out into
8180         extensible interfaces and is now implemented by two different crates:
8181         libnative, for native threading and I/O; and libgreen, for green threading
8182         and I/O. This paves the way for using the standard library in more limited
8183         embedded environments.
8184       * std: The `comm` module has been rewritten to be much faster, have a
8185         simpler, more consistent API, and to work for both native and green
8186         threading.
8187       * std: All libuv dependencies have been moved into the rustuv crate.
8188       * native: New implementations of runtime scheduling on top of OS threads.
8189       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8190         and other I/O.
8191       * green: The green thread scheduler and message passing types are almost
8192         entirely lock-free.
8193       * extra: The `flatpipes` module had bitrotted and was removed.
8194       * extra: All crypto functions have been removed and Rust now has a policy of
8195         not reimplementing crypto in the standard library. In the future crypto
8196         will be provided by external crates with bindings to established libraries.
8197       * extra: `c_vec` has been modernized.
8198       * extra: The `sort` module has been removed. Use the `sort` method on
8199         mutable slices.
8200
8201    * Tooling
8202       * The `rust` and `rusti` commands have been removed, due to lack of
8203         maintenance.
8204       * `rustdoc` was completely rewritten.
8205       * `rustdoc` can test code examples in documentation.
8206       * `rustpkg` can test packages with the argument, 'test'.
8207       * `rustpkg` supports arbitrary dependencies, including C libraries.
8208       * `rustc`'s support for generating debug info is improved again.
8209       * `rustc` has better error reporting for unbalanced delimiters.
8210       * `rustc`'s JIT support was removed due to bitrot.
8211       * Executables and static libraries can be built with LTO (-Z lto)
8212       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8213         build tools.
8214
8215
8216 Version 0.8 (2013-09-26)
8217 ============================
8218
8219    * ~2200 changes, numerous bugfixes
8220
8221    * Language
8222       * The `for` loop syntax has changed to work with the `Iterator` trait.
8223       * At long last, unwinding works on Windows.
8224       * Default methods are ready for use.
8225       * Many trait inheritance bugs fixed.
8226       * Owned and borrowed trait objects work more reliably.
8227       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8228       * rustc can omit emission of code for the `debug!` macro if it is passed
8229         `--cfg ndebug`
8230       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8231         for foo.rs, then foo/mod.rs, and will generate an error when both are
8232         present.
8233       * Strings no longer contain trailing nulls. The new `std::c_str` module
8234         provides new mechanisms for converting to C strings.
8235       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8236       * The FFI has been overhauled such that foreign functions are called directly,
8237         instead of through a stack-switching wrapper.
8238       * Calling a foreign function must be done through a Rust function with the
8239         `#[fixed_stack_segment]` attribute.
8240       * The `externfn!` macro can be used to declare both a foreign function and
8241         a `#[fixed_stack_segment]` wrapper at once.
8242       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8243       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8244       * `priv` is disallowed everywhere except for struct fields and enum variants.
8245       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8246       * `ref` bindings in irrefutable patterns work correctly now.
8247       * `char` is now prevented from containing invalid code points.
8248       * Casting to `bool` is no longer allowed.
8249       * `\0` is now accepted as an escape in chars and strings.
8250       * `yield` is a reserved keyword.
8251       * `typeof` is a reserved keyword.
8252       * Crates may be imported by URL with `extern mod foo = "url";`.
8253       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8254       * Static vectors can be initialized with repeating elements,
8255         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8256       * Static structs can be initialized with functional record update,
8257         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8258       * `cfg!` can be used to conditionally execute code based on the crate
8259         configuration, similarly to `#[cfg(...)]`.
8260       * The `unnecessary_qualification` lint detects unneeded module
8261         prefixes (default: allow).
8262       * Arithmetic operations have been implemented on the SIMD types in
8263         `std::unstable::simd`.
8264       * Exchange allocation headers were removed, reducing memory usage.
8265       * `format!` implements a completely new, extensible, and higher-performance
8266         string formatting system. It will replace `fmt!`.
8267       * `print!` and `println!` write formatted strings (using the `format!`
8268         extension) to stdout.
8269       * `write!` and `writeln!` write formatted strings (using the `format!`
8270         extension) to the new Writers in `std::rt::io`.
8271       * The library section in which a function or static is placed may
8272         be specified with `#[link_section = "..."]`.
8273       * The `proto!` syntax extension for defining bounded message protocols
8274         was removed.
8275       * `macro_rules!` is hygienic for `let` declarations.
8276       * The `#[export_name]` attribute specifies the name of a symbol.
8277       * `unreachable!` can be used to indicate unreachable code, and fails
8278         if executed.
8279
8280    * Libraries
8281       * std: Transitioned to the new runtime, written in Rust.
8282       * std: Added an experimental I/O library, `rt::io`, based on the new
8283         runtime.
8284       * std: A new generic `range` function was added to the prelude, replacing
8285         `uint::range` and friends.
8286       * std: `range_rev` no longer exists. Since range is an iterator it can be
8287         reversed with `range(lo, hi).invert()`.
8288       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8289         renamed to `unwrap_or`.
8290       * std: The `iterator` module was renamed to `iter`.
8291       * std: Integral types now support the `checked_add`, `checked_sub`, and
8292         `checked_mul` operations for detecting overflow.
8293       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8294         consistency.
8295       * std: Methods are standardizing on conventions for casting methods:
8296         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8297         and cheap casts.
8298       * std: The `CString` type in `c_str` provides new ways to convert to and
8299         from C strings.
8300       * std: `DoubleEndedIterator` can yield elements in two directions.
8301       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8302         two splices.
8303       * std: `str::from_bytes` renamed to `str::from_utf8`.
8304       * std: `pop_opt` and `shift_opt` methods added to vectors.
8305       * std: The task-local data interface no longer uses @, and keys are
8306         no longer function pointers.
8307       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8308       * std: Added `SharedPort` to `comm`.
8309       * std: `Eq` has a default method for `ne`; only `eq` is required
8310         in implementations.
8311       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8312         is required in implementations.
8313       * std: `is_utf8` performance is improved, impacting many string functions.
8314       * std: `os::MemoryMap` provides cross-platform mmap.
8315       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8316         are not 'in-bounds' are considered undefined.
8317       * std: Many freestanding functions in `vec` removed in favor of methods.
8318       * std: Many freestanding functions on scalar types removed in favor of
8319         methods.
8320       * std: Many options to task builders were removed since they don't make
8321         sense in the new scheduler design.
8322       * std: More containers implement `FromIterator` so can be created by the
8323         `collect` method.
8324       * std: More complete atomic types in `unstable::atomics`.
8325       * std: `comm::PortSet` removed.
8326       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8327         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8328         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8329         default implementations.
8330       * std: Various `from_str` functions were removed in favor of a generic
8331         `from_str` which is available in the prelude.
8332       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8333       * extra: `dlist`, the doubly-linked list was modernized.
8334       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8335       * extra: Added `glob` module, replacing `std::os::glob`.
8336       * extra: `rope` was removed.
8337       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8338       * extra: `net`, and `timer` were removed. The experimental replacements
8339         are `std::rt::io::net` and `std::rt::io::timer`.
8340       * extra: Iterators implemented for `SmallIntMap`.
8341       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8342       * extra: `SmallIntSet` removed. Use `BitvSet`.
8343       * extra: Performance of JSON parsing greatly improved.
8344       * extra: `semver` updated to SemVer 2.0.0.
8345       * extra: `term` handles more terminals correctly.
8346       * extra: `dbg` module removed.
8347       * extra: `par` module removed.
8348       * extra: `future` was cleaned up, with some method renames.
8349       * extra: Most free functions in `getopts` were converted to methods.
8350
8351    * Other
8352       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8353       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8354         similarly to gcc's `--march` flag.
8355       * rustc's performance compiling small crates is much better.
8356       * rustpkg has received many improvements.
8357       * rustpkg supports git tags as package IDs.
8358       * rustpkg builds into target-specific directories so it can be used for
8359         cross-compiling.
8360       * The number of concurrent test tasks is controlled by the environment
8361         variable RUST_TEST_TASKS.
8362       * The test harness can now report metrics for benchmarks.
8363       * All tools have man pages.
8364       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8365       * The runtime uses jemalloc for allocations.
8366       * Segmented stacks are temporarily disabled as part of the transition to
8367         the new runtime. Stack overflows are possible!
8368       * A new documentation backend, rustdoc_ng, is available for use. It is
8369         still invoked through the normal `rustdoc` command.
8370
8371
8372 Version 0.7 (2013-07-03)
8373 =======================
8374
8375    * ~2000 changes, numerous bugfixes
8376
8377    * Language
8378       * `impl`s no longer accept a visibility qualifier. Put them on methods
8379         instead.
8380       * The borrow checker has been rewritten with flow-sensitivity, fixing
8381         many bugs and inconveniences.
8382       * The `self` parameter no longer implicitly means `&'self self`,
8383         and can be explicitly marked with a lifetime.
8384       * Overloadable compound operators (`+=`, etc.) have been temporarily
8385         removed due to bugs.
8386       * The `for` loop protocol now requires `for`-iterators to return `bool`
8387         so they compose better.
8388       * The `Durable` trait is replaced with the `'static` bounds.
8389       * Trait default methods work more often.
8390       * Structs with the `#[packed]` attribute have byte alignment and
8391         no padding between fields.
8392       * Type parameters bound by `Copy` must now be copied explicitly with
8393         the `copy` keyword.
8394       * It is now illegal to move out of a dereferenced unsafe pointer.
8395       * `Option<~T>` is now represented as a nullable pointer.
8396       * `@mut` does dynamic borrow checks correctly.
8397       * The `main` function is only detected at the topmost level of the crate.
8398         The `#[main]` attribute is still valid anywhere.
8399       * Struct fields may no longer be mutable. Use inherited mutability.
8400       * The `#[no_send]` attribute makes a type that would otherwise be
8401         `Send`, not.
8402       * The `#[no_freeze]` attribute makes a type that would otherwise be
8403         `Freeze`, not.
8404       * Unbounded recursion will abort the process after reaching the limit
8405         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8406       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8407         are never implicitly copyable.
8408       * `#[static_assert]` makes compile-time assertions about static bools.
8409       * At long last, 'argument modes' no longer exist.
8410       * The rarely used `use mod` statement no longer exists.
8411
8412    * Syntax extensions
8413       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8414         argument list.
8415       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8416         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8417         `#[deriving(...)]`.
8418       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8419         and unsuffixed integer literals.
8420
8421    * Libraries
8422       * The `core` crate was renamed to `std`.
8423       * The `std` crate was renamed to `extra`.
8424       * More and improved documentation.
8425       * std: `iterator` module for external iterator objects.
8426       * Many old-style (internal, higher-order function) iterators replaced by
8427         implementations of `Iterator`.
8428       * std: Many old internal vector and string iterators,
8429         incl. `any`, `all`. removed.
8430       * std: The `finalize` method of `Drop` renamed to `drop`.
8431       * std: The `drop` method now takes `&mut self` instead of `&self`.
8432       * std: The prelude no longer re-exports any modules, only types and traits.
8433       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8434         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8435       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8436         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8437       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8438         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8439       * std: Many types implement `Clone`.
8440       * std: `path` type renamed to `Path`.
8441       * std: `mut` module and `Mut` type removed.
8442       * std: Many standalone functions removed in favor of methods and iterators
8443         in `vec`, `str`. In the future methods will also work as functions.
8444       * std: `reinterpret_cast` removed. Use `transmute`.
8445       * std: ascii string handling in `std::ascii`.
8446       * std: `Rand` is implemented for ~/@.
8447       * std: `run` module for spawning processes overhauled.
8448       * std: Various atomic types added to `unstable::atomic`.
8449       * std: Various types implement `Zero`.
8450       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8451       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8452       * std: Added `os::mkdir_recursive`.
8453       * std: Added `os::glob` function performs filesystems globs.
8454       * std: `FuzzyEq` renamed to `ApproxEq`.
8455       * std: `Map` now defines `pop` and `swap` methods.
8456       * std: `Cell` constructors converted to static methods.
8457       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8458       * extra: `flate` module moved from `std` to `extra`.
8459       * extra: `fileinput` module for iterating over a series of files.
8460       * extra: `Complex` number type and `complex` module.
8461       * extra: `Rational` number type and `rational` module.
8462       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8463       * extra: `term` uses terminfo now, is more correct.
8464       * extra: `arc` functions converted to methods.
8465       * extra: Implementation of fixed output size variations of SHA-2.
8466
8467    * Tooling
8468       * `unused_variables` lint mode for unused variables (default: warn).
8469       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8470         (default: warn).
8471       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8472         (default: warn).
8473       * `dead_assignment` lint mode for unread variables (default: warn).
8474       * `unnecessary_allocation` lint mode detects some heap allocations that are
8475         immediately borrowed so could be written without allocating (default: warn).
8476       * `missing_doc` lint mode (default: allow).
8477       * `unreachable_code` lint mode (default: warn).
8478       * The `rusti` command has been rewritten and a number of bugs addressed.
8479       * rustc outputs in color on more terminals.
8480       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8481       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8482       * Compiling with `-g` will make the binary record information about
8483         dynamic borrowcheck failures for debugging.
8484       * rustdoc has a nicer stylesheet.
8485       * Various improvements to rustdoc.
8486       * Improvements to rustpkg (see the detailed release notes).
8487
8488
8489 Version 0.6 (2013-04-03)
8490 ========================
8491
8492    * ~2100 changes, numerous bugfixes
8493
8494    * Syntax changes
8495       * The self type parameter in traits is now spelled `Self`
8496       * The `self` parameter in trait and impl methods must now be explicitly
8497         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8498       * Static methods no longer require the `static` keyword and instead
8499         are distinguished by the lack of a `self` parameter
8500       * Replaced the `Durable` trait with the `'static` lifetime
8501       * The old closure type syntax with the trailing sigil has been
8502         removed in favor of the more consistent leading sigil
8503       * `super` is a keyword, and may be prefixed to paths
8504       * Trait bounds are separated with `+` instead of whitespace
8505       * Traits are implemented with `impl Trait for Type`
8506         instead of `impl Type: Trait`
8507       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8508       * The `export` keyword has finally been removed
8509       * The `move` keyword has been removed (see "Semantic changes")
8510       * The interior mutability qualifier on vectors, `[mut T]`, has been
8511         removed. Use `&mut [T]`, etc.
8512       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8513       * `fail` is no longer a keyword. Use `fail!()`
8514       * `assert` is no longer a keyword. Use `assert!()`
8515       * `log` is no longer a keyword. use `debug!`, etc.
8516       * 1-tuples may be represented as `(T,)`
8517       * Struct fields may no longer be `mut`. Use inherited mutability,
8518         `@mut T`, `core::mut` or `core::cell`
8519       * `extern mod { ... }` is no longer valid syntax for foreign
8520         function modules. Use extern blocks: `extern { ... }`
8521       * Newtype enums removed. Use tuple-structs.
8522       * Trait implementations no longer support visibility modifiers
8523       * Pattern matching over vectors improved and expanded
8524       * `const` renamed to `static` to correspond to lifetime name,
8525         and make room for future `static mut` unsafe mutable globals.
8526       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8527       * `Clone` implementations can be automatically generated with
8528         `#[deriving(Clone)]`
8529       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8530         instead of `foo as Bar`.
8531       * Fixed length vector types are now written as `[int, .. 3]`
8532         instead of `[int * 3]`.
8533       * Fixed length vector types can express the length as a constant
8534         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8535
8536    * Semantic changes
8537       * Types with owned pointers or custom destructors move by default,
8538         eliminating the `move` keyword
8539       * All foreign functions are considered unsafe
8540       * &mut is now unaliasable
8541       * Writes to borrowed @mut pointers are prevented dynamically
8542       * () has size 0
8543       * The name of the main function can be customized using #[main]
8544       * The default type of an inferred closure is &fn instead of @fn
8545       * `use` statements may no longer be "chained" - they cannot import
8546         identifiers imported by previous `use` statements
8547       * `use` statements are crate relative, importing from the "top"
8548         of the crate by default. Paths may be prefixed with `super::`
8549         or `self::` to change the search behavior.
8550       * Method visibility is inherited from the implementation declaration
8551       * Structural records have been removed
8552       * Many more types can be used in static items, including enums
8553         'static-lifetime pointers and vectors
8554       * Pattern matching over vectors improved and expanded
8555       * Typechecking of closure types has been overhauled to
8556         improve inference and eliminate unsoundness
8557       * Macros leave scope at the end of modules, unless that module is
8558         tagged with #[macro_escape]
8559
8560    * Libraries
8561       * Added big integers to `std::bigint`
8562       * Removed `core::oldcomm` module
8563       * Added pipe-based `core::comm` module
8564       * Numeric traits have been reorganized under `core::num`
8565       * `vec::slice` finally returns a slice
8566       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8567       * Containers reorganized around traits in `core::container`
8568       * `core::dvec` removed, `~[T]` is a drop-in replacement
8569       * `core::send_map` renamed to `core::hashmap`
8570       * `std::map` removed; replaced with `core::hashmap`
8571       * `std::treemap` reimplemented as an owned balanced tree
8572       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8573       * `core::trie` added as a fast ordered map for integer keys
8574       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8575       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8576         overload the comparison operators, whereas `TotalOrd` is used
8577         by certain container types
8578
8579    * Other
8580       * Replaced the 'cargo' package manager with 'rustpkg'
8581       * Added all-purpose 'rust' tool
8582       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8583       * rustc now *attempts* to offer spelling suggestions
8584       * Improved support for ARM and Android
8585       * Preliminary MIPS backend
8586       * Improved foreign function ABI implementation for x86, x86_64
8587       * Various memory usage improvements
8588       * Rust code may be embedded in foreign code under limited circumstances
8589       * Inline assembler supported by new asm!() syntax extension.
8590
8591
8592 Version 0.5 (2012-12-21)
8593 ===========================
8594
8595    * ~900 changes, numerous bugfixes
8596
8597    * Syntax changes
8598       * Removed `<-` move operator
8599       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8600       * Removed old fixed length vector syntax - `[T]/N`
8601       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8602       * Macros may now expand to items and statements
8603       * `a.b()` is always parsed as a method call, never as a field projection
8604       * `Eq` and `IterBytes` implementations can be automatically generated
8605         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8606       * Removed the special crate language for `.rc` files
8607       * Function arguments may consist of any irrefutable pattern
8608
8609    * Semantic changes
8610       * `&` and `~` pointers may point to objects
8611       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8612       * Enum variants may be structs
8613       * Destructors can be added to all nominal types with the Drop trait
8614       * Structs and nullary enum variants may be constants
8615       * Values that cannot be implicitly copied are now automatically moved
8616         without writing `move` explicitly
8617       * `&T` may now be coerced to `*T`
8618       * Coercions happen in `let` statements as well as function calls
8619       * `use` statements now take crate-relative paths
8620       * The module and type namespaces have been merged so that static
8621         method names can be resolved under the trait in which they are
8622         declared
8623
8624    * Improved support for language features
8625       * Trait inheritance works in many scenarios
8626       * More support for explicit self arguments in methods - `self`, `&self`
8627         `@self`, and `~self` all generally work as expected
8628       * Static methods work in more situations
8629       * Experimental: Traits may declare default methods for the implementations
8630         to use
8631
8632    * Libraries
8633       * New condition handling system in `core::condition`
8634       * Timsort added to `std::sort`
8635       * New priority queue, `std::priority_queue`
8636       * Pipes for serializable types, `std::flatpipes'
8637       * Serialization overhauled to be trait-based
8638       * Expanded `getopts` definitions
8639       * Moved futures to `std`
8640       * More functions are pure now
8641       * `core::comm` renamed to `oldcomm`. Still deprecated
8642       * `rustdoc` and `cargo` are libraries now
8643
8644    * Misc
8645       * Added a preliminary REPL, `rusti`
8646       * License changed from MIT to dual MIT/APL2
8647
8648
8649 Version 0.4 (2012-10-15)
8650 ==========================
8651
8652    * ~2000 changes, numerous bugfixes
8653
8654    * Syntax
8655       * All keywords are now strict and may not be used as identifiers anywhere
8656       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8657         'of', 'with', 'to', 'class'.
8658       * Classes are replaced with simpler structs
8659       * Explicit method self types
8660       * `ret` became `return` and `alt` became `match`
8661       * `import` is now `use`; `use is now `extern mod`
8662       * `extern mod { ... }` is now `extern { ... }`
8663       * `use mod` is the recommended way to import modules
8664       * `pub` and `priv` replace deprecated export lists
8665       * The syntax of `match` pattern arms now uses fat arrow (=>)
8666       * `main` no longer accepts an args vector; use `os::args` instead
8667
8668    * Semantics
8669       * Trait implementations are now coherent, ala Haskell typeclasses
8670       * Trait methods may be static
8671       * Argument modes are deprecated
8672       * Borrowed pointers are much more mature and recommended for use
8673       * Strings and vectors in the static region are stored in constant memory
8674       * Typestate was removed
8675       * Resolution rewritten to be more reliable
8676       * Support for 'dual-mode' data structures (freezing and thawing)
8677
8678    * Libraries
8679       * Most binary operators can now be overloaded via the traits in
8680         `core::ops'
8681       * `std::net::url` for representing URLs
8682       * Sendable hash maps in `core::send_map`
8683       * `core::task' gained a (currently unsafe) task-local storage API
8684
8685    * Concurrency
8686       * An efficient new intertask communication primitive called the pipe,
8687         along with a number of higher-level channel types, in `core::pipes`
8688       * `std::arc`, an atomically reference counted, immutable, shared memory
8689         type
8690       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8691       * Futures are now based on pipes and sendable
8692       * More robust linked task failure
8693       * Improved task builder API
8694
8695    * Other
8696       * Improved error reporting
8697       * Preliminary JIT support
8698       * Preliminary work on precise GC
8699       * Extensive architectural improvements to rustc
8700       * Begun a transition away from buggy C++-based reflection (shape) code to
8701         Rust-based (visitor) code
8702       * All hash functions and tables converted to secure, randomized SipHash
8703
8704
8705 Version 0.3  (2012-07-12)
8706 ========================
8707
8708    * ~1900 changes, numerous bugfixes
8709
8710    * New coding conveniences
8711       * Integer-literal suffix inference
8712       * Per-item control over warnings, errors
8713       * #[cfg(windows)] and #[cfg(unix)] attributes
8714       * Documentation comments
8715       * More compact closure syntax
8716       * 'do' expressions for treating higher-order functions as
8717         control structures
8718       * *-patterns (wildcard extended to all constructor fields)
8719
8720    * Semantic cleanup
8721       * Name resolution pass and exhaustiveness checker rewritten
8722       * Region pointers and borrow checking supersede alias
8723         analysis
8724       * Init-ness checking is now provided by a region-based liveness
8725         pass instead of the typestate pass; same for last-use analysis
8726       * Extensive work on region pointers
8727
8728    * Experimental new language features
8729       * Slices and fixed-size, interior-allocated vectors
8730       * #!-comments for lang versioning, shell execution
8731       * Destructors and iface implementation for classes;
8732         type-parameterized classes and class methods
8733       * 'const' type kind for types that can be used to implement
8734         shared-memory concurrency patterns
8735
8736    * Type reflection
8737
8738    * Removal of various obsolete features
8739       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8740                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8741
8742       * Constructs: do-while loops ('do' repurposed), fn binding,
8743                     resources (replaced by destructors)
8744
8745    * Compiler reorganization
8746       * Syntax-layer of compiler split into separate crate
8747       * Clang (from LLVM project) integrated into build
8748       * Typechecker split into sub-modules
8749
8750    * New library code
8751       * New time functions
8752       * Extension methods for many built-in types
8753       * Arc: atomic-refcount read-only / exclusive-use shared cells
8754       * Par: parallel map and search routines
8755       * Extensive work on libuv interface
8756       * Much vector code moved to libraries
8757       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8758         #include, #include_str, #include_bin
8759
8760    * Tool improvements
8761       * Cargo automatically resolves dependencies
8762
8763
8764 Version 0.2  (2012-03-29)
8765 =========================
8766
8767    * >1500 changes, numerous bugfixes
8768
8769    * New docs and doc tooling
8770
8771    * New port: FreeBSD x86_64
8772
8773    * Compilation model enhancements
8774       * Generics now specialized, multiply instantiated
8775       * Functions now inlined across separate crates
8776
8777    * Scheduling, stack and threading fixes
8778       * Noticeably improved message-passing performance
8779       * Explicit schedulers
8780       * Callbacks from C
8781       * Helgrind clean
8782
8783    * Experimental new language features
8784       * Operator overloading
8785       * Region pointers
8786       * Classes
8787
8788    * Various language extensions
8789       * C-callback function types: 'crust fn ...'
8790       * Infinite-loop construct: 'loop { ... }'
8791       * Shorten 'mutable' to 'mut'
8792       * Required mutable-local qualifier: 'let mut ...'
8793       * Basic glob-exporting: 'export foo::*;'
8794       * Alt now exhaustive, 'alt check' for runtime-checked
8795       * Block-function form of 'for' loop, with 'break' and 'ret'.
8796
8797    * New library code
8798       * AST quasi-quote syntax extension
8799       * Revived libuv interface
8800       * New modules: core::{future, iter}, std::arena
8801       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8802       * Extensive cleanup, regularization in libstd, libcore
8803
8804
8805 Version 0.1  (2012-01-20)
8806 ===============================
8807
8808    * Most language features work, including:
8809       * Unique pointers, unique closures, move semantics
8810       * Interface-constrained generics
8811       * Static interface dispatch
8812       * Stack growth
8813       * Multithread task scheduling
8814       * Typestate predicates
8815       * Failure unwinding, destructors
8816       * Pattern matching and destructuring assignment
8817       * Lightweight block-lambda syntax
8818       * Preliminary macro-by-example
8819
8820    * Compiler works with the following configurations:
8821       * Linux: x86 and x86_64 hosts and targets
8822       * macOS: x86 and x86_64 hosts and targets
8823       * Windows: x86 hosts and targets
8824
8825    * Cross compilation / multi-target configuration supported.
8826
8827    * Preliminary API-documentation and package-management tools included.
8828
8829 Known issues:
8830
8831    * Documentation is incomplete.
8832
8833    * Performance is below intended target.
8834
8835    * Standard library APIs are subject to extensive change, reorganization.
8836
8837    * Language-level versioning is not yet operational - future code will
8838      break unexpectedly.