]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Use `bug!` instead of `panic!`
[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 ```rust
13 #[cfg(FALSE)]
14 mod foo {
15     mod bar {
16         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
17     }
18 }
19 ```
20
21 These are still rejected semantically, so you will likely receive an error but
22 these changes can be seen and parsed by macros and conditional compilation.
23
24 Compiler
25 --------
26 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
27   Additionally when in incremental mode rustc defaults to 256 codegen units.
28 - [Refactored `catch_unwind`, to have zero-cost unless unwinding is enabled and
29   a panic is thrown.][67502]
30 - [Added tier 3\* support for the `aarch64-unknown-none` and
31   `aarch64-unknown-none-softfloat` targets.][68334]
32 - [Added tier 3 support for `arm64-apple-tvos` and
33   `x86_64-apple-tvos` targets.][68191]
34
35
36 Libraries
37 ---------
38 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
39   `vec![]` to be able to be used in `const` contexts.
40 - [`convert::Infallible` now implements `Hash`.][70281]
41 - [`OsString` now implements `DerefMut` and `IndexMut` returning
42   a `&mut OsStr`.][70048]
43 - [Unicode 13 is now supported.][69929]
44 - [`String` now implements `From<&mut str>`.][69661]
45 - [`IoSlice` now implements `Copy`.][69403]
46 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is less than 32.
47 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
48 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
49   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
50   integer types.][69373]
51
52 Stabilized APIs
53 ---------------
54 - [`PathBuf::with_capacity`]
55 - [`PathBuf::capacity`]
56 - [`PathBuf::clear`]
57 - [`PathBuf::reserve`]
58 - [`PathBuf::reserve_exact`]
59 - [`PathBuf::shrink_to_fit`]
60 - [`f32::to_int_unchecked`]
61 - [`f64::to_int_unchecked`]
62 - [`Layout::align_to`]
63 - [`Layout::pad_to_align`]
64 - [`Layout::array`]
65 - [`Layout::extend`]
66
67 Cargo
68 -----
69 - [Added the `cargo tree` command which will print a tree graph of
70   your dependencies.][cargo/8062] E.g.
71   ```
72     mdbook v0.3.2 (/Users/src/rust/mdbook)
73   ├── ammonia v3.0.0
74   │   ├── html5ever v0.24.0
75   │   │   ├── log v0.4.8
76   │   │   │   └── cfg-if v0.1.9
77   │   │   ├── mac v0.1.1
78   │   │   └── markup5ever v0.9.0
79   │   │       ├── log v0.4.8 (*)
80   │   │       ├── phf v0.7.24
81   │   │       │   └── phf_shared v0.7.24
82   │   │       │       ├── siphasher v0.2.3
83   │   │       │       └── unicase v1.4.2
84   │   │       │           [build-dependencies]
85   │   │       │           └── version_check v0.1.5
86   ...
87   ```
88
89 Misc
90 ----
91 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
92   the version in the sidebar.][69494]
93
94 Compatibility Notes
95 -------------------
96 - [Rustc now correctly generates static libraries on Windows GNU targets with
97   the `.a` extension, rather than the previous `.lib`.][70937]
98 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
99 - [The `file_name` property in JSON output of macro errors now points the actual
100   source file rather than the previous format of `<NAME macros>`.][70969]
101   **Note:** this may not point a file that actually exists on the user's system.
102 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
103 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
104   not allow zero initialization such as `NonZeroU8`.][66059] This was
105   previously a warning.
106 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
107   operator has been defined as a saturating operation.][71269] This was previously
108   undefined behaviour, you can use the `{f64, f32}::to_int_unchecked` methods to
109   continue using the current behaviour which may desirable in rare performance
110   sensitive situations.
111
112 Internal Only
113 -------------
114 These changes provide no direct user facing benefits, but represent significant
115 improvements to the internals and overall performance of rustc and
116 related tools.
117
118 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
119 - [Replace big JS dict with JSON parsing.][71250]
120
121 [69373]: https://github.com/rust-lang/rust/pull/69373/
122 [66059]: https://github.com/rust-lang/rust/pull/66059/
123 [68191]: https://github.com/rust-lang/rust/pull/68191/
124 [68899]: https://github.com/rust-lang/rust/pull/68899/
125 [71147]: https://github.com/rust-lang/rust/pull/71147/
126 [71250]: https://github.com/rust-lang/rust/pull/71250/
127 [70937]: https://github.com/rust-lang/rust/pull/70937/
128 [70969]: https://github.com/rust-lang/rust/pull/70969/
129 [70632]: https://github.com/rust-lang/rust/pull/70632/
130 [70281]: https://github.com/rust-lang/rust/pull/70281/
131 [70345]: https://github.com/rust-lang/rust/pull/70345/
132 [70048]: https://github.com/rust-lang/rust/pull/70048/
133 [70081]: https://github.com/rust-lang/rust/pull/70081/
134 [70156]: https://github.com/rust-lang/rust/pull/70156/
135 [71269]: https://github.com/rust-lang/rust/pull/71269/
136 [69838]: https://github.com/rust-lang/rust/pull/69838/
137 [69929]: https://github.com/rust-lang/rust/pull/69929/
138 [69661]: https://github.com/rust-lang/rust/pull/69661/
139 [69778]: https://github.com/rust-lang/rust/pull/69778/
140 [69494]: https://github.com/rust-lang/rust/pull/69494/
141 [69403]: https://github.com/rust-lang/rust/pull/69403/
142 [69033]: https://github.com/rust-lang/rust/pull/69033/
143 [68692]: https://github.com/rust-lang/rust/pull/68692/
144 [68334]: https://github.com/rust-lang/rust/pull/68334/
145 [67502]: https://github.com/rust-lang/rust/pull/67502/
146 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
147 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
148 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
149 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
150 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
151 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
152 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
153 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
154 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
155 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
156 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
157 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
158 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
159
160
161 Version 1.43.1 (2020-05-07)
162 ===========================
163
164 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
165 * [Fixed the stabilization of AVX-512 features.][71473]
166 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
167
168 [71430]: https://github.com/rust-lang/rust/pull/71430
169 [71473]: https://github.com/rust-lang/rust/issues/71473
170 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
171
172
173 Version 1.43.0 (2020-04-23)
174 ==========================
175
176 Language
177 --------
178 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
179   the type inferred correctly.][68129]
180 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
181
182 **Syntax only changes**
183 - [Allow `type Foo: Ord` syntactically.][69361]
184 - [Fuse associated and extern items up to defaultness.][69194]
185 - [Syntactically allow `self` in all `fn` contexts.][68764]
186 - [Merge `fn` syntax + cleanup item parsing.][68728]
187 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
188   For example, you may now write:
189   ```rust
190   macro_rules! mac_trait {
191       ($i:item) => {
192           trait T { $i }
193       }
194   }
195   mac_trait! {
196       fn foo() {}
197   }
198   ```
199
200 These are still rejected *semantically*, so you will likely receive an error but
201 these changes can be seen and parsed by macros and
202 conditional compilation.
203
204
205 Compiler
206 --------
207 - [You can now pass multiple lint flags to rustc to override the previous
208   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
209   everything in the `unused` lint group except `unused-variables` which
210   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
211   everything in the `unused` lint group **including** `unused-variables` since
212   the allow flag is specified before the deny flag (and therefore overridden).
213 - [rustc will now prefer your system MinGW libraries over its bundled libraries
214   if they are available on `windows-gnu`.][67429]
215 - [rustc now buffers errors/warnings printed in JSON.][69227]
216
217 Libraries
218 ---------
219 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
220   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
221   respectively.][69538] **Note** These conversions are only available when `N`
222   is `0..=32`.
223 - [You can now use associated constants on floats and integers directly, rather
224   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
225   `f32::NAN` with no imports.
226 - [`u8::is_ascii` is now `const`.][68984]
227 - [`String` now implements `AsMut<str>`.][68742]
228 - [Added the `primitive` module to `std` and `core`.][67637] This module
229   reexports Rust's primitive types. This is mainly useful in macros
230   where you want avoid these types being shadowed.
231 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
232 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
233
234 Stabilized APIs
235 ---------------
236 - [`Once::is_completed`]
237 - [`f32::LOG10_2`]
238 - [`f32::LOG2_10`]
239 - [`f64::LOG10_2`]
240 - [`f64::LOG2_10`]
241 - [`iter::once_with`]
242
243 Cargo
244 -----
245 - [You can now set config `[profile]`s in your `.cargo/config`, or through
246   your environment.][cargo/7823]
247 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
248   executable path when running integration tests or benchmarks.][cargo/7697]
249   `<name>` is the name of your binary as-is e.g. If you wanted the executable
250   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
251
252 Misc
253 ----
254 - [Certain checks in the `const_err` lint were deemed unrelated to const
255   evaluation][69185], and have been moved to the `unconditional_panic` and
256   `arithmetic_overflow` lints.
257
258 Compatibility Notes
259 -------------------
260
261 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
262   has been a warning since 1.36.0.
263 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
264   led to some instances being accepted, and now correctly emits a hard error.
265
266 [69340]: https://github.com/rust-lang/rust/pull/69340
267
268 Internal Only
269 -------------
270 These changes provide no direct user facing benefits, but represent significant
271 improvements to the internals and overall performance of `rustc` and
272 related tools.
273
274 - [All components are now built with `opt-level=3` instead of `2`.][67878]
275 - [Improved how rustc generates drop code.][67332]
276 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
277 - [traits: preallocate 2 Vecs of known initial size][69022]
278 - [Avoid exponential behaviour when relating types][68772]
279 - [Skip `Drop` terminators for enum variants without drop glue][68943]
280 - [Improve performance of coherence checks][68966]
281 - [Deduplicate types in the generator witness][68672]
282 - [Invert control in struct_lint_level.][68725]
283
284 [67332]: https://github.com/rust-lang/rust/pull/67332/
285 [67429]: https://github.com/rust-lang/rust/pull/67429/
286 [67637]: https://github.com/rust-lang/rust/pull/67637/
287 [67642]: https://github.com/rust-lang/rust/pull/67642/
288 [67878]: https://github.com/rust-lang/rust/pull/67878/
289 [67885]: https://github.com/rust-lang/rust/pull/67885/
290 [68129]: https://github.com/rust-lang/rust/pull/68129/
291 [68672]: https://github.com/rust-lang/rust/pull/68672/
292 [68725]: https://github.com/rust-lang/rust/pull/68725/
293 [68728]: https://github.com/rust-lang/rust/pull/68728/
294 [68738]: https://github.com/rust-lang/rust/pull/68738/
295 [68742]: https://github.com/rust-lang/rust/pull/68742/
296 [68764]: https://github.com/rust-lang/rust/pull/68764/
297 [68772]: https://github.com/rust-lang/rust/pull/68772/
298 [68943]: https://github.com/rust-lang/rust/pull/68943/
299 [68952]: https://github.com/rust-lang/rust/pull/68952/
300 [68966]: https://github.com/rust-lang/rust/pull/68966/
301 [68984]: https://github.com/rust-lang/rust/pull/68984/
302 [69022]: https://github.com/rust-lang/rust/pull/69022/
303 [69185]: https://github.com/rust-lang/rust/pull/69185/
304 [69194]: https://github.com/rust-lang/rust/pull/69194/
305 [69201]: https://github.com/rust-lang/rust/pull/69201/
306 [69227]: https://github.com/rust-lang/rust/pull/69227/
307 [69548]: https://github.com/rust-lang/rust/pull/69548/
308 [69256]: https://github.com/rust-lang/rust/pull/69256/
309 [69361]: https://github.com/rust-lang/rust/pull/69361/
310 [69366]: https://github.com/rust-lang/rust/pull/69366/
311 [69538]: https://github.com/rust-lang/rust/pull/69538/
312 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
313 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
314 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
315 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
316 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
317 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
318 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
319 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
320
321
322 Version 1.42.0 (2020-03-12)
323 ==========================
324
325 Language
326 --------
327 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
328   ```rust
329   fn foo(words: &[&str]) {
330       match words {
331           ["Hello", "World", "!", ..] => println!("Hello World!"),
332           ["Foo", "Bar", ..] => println!("Baz"),
333           rest => println!("{:?}", rest),
334       }
335   }
336   ```
337 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
338   that you can create an enum that has the exact layout and ABI of the type
339   it contains.
340 - [There are some *syntax-only* changes:][67131]
341    - `default` is syntactically allowed before items in `trait` definitions.
342    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
343      leave out their bodies in favor of `;`.
344    - Bounds on associated types in `impl`s are now syntactically allowed
345      (e.g. `type Foo: Ord;`).
346    - `...` (the C-variadic type) may occur syntactically directly as the type of
347       any function parameter.
348
349   These are still rejected *semantically*, so you will likely receive an error
350   but these changes can be seen and parsed by procedural macros and
351   conditional compilation.
352
353 Compiler
354 --------
355 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
356 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
357 - [`Option::{expect,unwrap}` and
358    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
359    pointing to the location where they were called, rather than
360    `core`'s internals. ][67887]
361
362 \* Refer to Rust's [platform support page][forge-platform-support] for more
363 information on Rust's tiered platform support.
364
365 Libraries
366 ---------
367 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
368 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
369    to implement `Sized`.][67935]
370 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
371 - [`Layout::new` is now `const`.][66254]
372 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
373
374
375 Stabilized APIs
376 ---------------
377 - [`CondVar::wait_while`]
378 - [`CondVar::wait_timeout_while`]
379 - [`DebugMap::key`]
380 - [`DebugMap::value`]
381 - [`ManuallyDrop::take`]
382 - [`matches!`]
383 - [`ptr::slice_from_raw_parts_mut`]
384 - [`ptr::slice_from_raw_parts`]
385
386 Cargo
387 -----
388 - [You no longer need to include `extern crate proc_macro;` to be able to
389   `use proc_macro;` in the `2018` edition.][cargo/7700]
390
391 Compatibility Notes
392 -------------------
393 - [`Error::description` has been deprecated, and its use will now produce a
394   warning.][66919] It's recommended to use `Display`/`to_string` instead.
395
396 [68253]: https://github.com/rust-lang/rust/pull/68253/
397 [68348]: https://github.com/rust-lang/rust/pull/68348/
398 [67935]: https://github.com/rust-lang/rust/pull/67935/
399 [68339]: https://github.com/rust-lang/rust/pull/68339/
400 [68122]: https://github.com/rust-lang/rust/pull/68122/
401 [67712]: https://github.com/rust-lang/rust/pull/67712/
402 [67887]: https://github.com/rust-lang/rust/pull/67887/
403 [67131]: https://github.com/rust-lang/rust/pull/67131/
404 [67233]: https://github.com/rust-lang/rust/pull/67233/
405 [66899]: https://github.com/rust-lang/rust/pull/66899/
406 [66919]: https://github.com/rust-lang/rust/pull/66919/
407 [66254]: https://github.com/rust-lang/rust/pull/66254/
408 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
409 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
410 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
411 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
412 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
413 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
414 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
415 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
416 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
417
418
419 Version 1.41.1 (2020-02-27)
420 ===========================
421
422 * [Always check types of static items][69145]
423 * [Always check lifetime bounds of `Copy` impls][69145]
424 * [Fix miscompilation in callers of `Layout::repeat`][69225]
425
426 [69225]: https://github.com/rust-lang/rust/issues/69225
427 [69145]: https://github.com/rust-lang/rust/pull/69145
428
429
430 Version 1.41.0 (2020-01-30)
431 ===========================
432
433 Language
434 --------
435
436 - [You can now pass type parameters to foreign items when implementing
437   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
438 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
439   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
440   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
441 - [You can now use any valid identifier in a `format_args` macro.][66847]
442   Previously identifiers starting with an underscore were not allowed.
443 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
444   enum variants.][66183] These are still rejected semantically, but
445   can be seen and parsed by procedural macros and conditional compilation.
446
447 Compiler
448 --------
449
450 - [Rustc will now warn if you have unused loop `'label`s.][66325]
451 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
452 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
453 - [You can now pass an arguments file passing the `@path` syntax
454   to rustc.][66172] Note that the format differs somewhat from what is
455   found in other tooling; please see [the documentation][argfile-docs] for
456   more information.
457 - [You can now provide `--extern` flag without a path, indicating that it is
458   available from the search path or specified with an `-L` flag.][64882]
459
460 \* Refer to Rust's [platform support page][forge-platform-support] for more
461 information on Rust's tiered platform support.
462
463 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
464
465 Libraries
466 ---------
467
468 - [The `core::panic` module is now stable.][66771] It was already stable
469   through `std`.
470 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
471   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
472 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
473
474 Stabilized APIs
475 ---------------
476
477 - [`Result::map_or`]
478 - [`Result::map_or_else`]
479 - [`std::rc::Weak::weak_count`]
480 - [`std::rc::Weak::strong_count`]
481 - [`std::sync::Weak::weak_count`]
482 - [`std::sync::Weak::strong_count`]
483
484 Cargo
485 -----
486
487 - [Cargo will now document all the private items for binary crates
488   by default.][cargo/7593]
489 - [`cargo-install` will now reinstall the package if it detects that it is out
490   of date.][cargo/7560]
491 - [Cargo.lock now uses a more git friendly format that should help to reduce
492   merge conflicts.][cargo/7579]
493 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
494   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
495   optimisation level to `2` for debug builds. You can also use
496   `[profile.<profile>.build-override]` to override build scripts and
497   their dependencies.
498
499 Misc
500 ----
501
502 - [You can now specify `edition` in documentation code blocks to compile the block
503   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
504   should be compiled the 2018 edition of Rust.
505 - [You can now provide custom themes to rustdoc with `--theme`, and check the
506   current theme with `--check-theme`.][54733]
507 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
508
509 Compatibility Notes
510 -------------------
511
512 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
513   Apple targets.][apple-32bit-drop] This means that the source code is still
514   available to build, but the targets are no longer being tested and release
515   binaries for those platforms will no longer be distributed by the Rust project.
516   Please refer to the linked blog post for more information.
517
518 [54733]: https://github.com/rust-lang/rust/pull/54733/
519 [61351]: https://github.com/rust-lang/rust/pull/61351/
520 [67255]: https://github.com/rust-lang/rust/pull/67255/
521 [66661]: https://github.com/rust-lang/rust/pull/66661/
522 [66771]: https://github.com/rust-lang/rust/pull/66771/
523 [66847]: https://github.com/rust-lang/rust/pull/66847/
524 [66238]: https://github.com/rust-lang/rust/pull/66238/
525 [66277]: https://github.com/rust-lang/rust/pull/66277/
526 [66325]: https://github.com/rust-lang/rust/pull/66325/
527 [66172]: https://github.com/rust-lang/rust/pull/66172/
528 [66183]: https://github.com/rust-lang/rust/pull/66183/
529 [65879]: https://github.com/rust-lang/rust/pull/65879/
530 [65013]: https://github.com/rust-lang/rust/pull/65013/
531 [64882]: https://github.com/rust-lang/rust/pull/64882/
532 [64325]: https://github.com/rust-lang/rust/pull/64325/
533 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
534 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
535 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
536 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
537 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
538 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
539 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
540 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
541 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
542 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
543 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
544
545 Version 1.40.0 (2019-12-19)
546 ===========================
547
548 Language
549 --------
550 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
551   `const` contexts.][65188] e.g.
552
553   ```rust
554   pub struct Point(i32, i32);
555
556   const ORIGIN: Point = {
557       let constructor = Point;
558
559       constructor(0, 0)
560   };
561   ```
562
563 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
564   indicate that there may be variants or fields added in the future.][64639]
565   For example this requires adding a wild-card branch (`_ => {}`) to any match
566   statements on a non-exhaustive `enum`. [(RFC 2008)]
567 - [You can now use function-like procedural macros in `extern` blocks and in
568   type positions.][63931] e.g. `type Generated = macro!();`
569 - [Function-like and attribute procedural macros can now emit
570   `macro_rules!` items, so you can now have your macros generate macros.][64035]
571 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
572   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
573   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
574
575 Compiler
576 --------
577 - [Added tier 3 support\* for the
578   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
579 - [Added tier 3 support for the
580   `aarch64-unknown-none-softfloat` target.][64589]
581 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
582   `mips64el-unknown-linux-muslabi64` targets.][65843]
583
584 \* Refer to Rust's [platform support page][forge-platform-support] for more
585   information on Rust's tiered platform support.
586
587 Libraries
588 ---------
589 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
590
591 Stabilized APIs
592 ---------------
593 - [`BTreeMap::get_key_value`]
594 - [`HashMap::get_key_value`]
595 - [`Option::as_deref_mut`]
596 - [`Option::as_deref`]
597 - [`Option::flatten`]
598 - [`UdpSocket::peer_addr`]
599 - [`f32::to_be_bytes`]
600 - [`f32::to_le_bytes`]
601 - [`f32::to_ne_bytes`]
602 - [`f64::to_be_bytes`]
603 - [`f64::to_le_bytes`]
604 - [`f64::to_ne_bytes`]
605 - [`f32::from_be_bytes`]
606 - [`f32::from_le_bytes`]
607 - [`f32::from_ne_bytes`]
608 - [`f64::from_be_bytes`]
609 - [`f64::from_le_bytes`]
610 - [`f64::from_ne_bytes`]
611 - [`mem::take`]
612 - [`slice::repeat`]
613 - [`todo!`]
614
615 Cargo
616 -----
617 - [Cargo will now always display warnings, rather than only on
618   fresh builds.][cargo/7450]
619 - [Feature flags (except `--all-features`) passed to a virtual workspace will
620   now produce an error.][cargo/7507] Previously these flags were ignored.
621 - [You can now publish `dev-dependencies` without including
622   a `version`.][cargo/7333]
623
624 Misc
625 ----
626 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
627   when running documentation tests with `rustdoc`.][63803]
628
629 Compatibility Notes
630 -------------------
631 - [As previously announced, any previous NLL warnings in the 2015 edition are
632   now hard errors.][64221]
633 - [The `include!` macro will now warn if it failed to include the
634   entire file.][64284] The `include!` macro unintentionally only includes the
635   first _expression_ in a file, and this can be unintuitive. This will become
636   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
637 - [Using `#[inline]` on function prototypes and consts now emits a warning under
638   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
639   or `extern` blocks now correctly emits a hard error.
640
641 [65294]: https://github.com/rust-lang/rust/pull/65294/
642 [66103]: https://github.com/rust-lang/rust/pull/66103/
643 [65843]: https://github.com/rust-lang/rust/pull/65843/
644 [65188]: https://github.com/rust-lang/rust/pull/65188/
645 [65092]: https://github.com/rust-lang/rust/pull/65092/
646 [64589]: https://github.com/rust-lang/rust/pull/64589/
647 [64639]: https://github.com/rust-lang/rust/pull/64639/
648 [64221]: https://github.com/rust-lang/rust/pull/64221/
649 [64284]: https://github.com/rust-lang/rust/pull/64284/
650 [63931]: https://github.com/rust-lang/rust/pull/63931/
651 [64035]: https://github.com/rust-lang/rust/pull/64035/
652 [63674]: https://github.com/rust-lang/rust/pull/63674/
653 [63803]: https://github.com/rust-lang/rust/pull/63803/
654 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
655 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
656 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
657 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
658 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
659 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
660 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
661 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
662 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
663 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
664 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
665 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
666 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
667 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
668 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
669 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
670 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
671 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
672 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
673 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
674 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
675 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
676 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
677 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
678 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
679 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
680
681
682 Version 1.39.0 (2019-11-07)
683 ===========================
684
685 Language
686 --------
687 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
688   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
689 - [You can now use certain attributes on function, closure, and function pointer
690   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
691   `deny`, `forbid` as well as inert helper attributes used by procedural macro
692   attributes applied to items. e.g.
693   ```rust
694   fn len(
695       #[cfg(windows)] slice: &[u16],
696       #[cfg(not(windows))] slice: &[u8],
697   ) -> usize {
698       slice.len()
699   }
700   ```
701 - [You can now take shared references to bind-by-move patterns in the `if` guards
702   of `match` arms.][63118] e.g.
703   ```rust
704   fn main() {
705       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
706
707       match array {
708           nums
709   //      ---- `nums` is bound by move.
710               if nums.iter().sum::<u8>() == 10
711   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
712           => {
713               drop(nums);
714   //          ----------- Legal as `nums` was bound by move and so we have ownership.
715           }
716           _ => unreachable!(),
717       }
718   }
719   ```
720
721
722
723 Compiler
724 --------
725 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
726 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
727 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
728   **Note** Cargo currently doesn't use this feature. Refer to
729   [cargo#7315][cargo/7315] to track this feature's progress.
730 - [You can now pass `--show-output` argument to test binaries to print the
731   output of successful tests.][62600]
732
733
734 \* Refer to Rust's [platform support page][forge-platform-support] for more
735 information on Rust's tiered platform support.
736
737 Libraries
738 ---------
739 - [`Vec::new` and `String::new` are now `const` functions.][64028]
740 - [`LinkedList::new` is now a `const` function.][63684]
741 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
742 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
743   now `const`.][63786]
744
745 Stabilized APIs
746 ---------------
747 - [`Pin::into_inner`]
748 - [`Instant::checked_duration_since`]
749 - [`Instant::saturating_duration_since`]
750
751 Cargo
752 -----
753 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
754 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
755   `--all` is now deprecated.
756
757 Misc
758 ----
759 - [You can now pass `-Clinker` to rustdoc to control the linker used
760   for compiling doctests.][63834]
761
762 Compatibility Notes
763 -------------------
764 - [Code that was previously accepted by the old borrow checker, but rejected by
765   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
766   previously a warning, and will also become a hard error in the Rust 2015
767   edition in the 1.40.0 release.
768 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
769   run tests.][63827] This should improve performance when running a large
770   amount of doctests.
771 - [The `try!` macro will now issue a deprecation warning.][62672] It is
772   recommended to use the `?` operator instead.
773 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
774   returned `0.0`.
775
776 [62600]: https://github.com/rust-lang/rust/pull/62600/
777 [62672]: https://github.com/rust-lang/rust/pull/62672/
778 [63118]: https://github.com/rust-lang/rust/pull/63118/
779 [63209]: https://github.com/rust-lang/rust/pull/63209/
780 [63402]: https://github.com/rust-lang/rust/pull/63402/
781 [63565]: https://github.com/rust-lang/rust/pull/63565/
782 [63595]: https://github.com/rust-lang/rust/pull/63595/
783 [63684]: https://github.com/rust-lang/rust/pull/63684/
784 [63698]: https://github.com/rust-lang/rust/pull/63698/
785 [63770]: https://github.com/rust-lang/rust/pull/63770/
786 [63786]: https://github.com/rust-lang/rust/pull/63786/
787 [63827]: https://github.com/rust-lang/rust/pull/63827/
788 [63834]: https://github.com/rust-lang/rust/pull/63834/
789 [63927]: https://github.com/rust-lang/rust/pull/63927/
790 [63933]: https://github.com/rust-lang/rust/pull/63933/
791 [63934]: https://github.com/rust-lang/rust/pull/63934/
792 [63938]: https://github.com/rust-lang/rust/pull/63938/
793 [63940]: https://github.com/rust-lang/rust/pull/63940/
794 [63941]: https://github.com/rust-lang/rust/pull/63941/
795 [63945]: https://github.com/rust-lang/rust/pull/63945/
796 [64010]: https://github.com/rust-lang/rust/pull/64010/
797 [64028]: https://github.com/rust-lang/rust/pull/64028/
798 [64334]: https://github.com/rust-lang/rust/pull/64334/
799 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
800 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
801 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
802 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
803 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
804 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
805
806 Version 1.38.0 (2019-09-26)
807 ==========================
808
809 Language
810 --------
811 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
812 - [The `#[deprecated]` attribute can now be used on macros.][62042]
813
814 Compiler
815 --------
816 - [Added pipelined compilation support to `rustc`.][62766] This will
817   improve compilation times in some cases. For further information please refer
818   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
819 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
820   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
821   `x86_64-uwp-windows-msvc` targets.][60260]
822 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
823   `armv7-unknown-linux-musleabi` targets.][63107]
824 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
825 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
826
827 \* Refer to Rust's [platform support page][forge-platform-support] for more
828 information on Rust's tiered platform support.
829
830 Libraries
831 ---------
832 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
833 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
834   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
835   is available at `std::clone::Clone`). This also makes all built-in macros
836   available in `std`/`core` root. e.g. `std::include_bytes!`.
837 - [`str::Chars` now implements `Debug`.][63000]
838 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
839 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
840 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
841 - [Added euclidean remainder and division operations (`div_euclid`,
842   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
843   `overflowing`, and `wrapping` versions are available for all
844   integer primitives.
845 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
846   `PartialEq`.][61491]
847 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
848
849 Stabilized APIs
850 ---------------
851 - [`<*const T>::cast`]
852 - [`<*mut T>::cast`]
853 - [`Duration::as_secs_f32`]
854 - [`Duration::as_secs_f64`]
855 - [`Duration::div_f32`]
856 - [`Duration::div_f64`]
857 - [`Duration::from_secs_f32`]
858 - [`Duration::from_secs_f64`]
859 - [`Duration::mul_f32`]
860 - [`Duration::mul_f64`]
861 - [`any::type_name`]
862
863 Cargo
864 -----
865 - [Added pipelined compilation support to `cargo`.][cargo/7143]
866 - [You can now pass the `--features` option multiple times to enable
867   multiple features.][cargo/7084]
868
869 Misc
870 ----
871 - [`rustc` will now warn about some incorrect uses of
872   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
873
874 Compatibility Notes
875 -------------------
876 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
877   1.38.0.
878 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
879   issues][62896] with certain crates such as libc.
880
881 [60260]: https://github.com/rust-lang/rust/pull/60260/
882 [61457]: https://github.com/rust-lang/rust/pull/61457/
883 [61491]: https://github.com/rust-lang/rust/pull/61491/
884 [61884]: https://github.com/rust-lang/rust/pull/61884/
885 [61953]: https://github.com/rust-lang/rust/pull/61953/
886 [62042]: https://github.com/rust-lang/rust/pull/62042/
887 [62528]: https://github.com/rust-lang/rust/pull/62528/
888 [62583]: https://github.com/rust-lang/rust/pull/62583/
889 [62735]: https://github.com/rust-lang/rust/pull/62735/
890 [62766]: https://github.com/rust-lang/rust/pull/62766/
891 [62784]: https://github.com/rust-lang/rust/pull/62784/
892 [62785]: https://github.com/rust-lang/rust/issues/62785/
893 [62814]: https://github.com/rust-lang/rust/pull/62814/
894 [62896]: https://github.com/rust-lang/rust/issues/62896/
895 [63000]: https://github.com/rust-lang/rust/pull/63000/
896 [63056]: https://github.com/rust-lang/rust/pull/63056/
897 [63107]: https://github.com/rust-lang/rust/pull/63107/
898 [63346]: https://github.com/rust-lang/rust/pull/63346/
899 [63421]: https://github.com/rust-lang/rust/pull/63421/
900 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
901 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
902 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
903 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
904 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
905 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
906 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
907 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
908 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
909 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
910 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
911 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
912 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
913 [forge-platform-support]: https://forge.rust-lang.org/platform-support.html
914 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
915
916 Version 1.37.0 (2019-08-15)
917 ==========================
918
919 Language
920 --------
921 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
922   [`Box`][62228], or an [array][62235] and unused.
923 - [You can now use the `cfg` and `cfg_attr` attributes on
924   generic parameters.][61547]
925 - [You can now use enum variants through type alias.][61682] e.g. You can
926   write the following:
927   ```rust
928   type MyOption = Option<u8>;
929
930   fn increment_or_zero(x: MyOption) -> u8 {
931       match x {
932           MyOption::Some(y) => y + 1,
933           MyOption::None => 0,
934       }
935   }
936   ```
937 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
938   `const _: u32 = 5;`.
939 - [You can now use `#[repr(align(X)]` on enums.][61229]
940 - [The  `?` Kleene macro operator is now available in the
941   2015 edition.][60932]
942
943 Compiler
944 --------
945 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
946   and `-C profile-use` flags.][61268] For more information on how to use profile
947   guided optimization, please refer to the [rustc book][rustc-book-pgo].
948 - [The `rust-lldb` wrapper script should now work again.][61827]
949
950 Libraries
951 ---------
952 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
953
954 Stabilized APIs
955 ---------------
956 - [`BufReader::buffer`]
957 - [`BufWriter::buffer`]
958 - [`Cell::from_mut`]
959 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
960 - [`DoubleEndedIterator::nth_back`]
961 - [`Option::xor`]
962 - [`Wrapping::reverse_bits`]
963 - [`i128::reverse_bits`]
964 - [`i16::reverse_bits`]
965 - [`i32::reverse_bits`]
966 - [`i64::reverse_bits`]
967 - [`i8::reverse_bits`]
968 - [`isize::reverse_bits`]
969 - [`slice::copy_within`]
970 - [`u128::reverse_bits`]
971 - [`u16::reverse_bits`]
972 - [`u32::reverse_bits`]
973 - [`u64::reverse_bits`]
974 - [`u8::reverse_bits`]
975 - [`usize::reverse_bits`]
976
977 Cargo
978 -----
979 - [`Cargo.lock` files are now included by default when publishing executable crates
980   with executables.][cargo/7026]
981 - [You can now specify `default-run="foo"` in `[package]` to specify the
982   default executable to use for `cargo run`.][cargo/7056]
983
984 Misc
985 ----
986
987 Compatibility Notes
988 -------------------
989 - [Using `...` for inclusive range patterns will now warn by default.][61342]
990   Please transition your code to using the `..=` syntax for inclusive
991   ranges instead.
992 - [Using a trait object without the `dyn` will now warn by default.][61203]
993   Please transition your code to use `dyn Trait` for trait objects instead.
994
995 [62228]: https://github.com/rust-lang/rust/pull/62228/
996 [62235]: https://github.com/rust-lang/rust/pull/62235/
997 [61802]: https://github.com/rust-lang/rust/pull/61802/
998 [61827]: https://github.com/rust-lang/rust/pull/61827/
999 [61547]: https://github.com/rust-lang/rust/pull/61547/
1000 [61682]: https://github.com/rust-lang/rust/pull/61682/
1001 [61268]: https://github.com/rust-lang/rust/pull/61268/
1002 [61342]: https://github.com/rust-lang/rust/pull/61342/
1003 [61347]: https://github.com/rust-lang/rust/pull/61347/
1004 [61100]: https://github.com/rust-lang/rust/pull/61100/
1005 [61203]: https://github.com/rust-lang/rust/pull/61203/
1006 [61229]: https://github.com/rust-lang/rust/pull/61229/
1007 [60932]: https://github.com/rust-lang/rust/pull/60932/
1008 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1009 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1010 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1011 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1012 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1013 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1014 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1015 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1016 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1017 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1018 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1019 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1020 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1021 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1022 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1023 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1024 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1025 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1026 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1027 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1028 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1029 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1030 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1031 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1032
1033
1034 Version 1.36.0 (2019-07-04)
1035 ==========================
1036
1037 Language
1038 --------
1039 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1040 - [The order of traits in trait objects no longer affects the semantics of that
1041   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1042   `dyn fmt::Debug + Send`, where this was previously not the case.
1043
1044 Libraries
1045 ---------
1046 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1047 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1048 - [`mem::needs_drop` is now available as a const fn.][60364]
1049 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1050 - [`String` now implements `BorrowMut<str>`.][60404]
1051 - [`io::Cursor` now implements `Default`.][60234]
1052 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1053 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1054   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1055   environment has access to heap memory allocation.
1056 - [`String` now implements `From<&String>`.][59825]
1057 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1058   return a tuple of each argument when there is multiple arguments.
1059 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1060   not used.][59648]
1061
1062 Stabilized APIs
1063 ---------------
1064 - [`VecDeque::rotate_left`]
1065 - [`VecDeque::rotate_right`]
1066 - [`Iterator::copied`]
1067 - [`io::IoSlice`]
1068 - [`io::IoSliceMut`]
1069 - [`Read::read_vectored`]
1070 - [`Write::write_vectored`]
1071 - [`str::as_mut_ptr`]
1072 - [`mem::MaybeUninit`]
1073 - [`pointer::align_offset`]
1074 - [`future::Future`]
1075 - [`task::Context`]
1076 - [`task::RawWaker`]
1077 - [`task::RawWakerVTable`]
1078 - [`task::Waker`]
1079 - [`task::Poll`]
1080
1081 Cargo
1082 -----
1083 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1084 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1085
1086 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1087
1088 Clippy
1089 ------
1090 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1091
1092 Misc
1093 ----
1094
1095 Compatibility Notes
1096 -------------------
1097 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1098   longer recommended, and will be deprecated in 1.39.0.
1099
1100 [60318]: https://github.com/rust-lang/rust/pull/60318/
1101 [60364]: https://github.com/rust-lang/rust/pull/60364/
1102 [60370]: https://github.com/rust-lang/rust/pull/60370/
1103 [60404]: https://github.com/rust-lang/rust/pull/60404/
1104 [60234]: https://github.com/rust-lang/rust/pull/60234/
1105 [60244]: https://github.com/rust-lang/rust/pull/60244/
1106 [58623]: https://github.com/rust-lang/rust/pull/58623/
1107 [59648]: https://github.com/rust-lang/rust/pull/59648/
1108 [59675]: https://github.com/rust-lang/rust/pull/59675/
1109 [59825]: https://github.com/rust-lang/rust/pull/59825/
1110 [59826]: https://github.com/rust-lang/rust/pull/59826/
1111 [59445]: https://github.com/rust-lang/rust/pull/59445/
1112 [59114]: https://github.com/rust-lang/rust/pull/59114/
1113 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1114 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1115 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1116 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1117 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1118 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1119 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1120 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1121 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1122 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1123 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1124 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1125 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1126 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1127 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1128 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1129 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1130 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1131 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1132 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1133
1134
1135 Version 1.35.0 (2019-05-23)
1136 ==========================
1137
1138 Language
1139 --------
1140 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1141   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1142 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1143   ```rust
1144   unsafe fn call_unsafe(func: unsafe fn()) {
1145       func()
1146   }
1147
1148   pub fn main() {
1149       unsafe { call_unsafe(|| {}); }
1150   }
1151   ```
1152
1153
1154 Compiler
1155 --------
1156 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1157   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1158 - [Added the `wasm32-unknown-wasi` target.][59464]
1159
1160
1161 Libraries
1162 ---------
1163 - [`Thread` will now show its ID in `Debug` output.][59460]
1164 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1165 - [`alloc::System` now implements `Default`.][59451]
1166 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1167   last field.][59076]
1168 - [`char::{ToLowercase, ToUppercase}` now
1169   implement `ExactSizeIterator`.][58778]
1170 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1171 - [Removed the `Read` trait bounds
1172   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1173 - [You can now call the `dbg!` macro without any parameters to print the file
1174   and line where it is called.][57847]
1175 - [In place ASCII case conversions are now up to 4× faster.][59283]
1176   e.g. `str::make_ascii_lowercase`
1177 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1178   and `Send`.][58369]
1179
1180 Stabilized APIs
1181 ---------------
1182 - [`f32::copysign`]
1183 - [`f64::copysign`]
1184 - [`RefCell::replace_with`]
1185 - [`RefCell::map_split`]
1186 - [`ptr::hash`]
1187 - [`Range::contains`]
1188 - [`RangeFrom::contains`]
1189 - [`RangeTo::contains`]
1190 - [`RangeInclusive::contains`]
1191 - [`RangeToInclusive::contains`]
1192 - [`Option::copied`]
1193
1194 Cargo
1195 -----
1196 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1197   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1198   platform specific.
1199
1200 Misc
1201 ----
1202 - [The Rust toolchain is now available natively for musl based distros.][58575]
1203
1204 [59460]: https://github.com/rust-lang/rust/pull/59460/
1205 [59464]: https://github.com/rust-lang/rust/pull/59464/
1206 [59500]: https://github.com/rust-lang/rust/pull/59500/
1207 [59512]: https://github.com/rust-lang/rust/pull/59512/
1208 [59580]: https://github.com/rust-lang/rust/pull/59580/
1209 [59283]: https://github.com/rust-lang/rust/pull/59283/
1210 [59451]: https://github.com/rust-lang/rust/pull/59451/
1211 [59076]: https://github.com/rust-lang/rust/pull/59076/
1212 [58778]: https://github.com/rust-lang/rust/pull/58778/
1213 [58717]: https://github.com/rust-lang/rust/pull/58717/
1214 [58369]: https://github.com/rust-lang/rust/pull/58369/
1215 [58423]: https://github.com/rust-lang/rust/pull/58423/
1216 [58080]: https://github.com/rust-lang/rust/pull/58080/
1217 [57847]: https://github.com/rust-lang/rust/pull/57847/
1218 [58575]: https://github.com/rust-lang/rust/pull/58575
1219 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1220 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1221 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1222 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1223 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1224 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1225 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1226 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1227 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1228 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1229 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1230 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1231
1232 Version 1.34.2 (2019-05-14)
1233 ===========================
1234
1235 * [Destabilize the `Error::type_id` function due to a security
1236    vulnerability][60785] ([CVE-2019-12083])
1237
1238 [60785]: https://github.com/rust-lang/rust/pull/60785
1239 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1240
1241 Version 1.34.1 (2019-04-25)
1242 ===========================
1243
1244 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1245 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1246 * [Fix Clippy panic when checking some macros][clippy/3805]
1247
1248 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1249 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1250 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1251
1252 Version 1.34.0 (2019-04-11)
1253 ==========================
1254
1255 Language
1256 --------
1257 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1258   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1259   but had no effect.
1260 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1261   `#[attr{}]` procedural macros.][57367]
1262 - [You can now write `extern crate self as foo;`][57407] to import your
1263   crate's root into the extern prelude.
1264
1265
1266 Compiler
1267 --------
1268 - [You can now target `riscv64imac-unknown-none-elf` and
1269   `riscv64gc-unknown-none-elf`.][58406]
1270 - [You can now enable linker plugin LTO optimisations with
1271   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1272   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1273   boundaries.
1274 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1275
1276
1277 Libraries
1278 ---------
1279 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1280   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1281   the `Hash` trait to create an iterator.
1282 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1283   methods.][58421] Most notably you no longer require the `Ord` trait to create
1284   an iterator.
1285 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1286   for all numeric types.][58044]
1287 - [Indexing a `str` is now generic over all types that
1288   implement `SliceIndex<str>`.][57604]
1289 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1290   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1291   produce a warning if their returning type is unused.
1292 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1293   `overflowing_pow` are now available for all numeric types.][57873] These are
1294   equivalent to methods such as `wrapping_add` for the `pow` operation.
1295
1296
1297 Stabilized APIs
1298 ---------------
1299
1300 #### std & core
1301 * [`Any::type_id`]
1302 * [`Error::type_id`]
1303 * [`atomic::AtomicI16`]
1304 * [`atomic::AtomicI32`]
1305 * [`atomic::AtomicI64`]
1306 * [`atomic::AtomicI8`]
1307 * [`atomic::AtomicU16`]
1308 * [`atomic::AtomicU32`]
1309 * [`atomic::AtomicU64`]
1310 * [`atomic::AtomicU8`]
1311 * [`convert::Infallible`]
1312 * [`convert::TryFrom`]
1313 * [`convert::TryInto`]
1314 * [`iter::from_fn`]
1315 * [`iter::successors`]
1316 * [`num::NonZeroI128`]
1317 * [`num::NonZeroI16`]
1318 * [`num::NonZeroI32`]
1319 * [`num::NonZeroI64`]
1320 * [`num::NonZeroI8`]
1321 * [`num::NonZeroIsize`]
1322 * [`slice::sort_by_cached_key`]
1323 * [`str::escape_debug`]
1324 * [`str::escape_default`]
1325 * [`str::escape_unicode`]
1326 * [`str::split_ascii_whitespace`]
1327
1328 #### std
1329 * [`Instant::checked_add`]
1330 * [`Instant::checked_sub`]
1331 * [`SystemTime::checked_add`]
1332 * [`SystemTime::checked_sub`]
1333
1334 Cargo
1335 -----
1336 - [You can now use alternative registries to crates.io.][cargo/6654]
1337
1338 Misc
1339 ----
1340 - [You can now use the `?` operator in your documentation tests without manually
1341   adding `fn main() -> Result<(), _> {}`.][56470]
1342
1343 Compatibility Notes
1344 -------------------
1345 - [`Command::before_exec` is being replaced by the unsafe method
1346   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1347 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1348   can now use `const` functions in `static` variables.
1349
1350 [58370]: https://github.com/rust-lang/rust/pull/58370/
1351 [58406]: https://github.com/rust-lang/rust/pull/58406/
1352 [58421]: https://github.com/rust-lang/rust/pull/58421/
1353 [58166]: https://github.com/rust-lang/rust/pull/58166/
1354 [58044]: https://github.com/rust-lang/rust/pull/58044/
1355 [58057]: https://github.com/rust-lang/rust/pull/58057/
1356 [58059]: https://github.com/rust-lang/rust/pull/58059/
1357 [57809]: https://github.com/rust-lang/rust/pull/57809/
1358 [57873]: https://github.com/rust-lang/rust/pull/57873/
1359 [57604]: https://github.com/rust-lang/rust/pull/57604/
1360 [57367]: https://github.com/rust-lang/rust/pull/57367/
1361 [57407]: https://github.com/rust-lang/rust/pull/57407/
1362 [57425]: https://github.com/rust-lang/rust/pull/57425/
1363 [57106]: https://github.com/rust-lang/rust/pull/57106/
1364 [56470]: https://github.com/rust-lang/rust/pull/56470/
1365 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1366 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1367 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1368 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1369 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1370 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1371 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1372 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1373 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1374 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1375 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1376 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1377 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1378 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1379 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1380 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1381 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1382 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1383 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1384 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1385 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1386 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1387 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1388 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1389 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1390 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1391 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1392 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1393 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1394 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1395 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1396
1397
1398 Version 1.33.0 (2019-02-28)
1399 ==========================
1400
1401 Language
1402 --------
1403 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1404   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1405 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1406   E.g. You can have match statement on a `u8` that covers `0..=255` and
1407   you would no longer be required to have a `_ => unreachable!()` case.
1408 - [You can now have multiple patterns in `if let` and `while let`
1409   expressions.][57532] You can do this with the same syntax as a `match`
1410   expression. E.g.
1411   ```rust
1412   enum Creature {
1413       Crab(String),
1414       Lobster(String),
1415       Person(String),
1416   }
1417
1418   fn main() {
1419       let state = Creature::Crab("Ferris");
1420
1421       if let Creature::Crab(name) | Creature::Person(name) = state {
1422           println!("This creature's name is: {}", name);
1423       }
1424   }
1425   ```
1426 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1427   this feature will by default produce a warning as this behaviour can be
1428   unintuitive. E.g. `if let _ = 5 {}`
1429 - [You can now use `let` bindings, assignments, expression statements,
1430   and irrefutable pattern destructuring in const functions.][57175]
1431 - [You can now call unsafe const functions.][57067] E.g.
1432   ```rust
1433   const unsafe fn foo() -> i32 { 5 }
1434   const fn bar() -> i32 {
1435       unsafe { foo() }
1436   }
1437   ```
1438 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1439   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1440 - [You can now specify a specific alignment with the `#[repr(packed)]`
1441   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1442   with an alignment of 2 bytes and a size of 6 bytes.
1443 - [You can now import an item from a module as an `_`.][56303] This allows you to
1444   import a trait's impls, and not have the name in the namespace. E.g.
1445   ```rust
1446   use std::io::Read as _;
1447
1448   // Allowed as there is only one `Read` in the module.
1449   pub trait Read {}
1450   ```
1451 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1452
1453 Compiler
1454 --------
1455 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1456   command line argument.][56351]
1457 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1458 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1459 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1460   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1461   information on Rust's platform support.
1462 - [Added support for the `thumbv7neon-linux-androideabi` and
1463   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1464 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1465
1466 Libraries
1467 ---------
1468 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1469   functions for all numeric types.][57566]
1470 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1471   are now `const` functions for all numeric types.][57105]
1472 - [The methods `is_positive` and `is_negative` are now `const` functions for
1473   all signed numeric types.][57105]
1474 - [The `get` method for all `NonZero` types is now `const`.][57167]
1475 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1476   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1477   numeric types.][57234]
1478 - [`Ipv4Addr::new` is now a `const` function][57234]
1479
1480 Stabilized APIs
1481 ---------------
1482 - [`unix::FileExt::read_exact_at`]
1483 - [`unix::FileExt::write_all_at`]
1484 - [`Option::transpose`]
1485 - [`Result::transpose`]
1486 - [`convert::identity`]
1487 - [`pin::Pin`]
1488 - [`marker::Unpin`]
1489 - [`marker::PhantomPinned`]
1490 - [`Vec::resize_with`]
1491 - [`VecDeque::resize_with`]
1492 - [`Duration::as_millis`]
1493 - [`Duration::as_micros`]
1494 - [`Duration::as_nanos`]
1495
1496
1497 Cargo
1498 -----
1499 - [You can now publish crates that require a feature flag to compile with
1500   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1501 - [Cargo should now rebuild a crate if a file was modified during the initial
1502   build.][cargo/6484]
1503
1504 Compatibility Notes
1505 -------------------
1506 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1507   are now deprecated in the standard library, and their usage will now produce a warning.
1508   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1509   methods instead.
1510 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1511   downcasting.
1512 - [Libtest no longer creates a new thread for each test when
1513   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1514
1515 [55982]: https://github.com/rust-lang/rust/pull/55982/
1516 [56243]: https://github.com/rust-lang/rust/pull/56243
1517 [56303]: https://github.com/rust-lang/rust/pull/56303/
1518 [56351]: https://github.com/rust-lang/rust/pull/56351/
1519 [56362]: https://github.com/rust-lang/rust/pull/56362
1520 [56642]: https://github.com/rust-lang/rust/pull/56642/
1521 [56769]: https://github.com/rust-lang/rust/pull/56769/
1522 [56805]: https://github.com/rust-lang/rust/pull/56805
1523 [56947]: https://github.com/rust-lang/rust/pull/56947/
1524 [57049]: https://github.com/rust-lang/rust/pull/57049/
1525 [57067]: https://github.com/rust-lang/rust/pull/57067/
1526 [57105]: https://github.com/rust-lang/rust/pull/57105
1527 [57130]: https://github.com/rust-lang/rust/pull/57130/
1528 [57167]: https://github.com/rust-lang/rust/pull/57167/
1529 [57175]: https://github.com/rust-lang/rust/pull/57175/
1530 [57234]: https://github.com/rust-lang/rust/pull/57234/
1531 [57332]: https://github.com/rust-lang/rust/pull/57332/
1532 [57465]: https://github.com/rust-lang/rust/pull/57465/
1533 [57532]: https://github.com/rust-lang/rust/pull/57532/
1534 [57535]: https://github.com/rust-lang/rust/pull/57535/
1535 [57566]: https://github.com/rust-lang/rust/pull/57566/
1536 [57615]: https://github.com/rust-lang/rust/pull/57615/
1537 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1538 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1539 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1540 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1541 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1542 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1543 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1544 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1545 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1546 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1547 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1548 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1549 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1550 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1551 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1552 [platform-support]: https://forge.rust-lang.org/platform-support.html
1553
1554 Version 1.32.0 (2019-01-17)
1555 ==========================
1556
1557 Language
1558 --------
1559 #### 2018 edition
1560 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1561   operator allows you to specify zero or one repetitions similar to the `*` and
1562   `+` operators.
1563 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1564   now always resolve to the item (`enum`, `struct`, etc.) available in the
1565   module if present, before resolving to a external crate or an item the prelude.][56759]
1566   E.g.
1567   ```rust
1568   enum Color { Red, Green, Blue }
1569
1570   use Color::*;
1571   ```
1572
1573 #### All editions
1574 - [You can now match against `PhantomData<T>` types.][55837]
1575 - [You can now match against literals in macros with the `literal`
1576   specifier.][56072] This will match against a literal of any type.
1577   E.g. `1`, `'A'`, `"Hello World"`
1578 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1579   ```rust
1580   struct Point(i32, i32);
1581
1582   impl Point {
1583       pub fn new(x: i32, y: i32) -> Self {
1584           Self(x, y)
1585       }
1586
1587       pub fn is_origin(&self) -> bool {
1588           match self {
1589               Self(0, 0) => true,
1590               _ => false,
1591           }
1592       }
1593   }
1594   ```
1595 - [Self can also now be used in type definitions.][56366] E.g.
1596   ```rust
1597   enum List<T>
1598   where
1599       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1600   {
1601       Nil,
1602       Cons(T, Box<Self>) // likewise here
1603   }
1604   ```
1605 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1606   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1607
1608 Compiler
1609 --------
1610 - [The default allocator has changed from jemalloc to the default allocator on
1611   your system.][55238] The compiler itself on Linux & macOS will still use
1612   jemalloc, but programs compiled with it will use the system allocator.
1613 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1614
1615 Libraries
1616 ---------
1617 - [`PathBuf` now implements `FromStr`.][55148]
1618 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1619 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1620   easily debug expressions in your rust program. E.g.
1621   ```rust
1622   let a = 2;
1623   let b = dbg!(a * 2) + 1;
1624   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1625   assert_eq!(b, 5);
1626   ```
1627
1628 The following APIs are now `const` functions and can be used in a
1629 `const` context.
1630
1631 - [`Cell::as_ptr`]
1632 - [`UnsafeCell::get`]
1633 - [`char::is_ascii`]
1634 - [`iter::empty`]
1635 - [`ManuallyDrop::new`]
1636 - [`ManuallyDrop::into_inner`]
1637 - [`RangeInclusive::start`]
1638 - [`RangeInclusive::end`]
1639 - [`NonNull::as_ptr`]
1640 - [`slice::as_ptr`]
1641 - [`str::as_ptr`]
1642 - [`Duration::as_secs`]
1643 - [`Duration::subsec_millis`]
1644 - [`Duration::subsec_micros`]
1645 - [`Duration::subsec_nanos`]
1646 - [`CStr::as_ptr`]
1647 - [`Ipv4Addr::is_unspecified`]
1648 - [`Ipv6Addr::new`]
1649 - [`Ipv6Addr::octets`]
1650
1651 Stabilized APIs
1652 ---------------
1653 - [`i8::to_be_bytes`]
1654 - [`i8::to_le_bytes`]
1655 - [`i8::to_ne_bytes`]
1656 - [`i8::from_be_bytes`]
1657 - [`i8::from_le_bytes`]
1658 - [`i8::from_ne_bytes`]
1659 - [`i16::to_be_bytes`]
1660 - [`i16::to_le_bytes`]
1661 - [`i16::to_ne_bytes`]
1662 - [`i16::from_be_bytes`]
1663 - [`i16::from_le_bytes`]
1664 - [`i16::from_ne_bytes`]
1665 - [`i32::to_be_bytes`]
1666 - [`i32::to_le_bytes`]
1667 - [`i32::to_ne_bytes`]
1668 - [`i32::from_be_bytes`]
1669 - [`i32::from_le_bytes`]
1670 - [`i32::from_ne_bytes`]
1671 - [`i64::to_be_bytes`]
1672 - [`i64::to_le_bytes`]
1673 - [`i64::to_ne_bytes`]
1674 - [`i64::from_be_bytes`]
1675 - [`i64::from_le_bytes`]
1676 - [`i64::from_ne_bytes`]
1677 - [`i128::to_be_bytes`]
1678 - [`i128::to_le_bytes`]
1679 - [`i128::to_ne_bytes`]
1680 - [`i128::from_be_bytes`]
1681 - [`i128::from_le_bytes`]
1682 - [`i128::from_ne_bytes`]
1683 - [`isize::to_be_bytes`]
1684 - [`isize::to_le_bytes`]
1685 - [`isize::to_ne_bytes`]
1686 - [`isize::from_be_bytes`]
1687 - [`isize::from_le_bytes`]
1688 - [`isize::from_ne_bytes`]
1689 - [`u8::to_be_bytes`]
1690 - [`u8::to_le_bytes`]
1691 - [`u8::to_ne_bytes`]
1692 - [`u8::from_be_bytes`]
1693 - [`u8::from_le_bytes`]
1694 - [`u8::from_ne_bytes`]
1695 - [`u16::to_be_bytes`]
1696 - [`u16::to_le_bytes`]
1697 - [`u16::to_ne_bytes`]
1698 - [`u16::from_be_bytes`]
1699 - [`u16::from_le_bytes`]
1700 - [`u16::from_ne_bytes`]
1701 - [`u32::to_be_bytes`]
1702 - [`u32::to_le_bytes`]
1703 - [`u32::to_ne_bytes`]
1704 - [`u32::from_be_bytes`]
1705 - [`u32::from_le_bytes`]
1706 - [`u32::from_ne_bytes`]
1707 - [`u64::to_be_bytes`]
1708 - [`u64::to_le_bytes`]
1709 - [`u64::to_ne_bytes`]
1710 - [`u64::from_be_bytes`]
1711 - [`u64::from_le_bytes`]
1712 - [`u64::from_ne_bytes`]
1713 - [`u128::to_be_bytes`]
1714 - [`u128::to_le_bytes`]
1715 - [`u128::to_ne_bytes`]
1716 - [`u128::from_be_bytes`]
1717 - [`u128::from_le_bytes`]
1718 - [`u128::from_ne_bytes`]
1719 - [`usize::to_be_bytes`]
1720 - [`usize::to_le_bytes`]
1721 - [`usize::to_ne_bytes`]
1722 - [`usize::from_be_bytes`]
1723 - [`usize::from_le_bytes`]
1724 - [`usize::from_ne_bytes`]
1725
1726 Cargo
1727 -----
1728 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1729 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1730
1731 Misc
1732 ----
1733 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1734
1735 Compatibility Notes
1736 -------------------
1737 - [The argument types for AVX's
1738   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1739   been changed from `*const` to `*mut` as the previous implementation
1740   was unsound.
1741
1742
1743 [55148]: https://github.com/rust-lang/rust/pull/55148/
1744 [55238]: https://github.com/rust-lang/rust/pull/55238/
1745 [55280]: https://github.com/rust-lang/rust/pull/55280/
1746 [55610]: https://github.com/rust-lang/rust/pull/55610/
1747 [55663]: https://github.com/rust-lang/rust/pull/55663/
1748 [55702]: https://github.com/rust-lang/rust/pull/55702/
1749 [55837]: https://github.com/rust-lang/rust/pull/55837/
1750 [55843]: https://github.com/rust-lang/rust/pull/55843/
1751 [56072]: https://github.com/rust-lang/rust/pull/56072/
1752 [56245]: https://github.com/rust-lang/rust/pull/56245/
1753 [56365]: https://github.com/rust-lang/rust/pull/56365/
1754 [56366]: https://github.com/rust-lang/rust/pull/56366/
1755 [56395]: https://github.com/rust-lang/rust/pull/56395/
1756 [56759]: https://github.com/rust-lang/rust/pull/56759/
1757 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1758 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1759 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1760 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1761 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1762 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1763 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1764 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1765 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1766 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1767 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1768 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1769 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1770 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1771 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1772 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1773 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1774 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1775 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1776 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1777 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1778 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1779 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1780 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1781 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1782 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1783 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1784 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1785 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1786 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1787 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1788 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1789 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1790 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1791 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1792 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1793 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1794 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1795 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1796 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1797 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1798 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1799 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1800 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1801 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1802 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1803 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1804 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1805 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1806 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1807 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1808 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1809 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1810 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1811 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1812 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1813 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1814 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1815 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1816 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1817 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1818 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1819 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1820 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1821 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1822 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1823 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1824 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1825 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1826 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1827 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1828 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1829 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1830 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1831 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1832 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1833 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1834 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1835 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1836 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1837 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1838 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1839 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1840 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1841 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1842 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1843 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1844 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1845 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1846 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1847 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1848 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1849 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1850
1851
1852 Version 1.31.1 (2018-12-20)
1853 ===========================
1854
1855 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1856 - [Fix broken go-to-definition in RLS][rls/1171]
1857 - [Fix infinite loop on hover in RLS][rls/1170]
1858
1859 [56562]: https://github.com/rust-lang/rust/pull/56562
1860 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1861 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1862
1863 Version 1.31.0 (2018-12-06)
1864 ==========================
1865
1866 Language
1867 --------
1868 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1869 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1870   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1871   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1872   in structs.
1873 - [You can now define and use `const` functions.][54835] These are currently
1874   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1875   [language reference][const-reference] for what exactly is available.
1876 - [You can now use tool lints, which allow you to scope lints from external
1877   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1878 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1879   a crate, not just in exported functions.][54451]
1880 - [You can now use parentheses in pattern matches.][54497]
1881
1882 Compiler
1883 --------
1884 - [Updated musl to 1.1.20][54430]
1885
1886 Libraries
1887 ---------
1888 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1889   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1890 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1891   into `Option<&mut T>` using the `From` trait.][53218]
1892 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1893
1894
1895 Stabilized APIs
1896 ---------------
1897 - [`slice::align_to`]
1898 - [`slice::align_to_mut`]
1899 - [`slice::chunks_exact`]
1900 - [`slice::chunks_exact_mut`]
1901 - [`slice::rchunks`]
1902 - [`slice::rchunks_mut`]
1903 - [`slice::rchunks_exact`]
1904 - [`slice::rchunks_exact_mut`]
1905 - [`Option::replace`]
1906
1907 Cargo
1908 -----
1909 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1910 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1911   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1912
1913 [52813]: https://github.com/rust-lang/rust/pull/52813/
1914 [53218]: https://github.com/rust-lang/rust/pull/53218/
1915 [53555]: https://github.com/rust-lang/rust/issues/53555/
1916 [54057]: https://github.com/rust-lang/rust/pull/54057/
1917 [54240]: https://github.com/rust-lang/rust/pull/54240/
1918 [54430]: https://github.com/rust-lang/rust/pull/54430/
1919 [54451]: https://github.com/rust-lang/rust/pull/54451/
1920 [54497]: https://github.com/rust-lang/rust/pull/54497/
1921 [54778]: https://github.com/rust-lang/rust/pull/54778/
1922 [54835]: https://github.com/rust-lang/rust/pull/54835/
1923 [54870]: https://github.com/rust-lang/rust/pull/54870/
1924 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1925 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1926 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1927 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1928 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1929 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1930 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1931 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1932 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1933 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1934 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1935 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1936 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1937 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1938
1939 Version 1.30.1 (2018-11-08)
1940 ===========================
1941
1942 - [Fixed overflow ICE in rustdoc][54199]
1943 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1944
1945 [54199]: https://github.com/rust-lang/rust/pull/54199
1946 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1947
1948 Version 1.30.0 (2018-10-25)
1949 ==========================
1950
1951 Language
1952 --------
1953 - [Procedural macros are now available.][52081] These kinds of macros allow for
1954   more powerful code generation. There is a [new chapter available][proc-macros]
1955   in the Rust Programming Language book that goes further in depth.
1956 - [You can now use keywords as identifiers using the raw identifiers
1957   syntax (`r#`),][53236] e.g. `let r#for = true;`
1958 - [Using anonymous parameters in traits is now deprecated with a warning and
1959   will be a hard error in the 2018 edition.][53272]
1960 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1961   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1962 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1963   Previously, using a external crate in a module without a use statement
1964   required `let json = ::serde_json::from_str(foo);` but can now be written
1965   as `let json = serde_json::from_str(foo);`.
1966 - [You can now apply the `#[used]` attribute to static items to prevent the
1967   compiler from optimising them away, even if they appear to be unused,][51363]
1968   e.g. `#[used] static FOO: u32 = 1;`
1969 - [You can now import and reexport macros from other crates with the `use`
1970   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1971   the root module of the crate. If your macro relies on calling other local
1972   macros, it is recommended to export with the
1973   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1974   those macros.
1975 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1976   using the `vis` specifier.][53370]
1977 - [Non-macro attributes now allow all forms of literals, not just
1978   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1979   write `#[attr(true)]`.
1980 - [You can now specify a function to handle a panic in the Rust runtime with the
1981   `#[panic_handler]` attribute.][51366]
1982
1983 Compiler
1984 --------
1985 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1986 - [Added the `aarch64-unknown-netbsd` target][53165]
1987
1988 Libraries
1989 ---------
1990 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1991
1992 Stabilized APIs
1993 ---------------
1994 - [`Ipv4Addr::BROADCAST`]
1995 - [`Ipv4Addr::LOCALHOST`]
1996 - [`Ipv4Addr::UNSPECIFIED`]
1997 - [`Ipv6Addr::LOCALHOST`]
1998 - [`Ipv6Addr::UNSPECIFIED`]
1999 - [`Iterator::find_map`]
2000
2001   The following methods are replacement methods for `trim_left`, `trim_right`,
2002   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2003   in 1.33.0:
2004 - [`str::trim_end_matches`]
2005 - [`str::trim_end`]
2006 - [`str::trim_start_matches`]
2007 - [`str::trim_start`]
2008
2009 Cargo
2010 ----
2011 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2012 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2013   equivalent to calling `rustdoc --error-format=json`.
2014 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2015
2016 Misc
2017 ----
2018 - [`rustdoc` allows you to specify what edition to treat your code as with the
2019   `--edition` option.][54057]
2020 - [`rustdoc` now has the `--color` (specify whether to output color) and
2021   `--error-format` (specify error format, e.g. `json`) options.][53003]
2022 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2023   debug symbols.][53774]
2024 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2025   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2026
2027 [50911]: https://github.com/rust-lang/rust/pull/50911/
2028 [51363]: https://github.com/rust-lang/rust/pull/51363/
2029 [51366]: https://github.com/rust-lang/rust/pull/51366/
2030 [52081]: https://github.com/rust-lang/rust/pull/52081/
2031 [53003]: https://github.com/rust-lang/rust/pull/53003/
2032 [53033]: https://github.com/rust-lang/rust/pull/53033/
2033 [53044]: https://github.com/rust-lang/rust/pull/53044/
2034 [53165]: https://github.com/rust-lang/rust/pull/53165/
2035 [53213]: https://github.com/rust-lang/rust/pull/53213/
2036 [53236]: https://github.com/rust-lang/rust/pull/53236/
2037 [53272]: https://github.com/rust-lang/rust/pull/53272/
2038 [53370]: https://github.com/rust-lang/rust/pull/53370/
2039 [53459]: https://github.com/rust-lang/rust/pull/53459/
2040 [53774]: https://github.com/rust-lang/rust/pull/53774/
2041 [53822]: https://github.com/rust-lang/rust/pull/53822/
2042 [54057]: https://github.com/rust-lang/rust/pull/54057/
2043 [54146]: https://github.com/rust-lang/rust/pull/54146/
2044 [54404]: https://github.com/rust-lang/rust/pull/54404/
2045 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2046 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2047 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2048 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2049
2050 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2051 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2052 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2053 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2054 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2055 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2056 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2057 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2058 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2059 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2060
2061
2062 Version 1.29.2 (2018-10-11)
2063 ===========================
2064
2065 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2066 - The `rls-preview` component on the windows-gnu targets has been restored.
2067
2068 [54639]: https://github.com/rust-lang/rust/pull/54639
2069
2070
2071 Version 1.29.1 (2018-09-25)
2072 ===========================
2073
2074 Security Notes
2075 --------------
2076
2077 - The standard library's `str::repeat` function contained an out of bounds write
2078   caused by an integer overflow. This has been fixed by deterministically
2079   panicking when an overflow happens.
2080
2081   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2082   us.
2083
2084
2085 Version 1.29.0 (2018-09-13)
2086 ==========================
2087
2088 Compiler
2089 --------
2090 - [Bumped minimum LLVM version to 5.0.][51899]
2091 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2092 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2093
2094 Libraries
2095 ---------
2096 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2097 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2098 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2099 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2100   for `&str`.][51178]
2101 - [`Cell<T>` now allows `T` to be unsized.][50494]
2102 - [`SocketAddr` is now stable on Redox.][52656]
2103
2104 Stabilized APIs
2105 ---------------
2106 - [`Arc::downcast`]
2107 - [`Iterator::flatten`]
2108 - [`Rc::downcast`]
2109
2110 Cargo
2111 -----
2112 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2113   `--locked` to disable this behavior.
2114 - [`cargo-install` will now allow you to cross compile an install
2115   using `--target`.][cargo/5614]
2116 - [Added the `cargo-fix` subcommand to automatically move project code from
2117   2015 edition to 2018.][cargo/5723]
2118 - [`cargo doc` can now optionally document private types using the
2119   `--document-private-items` flag.][cargo/5543]
2120
2121 Misc
2122 ----
2123 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2124   the specified level to that level.][52354] For example `--cap-lints warn`
2125   will demote `deny` and `forbid` lints to `warn`.
2126 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2127   fails and `101` if there is a panic.][52197]
2128 - [A preview of clippy has been made available through rustup.][51122]
2129   You can install the preview with `rustup component add clippy-preview`.
2130
2131 Compatibility Notes
2132 -------------------
2133 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2134   Use `str::get_unchecked(begin..end)` instead.
2135 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2136   Consider using the `home_dir` function from
2137   https://crates.io/crates/dirs instead.
2138 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2139 - [`cfg` attributes and `--cfg` command line flags are now more
2140   strictly validated.][53893]
2141
2142 [53893]: https://github.com/rust-lang/rust/pull/53893/
2143 [52861]: https://github.com/rust-lang/rust/pull/52861/
2144 [52656]: https://github.com/rust-lang/rust/pull/52656/
2145 [52239]: https://github.com/rust-lang/rust/pull/52239/
2146 [52330]: https://github.com/rust-lang/rust/pull/52330/
2147 [52354]: https://github.com/rust-lang/rust/pull/52354/
2148 [52402]: https://github.com/rust-lang/rust/pull/52402/
2149 [52103]: https://github.com/rust-lang/rust/pull/52103/
2150 [52197]: https://github.com/rust-lang/rust/pull/52197/
2151 [51807]: https://github.com/rust-lang/rust/pull/51807/
2152 [51899]: https://github.com/rust-lang/rust/pull/51899/
2153 [51912]: https://github.com/rust-lang/rust/pull/51912/
2154 [51511]: https://github.com/rust-lang/rust/pull/51511/
2155 [51619]: https://github.com/rust-lang/rust/pull/51619/
2156 [51656]: https://github.com/rust-lang/rust/pull/51656/
2157 [51178]: https://github.com/rust-lang/rust/pull/51178/
2158 [51122]: https://github.com/rust-lang/rust/pull/51122
2159 [50494]: https://github.com/rust-lang/rust/pull/50494/
2160 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2161 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2162 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2163 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2164 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2165 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2166 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2167
2168
2169 Version 1.28.0 (2018-08-02)
2170 ===========================
2171
2172 Language
2173 --------
2174 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2175   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2176   the inner type across Foreign Function Interface (FFI) boundaries.
2177 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2178   and can now be used as identifiers.][51196]
2179 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2180   stable.][51241] This will allow users to specify a global allocator for
2181   their program.
2182 - [Unit test functions marked with the `#[test]` attribute can now return
2183   `Result<(), E: Debug>` in addition to `()`.][51298]
2184 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2185   allows macros to easily target lifetimes.
2186
2187 Compiler
2188 --------
2189 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2190   prioritise making smaller binary sizes. `z` is the same as `s` with the
2191   exception that it does not vectorise loops, which typically results in an even
2192   smaller binary.
2193 - [The short error format is now stable.][49546] Specified with
2194   `--error-format=short` this option will provide a more compressed output of
2195   rust error messages.
2196 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2197 - [Reduced the number of allocations in the macro parser.][50855] This can
2198   improve compile times of macro heavy crates on average by 5%.
2199
2200 Libraries
2201 ---------
2202 - [Implemented `Default` for `&mut str`.][51306]
2203 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2204 - [Implemented `Extend` for `()`.][50234]
2205 - [The `Debug` implementation of `time::Duration` should now be more easily
2206   human readable.][50364] Previously a `Duration` of one second would printed as
2207   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2208 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2209   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2210   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2211   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2212   for `PathBuf`.][50170]
2213 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2214   and `Wrapping<i128>`.][50465]
2215 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2216   possible.][51050] This can provide up to a 40% speed increase.
2217 - [Improved error messages when using `format!`.][50610]
2218
2219 Stabilized APIs
2220 ---------------
2221 - [`Iterator::step_by`]
2222 - [`Path::ancestors`]
2223 - [`SystemTime::UNIX_EPOCH`]
2224 - [`alloc::GlobalAlloc`]
2225 - [`alloc::Layout`]
2226 - [`alloc::LayoutErr`]
2227 - [`alloc::System`]
2228 - [`alloc::alloc`]
2229 - [`alloc::alloc_zeroed`]
2230 - [`alloc::dealloc`]
2231 - [`alloc::realloc`]
2232 - [`alloc::handle_alloc_error`]
2233 - [`btree_map::Entry::or_default`]
2234 - [`fmt::Alignment`]
2235 - [`hash_map::Entry::or_default`]
2236 - [`iter::repeat_with`]
2237 - [`num::NonZeroUsize`]
2238 - [`num::NonZeroU128`]
2239 - [`num::NonZeroU16`]
2240 - [`num::NonZeroU32`]
2241 - [`num::NonZeroU64`]
2242 - [`num::NonZeroU8`]
2243 - [`ops::RangeBounds`]
2244 - [`slice::SliceIndex`]
2245 - [`slice::from_mut`]
2246 - [`slice::from_ref`]
2247 - [`{Any + Send + Sync}::downcast_mut`]
2248 - [`{Any + Send + Sync}::downcast_ref`]
2249 - [`{Any + Send + Sync}::is`]
2250
2251 Cargo
2252 -----
2253 - [Cargo will now no longer allow you to publish crates with build scripts that
2254   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2255   considered to be immutable.
2256
2257 Misc
2258 ----
2259 - [The `suggestion_applicability` field in `rustc`'s json output is now
2260   stable.][50486] This will allow dev tools to check whether a code suggestion
2261   would apply to them.
2262
2263 Compatibility Notes
2264 -------------------
2265 - [Rust will consider trait objects with duplicated constraints to be the same
2266   type as without the duplicated constraint.][51276] For example the below code will
2267   now fail to compile.
2268   ```rust
2269   trait Trait {}
2270
2271   impl Trait + Send {
2272       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2273   }
2274
2275   impl Trait + Send + Send {
2276       fn test(&self) { println!("two"); }
2277   }
2278   ```
2279
2280 [49546]: https://github.com/rust-lang/rust/pull/49546/
2281 [50143]: https://github.com/rust-lang/rust/pull/50143/
2282 [50170]: https://github.com/rust-lang/rust/pull/50170/
2283 [50234]: https://github.com/rust-lang/rust/pull/50234/
2284 [50265]: https://github.com/rust-lang/rust/pull/50265/
2285 [50364]: https://github.com/rust-lang/rust/pull/50364/
2286 [50385]: https://github.com/rust-lang/rust/pull/50385/
2287 [50465]: https://github.com/rust-lang/rust/pull/50465/
2288 [50486]: https://github.com/rust-lang/rust/pull/50486/
2289 [50554]: https://github.com/rust-lang/rust/pull/50554/
2290 [50610]: https://github.com/rust-lang/rust/pull/50610/
2291 [50855]: https://github.com/rust-lang/rust/pull/50855/
2292 [51050]: https://github.com/rust-lang/rust/pull/51050/
2293 [51196]: https://github.com/rust-lang/rust/pull/51196/
2294 [51200]: https://github.com/rust-lang/rust/pull/51200/
2295 [51241]: https://github.com/rust-lang/rust/pull/51241/
2296 [51276]: https://github.com/rust-lang/rust/pull/51276/
2297 [51298]: https://github.com/rust-lang/rust/pull/51298/
2298 [51306]: https://github.com/rust-lang/rust/pull/51306/
2299 [51562]: https://github.com/rust-lang/rust/pull/51562/
2300 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2301 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2302 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2303 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2304 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2305 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2306 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2307 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2308 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2309 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2310 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2311 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2312 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2313 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2314 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2315 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2316 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2317 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2318 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2319 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2320 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2321 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2322 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2323 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2324 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2325 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2326 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2327 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2328 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2329 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2330
2331 Version 1.27.2 (2018-07-20)
2332 ===========================
2333
2334 Compatibility Notes
2335 -------------------
2336
2337 - The borrow checker was fixed to avoid potential unsoundness when using
2338   match ergonomics: [#52213][52213].
2339
2340 [52213]: https://github.com/rust-lang/rust/issues/52213
2341
2342 Version 1.27.1 (2018-07-10)
2343 ===========================
2344
2345 Security Notes
2346 --------------
2347
2348 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2349   when running, which enabled executing code as some other user on a
2350   given machine. This release fixes that vulnerability; you can read
2351   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2352
2353   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2354
2355 Compatibility Notes
2356 -------------------
2357
2358 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2359   match ergonomics: [#51415][51415], [#49534][49534].
2360
2361 [51415]: https://github.com/rust-lang/rust/issues/51415
2362 [49534]: https://github.com/rust-lang/rust/issues/49534
2363 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2364 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2365
2366 Version 1.27.0 (2018-06-21)
2367 ==========================
2368
2369 Language
2370 --------
2371 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2372   be used as an identifier.
2373 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2374   bare `Trait` syntax, and should make it clearer when being used in tandem with
2375   `impl Trait` because it is equivalent to the following syntax:
2376   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2377   `Box<Trait> == Box<dyn Trait>`.
2378 - [Attributes on generic parameters such as types and lifetimes are
2379   now stable.][48851] e.g.
2380   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2381 - [The `#[must_use]` attribute can now also be used on functions as well as
2382   types.][48925] It provides a lint that by default warns users when the
2383   value returned by a function has not been used.
2384
2385 Compiler
2386 --------
2387 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2388
2389 Libraries
2390 ---------
2391 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2392   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2393   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2394   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2395   the `cfg` attribute.
2396 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2397   std are now available in core.][49896]
2398 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2399   to `Self`.][49630]
2400 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2401   that the operation isn't done in place.
2402 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2403   the `#[must_use]` attribute][49533] to warn about unused potentially
2404   expensive allocations.
2405
2406 Stabilized APIs
2407 ---------------
2408 - [`DoubleEndedIterator::rfind`]
2409 - [`DoubleEndedIterator::rfold`]
2410 - [`DoubleEndedIterator::try_rfold`]
2411 - [`Duration::from_micros`]
2412 - [`Duration::from_nanos`]
2413 - [`Duration::subsec_micros`]
2414 - [`Duration::subsec_millis`]
2415 - [`HashMap::remove_entry`]
2416 - [`Iterator::try_fold`]
2417 - [`Iterator::try_for_each`]
2418 - [`NonNull::cast`]
2419 - [`Option::filter`]
2420 - [`String::replace_range`]
2421 - [`Take::set_limit`]
2422 - [`hint::unreachable_unchecked`]
2423 - [`os::unix::process::parent_id`]
2424 - [`ptr::swap_nonoverlapping`]
2425 - [`slice::rsplit_mut`]
2426 - [`slice::rsplit`]
2427 - [`slice::swap_with_slice`]
2428
2429 Cargo
2430 -----
2431 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2432   `readme`, and `repository` fields.][cargo/5386]
2433 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2434 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2435   a different directory than `target` for placing compilation artifacts.
2436 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2437   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2438   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2439   where cargo would infer a binary, Cargo will produce a warning. You can
2440   disable this feature ahead of time by setting any of the following to false:
2441   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2442 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2443   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2444
2445 Misc
2446 ----
2447 - [Added “The Rustc book” into the official documentation.][49707]
2448   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2449 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2450
2451 Compatibility Notes
2452 -------------------
2453 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2454   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2455   compile, `"".is_empty()` will still compile.
2456 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2457   will only print the inner type.][48553] E.g.
2458   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2459   not `AtomicBool(true)`.
2460 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2461   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2462   alignment should cover all use cases.
2463 - The `.description()` method on the `std::error::Error` trait
2464   [has been soft-deprecated][50163]. It is no longer required to implement it.
2465
2466 [48553]: https://github.com/rust-lang/rust/pull/48553/
2467 [48851]: https://github.com/rust-lang/rust/pull/48851/
2468 [48925]: https://github.com/rust-lang/rust/pull/48925/
2469 [49533]: https://github.com/rust-lang/rust/pull/49533/
2470 [49623]: https://github.com/rust-lang/rust/pull/49623/
2471 [49630]: https://github.com/rust-lang/rust/pull/49630/
2472 [49664]: https://github.com/rust-lang/rust/pull/49664/
2473 [49699]: https://github.com/rust-lang/rust/pull/49699/
2474 [49707]: https://github.com/rust-lang/rust/pull/49707/
2475 [49719]: https://github.com/rust-lang/rust/pull/49719/
2476 [49896]: https://github.com/rust-lang/rust/pull/49896/
2477 [49968]: https://github.com/rust-lang/rust/pull/49968/
2478 [50163]: https://github.com/rust-lang/rust/pull/50163
2479 [50177]: https://github.com/rust-lang/rust/pull/50177/
2480 [50378]: https://github.com/rust-lang/rust/pull/50378/
2481 [50398]: https://github.com/rust-lang/rust/pull/50398/
2482 [50423]: https://github.com/rust-lang/rust/pull/50423/
2483 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2484 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2485 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2486 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2487 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2488 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2489 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2490 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2491 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2492 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2493 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2494 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2495 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2496 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2497 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2498 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2499 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2500 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2501 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2502 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2503 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2504 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2505 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2506 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2507 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2508 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2509 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2510 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2511 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2512 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2513
2514
2515 Version 1.26.2 (2018-06-05)
2516 ==========================
2517
2518 Compatibility Notes
2519 -------------------
2520
2521 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2522
2523 [51117]: https://github.com/rust-lang/rust/issues/51117
2524
2525
2526 Version 1.26.1 (2018-05-29)
2527 ==========================
2528
2529 Tools
2530 -----
2531
2532 - [RLS now works on Windows.][50646]
2533 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2534
2535
2536 Compatibility Notes
2537 --------
2538
2539 - [`fn main() -> impl Trait` no longer works for non-Termination
2540   trait.][50656]
2541   This reverts an accidental stabilization.
2542 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2543 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2544
2545 [50646]: https://github.com/rust-lang/rust/issues/50646
2546 [50656]: https://github.com/rust-lang/rust/pull/50656
2547 [50812]: https://github.com/rust-lang/rust/pull/50812
2548 [50950]: https://github.com/rust-lang/rust/issues/50950
2549 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2550
2551 Version 1.26.0 (2018-05-10)
2552 ==========================
2553
2554 Language
2555 --------
2556 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2557   implement either or both traits.][49299]
2558 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2559 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2560   lifetime can be elided.][49458]
2561 - [`impl Trait` is now stable allowing you to have abstract types in returns
2562    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2563   `fn open(path: impl AsRef<Path>)`.
2564 - [Pattern matching will now automatically apply dereferences.][49394]
2565 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2566 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2567 - [A lot of operations are now available in a const context.][46882] E.g. You
2568   can now index into constant arrays, reference and dereference into constants,
2569   and use tuple struct constructors.
2570 - [Fixed entry slice patterns are now stable.][48516] E.g.
2571   ```rust
2572   let points = [1, 2, 3, 4];
2573   match points {
2574       [1, 2, 3, 4] => println!("All points were sequential."),
2575       _ => println!("Not all points were sequential."),
2576   }
2577   ```
2578
2579
2580 Compiler
2581 --------
2582 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2583 - [Fixed exponential projection complexity on nested types.][48296]
2584   This can provide up to a ~12% reduction in compile times for certain crates.
2585 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2586   to remap path prefixes outputted by the compiler.
2587 - [Added `powerpc-unknown-netbsd` target.][48281]
2588
2589 Libraries
2590 ---------
2591 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2592 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2593   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2594 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2595 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2596 - [`ascii::escape_default` is now available in libcore.][48735]
2597 - [Trailing commas are now supported in std and core macros.][48056]
2598 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2599 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2600
2601 Stabilized APIs
2602 ---------------
2603 - [`*const T::add`]
2604 - [`*const T::copy_to_nonoverlapping`]
2605 - [`*const T::copy_to`]
2606 - [`*const T::read_unaligned`]
2607 - [`*const T::read_volatile`]
2608 - [`*const T::read`]
2609 - [`*const T::sub`]
2610 - [`*const T::wrapping_add`]
2611 - [`*const T::wrapping_sub`]
2612 - [`*mut T::add`]
2613 - [`*mut T::copy_to_nonoverlapping`]
2614 - [`*mut T::copy_to`]
2615 - [`*mut T::read_unaligned`]
2616 - [`*mut T::read_volatile`]
2617 - [`*mut T::read`]
2618 - [`*mut T::replace`]
2619 - [`*mut T::sub`]
2620 - [`*mut T::swap`]
2621 - [`*mut T::wrapping_add`]
2622 - [`*mut T::wrapping_sub`]
2623 - [`*mut T::write_bytes`]
2624 - [`*mut T::write_unaligned`]
2625 - [`*mut T::write_volatile`]
2626 - [`*mut T::write`]
2627 - [`Box::leak`]
2628 - [`FromUtf8Error::as_bytes`]
2629 - [`LocalKey::try_with`]
2630 - [`Option::cloned`]
2631 - [`btree_map::Entry::and_modify`]
2632 - [`fs::read_to_string`]
2633 - [`fs::read`]
2634 - [`fs::write`]
2635 - [`hash_map::Entry::and_modify`]
2636 - [`iter::FusedIterator`]
2637 - [`ops::RangeInclusive`]
2638 - [`ops::RangeToInclusive`]
2639 - [`process::id`]
2640 - [`slice::rotate_left`]
2641 - [`slice::rotate_right`]
2642 - [`String::retain`]
2643
2644
2645 Cargo
2646 -----
2647 - [Cargo will now output path to custom commands when `-v` is
2648   passed with `--list`][cargo/5041]
2649 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2650
2651 Misc
2652 ----
2653 - [The second edition of "The Rust Programming Language" book is now recommended
2654   over the first.][48404]
2655
2656 Compatibility Notes
2657 -------------------
2658
2659 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2660   syntax is now invalid.
2661   ```
2662   use std::ops::Fn as dyn;
2663   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2664   ```
2665 - [The result of dereferences are no longer promoted to `'static`.][47408]
2666   e.g.
2667   ```rust
2668   fn main() {
2669       const PAIR: &(i32, i32) = &(0, 1);
2670       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2671   }
2672   ```
2673 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2674 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2675   an error.][48235]
2676 - [Removed hoedown from rustdoc.][48274]
2677 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2678
2679 [46882]: https://github.com/rust-lang/rust/pull/46882
2680 [47379]: https://github.com/rust-lang/rust/pull/47379
2681 [47408]: https://github.com/rust-lang/rust/pull/47408
2682 [47813]: https://github.com/rust-lang/rust/pull/47813
2683 [48056]: https://github.com/rust-lang/rust/pull/48056
2684 [48125]: https://github.com/rust-lang/rust/pull/48125
2685 [48166]: https://github.com/rust-lang/rust/pull/48166
2686 [48235]: https://github.com/rust-lang/rust/pull/48235
2687 [48274]: https://github.com/rust-lang/rust/pull/48274
2688 [48281]: https://github.com/rust-lang/rust/pull/48281
2689 [48296]: https://github.com/rust-lang/rust/pull/48296
2690 [48326]: https://github.com/rust-lang/rust/pull/48326
2691 [48359]: https://github.com/rust-lang/rust/pull/48359
2692 [48404]: https://github.com/rust-lang/rust/pull/48404
2693 [48481]: https://github.com/rust-lang/rust/pull/48481
2694 [48516]: https://github.com/rust-lang/rust/pull/48516
2695 [48628]: https://github.com/rust-lang/rust/pull/48628
2696 [48629]: https://github.com/rust-lang/rust/pull/48629
2697 [48657]: https://github.com/rust-lang/rust/pull/48657
2698 [48735]: https://github.com/rust-lang/rust/pull/48735
2699 [48978]: https://github.com/rust-lang/rust/pull/48978
2700 [49101]: https://github.com/rust-lang/rust/pull/49101
2701 [49109]: https://github.com/rust-lang/rust/pull/49109
2702 [49121]: https://github.com/rust-lang/rust/pull/49121
2703 [49162]: https://github.com/rust-lang/rust/pull/49162
2704 [49184]: https://github.com/rust-lang/rust/pull/49184
2705 [49234]: https://github.com/rust-lang/rust/pull/49234
2706 [49255]: https://github.com/rust-lang/rust/pull/49255
2707 [49299]: https://github.com/rust-lang/rust/pull/49299
2708 [49305]: https://github.com/rust-lang/rust/pull/49305
2709 [49394]: https://github.com/rust-lang/rust/pull/49394
2710 [49458]: https://github.com/rust-lang/rust/pull/49458
2711 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2712 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2713 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2714 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2715 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2716 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2717 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2718 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2719 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2720 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2721 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2722 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2723 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2724 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2725 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2726 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2727 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2728 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2729 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2730 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2731 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2732 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2733 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2734 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2735 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2736 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2737 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2738 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2739 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2740 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2741 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2742 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2743 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2744 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2745 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2746 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2747 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2748 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2749 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2750 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2751 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2752 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2753
2754
2755 Version 1.25.0 (2018-03-29)
2756 ==========================
2757
2758 Language
2759 --------
2760 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2761 - [You can now use nested groups of imports.][47948]
2762   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2763 - [You can now have `|` at the start of a match arm.][47947] e.g.
2764 ```rust
2765 enum Foo { A, B, C }
2766
2767 fn main() {
2768     let x = Foo::A;
2769     match x {
2770         | Foo::A
2771         | Foo::B => println!("AB"),
2772         | Foo::C => println!("C"),
2773     }
2774 }
2775 ```
2776
2777 Compiler
2778 --------
2779 - [Upgraded to LLVM 6.][47828]
2780 - [Added `-C lto=val` option.][47521]
2781 - [Added `i586-unknown-linux-musl` target][47282]
2782
2783 Libraries
2784 ---------
2785 - [Impl Send for `process::Command` on Unix.][47760]
2786 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2787 - [`UnsafeCell::into_inner` is now safe.][47204]
2788 - [Implement libstd for CloudABI.][47268]
2789 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2790 - [Implement `AsRef<Path>` for Component][46985]
2791 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2792 - [Moved `Duration` to libcore.][46666]
2793
2794 Stabilized APIs
2795 ---------------
2796 - [`Location::column`]
2797 - [`ptr::NonNull`]
2798
2799 The following functions can now be used in a constant expression.
2800 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2801 - [`Duration::new`][47300]
2802 - [`Duration::from_secs`][47300]
2803 - [`Duration::from_millis`][47300]
2804
2805 Cargo
2806 -----
2807 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2808 - [`cargo new` now defaults to creating a binary crate, instead of a
2809   library crate.][cargo/5029]
2810
2811 Misc
2812 ----
2813 - [Rust by example is now shipped with new releases][46196]
2814
2815 Compatibility Notes
2816 -------------------
2817 - [Deprecated `net::lookup_host`.][47510]
2818 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2819 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2820   around indexing operations (see [#47349][47349]). This has been fixed (which also
2821   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2822 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2823
2824 [33903]: https://github.com/rust-lang/rust/pull/33903
2825 [47947]: https://github.com/rust-lang/rust/pull/47947
2826 [47948]: https://github.com/rust-lang/rust/pull/47948
2827 [47760]: https://github.com/rust-lang/rust/pull/47760
2828 [47790]: https://github.com/rust-lang/rust/pull/47790
2829 [47828]: https://github.com/rust-lang/rust/pull/47828
2830 [47398]: https://github.com/rust-lang/rust/pull/47398
2831 [47510]: https://github.com/rust-lang/rust/pull/47510
2832 [47521]: https://github.com/rust-lang/rust/pull/47521
2833 [47204]: https://github.com/rust-lang/rust/pull/47204
2834 [47251]: https://github.com/rust-lang/rust/pull/47251
2835 [47268]: https://github.com/rust-lang/rust/pull/47268
2836 [47282]: https://github.com/rust-lang/rust/pull/47282
2837 [47300]: https://github.com/rust-lang/rust/pull/47300
2838 [47349]: https://github.com/rust-lang/rust/pull/47349
2839 [46931]: https://github.com/rust-lang/rust/pull/46931
2840 [46985]: https://github.com/rust-lang/rust/pull/46985
2841 [47006]: https://github.com/rust-lang/rust/pull/47006
2842 [46830]: https://github.com/rust-lang/rust/pull/46830
2843 [46095]: https://github.com/rust-lang/rust/pull/46095
2844 [46666]: https://github.com/rust-lang/rust/pull/46666
2845 [46196]: https://github.com/rust-lang/rust/pull/46196
2846 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2847 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2848 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2849 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2850 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2851
2852
2853 Version 1.24.1 (2018-03-01)
2854 ==========================
2855
2856  - [Do not abort when unwinding through FFI][48251]
2857  - [Emit UTF-16 files for linker arguments on Windows][48318]
2858  - [Make the error index generator work again][48308]
2859  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2860
2861 [48251]: https://github.com/rust-lang/rust/issues/48251
2862 [48308]: https://github.com/rust-lang/rust/issues/48308
2863 [48318]: https://github.com/rust-lang/rust/issues/48318
2864 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2865
2866
2867 Version 1.24.0 (2018-02-15)
2868 ==========================
2869
2870 Language
2871 --------
2872 - [External `sysv64` ffi is now available.][46528]
2873   eg. `extern "sysv64" fn foo () {}`
2874
2875 Compiler
2876 --------
2877 - [rustc now uses 16 codegen units by default for release builds.][46910]
2878   For the fastest builds, utilize `codegen-units=1`.
2879 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2880 - [Add `aarch64-unknown-openbsd` support][46760]
2881
2882 Libraries
2883 ---------
2884 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2885   improvement in performance in the majority of cases.
2886 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2887   with Windows.][46798]
2888 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2889 - [impl `From<bool>` for `AtomicBool`][46293]
2890 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2891 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2892 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2893 - [float::from_bits now just uses transmute.][46012] This provides
2894   some optimisations from LLVM.
2895 - [Copied `AsciiExt` methods onto `char`][46077]
2896 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2897 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2898 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2899 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2900
2901 Stabilized APIs
2902 ---------------
2903 - [`RefCell::replace`]
2904 - [`RefCell::swap`]
2905 - [`atomic::spin_loop_hint`]
2906
2907 The following functions can now be used in a constant expression.
2908 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2909
2910 - [`AtomicBool::new`][46287]
2911 - [`AtomicUsize::new`][46287]
2912 - [`AtomicIsize::new`][46287]
2913 - [`AtomicPtr::new`][46287]
2914 - [`Cell::new`][46287]
2915 - [`{integer}::min_value`][46287]
2916 - [`{integer}::max_value`][46287]
2917 - [`mem::size_of`][46287]
2918 - [`mem::align_of`][46287]
2919 - [`ptr::null`][46287]
2920 - [`ptr::null_mut`][46287]
2921 - [`RefCell::new`][46287]
2922 - [`UnsafeCell::new`][46287]
2923
2924 Cargo
2925 -----
2926 - [Added a `workspace.default-members` config that
2927   overrides implied `--all` in virtual workspaces.][cargo/4743]
2928 - [Enable incremental by default on development builds.][cargo/4817] Also added
2929   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2930   per-project or global basis respectively.
2931
2932 Misc
2933 ----
2934
2935 Compatibility Notes
2936 -------------------
2937 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2938 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2939   in accordance with IETF RFC 4291 §2.2.
2940 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2941 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2942   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2943 - [Leading zeros in tuple struct members is now an error][47084]
2944 - [`column!()` macro is one-based instead of zero-based][46977]
2945 - [`fmt::Arguments` can no longer be shared across threads][45198]
2946 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2947 - [Cargo sets a different working directory for the compiler][cargo/4788]
2948
2949 [44884]: https://github.com/rust-lang/rust/pull/44884
2950 [45198]: https://github.com/rust-lang/rust/pull/45198
2951 [45506]: https://github.com/rust-lang/rust/pull/45506
2952 [45904]: https://github.com/rust-lang/rust/pull/45904
2953 [45990]: https://github.com/rust-lang/rust/pull/45990
2954 [46012]: https://github.com/rust-lang/rust/pull/46012
2955 [46077]: https://github.com/rust-lang/rust/pull/46077
2956 [46094]: https://github.com/rust-lang/rust/pull/46094
2957 [46284]: https://github.com/rust-lang/rust/pull/46284
2958 [46287]: https://github.com/rust-lang/rust/pull/46287
2959 [46293]: https://github.com/rust-lang/rust/pull/46293
2960 [46528]: https://github.com/rust-lang/rust/pull/46528
2961 [46671]: https://github.com/rust-lang/rust/pull/46671
2962 [46713]: https://github.com/rust-lang/rust/pull/46713
2963 [46735]: https://github.com/rust-lang/rust/pull/46735
2964 [46749]: https://github.com/rust-lang/rust/pull/46749
2965 [46760]: https://github.com/rust-lang/rust/pull/46760
2966 [46798]: https://github.com/rust-lang/rust/pull/46798
2967 [46828]: https://github.com/rust-lang/rust/pull/46828
2968 [46831]: https://github.com/rust-lang/rust/pull/46831
2969 [46833]: https://github.com/rust-lang/rust/pull/46833
2970 [46910]: https://github.com/rust-lang/rust/pull/46910
2971 [46977]: https://github.com/rust-lang/rust/pull/46977
2972 [47018]: https://github.com/rust-lang/rust/pull/47018
2973 [47080]: https://github.com/rust-lang/rust/pull/47080
2974 [47084]: https://github.com/rust-lang/rust/pull/47084
2975 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2976 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2977 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2978 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2979 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2980 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2981
2982
2983 Version 1.23.0 (2018-01-04)
2984 ==========================
2985
2986 Language
2987 --------
2988 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2989 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2990   Which should fix some confusing errors in some operations.
2991
2992 Compiler
2993 --------
2994 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2995   undefined behavior.][45920]
2996 - [rustc now suggests renaming import if names clash.][45660]
2997 - [Display errors/warnings correctly when there are zero-width or
2998   wide characters.][45711]
2999 - [rustc now avoids unnecessary copies of arguments that are
3000   simple bindings][45380] This should improve memory usage on average by 5-10%.
3001 - [Updated musl used to build musl rustc to 1.1.17][45393]
3002
3003 Libraries
3004 ---------
3005 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3006 - [Implement Hash for raw pointers to unsized types][45483]
3007 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3008 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3009 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3010 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3011   and `<*mut T>::as_mut`][44932]
3012 - [Optimized `Thread::{park, unpark}` implementation][45524]
3013 - [Improved `SliceExt::binary_search` performance.][45333]
3014 - [impl `FromIterator<()>` for `()`][45379]
3015 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3016   is now deprecated.
3017
3018 Stabilized APIs
3019 ---------------
3020
3021 Cargo
3022 -----
3023 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3024   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3025 - [Added unit test checking to `cargo check`][cargo/4592]
3026 - [Cargo now lets you install a specific version
3027   using `cargo install --version`][cargo/4637]
3028
3029 Misc
3030 ----
3031 - [Releases now ship with the Cargo book documentation.][45692]
3032 - [rustdoc now prints rendering warnings on every run.][45324]
3033
3034 Compatibility Notes
3035 -------------------
3036 - [Changes have been made to type equality to make it more correct,
3037   in rare cases this could break some code.][45853] [Tracking issue for
3038   further information][45852]
3039 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3040 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3041   Android 9, the minimum supported version is Android 14.
3042 - [Bumped the minimum LLVM to 3.9][45326]
3043
3044 [44042]: https://github.com/rust-lang/rust/pull/44042
3045 [44932]: https://github.com/rust-lang/rust/pull/44932
3046 [45267]: https://github.com/rust-lang/rust/pull/45267
3047 [45324]: https://github.com/rust-lang/rust/pull/45324
3048 [45326]: https://github.com/rust-lang/rust/pull/45326
3049 [45333]: https://github.com/rust-lang/rust/pull/45333
3050 [45379]: https://github.com/rust-lang/rust/pull/45379
3051 [45380]: https://github.com/rust-lang/rust/pull/45380
3052 [45393]: https://github.com/rust-lang/rust/pull/45393
3053 [45435]: https://github.com/rust-lang/rust/pull/45435
3054 [45483]: https://github.com/rust-lang/rust/pull/45483
3055 [45524]: https://github.com/rust-lang/rust/pull/45524
3056 [45571]: https://github.com/rust-lang/rust/pull/45571
3057 [45580]: https://github.com/rust-lang/rust/pull/45580
3058 [45610]: https://github.com/rust-lang/rust/pull/45610
3059 [45660]: https://github.com/rust-lang/rust/pull/45660
3060 [45692]: https://github.com/rust-lang/rust/pull/45692
3061 [45711]: https://github.com/rust-lang/rust/pull/45711
3062 [45772]: https://github.com/rust-lang/rust/pull/45772
3063 [45852]: https://github.com/rust-lang/rust/issues/45852
3064 [45853]: https://github.com/rust-lang/rust/pull/45853
3065 [45887]: https://github.com/rust-lang/rust/pull/45887
3066 [45920]: https://github.com/rust-lang/rust/pull/45920
3067 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3068 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3069 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3070
3071
3072 Version 1.22.1 (2017-11-22)
3073 ==========================
3074
3075 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3076
3077 [46183]: https://github.com/rust-lang/rust/pull/46183
3078
3079 Version 1.22.0 (2017-11-22)
3080 ==========================
3081
3082 Language
3083 --------
3084 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3085 - [Now accepts underscores in unicode escapes][43716]
3086 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3087 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3088
3089 Compiler
3090 --------
3091 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3092 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3093   This should decrease compile times for debug builds.
3094 - [strict memory alignment now enabled on ARMv6][45094]
3095 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3096
3097 Libraries
3098 ---------
3099 - [Allow atomic operations up to 32 bits
3100   on `armv5te_unknown_linux_gnueabi`][44978]
3101 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3102 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3103 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3104 - [Properly detect overflow in `Instant += Duration`.][44220]
3105 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3106 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3107 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3108
3109 Stabilized APIs
3110 ---------------
3111
3112 Cargo
3113 -----
3114 - [Cargo will now build multi file examples in subdirectories of the `examples`
3115   folder that have a `main.rs` file.][cargo/4496]
3116 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3117   the old format will continue to work and can be updated with `cargo update`.
3118 - [Now supports vendoring git repositories][cargo/3992]
3119
3120 Misc
3121 ----
3122 - [`libbacktrace` is now available on Apple platforms.][44251]
3123 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3124   This now lets you specify that a given code example will fail to compile.
3125
3126 Compatibility Notes
3127 -------------------
3128 - [The minimum Android version that rustc can build for has been bumped
3129   to `4.0` from `2.3`][45656]
3130 - [Allowing `T op= &T` for numeric types has broken some type
3131   inference cases][45480]
3132
3133
3134 [42526]: https://github.com/rust-lang/rust/pull/42526
3135 [43017]: https://github.com/rust-lang/rust/pull/43017
3136 [43716]: https://github.com/rust-lang/rust/pull/43716
3137 [43949]: https://github.com/rust-lang/rust/pull/43949
3138 [44015]: https://github.com/rust-lang/rust/pull/44015
3139 [44220]: https://github.com/rust-lang/rust/pull/44220
3140 [44251]: https://github.com/rust-lang/rust/pull/44251
3141 [44287]: https://github.com/rust-lang/rust/pull/44287
3142 [44303]: https://github.com/rust-lang/rust/pull/44303
3143 [44456]: https://github.com/rust-lang/rust/pull/44456
3144 [44466]: https://github.com/rust-lang/rust/pull/44466
3145 [44895]: https://github.com/rust-lang/rust/pull/44895
3146 [44966]: https://github.com/rust-lang/rust/pull/44966
3147 [44978]: https://github.com/rust-lang/rust/pull/44978
3148 [45041]: https://github.com/rust-lang/rust/pull/45041
3149 [45064]: https://github.com/rust-lang/rust/pull/45064
3150 [45075]: https://github.com/rust-lang/rust/pull/45075
3151 [45094]: https://github.com/rust-lang/rust/pull/45094
3152 [45095]: https://github.com/rust-lang/rust/pull/45095
3153 [45480]: https://github.com/rust-lang/rust/issues/45480
3154 [45656]: https://github.com/rust-lang/rust/pull/45656
3155 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3156 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3157 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3158
3159
3160
3161
3162
3163
3164 Version 1.21.0 (2017-10-12)
3165 ==========================
3166
3167 Language
3168 --------
3169 - [You can now use static references for literals.][43838]
3170   Example:
3171   ```rust
3172   fn main() {
3173       let x: &'static u32 = &0;
3174   }
3175   ```
3176 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3177   Example:
3178   ```rust
3179   my_macro!(Vec<i32>::new); // Always worked
3180   my_macro!(Vec::<i32>::new); // Now works
3181   ```
3182
3183 Compiler
3184 --------
3185 - [Upgraded jemalloc to 4.5.0][43911]
3186 - [Enabled unwinding panics on Redox][43917]
3187 - [Now runs LLVM in parallel during translation phase.][43506]
3188   This should reduce peak memory usage.
3189
3190 Libraries
3191 ---------
3192 - [Generate builtin impls for `Clone` for all arrays and tuples that
3193   are `T: Clone`][43690]
3194 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3195 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3196   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3197
3198 Stabilized APIs
3199 ---------------
3200
3201 [`std::mem::discriminant`]
3202
3203 Cargo
3204 -----
3205 - [You can now call `cargo install` with multiple package names][cargo/4216]
3206 - [Cargo commands inside a virtual workspace will now implicitly
3207   pass `--all`][cargo/4335]
3208 - [Added a `[patch]` section to `Cargo.toml` to handle
3209   prepublication dependencies][cargo/4123] [RFC 1969]
3210 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3211   like patterns][cargo/4270]
3212 - [Added the `--all-targets` option][cargo/4400]
3213 - [Using required dependencies as a feature is now deprecated and emits
3214   a warning][cargo/4364]
3215
3216
3217 Misc
3218 ----
3219 - [Cargo docs are moving][43916]
3220   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3221 - [The rustdoc book is now available][43863]
3222   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3223 - [Added a preview of RLS has been made available through rustup][44204]
3224   Install with `rustup component add rls-preview`
3225 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3226   Previously only showed `std::os::unix`.
3227
3228 Compatibility Notes
3229 -------------------
3230 - [Changes in method matching against higher-ranked types][43880] This may cause
3231   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3232 - [rustc's JSON error output's byte position start at top of file.][42973]
3233   Was previously relative to the rustc's internal `CodeMap` struct which
3234   required the unstable library `libsyntax` to correctly use.
3235 - [`unused_results` lint no longer ignores booleans][43728]
3236
3237 [42565]: https://github.com/rust-lang/rust/pull/42565
3238 [42973]: https://github.com/rust-lang/rust/pull/42973
3239 [43348]: https://github.com/rust-lang/rust/pull/43348
3240 [43459]: https://github.com/rust-lang/rust/pull/43459
3241 [43506]: https://github.com/rust-lang/rust/pull/43506
3242 [43540]: https://github.com/rust-lang/rust/pull/43540
3243 [43690]: https://github.com/rust-lang/rust/pull/43690
3244 [43728]: https://github.com/rust-lang/rust/pull/43728
3245 [43838]: https://github.com/rust-lang/rust/pull/43838
3246 [43863]: https://github.com/rust-lang/rust/pull/43863
3247 [43880]: https://github.com/rust-lang/rust/pull/43880
3248 [43911]: https://github.com/rust-lang/rust/pull/43911
3249 [43916]: https://github.com/rust-lang/rust/pull/43916
3250 [43917]: https://github.com/rust-lang/rust/pull/43917
3251 [44204]: https://github.com/rust-lang/rust/pull/44204
3252 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3253 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3254 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3255 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3256 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3257 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3258 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3259 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3260 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3261
3262 Version 1.20.0 (2017-08-31)
3263 ===========================
3264
3265 Language
3266 --------
3267 - [Associated constants are now stabilised.][42809]
3268 - [A lot of macro bugs are now fixed.][42913]
3269
3270 Compiler
3271 --------
3272
3273 - [Struct fields are now properly coerced to the expected field type.][42807]
3274 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3275   `wasm32-experimental-emscripten` target.
3276 - [Changed some of the error messages to be more helpful.][42033]
3277 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3278   it.][43170]
3279 - [rustc now reports the total number of errors on compilation failure][43015]
3280   previously this was only the number of errors in the pass that failed.
3281 - [Expansion in rustc has been sped up 29x.][42533]
3282 - [added `msp430-none-elf` target.][43099]
3283 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3284   applicable][43178]
3285 - [Fixes backtraces on Redox][43228]
3286 - [rustc now identifies different versions of same crate when absolute paths of
3287   different types match in an error message.][42826]
3288
3289 Libraries
3290 ---------
3291
3292
3293 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3294 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3295   tuples.][43011]
3296 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3297   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3298 - [Impl `Clone` for `DefaultHasher`.][42799]
3299 - [Impl `Sync` for `SyncSender`.][42397]
3300 - [Impl `FromStr` for `char`][42271]
3301 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3302   NaN.][42431]
3303 - [allow messages in the `unimplemented!()` macro.][42155]
3304   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3305 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3306 - [Upgrade to Unicode 10.0.0][42999]
3307 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3308 - [Skip the main thread's manual stack guard on Linux][43072]
3309 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3310 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3311   previously 2^15.
3312 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3313
3314 Stabilized APIs
3315 ---------------
3316
3317 - [`CStr::into_c_string`]
3318 - [`CString::as_c_str`]
3319 - [`CString::into_boxed_c_str`]
3320 - [`Chain::get_mut`]
3321 - [`Chain::get_ref`]
3322 - [`Chain::into_inner`]
3323 - [`Option::get_or_insert_with`]
3324 - [`Option::get_or_insert`]
3325 - [`OsStr::into_os_string`]
3326 - [`OsString::into_boxed_os_str`]
3327 - [`Take::get_mut`]
3328 - [`Take::get_ref`]
3329 - [`Utf8Error::error_len`]
3330 - [`char::EscapeDebug`]
3331 - [`char::escape_debug`]
3332 - [`compile_error!`]
3333 - [`f32::from_bits`]
3334 - [`f32::to_bits`]
3335 - [`f64::from_bits`]
3336 - [`f64::to_bits`]
3337 - [`mem::ManuallyDrop`]
3338 - [`slice::sort_unstable_by_key`]
3339 - [`slice::sort_unstable_by`]
3340 - [`slice::sort_unstable`]
3341 - [`str::from_boxed_utf8_unchecked`]
3342 - [`str::as_bytes_mut`]
3343 - [`str::as_bytes_mut`]
3344 - [`str::from_utf8_mut`]
3345 - [`str::from_utf8_unchecked_mut`]
3346 - [`str::get_mut`]
3347 - [`str::get_unchecked_mut`]
3348 - [`str::get_unchecked`]
3349 - [`str::get`]
3350 - [`str::into_boxed_bytes`]
3351
3352
3353 Cargo
3354 -----
3355 - [Cargo API token location moved from `~/.cargo/config` to
3356   `~/.cargo/credentials`.][cargo/3978]
3357 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3358   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3359   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3360 - [You can now specify version of a binary when installed through
3361   `cargo install` using `--vers`.][cargo/4229]
3362 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3363   failure.][cargo/4248]
3364 - [Changed the convention around which file is the crate root.][cargo/4259]
3365 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3366   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3367
3368 Compatibility Notes
3369 -------------------
3370
3371 - [Functions with `'static` in their return types will now not be as usable as
3372   if they were using lifetime parameters instead.][42417]
3373 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3374   takes the sign of NaN into account where previously didn't.][42430]
3375
3376 [42033]: https://github.com/rust-lang/rust/pull/42033
3377 [42155]: https://github.com/rust-lang/rust/pull/42155
3378 [42271]: https://github.com/rust-lang/rust/pull/42271
3379 [42397]: https://github.com/rust-lang/rust/pull/42397
3380 [42417]: https://github.com/rust-lang/rust/pull/42417
3381 [42430]: https://github.com/rust-lang/rust/pull/42430
3382 [42431]: https://github.com/rust-lang/rust/pull/42431
3383 [42533]: https://github.com/rust-lang/rust/pull/42533
3384 [42571]: https://github.com/rust-lang/rust/pull/42571
3385 [42613]: https://github.com/rust-lang/rust/pull/42613
3386 [42799]: https://github.com/rust-lang/rust/pull/42799
3387 [42807]: https://github.com/rust-lang/rust/pull/42807
3388 [42809]: https://github.com/rust-lang/rust/pull/42809
3389 [42822]: https://github.com/rust-lang/rust/pull/42822
3390 [42826]: https://github.com/rust-lang/rust/pull/42826
3391 [42854]: https://github.com/rust-lang/rust/pull/42854
3392 [42913]: https://github.com/rust-lang/rust/pull/42913
3393 [42999]: https://github.com/rust-lang/rust/pull/42999
3394 [43011]: https://github.com/rust-lang/rust/pull/43011
3395 [43015]: https://github.com/rust-lang/rust/pull/43015
3396 [43072]: https://github.com/rust-lang/rust/pull/43072
3397 [43077]: https://github.com/rust-lang/rust/pull/43077
3398 [43097]: https://github.com/rust-lang/rust/pull/43097
3399 [43099]: https://github.com/rust-lang/rust/pull/43099
3400 [43170]: https://github.com/rust-lang/rust/pull/43170
3401 [43178]: https://github.com/rust-lang/rust/pull/43178
3402 [43185]: https://github.com/rust-lang/rust/pull/43185
3403 [43228]: https://github.com/rust-lang/rust/pull/43228
3404 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3405 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3406 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3407 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3408 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3409 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3410 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3411 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3412 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3413 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3414 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3415 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3416 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3417 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3418 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3419 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3420 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3421 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3422 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3423 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3424 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3425 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3426 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3427 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3428 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3429 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3430 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3431 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3432 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3433 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3434 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3435 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3436 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3437 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3438 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3439 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3440 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3441 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3442 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3443
3444
3445 Version 1.19.0 (2017-07-20)
3446 ===========================
3447
3448 Language
3449 --------
3450
3451 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3452   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3453 - [Macro recursion limit increased to 1024 from 64.][41676]
3454 - [Added lint for detecting unused macros.][41907]
3455 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3456   For example: `let x = loop { break 7; };`
3457 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3458   contain `Copy` types and cannot have a `Drop` implementation.
3459   Example: `union Foo { bar: u8, baz: usize }`
3460 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3461   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3462
3463 Compiler
3464 --------
3465
3466 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3467 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3468   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3469   you should use `--target armv7-linux-androideabi`.
3470 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3471 - [Minor optimisation of string operations.][42037]
3472 - [Compiler error message is now `aborting due to previous error(s)` instead of
3473   `aborting due to N previous errors`][42150] This was previously inaccurate and
3474   would only count certain kinds of errors.
3475 - [The compiler now supports Visual Studio 2017][42225]
3476 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3477 - [Added a lot][42264] of [new error codes][42302]
3478 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3479   libraries with C Run-time Libraries(CRT) to be statically linked.
3480 - [Fixed various ARM codegen bugs][42740]
3481
3482 Libraries
3483 ---------
3484
3485 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3486   `Extend<Cow<'a, str>>`][41449]
3487 - [`Vec` now implements `From<&mut [T]>`][41530]
3488 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3489 - [`SplitWhitespace` now implements `Clone`][41659]
3490 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3491   1.5x faster][41764]
3492 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3493   macros, but for printing to stderr.
3494
3495 Stabilized APIs
3496 ---------------
3497
3498 - [`OsString::shrink_to_fit`]
3499 - [`cmp::Reverse`]
3500 - [`Command::envs`]
3501 - [`thread::ThreadId`]
3502
3503 Cargo
3504 -----
3505
3506 - [Build scripts can now add environment variables to the environment
3507   the crate is being compiled in.
3508   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3509 - [Subcommands now replace the current process rather than spawning a new
3510   child process][cargo/3970]
3511 - [Workspace members can now accept glob file patterns][cargo/3979]
3512 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3513   the members in a given workspace.][cargo/3988]
3514 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3515 - [Target directory path is now in the cargo metadata][cargo/4022]
3516 - [Cargo no longer checks out a local working directory for the
3517   crates.io index][cargo/4026] This should provide smaller file size for the
3518   registry, and improve cloning times, especially on Windows machines.
3519 - [Added an `--exclude` option for excluding certain packages when using the
3520   `--all` option][cargo/4031]
3521 - [Cargo will now automatically retry when receiving a 5xx error
3522   from crates.io][cargo/4032]
3523 - [The `--features` option now accepts multiple comma or space
3524   delimited values.][cargo/4084]
3525 - [Added support for custom target specific runners][cargo/3954]
3526
3527 Misc
3528 ----
3529
3530 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3531   Windows Debugger.
3532 - [Rust will now release XZ compressed packages][rust-installer/57]
3533 - [rustup will now prefer to download rust packages with
3534   XZ compression][rustup/1100] over GZip packages.
3535 - [Added the ability to escape `#` in rust documentation][41785] By adding
3536   additional `#`'s ie. `##` is now `#`
3537
3538 Compatibility Notes
3539 -------------------
3540
3541 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3542 - [`-Z` flags are now no longer allowed to be used on the stable
3543   compiler.][41751] This has been a warning for a year previous to this.
3544 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3545   longer works][42844]. Users should migrate to the built-in `check`
3546   command, which has been available since 1.16.
3547 - [Ending a float literal with `._` is now a hard error.
3548   Example: `42._` .][41946]
3549 - [Any use of a private `extern crate` outside of its module is now a
3550   hard error.][36886] This was previously a warning.
3551 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3552   relative while the `::` prefix makes a path absolute, but was ignored and the
3553   path was relative regardless.
3554 - [Floating point constants in match patterns is now a hard error][36890]
3555   This was previously a warning.
3556 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3557   match patterns is now a hard error][36891] This was previously a warning.
3558 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3559   a warning.
3560 - [From the pound escape, lines consisting of multiple `#`s are
3561   now visible][41785]
3562 - [It is an error to re-export private enum variants][42460]. This is
3563   known to break a number of crates that depend on an older version of
3564   mustache.
3565 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3566   to use it to find the linker, and the build will fail where it did
3567   not previously][42607]
3568
3569 [36886]: https://github.com/rust-lang/rust/issues/36886
3570 [36888]: https://github.com/rust-lang/rust/issues/36888
3571 [36890]: https://github.com/rust-lang/rust/issues/36890
3572 [36891]: https://github.com/rust-lang/rust/issues/36891
3573 [36892]: https://github.com/rust-lang/rust/issues/36892
3574 [37406]: https://github.com/rust-lang/rust/issues/37406
3575 [39983]: https://github.com/rust-lang/rust/pull/39983
3576 [41145]: https://github.com/rust-lang/rust/pull/41145
3577 [41192]: https://github.com/rust-lang/rust/pull/41192
3578 [41258]: https://github.com/rust-lang/rust/pull/41258
3579 [41370]: https://github.com/rust-lang/rust/pull/41370
3580 [41449]: https://github.com/rust-lang/rust/pull/41449
3581 [41530]: https://github.com/rust-lang/rust/pull/41530
3582 [41624]: https://github.com/rust-lang/rust/pull/41624
3583 [41656]: https://github.com/rust-lang/rust/pull/41656
3584 [41659]: https://github.com/rust-lang/rust/pull/41659
3585 [41676]: https://github.com/rust-lang/rust/pull/41676
3586 [41751]: https://github.com/rust-lang/rust/pull/41751
3587 [41764]: https://github.com/rust-lang/rust/pull/41764
3588 [41785]: https://github.com/rust-lang/rust/pull/41785
3589 [41873]: https://github.com/rust-lang/rust/pull/41873
3590 [41907]: https://github.com/rust-lang/rust/pull/41907
3591 [41946]: https://github.com/rust-lang/rust/pull/41946
3592 [42016]: https://github.com/rust-lang/rust/pull/42016
3593 [42037]: https://github.com/rust-lang/rust/pull/42037
3594 [42068]: https://github.com/rust-lang/rust/pull/42068
3595 [42150]: https://github.com/rust-lang/rust/pull/42150
3596 [42162]: https://github.com/rust-lang/rust/pull/42162
3597 [42225]: https://github.com/rust-lang/rust/pull/42225
3598 [42264]: https://github.com/rust-lang/rust/pull/42264
3599 [42302]: https://github.com/rust-lang/rust/pull/42302
3600 [42460]: https://github.com/rust-lang/rust/issues/42460
3601 [42607]: https://github.com/rust-lang/rust/issues/42607
3602 [42740]: https://github.com/rust-lang/rust/pull/42740
3603 [42844]: https://github.com/rust-lang/rust/issues/42844
3604 [42948]: https://github.com/rust-lang/rust/pull/42948
3605 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3606 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3607 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3608 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3609 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3610 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3611 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3612 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3613 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3614 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3615 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3616 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3617 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3618 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3619 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3620 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3621 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3622 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3623 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3624 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3625 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3626 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3627
3628
3629 Version 1.18.0 (2017-06-08)
3630 ===========================
3631
3632 Language
3633 --------
3634
3635 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3636   make the item visible to just that module tree. Also accepts the keyword
3637   `crate` to make something public to the whole crate but not users of the
3638   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3639 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3640   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3641 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3642   types like `Write + Send`, trailing `+` are now supported in trait objects,
3643   and better error reporting for trait objects starting with `?Sized`.
3644 - [0e+10 is now a valid floating point literal][40589]
3645 - [Now warns if you bind a lifetime parameter to 'static][40734]
3646 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3647   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3648   representation in some cases.][40377]
3649
3650 Compiler
3651 --------
3652
3653 - [rustc can now emit mir with `--emit mir`][39891]
3654 - [Improved LLVM IR for trivial functions][40367]
3655 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3656 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3657   opportunities found through profiling
3658 - [Improved backtrace formatting when panicking][38165]
3659
3660 Libraries
3661 ---------
3662
3663 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3664   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3665   iteration or reallocation.
3666 - [Simplified HashMap Bucket interface][40561] provides performance
3667   improvements for iterating and cloning.
3668 - [Specialize Vec::from_elem to use calloc][40409]
3669 - [Fixed Race condition in fs::create_dir_all][39799]
3670 - [No longer caching stdio on Windows][40516]
3671 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3672   2.50%~ faster and in one case now 12.50% faster.
3673 - [Optimized `AtomicBool::fetch_nand`][41143]
3674
3675 Stabilized APIs
3676 ---------------
3677
3678 - [`Child::try_wait`]
3679 - [`HashMap::retain`]
3680 - [`HashSet::retain`]
3681 - [`PeekMut::pop`]
3682 - [`TcpStream::peek`]
3683 - [`UdpSocket::peek`]
3684 - [`UdpSocket::peek_from`]
3685
3686 Cargo
3687 -----
3688
3689 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3690   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3691 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3692 - [Added Android build support][cargo/3885]
3693 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3694   of a certain type, for example `cargo build --bins` will build all
3695   binaries.
3696 - [Added support for haiku][cargo/3952]
3697
3698 Misc
3699 ----
3700
3701 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3702 - [Added rust-windbg script for better debugging on Windows][39983]
3703 - [Rust now uses the official cross compiler for NetBSD][40612]
3704 - [rustdoc now accepts `#` at the start of files][40828]
3705 - [Fixed jemalloc support for musl][41168]
3706
3707 Compatibility Notes
3708 -------------------
3709
3710 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3711   always placed after the sign if it exists and before the digits. With the `#`
3712   flag the zeroes are placed after the prefix and before the digits.
3713 - [Due to the struct field optimisation][40377], using `transmute` on structs
3714   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3715   always been undefined behavior, but is now more likely to break in practice.
3716 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3717   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3718   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3719 - [Overlapping inherent `impl`s are now a hard error][40728]
3720 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3721 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3722   `out.asm` and `out.ll` instead of only one of the filetypes.
3723 - [ calling a function that returns `Self` will no longer work][41805] when
3724   the size of `Self` cannot be statically determined.
3725 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3726   this has caused a few regressions namely:
3727
3728   - Changed the link order of local static/dynamic libraries (respecting the
3729     order on given rather than having the compiler reorder).
3730   - Changed how MinGW is linked, native code linked to dynamic libraries
3731     may require manually linking to the gcc support library (for the native
3732     code itself)
3733
3734 [38165]: https://github.com/rust-lang/rust/pull/38165
3735 [39799]: https://github.com/rust-lang/rust/pull/39799
3736 [39891]: https://github.com/rust-lang/rust/pull/39891
3737 [39983]: https://github.com/rust-lang/rust/pull/39983
3738 [40043]: https://github.com/rust-lang/rust/pull/40043
3739 [40241]: https://github.com/rust-lang/rust/pull/40241
3740 [40338]: https://github.com/rust-lang/rust/pull/40338
3741 [40367]: https://github.com/rust-lang/rust/pull/40367
3742 [40377]: https://github.com/rust-lang/rust/pull/40377
3743 [40409]: https://github.com/rust-lang/rust/pull/40409
3744 [40516]: https://github.com/rust-lang/rust/pull/40516
3745 [40556]: https://github.com/rust-lang/rust/pull/40556
3746 [40561]: https://github.com/rust-lang/rust/pull/40561
3747 [40589]: https://github.com/rust-lang/rust/pull/40589
3748 [40612]: https://github.com/rust-lang/rust/pull/40612
3749 [40723]: https://github.com/rust-lang/rust/pull/40723
3750 [40728]: https://github.com/rust-lang/rust/pull/40728
3751 [40731]: https://github.com/rust-lang/rust/pull/40731
3752 [40734]: https://github.com/rust-lang/rust/pull/40734
3753 [40805]: https://github.com/rust-lang/rust/pull/40805
3754 [40807]: https://github.com/rust-lang/rust/pull/40807
3755 [40828]: https://github.com/rust-lang/rust/pull/40828
3756 [40870]: https://github.com/rust-lang/rust/pull/40870
3757 [41085]: https://github.com/rust-lang/rust/pull/41085
3758 [41143]: https://github.com/rust-lang/rust/pull/41143
3759 [41168]: https://github.com/rust-lang/rust/pull/41168
3760 [41270]: https://github.com/rust-lang/rust/issues/41270
3761 [41469]: https://github.com/rust-lang/rust/pull/41469
3762 [41805]: https://github.com/rust-lang/rust/issues/41805
3763 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3764 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3765 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3766 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3767 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3768 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3769 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3770 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3771 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3772 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3773 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3774 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3775 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3776 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3777
3778
3779 Version 1.17.0 (2017-04-27)
3780 ===========================
3781
3782 Language
3783 --------
3784
3785 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3786 * [Fields of structs may be initialized without duplicating the field/variable
3787   names][39761]. [RFC 1682]
3788 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3789 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3790   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3791   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3792   `'b`. Soundness fix.
3793 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3794 * [Static variables may contain references to other statics][40027]
3795
3796 Compiler
3797 --------
3798
3799 * [Exit quickly on only `--emit dep-info`][40336]
3800 * [Make `-C relocation-model` more correctly determine whether the linker
3801   creates a position-independent executable][40245]
3802 * [Add `-C overflow-checks` to directly control whether integer overflow
3803   panics][40037]
3804 * [The rustc type checker now checks items on demand instead of in a single
3805   in-order pass][40008]. This is mostly an internal refactoring in support of
3806   future work, including incremental type checking, but also resolves [RFC
3807   1647], allowing `Self` to appear in `impl` `where` clauses.
3808 * [Optimize vtable loads][39995]
3809 * [Turn off vectorization for Emscripten targets][39990]
3810 * [Provide suggestions for unknown macros imported with `use`][39953]
3811 * [Fix ICEs in path resolution][39939]
3812 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3813 * [Add clearer error message using `&str + &str`][39116]
3814
3815 Stabilized APIs
3816 ---------------
3817
3818 * [`Arc::into_raw`]
3819 * [`Arc::from_raw`]
3820 * [`Arc::ptr_eq`]
3821 * [`Rc::into_raw`]
3822 * [`Rc::from_raw`]
3823 * [`Rc::ptr_eq`]
3824 * [`Ordering::then`]
3825 * [`Ordering::then_with`]
3826 * [`BTreeMap::range`]
3827 * [`BTreeMap::range_mut`]
3828 * [`collections::Bound`]
3829 * [`process::abort`]
3830 * [`ptr::read_unaligned`]
3831 * [`ptr::write_unaligned`]
3832 * [`Result::expect_err`]
3833 * [`Cell::swap`]
3834 * [`Cell::replace`]
3835 * [`Cell::into_inner`]
3836 * [`Cell::take`]
3837
3838 Libraries
3839 ---------
3840
3841 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3842 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3843 * [`String` implements `FromIterator<&char>`][40028]
3844 * `Box` [implements][40009] a number of new conversions:
3845   `From<Box<str>> for String`,
3846   `From<Box<[T]>> for Vec<T>`,
3847   `From<Box<CStr>> for CString`,
3848   `From<Box<OsStr>> for OsString`,
3849   `From<Box<Path>> for PathBuf`,
3850   `Into<Box<str>> for String`,
3851   `Into<Box<[T]>> for Vec<T>`,
3852   `Into<Box<CStr>> for CString`,
3853   `Into<Box<OsStr>> for OsString`,
3854   `Into<Box<Path>> for PathBuf`,
3855   `Default for Box<str>`,
3856   `Default for Box<CStr>`,
3857   `Default for Box<OsStr>`,
3858   `From<&CStr> for Box<CStr>`,
3859   `From<&OsStr> for Box<OsStr>`,
3860   `From<&Path> for Box<Path>`
3861 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3862 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3863 * [Slightly optimize `slice::sort`][39538]
3864 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3865 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3866   `Box<str>` implements `From<&str>`][39438]
3867 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3868   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3869 * [`format!` estimates the needed capacity before writing a string][39356]
3870 * [Support unprivileged symlink creation in Windows][38921]
3871 * [`PathBuf` implements `Default`][38764]
3872 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3873 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3874   and poor hash functions.
3875
3876 Cargo
3877 -----
3878
3879 * [Add `cargo check --all`][cargo/3731]
3880 * [Add an option to ignore SSL revocation checking][cargo/3699]
3881 * [Add `cargo run --package`][cargo/3691]
3882 * [Add `required_features`][cargo/3667]
3883 * [Assume `build.rs` is a build script][cargo/3664]
3884 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3885
3886 Misc
3887 ----
3888
3889 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3890   `rustbook`][39633]
3891 * [The "Unstable Book" documents nightly-only features][ubook]
3892 * [Improve the style of the sidebar in rustdoc output][40265]
3893 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3894 * [Fix MSP430 breakage due to `i128`][40257]
3895 * [Preliminary Solaris/SPARCv9 support][39903]
3896 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3897   run without installing the MSVC runtime.
3898 * [`rustdoc --test` includes file names in test names][39788]
3899 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3900   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3901 * [Initial support for `aarch64-unknown-freebsd`][39491]
3902 * [Initial support for `i686-unknown-netbsd`][39426]
3903 * [This release no longer includes the old makefile build system][39431]. Rust
3904   is built with a custom build system, written in Rust, and with Cargo.
3905 * [Add Debug implementations for libcollection structs][39002]
3906 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3907 * [`--test-threads=0` produces an error][38945]
3908 * [`rustup` installs documentation by default][40526]
3909 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3910   WinDbg and Visual Studio to improve the debugging experience.
3911
3912 Compatibility Notes
3913 -------------------
3914
3915 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3916   workaround, either use MSVC 2015 or run vcvars.bat.
3917 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3918   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3919   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3920   fix.
3921 * [`format!` and `Display::to_string` panic if an underlying formatting
3922   implementation returns an error][40117]. Previously the error was silently
3923   ignored. It is incorrect for `write_fmt` to return an error when writing
3924   to a string.
3925 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3926   crates were marked stable and could be accessed from the stable toolchain.
3927 * [Rust git source no longer includes vendored crates][39728]. Those that need
3928   to build with vendored crates should build from release tarballs.
3929 * [Fix inert attributes from `proc_macro_derives`][39572]
3930 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3931   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3932   build system.
3933 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3934   existing code generally ignores the type of dead-code unless a type-hint is
3935   provided; this can cause surprising inference interactions particularly around
3936   defaulting. The new code uniformly ignores the result type of dead-code.
3937 * [Tuple-struct constructors with private fields are no longer visible][38932]
3938 * [Lifetime parameters that do not appear in the arguments are now considered
3939   early-bound][38897], resolving a soundness bug (#[32330]). The
3940   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3941   April of 2016.
3942 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3943 * [Make transmuting from fn item types to pointer-sized types a hard
3944   error][34198]
3945
3946 [27787]: https://github.com/rust-lang/rust/issues/27787
3947 [32330]: https://github.com/rust-lang/rust/issues/32330
3948 [34198]: https://github.com/rust-lang/rust/pull/34198
3949 [38161]: https://github.com/rust-lang/rust/pull/38161
3950 [38368]: https://github.com/rust-lang/rust/pull/38368
3951 [38584]: https://github.com/rust-lang/rust/issues/38584
3952 [38661]: https://github.com/rust-lang/rust/pull/38661
3953 [38764]: https://github.com/rust-lang/rust/pull/38764
3954 [38864]: https://github.com/rust-lang/rust/issues/38864
3955 [38897]: https://github.com/rust-lang/rust/pull/38897
3956 [38921]: https://github.com/rust-lang/rust/pull/38921
3957 [38932]: https://github.com/rust-lang/rust/pull/38932
3958 [38945]: https://github.com/rust-lang/rust/pull/38945
3959 [38981]: https://github.com/rust-lang/rust/pull/38981
3960 [39002]: https://github.com/rust-lang/rust/pull/39002
3961 [39116]: https://github.com/rust-lang/rust/pull/39116
3962 [39193]: https://github.com/rust-lang/rust/pull/39193
3963 [39265]: https://github.com/rust-lang/rust/pull/39265
3964 [39356]: https://github.com/rust-lang/rust/pull/39356
3965 [39372]: https://github.com/rust-lang/rust/pull/39372
3966 [39426]: https://github.com/rust-lang/rust/pull/39426
3967 [39431]: https://github.com/rust-lang/rust/pull/39431
3968 [39438]: https://github.com/rust-lang/rust/pull/39438
3969 [39440]: https://github.com/rust-lang/rust/pull/39440
3970 [39485]: https://github.com/rust-lang/rust/pull/39485
3971 [39491]: https://github.com/rust-lang/rust/pull/39491
3972 [39518]: https://github.com/rust-lang/rust/pull/39518
3973 [39538]: https://github.com/rust-lang/rust/pull/39538
3974 [39572]: https://github.com/rust-lang/rust/pull/39572
3975 [39633]: https://github.com/rust-lang/rust/pull/39633
3976 [39642]: https://github.com/rust-lang/rust/pull/39642
3977 [39728]: https://github.com/rust-lang/rust/pull/39728
3978 [39761]: https://github.com/rust-lang/rust/pull/39761
3979 [39788]: https://github.com/rust-lang/rust/pull/39788
3980 [39793]: https://github.com/rust-lang/rust/pull/39793
3981 [39837]: https://github.com/rust-lang/rust/pull/39837
3982 [39843]: https://github.com/rust-lang/rust/pull/39843
3983 [39851]: https://github.com/rust-lang/rust/pull/39851
3984 [39903]: https://github.com/rust-lang/rust/pull/39903
3985 [39939]: https://github.com/rust-lang/rust/pull/39939
3986 [39953]: https://github.com/rust-lang/rust/pull/39953
3987 [39960]: https://github.com/rust-lang/rust/pull/39960
3988 [39990]: https://github.com/rust-lang/rust/pull/39990
3989 [39995]: https://github.com/rust-lang/rust/pull/39995
3990 [40008]: https://github.com/rust-lang/rust/pull/40008
3991 [40009]: https://github.com/rust-lang/rust/pull/40009
3992 [40027]: https://github.com/rust-lang/rust/pull/40027
3993 [40028]: https://github.com/rust-lang/rust/pull/40028
3994 [40037]: https://github.com/rust-lang/rust/pull/40037
3995 [40117]: https://github.com/rust-lang/rust/pull/40117
3996 [40166]: https://github.com/rust-lang/rust/pull/40166
3997 [40245]: https://github.com/rust-lang/rust/pull/40245
3998 [40257]: https://github.com/rust-lang/rust/pull/40257
3999 [40261]: https://github.com/rust-lang/rust/pull/40261
4000 [40265]: https://github.com/rust-lang/rust/pull/40265
4001 [40319]: https://github.com/rust-lang/rust/pull/40319
4002 [40336]: https://github.com/rust-lang/rust/pull/40336
4003 [40526]: https://github.com/rust-lang/rust/pull/40526
4004 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4005 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4006 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4007 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4008 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4009 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4010 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4011 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4012 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4013 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4014 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4015 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4016 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4017 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4018 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4019 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4020 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4021 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4022 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4023 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4024 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4025 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4026 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4027 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4028 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4029 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4030 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4031 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4032 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4033 [mdbook]: https://crates.io/crates/mdbook
4034 [ubook]: https://doc.rust-lang.org/unstable-book/
4035
4036
4037 Version 1.16.0 (2017-03-16)
4038 ===========================
4039
4040 Language
4041 --------
4042
4043 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4044 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4045   match patterns][38069]
4046 * [Clean up semantics of `self` in an import list][38313]
4047 * [`Self` may appear in `impl` headers][38920]
4048 * [`Self` may appear in struct expressions][39282]
4049
4050 Compiler
4051 --------
4052
4053 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4054   a `.rmeta` file containing only crate metadata][38571]. This can be
4055   used by tools like the Rust Language Service to perform
4056   metadata-only builds.
4057 * [Levenshtein based typo suggestions now work in most places, while
4058   previously they worked only for fields and sometimes for local
4059   variables][38927]. Together with the overhaul of "no
4060   resolution"/"unexpected resolution" errors (#[38154]) they result in
4061   large and systematic improvement in resolution diagnostics.
4062 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4063   `U`][38670]
4064 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4065 * [`rustc` no longer attempts to provide "consider using an explicit
4066   lifetime" suggestions][37057]. They were inaccurate.
4067
4068 Stabilized APIs
4069 ---------------
4070
4071 * [`VecDeque::truncate`]
4072 * [`VecDeque::resize`]
4073 * [`String::insert_str`]
4074 * [`Duration::checked_add`]
4075 * [`Duration::checked_sub`]
4076 * [`Duration::checked_div`]
4077 * [`Duration::checked_mul`]
4078 * [`str::replacen`]
4079 * [`str::repeat`]
4080 * [`SocketAddr::is_ipv4`]
4081 * [`SocketAddr::is_ipv6`]
4082 * [`IpAddr::is_ipv4`]
4083 * [`IpAddr::is_ipv6`]
4084 * [`Vec::dedup_by`]
4085 * [`Vec::dedup_by_key`]
4086 * [`Result::unwrap_or_default`]
4087 * [`<*const T>::wrapping_offset`]
4088 * [`<*mut T>::wrapping_offset`]
4089 * `CommandExt::creation_flags`
4090 * [`File::set_permissions`]
4091 * [`String::split_off`]
4092
4093 Libraries
4094 ---------
4095
4096 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4097   their argument by `Borrow` parameter][37761]
4098 * [All public types in std implement `Debug`][38006]
4099 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4100 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4101 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4102   Windows][38274]
4103 * [std: Fix partial writes in `LineWriter`][38062]
4104 * [std: Clamp max read/write sizes on Unix][38062]
4105 * [Use more specific panic message for `&str` slicing errors][38066]
4106 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4107   functionality cannot be achieved in std currently.
4108 * [`writeln!`, like `println!`, now accepts a form with no string
4109   or formatting arguments, to just print a newline][38469]
4110 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4111 * [Reduce the size of static data in `std_unicode::tables`][38781]
4112 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4113   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4114   `Display`][38909]
4115 * [`Duration` implements `Sum`][38712]
4116 * [`String` implements `ToSocketAddrs`][39048]
4117
4118 Cargo
4119 -----
4120
4121 * [The `cargo check` command does a type check of a project without
4122   building it][cargo/3296]
4123 * [crates.io will display CI badges from Travis and AppVeyor, if
4124   specified in Cargo.toml][cargo/3546]
4125 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4126 * [Compilation profiles accept integer values for `debug`, in addition
4127   to `true` and `false`. These are passed to `rustc` as the value to
4128   `-C debuginfo`][cargo/3534]
4129 * [Implement `cargo --version --verbose`][cargo/3604]
4130 * [All builds now output 'dep-info' build dependencies compatible with
4131   make and ninja][cargo/3557]
4132 * [Build all workspace members with `build --all`][cargo/3511]
4133 * [Document all workspace members with `doc --all`][cargo/3515]
4134 * [Path deps outside workspace are not members][cargo/3443]
4135
4136 Misc
4137 ----
4138
4139 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4140   the path to the Rust implementation][38589]
4141 * [The `armv7-linux-androideabi` target no longer enables NEON
4142   extensions, per Google's ABI guide][38413]
4143 * [The stock standard library can be compiled for Redox OS][38401]
4144 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4145   available.
4146 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4147   builds available.
4148 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4149
4150 Compatibility Notes
4151 -------------------
4152
4153 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4154   match patterns][38069]
4155 * In this release, references to uninhabited types can not be
4156   pattern-matched. This was accidentally allowed in 1.15.
4157 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4158 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4159   Windows][38274]
4160 * [Clean up semantics of `self` in an import list][38313]
4161 * Reimplemented lifetime elision. This change was almost entirely compatible
4162   with existing code, but it did close a number of small bugs and loopholes,
4163   as well as being more accepting in some other [cases][41105].
4164
4165 [37057]: https://github.com/rust-lang/rust/pull/37057
4166 [37761]: https://github.com/rust-lang/rust/pull/37761
4167 [38006]: https://github.com/rust-lang/rust/pull/38006
4168 [38051]: https://github.com/rust-lang/rust/pull/38051
4169 [38062]: https://github.com/rust-lang/rust/pull/38062
4170 [38062]: https://github.com/rust-lang/rust/pull/38622
4171 [38066]: https://github.com/rust-lang/rust/pull/38066
4172 [38069]: https://github.com/rust-lang/rust/pull/38069
4173 [38131]: https://github.com/rust-lang/rust/pull/38131
4174 [38154]: https://github.com/rust-lang/rust/pull/38154
4175 [38274]: https://github.com/rust-lang/rust/pull/38274
4176 [38304]: https://github.com/rust-lang/rust/pull/38304
4177 [38313]: https://github.com/rust-lang/rust/pull/38313
4178 [38314]: https://github.com/rust-lang/rust/pull/38314
4179 [38327]: https://github.com/rust-lang/rust/pull/38327
4180 [38401]: https://github.com/rust-lang/rust/pull/38401
4181 [38413]: https://github.com/rust-lang/rust/pull/38413
4182 [38469]: https://github.com/rust-lang/rust/pull/38469
4183 [38559]: https://github.com/rust-lang/rust/pull/38559
4184 [38571]: https://github.com/rust-lang/rust/pull/38571
4185 [38580]: https://github.com/rust-lang/rust/pull/38580
4186 [38589]: https://github.com/rust-lang/rust/pull/38589
4187 [38670]: https://github.com/rust-lang/rust/pull/38670
4188 [38712]: https://github.com/rust-lang/rust/pull/38712
4189 [38726]: https://github.com/rust-lang/rust/pull/38726
4190 [38781]: https://github.com/rust-lang/rust/pull/38781
4191 [38798]: https://github.com/rust-lang/rust/pull/38798
4192 [38909]: https://github.com/rust-lang/rust/pull/38909
4193 [38920]: https://github.com/rust-lang/rust/pull/38920
4194 [38927]: https://github.com/rust-lang/rust/pull/38927
4195 [39048]: https://github.com/rust-lang/rust/pull/39048
4196 [39282]: https://github.com/rust-lang/rust/pull/39282
4197 [39379]: https://github.com/rust-lang/rust/pull/39379
4198 [41105]: https://github.com/rust-lang/rust/issues/41105
4199 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4200 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4201 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4202 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4203 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4204 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4205 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4206 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4207 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4208 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4209 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4210 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4211 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4212 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4213 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4214 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4215 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4216 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4217 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4218 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4219 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4220 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4221 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4222 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4223 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4224 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4225 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4226 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4227 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4228 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4229
4230
4231 Version 1.15.1 (2017-02-09)
4232 ===========================
4233
4234 * [Fix IntoIter::as_mut_slice's signature][39466]
4235 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4236
4237 [39466]: https://github.com/rust-lang/rust/pull/39466
4238 [39523]: https://github.com/rust-lang/rust/pull/39523
4239
4240
4241 Version 1.15.0 (2017-02-02)
4242 ===========================
4243
4244 Language
4245 --------
4246
4247 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4248   stable. This allows popular code-generating crates like Serde and Diesel to
4249   work ergonomically. [RFC 1681].
4250 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4251   with curly braces][36868]. Part of [RFC 1506].
4252 * [A number of minor changes to name resolution have been activated][37127].
4253   They add up to more consistent semantics, allowing for future evolution of
4254   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4255   details of what is different. The breaking changes here have been transitioned
4256   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4257 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4258   bounds][38279]
4259 * [`?Sized` can be used in `where` clauses][37791]
4260 * [There is now a limit on the size of monomorphized types and it can be
4261   modified with the `#![type_size_limit]` crate attribute, similarly to
4262   the `#![recursion_limit]` attribute][37789]
4263
4264 Compiler
4265 --------
4266
4267 * [On Windows, the compiler will apply dllimport attributes when linking to
4268   extern functions][37973]. Additional attributes and flags can control which
4269   library kind is linked and its name. [RFC 1717].
4270 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4271 * [The `--test` flag works with procedural macro crates][38107]
4272 * [Fix `extern "aapcs" fn` ABI][37814]
4273 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4274 * [The `format!` expander recognizes incorrect `printf` and shell-style
4275   formatting directives and suggests the correct format][37613].
4276 * [Only report one error for all unused imports in an import list][37456]
4277
4278 Compiler Performance
4279 --------------------
4280
4281 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4282 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4283 * [Don't clone in `UnificationTable::probe`][37848]
4284 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4285 * [Use small vectors in type walker][37760]
4286 * [Macro expansion performance was improved][37701]
4287 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4288 * [Replace FNV with a faster hash function][37229]
4289
4290 Stabilized APIs
4291 ---------------
4292
4293 * [`std::iter::Iterator::min_by`]
4294 * [`std::iter::Iterator::max_by`]
4295 * [`std::os::*::fs::FileExt`]
4296 * [`std::sync::atomic::Atomic*::get_mut`]
4297 * [`std::sync::atomic::Atomic*::into_inner`]
4298 * [`std::vec::IntoIter::as_slice`]
4299 * [`std::vec::IntoIter::as_mut_slice`]
4300 * [`std::sync::mpsc::Receiver::try_iter`]
4301 * [`std::os::unix::process::CommandExt::before_exec`]
4302 * [`std::rc::Rc::strong_count`]
4303 * [`std::rc::Rc::weak_count`]
4304 * [`std::sync::Arc::strong_count`]
4305 * [`std::sync::Arc::weak_count`]
4306 * [`std::char::encode_utf8`]
4307 * [`std::char::encode_utf16`]
4308 * [`std::cell::Ref::clone`]
4309 * [`std::io::Take::into_inner`]
4310
4311 Libraries
4312 ---------
4313
4314 * [The standard sorting algorithm has been rewritten for dramatic performance
4315   improvements][38192]. It is a hybrid merge sort, drawing influences from
4316   Timsort. Previously it was a naive merge sort.
4317 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4318 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4319   performance.
4320 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4321   and `char_indices().last()`][37882]
4322 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4323 * [Chinese characters display correctly in `fmt::Debug`][37855]
4324 * [Derive `Default` for `Duration`][37699]
4325 * [Support creation of anonymous pipes on WinXP/2k][37677]
4326 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4327 * [Don't pass overlapped handles to processes][38835]
4328
4329 Cargo
4330 -----
4331
4332 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4333   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4334   should instead check the variable at runtime with `std::env`. That the value
4335   was set at build time was a bug, and incorrect when cross-compiling. This
4336   change is known to cause breakage.
4337 * [Add `--all` flag to `cargo test`][cargo/3221]
4338 * [Compile statically against the MSVC CRT][cargo/3363]
4339 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4340 * [Link OpenSSL statically on OSX][cargo/3311]
4341 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4342 * [Test for bad path overrides with summaries][cargo/3336]
4343 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4344 * [Fix retrying crate downloads for network errors][cargo/3348]
4345 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4346 * [Emit more info on --message-format=json][cargo/3319]
4347 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4348 * [Don't ignore errors in workspace manifest][cargo/3409]
4349 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4350
4351 Tooling
4352 -------
4353
4354 * [Test runners (binaries built with `--test`) now support a `--list` argument
4355   that lists the tests it contains][38185]
4356 * [Test runners now support a `--exact` argument that makes the test filter
4357   match exactly, instead of matching only a substring of the test name][38181]
4358 * [rustdoc supports a `--playground-url` flag][37763]
4359 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4360
4361 Misc
4362 ----
4363
4364 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4365   continue to be used in this release by passing `--disable-rustbuild` to the
4366   configure script, but they will be deleted soon. Note that the new build
4367   system uses a different on-disk layout that will likely affect any scripts
4368   building Rust.
4369 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4370   releases.
4371 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4372 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4373   releases.
4374
4375 Compatibility Notes
4376 -------------------
4377
4378 * [A number of minor changes to name resolution have been activated][37127].
4379   They add up to more consistent semantics, allowing for future evolution of
4380   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4381   details of what is different. The breaking changes here have been transitioned
4382   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4383 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4384   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4385   should instead check the variable at runtime with `std::env`. That the value
4386   was set at build time was a bug, and incorrect when cross-compiling. This
4387   change is known to cause breakage.
4388 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4389   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4390   1.10 and is now an error by default. It will become a hard error in the near
4391   future.
4392 * [The semantics relating modules to file system directories are changing in
4393   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4394   lint, which is a warning in this release, and will become a hard error in the
4395   future.
4396 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4397 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4398   the underlying iterator][37834]
4399
4400 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4401 [33685]: https://github.com/rust-lang/rust/issues/33685
4402 [36868]: https://github.com/rust-lang/rust/pull/36868
4403 [37127]: https://github.com/rust-lang/rust/pull/37127
4404 [37229]: https://github.com/rust-lang/rust/pull/37229
4405 [37456]: https://github.com/rust-lang/rust/pull/37456
4406 [37527]: https://github.com/rust-lang/rust/pull/37527
4407 [37602]: https://github.com/rust-lang/rust/pull/37602
4408 [37613]: https://github.com/rust-lang/rust/pull/37613
4409 [37615]: https://github.com/rust-lang/rust/pull/37615
4410 [37636]: https://github.com/rust-lang/rust/pull/37636
4411 [37627]: https://github.com/rust-lang/rust/pull/37627
4412 [37642]: https://github.com/rust-lang/rust/pull/37642
4413 [37677]: https://github.com/rust-lang/rust/pull/37677
4414 [37699]: https://github.com/rust-lang/rust/pull/37699
4415 [37701]: https://github.com/rust-lang/rust/pull/37701
4416 [37705]: https://github.com/rust-lang/rust/pull/37705
4417 [37749]: https://github.com/rust-lang/rust/pull/37749
4418 [37760]: https://github.com/rust-lang/rust/pull/37760
4419 [37763]: https://github.com/rust-lang/rust/pull/37763
4420 [37764]: https://github.com/rust-lang/rust/pull/37764
4421 [37789]: https://github.com/rust-lang/rust/pull/37789
4422 [37791]: https://github.com/rust-lang/rust/pull/37791
4423 [37814]: https://github.com/rust-lang/rust/pull/37814
4424 [37817]: https://github.com/rust-lang/rust/pull/37817
4425 [37834]: https://github.com/rust-lang/rust/pull/37834
4426 [37848]: https://github.com/rust-lang/rust/pull/37848
4427 [37855]: https://github.com/rust-lang/rust/pull/37855
4428 [37882]: https://github.com/rust-lang/rust/pull/37882
4429 [37888]: https://github.com/rust-lang/rust/pull/37888
4430 [37973]: https://github.com/rust-lang/rust/pull/37973
4431 [37979]: https://github.com/rust-lang/rust/pull/37979
4432 [38086]: https://github.com/rust-lang/rust/pull/38086
4433 [38107]: https://github.com/rust-lang/rust/pull/38107
4434 [38117]: https://github.com/rust-lang/rust/pull/38117
4435 [38134]: https://github.com/rust-lang/rust/pull/38134
4436 [38146]: https://github.com/rust-lang/rust/pull/38146
4437 [38181]: https://github.com/rust-lang/rust/pull/38181
4438 [38182]: https://github.com/rust-lang/rust/pull/38182
4439 [38185]: https://github.com/rust-lang/rust/pull/38185
4440 [38192]: https://github.com/rust-lang/rust/pull/38192
4441 [38279]: https://github.com/rust-lang/rust/pull/38279
4442 [38835]: https://github.com/rust-lang/rust/pull/38835
4443 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4444 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4445 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4446 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4447 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4448 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4449 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4450 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4451 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4452 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4453 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4454 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4455 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4456 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4457 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4458 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4459 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4460 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4461 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4462 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4463 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4464 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4465 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4466 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4467 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4468 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4469 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4470 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4471 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4472 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4473 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4474 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4475 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4476 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4477 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4478 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4479 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4480 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4481
4482
4483 Version 1.14.0 (2016-12-22)
4484 ===========================
4485
4486 Language
4487 --------
4488
4489 * [`..` matches multiple tuple fields in enum variants, structs
4490   and tuples][36843]. [RFC 1492].
4491 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4492 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4493 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4494   dereferencing][36822]
4495
4496 Compiler
4497 --------
4498
4499 * [Mark enums with non-zero discriminant as non-zero][37224]
4500 * [Lower-case `static mut` names are linted like other
4501   statics and consts][37162]
4502 * [Fix ICE on some macros in const integer positions
4503    (e.g. `[u8; m!()]`)][36819]
4504 * [Improve error message and snippet for "did you mean `x`"][36798]
4505 * [Add a panic-strategy field to the target specification][36794]
4506 * [Include LLVM version in `--version --verbose`][37200]
4507
4508 Compile-time Optimizations
4509 --------------------------
4510
4511 * [Improve macro expansion performance][37569]
4512 * [Shrink `Expr_::ExprInlineAsm`][37445]
4513 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4514 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4515 * [Avoid more allocations when compiling html5ever][37373]
4516 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4517 * [Avoid some allocations in the macro parser][37318]
4518 * [Use a faster deflate setting][37298]
4519 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4520   during interning of slices][37270]
4521 * [Optimize `write_metadata`][37267]
4522 * [Don't process obligation forest cycles when stalled][37231]
4523 * [Avoid many `CrateConfig` clones][37161]
4524 * [Optimize `Substs::super_fold_with`][37108]
4525 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4526 * [Speed up `plug_leaks`][36917]
4527
4528 Libraries
4529 ---------
4530
4531 * [`println!()`, with no arguments, prints newline][36825].
4532   Previously, an empty string was required to achieve the same.
4533 * [`Wrapping` impls standard binary and unary operators, as well as
4534    the `Sum` and `Product` iterators][37356]
4535 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4536   Vec<T>`][37326]
4537 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4538   `VecDeque` iterators][37315]
4539 * [Improve `SipHasher` performance on small values][37312]
4540 * [Add Iterator trait TrustedLen to enable better FromIterator /
4541   Extend][37306]
4542 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4543 * [`ReadDir` implements `Debug`][37221]
4544 * [Implement `RefUnwindSafe` for atomic types][37178]
4545 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4546 * [Avoid allocations in `Decoder::read_str`][37064]
4547 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4548 * [Impl `Debug` for raw pointers to unsized data][36880]
4549 * [Don't reuse `HashMap` random seeds][37470]
4550 * [The internal memory layout of `HashMap` is more cache-friendly, for
4551   significant improvements in some operations][36692]
4552 * [`HashMap` uses less memory on 32-bit architectures][36595]
4553 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4554
4555 Cargo
4556 -----
4557
4558 * [Expose rustc cfg values to build scripts][cargo/3243]
4559 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4560 * [Fix passing --features when testing multiple packages][cargo/3280]
4561 * [Use a single profile set per workspace][cargo/3249]
4562 * [Load `replace` sections from lock files][cargo/3220]
4563 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4564
4565 Tooling
4566 -------
4567
4568 * [rustup is the recommended Rust installation method][1.14rustup]
4569 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4570   S390x. These are [tier 2] platforms and may have major defects. Follow the
4571   instructions on the website to install, or add the targets to an existing
4572   installation with `rustup target add`. The new target triples are:
4573   - `mips-unknown-linux-gnu`
4574   - `mipsel-unknown-linux-gnu`
4575   - `mips64-unknown-linux-gnuabi64`
4576   - `mips64el-unknown-linux-gnuabi64 `
4577   - `powerpc-unknown-linux-gnu`
4578   - `powerpc64-unknown-linux-gnu`
4579   - `powerpc64le-unknown-linux-gnu`
4580   - `s390x-unknown-linux-gnu `
4581 * This release includes target (std) builds for ARM Linux running MUSL
4582   libc. These are [tier 2] platforms and may have major defects. Add the
4583   following triples to an existing rustup installation with `rustup target add`:
4584   - `arm-unknown-linux-musleabi`
4585   - `arm-unknown-linux-musleabihf`
4586   - `armv7-unknown-linux-musleabihf`
4587 * This release includes [experimental support for WebAssembly][1.14wasm], via
4588   the `wasm32-unknown-emscripten` target. This target is known to have major
4589   defects. Please test, report, and fix.
4590 * rustup no longer installs documentation by default. Run `rustup
4591   component add rust-docs` to install.
4592 * [Fix line stepping in debugger][37310]
4593 * [Enable line number debuginfo in releases][37280]
4594
4595 Misc
4596 ----
4597
4598 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4599 * [Add support for Fuchsia OS][37313]
4600 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4601
4602 Compatibility Notes
4603 -------------------
4604
4605 * [A number of forward-compatibility lints used by the compiler
4606   to gradually introduce language changes have been converted
4607   to deny by default][36894]:
4608   - ["use of inaccessible extern crate erroneously allowed"][36886]
4609   - ["type parameter default erroneously allowed in invalid location"][36887]
4610   - ["detects super or self keywords at the beginning of global path"][36888]
4611   - ["two overlapping inherent impls define an item with the same name
4612     were erroneously allowed"][36889]
4613   - ["floating-point constants cannot be used in patterns"][36890]
4614   - ["constants of struct or enum type can only be used in a pattern if
4615      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4616   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4617 * [Prohibit patterns in trait methods without bodies][37378]
4618 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4619 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4620 * [The `$crate` macro variable is accepted in fewer locations][37213]
4621 * [Impls specifying extra region requirements beyond the trait
4622   they implement are rejected][37167]
4623 * [Enums may not be unsized][37111]. Unsized enums are intended to
4624   work but never have. For now they are forbidden.
4625 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4626
4627 [tier 2]: https://forge.rust-lang.org/platform-support.html
4628 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4629 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4630 [36430]: https://github.com/rust-lang/rust/pull/36430
4631 [36595]: https://github.com/rust-lang/rust/pull/36595
4632 [36595]: https://github.com/rust-lang/rust/pull/36595
4633 [36692]: https://github.com/rust-lang/rust/pull/36692
4634 [36767]: https://github.com/rust-lang/rust/pull/36767
4635 [36794]: https://github.com/rust-lang/rust/pull/36794
4636 [36798]: https://github.com/rust-lang/rust/pull/36798
4637 [36819]: https://github.com/rust-lang/rust/pull/36819
4638 [36822]: https://github.com/rust-lang/rust/pull/36822
4639 [36825]: https://github.com/rust-lang/rust/pull/36825
4640 [36843]: https://github.com/rust-lang/rust/pull/36843
4641 [36880]: https://github.com/rust-lang/rust/pull/36880
4642 [36886]: https://github.com/rust-lang/rust/issues/36886
4643 [36887]: https://github.com/rust-lang/rust/issues/36887
4644 [36888]: https://github.com/rust-lang/rust/issues/36888
4645 [36889]: https://github.com/rust-lang/rust/issues/36889
4646 [36890]: https://github.com/rust-lang/rust/issues/36890
4647 [36891]: https://github.com/rust-lang/rust/issues/36891
4648 [36892]: https://github.com/rust-lang/rust/issues/36892
4649 [36894]: https://github.com/rust-lang/rust/pull/36894
4650 [36917]: https://github.com/rust-lang/rust/pull/36917
4651 [36993]: https://github.com/rust-lang/rust/pull/36993
4652 [37037]: https://github.com/rust-lang/rust/pull/37037
4653 [37064]: https://github.com/rust-lang/rust/pull/37064
4654 [37094]: https://github.com/rust-lang/rust/pull/37094
4655 [37108]: https://github.com/rust-lang/rust/pull/37108
4656 [37111]: https://github.com/rust-lang/rust/pull/37111
4657 [37161]: https://github.com/rust-lang/rust/pull/37161
4658 [37162]: https://github.com/rust-lang/rust/pull/37162
4659 [37167]: https://github.com/rust-lang/rust/pull/37167
4660 [37178]: https://github.com/rust-lang/rust/pull/37178
4661 [37200]: https://github.com/rust-lang/rust/pull/37200
4662 [37213]: https://github.com/rust-lang/rust/pull/37213
4663 [37221]: https://github.com/rust-lang/rust/pull/37221
4664 [37224]: https://github.com/rust-lang/rust/pull/37224
4665 [37230]: https://github.com/rust-lang/rust/pull/37230
4666 [37231]: https://github.com/rust-lang/rust/pull/37231
4667 [37247]: https://github.com/rust-lang/rust/pull/37247
4668 [37267]: https://github.com/rust-lang/rust/pull/37267
4669 [37270]: https://github.com/rust-lang/rust/pull/37270
4670 [37273]: https://github.com/rust-lang/rust/pull/37273
4671 [37280]: https://github.com/rust-lang/rust/pull/37280
4672 [37298]: https://github.com/rust-lang/rust/pull/37298
4673 [37306]: https://github.com/rust-lang/rust/pull/37306
4674 [37310]: https://github.com/rust-lang/rust/pull/37310
4675 [37312]: https://github.com/rust-lang/rust/pull/37312
4676 [37313]: https://github.com/rust-lang/rust/pull/37313
4677 [37315]: https://github.com/rust-lang/rust/pull/37315
4678 [37318]: https://github.com/rust-lang/rust/pull/37318
4679 [37322]: https://github.com/rust-lang/rust/pull/37322
4680 [37326]: https://github.com/rust-lang/rust/pull/37326
4681 [37351]: https://github.com/rust-lang/rust/pull/37351
4682 [37356]: https://github.com/rust-lang/rust/pull/37356
4683 [37367]: https://github.com/rust-lang/rust/pull/37367
4684 [37373]: https://github.com/rust-lang/rust/pull/37373
4685 [37378]: https://github.com/rust-lang/rust/pull/37378
4686 [37389]: https://github.com/rust-lang/rust/pull/37389
4687 [37392]: https://github.com/rust-lang/rust/pull/37392
4688 [37427]: https://github.com/rust-lang/rust/pull/37427
4689 [37439]: https://github.com/rust-lang/rust/pull/37439
4690 [37445]: https://github.com/rust-lang/rust/pull/37445
4691 [37470]: https://github.com/rust-lang/rust/pull/37470
4692 [37569]: https://github.com/rust-lang/rust/pull/37569
4693 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4694 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4695 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4696 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4697 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4698 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4699 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4700
4701
4702 Version 1.13.0 (2016-11-10)
4703 ===========================
4704
4705 Language
4706 --------
4707
4708 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4709   errors, like the `try!` macro, described in [RFC 0243].
4710 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4711 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4712 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4713 * [Fix lifetime rules for 'if' conditions][36029]
4714 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4715
4716 Compiler
4717 --------
4718
4719 * [Add the `-C link-arg` argument][36574]
4720 * [Remove the old AST-based backend from rustc_trans][35764]
4721 * [Don't enable NEON by default on armv7 Linux][35814]
4722 * [Fix debug line number info for macro expansions][35238]
4723 * [Do not emit "class method" debuginfo for types that are not
4724   DICompositeType][36008]
4725 * [Warn about multiple conflicting #[repr] hints][34623]
4726 * [When sizing DST, don't double-count nested struct prefixes][36351]
4727 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4728 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4729 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4730 * [Expand macros without recursing to avoid stack overflows][36214]
4731
4732 Diagnostics
4733 -----------
4734
4735 * [Replace macro backtraces with labeled local uses][35702]
4736 * [Improve error message for misplaced doc comments][33922]
4737 * [Buffer unix and lock windows to prevent message interleaving][35975]
4738 * [Update lifetime errors to specifically note temporaries][36171]
4739 * [Special case a few colors for Windows][36178]
4740 * [Suggest `use self` when such an import resolves][36289]
4741 * [Be more specific when type parameter shadows primitive type][36338]
4742 * Many minor improvements
4743
4744 Compile-time Optimizations
4745 --------------------------
4746
4747 * [Compute and cache HIR hashes at beginning][35854]
4748 * [Don't hash types in loan paths][36004]
4749 * [Cache projections in trans][35761]
4750 * [Optimize the parser's last token handling][36527]
4751 * [Only instantiate #[inline] functions in codegen units referencing
4752   them][36524]. This leads to big improvements in cases where crates export
4753   define many inline functions without using them directly.
4754 * [Lazily allocate TypedArena's first chunk][36592]
4755 * [Don't allocate during default HashSet creation][36734]
4756
4757 Stabilized APIs
4758 ---------------
4759
4760 * [`checked_abs`]
4761 * [`wrapping_abs`]
4762 * [`overflowing_abs`]
4763 * [`RefCell::try_borrow`]
4764 * [`RefCell::try_borrow_mut`]
4765
4766 Libraries
4767 ---------
4768
4769 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4770 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4771   covariant][35354]
4772 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4773 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4774 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4775 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4776 * [Use arc4rand on FreeBSD][35884]
4777 * [memrchr: Correct aligned offset computation][35969]
4778 * [Improve Demangling of Rust Symbols][36059]
4779 * [Use monotonic time in condition variables][35048]
4780 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4781 * [Implement conversion traits for `char`][35755]
4782 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4783 * [Zero first byte of CString on drop][36264]
4784 * [Inherit overflow checks for sum and product][36372]
4785 * [Add missing Eq implementations][36423]
4786 * [Implement `Debug` for `DirEntry`][36631]
4787 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4788   `errno`][36754]
4789 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4790 * [Implement more traits for `std::io::ErrorKind`][35911]
4791 * [Optimize BinaryHeap bounds checking][36072]
4792 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4793   `extend_with_element`][36355]
4794 * [Fix overflow checking in unsigned pow()][34942]
4795
4796 Cargo
4797 -----
4798
4799 * This release includes security fixes to both curl and OpenSSL.
4800 * [Fix transitive doctests when panic=abort][cargo/3021]
4801 * [Add --all-features flag to cargo][cargo/3038]
4802 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4803 * [Don't parse the home directory more than once][cargo/3078]
4804 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4805 * [Update OpenSSL to 1.0.2j][cargo/3121]
4806 * [Add license and license_file to cargo metadata output][cargo/3110]
4807 * [Make crates-io registry URL optional in config; ignore all changes to
4808   source.crates-io][cargo/3089]
4809 * [Don't download dependencies from other platforms][cargo/3123]
4810 * [Build transitive dev-dependencies when needed][cargo/3125]
4811 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4812 * [Avoid updating registry when adding existing deps][cargo/3144]
4813 * [Warn about path overrides that won't work][cargo/3136]
4814 * [Use workspaces during `cargo install`][cargo/3146]
4815 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4816 * [Add --message-format flag][cargo/3000]
4817 * [Pass target environment for rustdoc][cargo/3205]
4818 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4819 * [Update curl and curl-sys][cargo/3241]
4820 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4821
4822 Tooling
4823 -------
4824
4825 * [rustdoc: Add the `--sysroot` argument][36586]
4826 * [rustdoc: Fix a couple of issues with the search results][35655]
4827 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4828 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4829 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4830
4831 Misc
4832 ----
4833
4834 * [Remove unmaintained style guide][35124]
4835 * [Add s390x support][36369]
4836 * [Initial work at Haiku OS support][36727]
4837 * [Add mips-uclibc targets][35734]
4838 * [Crate-ify compiler-rt into compiler-builtins][35021]
4839 * [Add rustc version info (git hash + date) to dist tarball][36213]
4840 * Many documentation improvements
4841
4842 Compatibility Notes
4843 -------------------
4844
4845 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4846 * [Deny (by default) transmuting from fn item types to pointer-sized
4847   types][34923]. Continuing the long transition to zero-sized fn items,
4848   per [RFC 401].
4849 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4850   Part of [RFC 1506].
4851 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4852 * [Fix lifetime rules for 'if' conditions][36029].
4853 * [Inherit overflow checks for sum and product][36372].
4854 * [Forbid user-defined macros named "macro_rules"][36730].
4855
4856 [33922]: https://github.com/rust-lang/rust/pull/33922
4857 [34623]: https://github.com/rust-lang/rust/pull/34623
4858 [34923]: https://github.com/rust-lang/rust/pull/34923
4859 [34942]: https://github.com/rust-lang/rust/pull/34942
4860 [34982]: https://github.com/rust-lang/rust/pull/34982
4861 [35021]: https://github.com/rust-lang/rust/pull/35021
4862 [35048]: https://github.com/rust-lang/rust/pull/35048
4863 [35074]: https://github.com/rust-lang/rust/pull/35074
4864 [35124]: https://github.com/rust-lang/rust/pull/35124
4865 [35234]: https://github.com/rust-lang/rust/pull/35234
4866 [35238]: https://github.com/rust-lang/rust/pull/35238
4867 [35354]: https://github.com/rust-lang/rust/pull/35354
4868 [35559]: https://github.com/rust-lang/rust/pull/35559
4869 [35585]: https://github.com/rust-lang/rust/pull/35585
4870 [35627]: https://github.com/rust-lang/rust/pull/35627
4871 [35655]: https://github.com/rust-lang/rust/pull/35655
4872 [35702]: https://github.com/rust-lang/rust/pull/35702
4873 [35707]: https://github.com/rust-lang/rust/pull/35707
4874 [35728]: https://github.com/rust-lang/rust/pull/35728
4875 [35734]: https://github.com/rust-lang/rust/pull/35734
4876 [35755]: https://github.com/rust-lang/rust/pull/35755
4877 [35761]: https://github.com/rust-lang/rust/pull/35761
4878 [35764]: https://github.com/rust-lang/rust/pull/35764
4879 [35814]: https://github.com/rust-lang/rust/pull/35814
4880 [35854]: https://github.com/rust-lang/rust/pull/35854
4881 [35871]: https://github.com/rust-lang/rust/pull/35871
4882 [35884]: https://github.com/rust-lang/rust/pull/35884
4883 [35911]: https://github.com/rust-lang/rust/pull/35911
4884 [35969]: https://github.com/rust-lang/rust/pull/35969
4885 [35975]: https://github.com/rust-lang/rust/pull/35975
4886 [36004]: https://github.com/rust-lang/rust/pull/36004
4887 [36008]: https://github.com/rust-lang/rust/pull/36008
4888 [36014]: https://github.com/rust-lang/rust/pull/36014
4889 [36029]: https://github.com/rust-lang/rust/pull/36029
4890 [36059]: https://github.com/rust-lang/rust/pull/36059
4891 [36072]: https://github.com/rust-lang/rust/pull/36072
4892 [36101]: https://github.com/rust-lang/rust/pull/36101
4893 [36104]: https://github.com/rust-lang/rust/pull/36104
4894 [36171]: https://github.com/rust-lang/rust/pull/36171
4895 [36173]: https://github.com/rust-lang/rust/pull/36173
4896 [36178]: https://github.com/rust-lang/rust/pull/36178
4897 [36213]: https://github.com/rust-lang/rust/pull/36213
4898 [36214]: https://github.com/rust-lang/rust/pull/36214
4899 [36264]: https://github.com/rust-lang/rust/pull/36264
4900 [36266]: https://github.com/rust-lang/rust/pull/36266
4901 [36289]: https://github.com/rust-lang/rust/pull/36289
4902 [36338]: https://github.com/rust-lang/rust/pull/36338
4903 [36351]: https://github.com/rust-lang/rust/pull/36351
4904 [36355]: https://github.com/rust-lang/rust/pull/36355
4905 [36369]: https://github.com/rust-lang/rust/pull/36369
4906 [36372]: https://github.com/rust-lang/rust/pull/36372
4907 [36423]: https://github.com/rust-lang/rust/pull/36423
4908 [36482]: https://github.com/rust-lang/rust/pull/36482
4909 [36505]: https://github.com/rust-lang/rust/pull/36505
4910 [36524]: https://github.com/rust-lang/rust/pull/36524
4911 [36527]: https://github.com/rust-lang/rust/pull/36527
4912 [36551]: https://github.com/rust-lang/rust/pull/36551
4913 [36574]: https://github.com/rust-lang/rust/pull/36574
4914 [36586]: https://github.com/rust-lang/rust/pull/36586
4915 [36592]: https://github.com/rust-lang/rust/pull/36592
4916 [36631]: https://github.com/rust-lang/rust/pull/36631
4917 [36639]: https://github.com/rust-lang/rust/pull/36639
4918 [36721]: https://github.com/rust-lang/rust/pull/36721
4919 [36727]: https://github.com/rust-lang/rust/pull/36727
4920 [36730]: https://github.com/rust-lang/rust/pull/36730
4921 [36734]: https://github.com/rust-lang/rust/pull/36734
4922 [36754]: https://github.com/rust-lang/rust/pull/36754
4923 [36995]: https://github.com/rust-lang/rust/pull/36995
4924 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4925 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4926 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4927 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4928 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4929 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4930 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4931 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4932 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4933 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4934 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4935 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4936 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4937 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4938 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4939 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4940 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4941 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4942 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4943 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4944 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4945 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4946 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4947 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4948 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4949 [rustup]: https://www.rustup.rs
4950 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4951 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4952 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4953 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4954 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4955 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4956 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4957
4958
4959 Version 1.12.1 (2016-10-20)
4960 ===========================
4961
4962 Regression Fixes
4963 ----------------
4964
4965 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4966 * [Confusion with double negation and booleans][36856]
4967 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4968 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4969 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4970 * [Corrupted memory after updated to 1.12][36936]
4971 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4972 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4973 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4974
4975 [36381]: https://github.com/rust-lang/rust/issues/36381
4976 [36856]: https://github.com/rust-lang/rust/issues/36856
4977 [36875]: https://github.com/rust-lang/rust/issues/36875
4978 [36924]: https://github.com/rust-lang/rust/issues/36924
4979 [36926]: https://github.com/rust-lang/rust/issues/36926
4980 [36936]: https://github.com/rust-lang/rust/issues/36936
4981 [37026]: https://github.com/rust-lang/rust/issues/37026
4982 [37112]: https://github.com/rust-lang/rust/issues/37112
4983 [37153]: https://github.com/rust-lang/rust/issues/37153
4984
4985
4986 Version 1.12.0 (2016-09-29)
4987 ===========================
4988
4989 Highlights
4990 ----------
4991
4992 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4993   This translation pass is far simpler than the previous AST->LLVM pass, and
4994   creates opportunities to perform new optimizations directly on the MIR. It
4995   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4996 * [`rustc` presents a new, more readable error format, along with
4997   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4998   Most common editors supporting Rust have been updated to work with it. It was
4999   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5000
5001 Compiler
5002 --------
5003
5004 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5005   This translation pass is far simpler than the previous AST->LLVM pass, and
5006   creates opportunities to perform new optimizations directly on the MIR. It
5007   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5008 * [Print the Rust target name, not the LLVM target name, with
5009   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5010 * [The computation of `TypeId` is correct in some cases where it was previously
5011   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5012 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5013 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5014   `--print relocation-models`, and `--print code-models` print the available
5015   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5016   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5017 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5018   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5019   These targets produce statically-linked binaries. There are no binary release
5020   builds yet though.
5021
5022 Diagnostics
5023 -----------
5024
5025 * [`rustc` presents a new, more readable error format, along with
5026   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5027   Most common editors supporting Rust have been updated to work with it. It was
5028   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5029 * [In error descriptions, references are now described in plain English,
5030   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5031 * [In error type descriptions, unknown numeric types are named `{integer}` or
5032   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5033 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5034
5035 Language
5036 --------
5037
5038 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5039 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5040 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5041   useful](https://github.com/rust-lang/rust/pull/34908)
5042 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5043   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5044 * [Semicolons are properly required as statement delimiters inside
5045   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5046 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5047
5048 Stabilized APIs
5049 ---------------
5050
5051 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5052 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5053 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5054 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5055 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5056 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5057 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5058 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5059 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5060 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5061   Both on Unix and Windows.
5062 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5063 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5064 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5065 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5066 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5067 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5068 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5069 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5070
5071 Libraries
5072 ---------
5073
5074 * [The `format!` macro and friends now allow a single argument to be formatted
5075   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5076 * [The lifetime bounds on `[T]::binary_search_by` and
5077   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5078 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5079 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5080 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5081 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5082 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5083 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5084 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5085 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5086   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5087 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5088   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5089 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5090 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5091   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5092 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5093 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5094 * [`mpsc::sync_channel` `Receiver`s return any available message before
5095   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5096 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5097 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5098
5099 Cargo
5100 -----
5101
5102 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5103 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5104 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5105 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5106 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5107 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5108 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5109 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5110 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5111 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5112 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5113 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5114 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5115 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5116 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5117 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5118
5119 Performance
5120 -----------
5121
5122 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5123 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5124
5125 Tooling
5126 -------
5127
5128 * [Test binaries now support a `--test-threads` argument to specify the number
5129   of threads used to run tests, and which acts the same as the
5130   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5131 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5132 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5133 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5134 * [Rust releases now come with source packages that can be installed by rustup
5135   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5136   The resulting source code can be used by tools and IDES, located in the
5137   sysroot under `lib/rustlib/src`.
5138
5139 Misc
5140 ----
5141
5142 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5143 * Many minor improvements to the documentation.
5144 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5145
5146 Compatibility Notes
5147 -------------------
5148
5149 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5150   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5151 * [When formatting strings, if "precision" is specified, the "fill",
5152   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5153 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5154
5155
5156 Version 1.11.0 (2016-08-18)
5157 ===========================
5158
5159 Language
5160 --------
5161
5162 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5163 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5164 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5165 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5166
5167 Stabilized APIs
5168 ---------------
5169
5170 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5171 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5172 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5173 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5174 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5175 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5176   (in libcore - previously stabilized in libstd)
5177 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5178   (in libcore - previously stabilized in libstd)
5179 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5180   (in libcore - previously stabilized in libstd)
5181 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5182   (in libcore - previously stabilized in libstd)
5183 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5184 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5185 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5186 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5187
5188 Libraries
5189 ---------
5190
5191 * [The `thread_local!` macro supports multiple definitions in a single
5192    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5193 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5194 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5195   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5196 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5197 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5198 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5199 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5200
5201 Cargo
5202 -----
5203
5204 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5205 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5206 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5207 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5208 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5209   and `-vv` prints warnings for all crates.
5210 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5211 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5212   This provides room for expansion by arbitrary tools.
5213 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5214 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5215 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5216 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5217 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5218 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5219 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5220
5221 Performance
5222 -----------
5223
5224 * [Caching projections speeds up type check dramatically for some
5225   workloads](https://github.com/rust-lang/rust/pull/33816)
5226 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5227   This hasher is faster, but is believed to provide sufficient
5228   protection from collision attacks.
5229 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5230
5231 Rustdoc
5232 -------
5233
5234 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5235 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5236 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5237 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5238 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5239
5240 Tooling
5241 -------
5242
5243 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5244 * [When emitting debug info, rustc emits frame pointers for closures,
5245   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5246 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5247 * Many more errors have been given error codes and extended
5248   explanations
5249 * API documentation continues to be improved, with many new examples
5250
5251 Misc
5252 ----
5253
5254 * [rustc no longer hangs when dependencies recursively re-export
5255   submodules](https://github.com/rust-lang/rust/pull/34542)
5256 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5257 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5258   rewritten](https://github.com/rust-lang/rust/pull/33895)
5259 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5260   No targets use this yet, but it works toward AVR support.
5261
5262 Compatibility Notes
5263 -------------------
5264
5265 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5266 * [The new follow-set rules that place restrictions on `macro_rules!`
5267   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5268   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5269   and has been a warning since 1.10.
5270 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5271   This causes breakage in some corner cases.
5272
5273
5274 Version 1.10.0 (2016-07-07)
5275 ===========================
5276
5277 Language
5278 --------
5279
5280 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5281   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5282 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5283 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5284 * [`panic!` can be converted to a runtime abort with the
5285   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5286   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5287 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5288   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5289   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5290   Note that Cargo does not yet directly support cdylibs.
5291
5292 Stabilized APIs
5293 ---------------
5294
5295 * `os::windows::fs::OpenOptionsExt::access_mode`
5296 * `os::windows::fs::OpenOptionsExt::share_mode`
5297 * `os::windows::fs::OpenOptionsExt::custom_flags`
5298 * `os::windows::fs::OpenOptionsExt::attributes`
5299 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5300 * `os::unix::fs::OpenOptionsExt::custom_flags`
5301 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5302 * `Default for sync::Weak`
5303 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5304 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5305 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5306 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5307 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5308 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5309 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5310 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5311 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5312 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5313 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5314 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5315 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5316 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5317 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5318 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5319 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5320 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5321 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5322 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5323 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5324 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5325 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5326 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5327 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5328 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5329 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5330 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5331 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5332 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5333 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5334 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5335 * Read/Write/RawFd impls for `UnixStream`
5336 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5337 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5338 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5339 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5340 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5341 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5342 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5343 * RawFd impls for `UnixListener`
5344 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5345 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5346 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5347 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5348 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5349 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5350 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5351 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5352 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5353 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5354 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5355 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5356 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5357 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5358 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5359 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5360 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5361 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5362 * RawFd impls for `UnixDatagram`
5363 * `{BTree,Hash}Map::values_mut`
5364 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5365
5366 Libraries
5367 ---------
5368
5369 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5370   The semantics of this minor method are subtle and probably not what
5371   most people want.
5372 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5373 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5374   will fall back to `/dev/urandom` temporarily to avoid blocking
5375   during early boot](https://github.com/rust-lang/rust/pull/33086).
5376 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5377 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5378 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5379 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5380 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5381 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5382   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5383
5384 Cargo
5385 -----
5386 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5387   This controls the runtime behavior of the `panic!` macro
5388   and can be either "unwind" (the default), or "abort".
5389   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5390 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5391 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5392 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5393   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5394 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5395 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5396 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5397   By default they are retried twice, which can be customized with the
5398   `net.retry` value in `.cargo/config`.
5399 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5400 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5401 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5402 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5403   Makes it possible to install multiple crates in parallel.
5404 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5405 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5406 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5407 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5408 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5409 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5410
5411 Performance
5412 -----------
5413
5414 * [rustc memory usage was reduced by refactoring the context used for
5415   type checking](https://github.com/rust-lang/rust/pull/33425).
5416 * [Speed up creation of `HashMap`s by caching the random keys used
5417   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5418 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5419 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5420 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5421   10x faster than the previous lookup tables.
5422 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5423
5424 Usability
5425 ---------
5426
5427 * Many incremental improvements to documentation and rustdoc.
5428 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5429 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5430 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5431 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5432 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5433 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5434 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5435
5436 Misc
5437 ----
5438
5439 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5440 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5441 * [`std` no longer prints backtraces on platforms where the running
5442   module must be loaded with `env::current_exe`, which can't be relied
5443   on](https://github.com/rust-lang/rust/pull/33554).
5444 * This release includes std binaries for the i586-unknown-linux-gnu,
5445   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5446   i586 target is for old x86 hardware without SSE2, and the armv7
5447   target is for Android running on modern ARM architectures.
5448 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5449   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5450 * [On Unix the runtime aborts by calling `libc::abort` instead of
5451   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5452 * [Rust is now bootstrapped from the previous release of Rust,
5453   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5454
5455 Compatibility Notes
5456 -------------------
5457
5458 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5459 * [`target_env` for Linux ARM targets is just `gnu`, not
5460   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5461 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5462 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5463 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5464   Affects how macros are parsed.
5465 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5466 * [Feature-gated attributes on macro-generated macro invocations are
5467   now rejected](https://github.com/rust-lang/rust/pull/32791).
5468 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5469   This caused some minor changes to type inference.
5470
5471
5472 Version 1.9.0 (2016-05-26)
5473 ==========================
5474
5475 Language
5476 --------
5477
5478 * The `#[deprecated]` attribute when applied to an API will generate
5479   warnings when used. The warnings may be suppressed with
5480   `#[allow(deprecated)]`. [RFC 1270].
5481 * [`fn` item types are zero sized, and each `fn` names a unique
5482   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5483   `transmute` on a `fn` type will generate a warning for a few cycles,
5484   then will be converted to an error.
5485 * [Field and method resolution understand visibility, so private
5486   fields and methods cannot prevent the proper use of public fields
5487   and methods][1.9fv].
5488 * [The parser considers unicode codepoints in the
5489   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5490
5491 Stabilized APIs
5492 ---------------
5493
5494 * [`std::panic`]
5495 * [`std::panic::catch_unwind`] (renamed from `recover`)
5496 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5497 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5498 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5499 * [`str::is_char_boundary`]
5500 * [`<*const T>::as_ref`]
5501 * [`<*mut T>::as_ref`]
5502 * [`<*mut T>::as_mut`]
5503 * [`AsciiExt::make_ascii_uppercase`]
5504 * [`AsciiExt::make_ascii_lowercase`]
5505 * [`char::decode_utf16`]
5506 * [`char::DecodeUtf16`]
5507 * [`char::DecodeUtf16Error`]
5508 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5509 * [`BTreeSet::take`]
5510 * [`BTreeSet::replace`]
5511 * [`BTreeSet::get`]
5512 * [`HashSet::take`]
5513 * [`HashSet::replace`]
5514 * [`HashSet::get`]
5515 * [`OsString::with_capacity`]
5516 * [`OsString::clear`]
5517 * [`OsString::capacity`]
5518 * [`OsString::reserve`]
5519 * [`OsString::reserve_exact`]
5520 * [`OsStr::is_empty`]
5521 * [`OsStr::len`]
5522 * [`std::os::unix::thread`]
5523 * [`RawPthread`]
5524 * [`JoinHandleExt`]
5525 * [`JoinHandleExt::as_pthread_t`]
5526 * [`JoinHandleExt::into_pthread_t`]
5527 * [`HashSet::hasher`]
5528 * [`HashMap::hasher`]
5529 * [`CommandExt::exec`]
5530 * [`File::try_clone`]
5531 * [`SocketAddr::set_ip`]
5532 * [`SocketAddr::set_port`]
5533 * [`SocketAddrV4::set_ip`]
5534 * [`SocketAddrV4::set_port`]
5535 * [`SocketAddrV6::set_ip`]
5536 * [`SocketAddrV6::set_port`]
5537 * [`SocketAddrV6::set_flowinfo`]
5538 * [`SocketAddrV6::set_scope_id`]
5539 * [`slice::copy_from_slice`]
5540 * [`ptr::read_volatile`]
5541 * [`ptr::write_volatile`]
5542 * [`OpenOptions::create_new`]
5543 * [`TcpStream::set_nodelay`]
5544 * [`TcpStream::nodelay`]
5545 * [`TcpStream::set_ttl`]
5546 * [`TcpStream::ttl`]
5547 * [`TcpStream::set_only_v6`]
5548 * [`TcpStream::only_v6`]
5549 * [`TcpStream::take_error`]
5550 * [`TcpStream::set_nonblocking`]
5551 * [`TcpListener::set_ttl`]
5552 * [`TcpListener::ttl`]
5553 * [`TcpListener::set_only_v6`]
5554 * [`TcpListener::only_v6`]
5555 * [`TcpListener::take_error`]
5556 * [`TcpListener::set_nonblocking`]
5557 * [`UdpSocket::set_broadcast`]
5558 * [`UdpSocket::broadcast`]
5559 * [`UdpSocket::set_multicast_loop_v4`]
5560 * [`UdpSocket::multicast_loop_v4`]
5561 * [`UdpSocket::set_multicast_ttl_v4`]
5562 * [`UdpSocket::multicast_ttl_v4`]
5563 * [`UdpSocket::set_multicast_loop_v6`]
5564 * [`UdpSocket::multicast_loop_v6`]
5565 * [`UdpSocket::set_multicast_ttl_v6`]
5566 * [`UdpSocket::multicast_ttl_v6`]
5567 * [`UdpSocket::set_ttl`]
5568 * [`UdpSocket::ttl`]
5569 * [`UdpSocket::set_only_v6`]
5570 * [`UdpSocket::only_v6`]
5571 * [`UdpSocket::join_multicast_v4`]
5572 * [`UdpSocket::join_multicast_v6`]
5573 * [`UdpSocket::leave_multicast_v4`]
5574 * [`UdpSocket::leave_multicast_v6`]
5575 * [`UdpSocket::take_error`]
5576 * [`UdpSocket::connect`]
5577 * [`UdpSocket::send`]
5578 * [`UdpSocket::recv`]
5579 * [`UdpSocket::set_nonblocking`]
5580
5581 Libraries
5582 ---------
5583
5584 * [`std::sync::Once` is poisoned if its initialization function
5585   fails][1.9o].
5586 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5587 * [Most types implement `fmt::Debug`][1.9db].
5588 * [The default buffer size used by `BufReader` and `BufWriter` was
5589   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5590   used by other languages.
5591 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5592   `Duration` additionally implements `*=` and `/=`][1.9ta].
5593 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5594 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5595 * [`Chain` implements `BufRead`][1.9ch].
5596 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5597
5598 Cargo
5599 -----
5600
5601 * [Cargo can now run concurrently][1.9cc].
5602 * [Top-level overrides allow specific revisions of crates to be
5603   overridden through the entire crate graph][1.9ct].  This is intended
5604   to make upgrades easier for large projects, by allowing crates to be
5605   forked temporarily until they've been upgraded and republished.
5606 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5607 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5608   on the commandline][1.9cf]. `rustc` arguments can also be specified
5609   in the `build.rustflags` configuration key.
5610
5611 Performance
5612 -----------
5613
5614 * [The time complexity of comparing variables for equivalence during type
5615   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5616   to major compilation time improvement in some scenarios.
5617 * [`ToString` is specialized for `str`, giving it the same performance
5618   as `to_owned`][1.9ts].
5619 * [Spawning processes with `Command::output` no longer creates extra
5620   threads][1.9sp].
5621 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5622   for C-like enums][1.9cl].
5623
5624 Misc
5625 ----
5626
5627 * [Passing the `--quiet` flag to a test runner will produce
5628   much-abbreviated output][1.9q].
5629 * The Rust Project now publishes std binaries for the
5630   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5631   `i586-pc-windows-msvc` targets.
5632
5633 Compatibility Notes
5634 -------------------
5635
5636 * [`std::sync::Once` is poisoned if its initialization function
5637   fails][1.9o].
5638 * [It is illegal to define methods with the same name in overlapping
5639   inherent `impl` blocks][1.9sn].
5640 * [`fn` item types are zero sized, and each `fn` names a unique
5641   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5642   `transmute` on a `fn` type will generate a warning for a few cycles,
5643   then will be converted to an error.
5644 * [Improvements to const evaluation may trigger new errors when integer
5645   literals are out of range][1.9ce].
5646
5647
5648 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5649 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5650 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5651 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5652 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5653 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5654 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5655 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5656 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5657 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5658 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5659 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5660 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5661 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5662 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5663 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5664 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5665 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5666 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5667 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5668 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5669 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5670 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5671 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5672 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5673 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5674 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5675 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5676 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5677 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5678 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5679 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5680 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5681 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5682 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5683 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5684 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5685 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5686 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5687 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5688 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5689 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5690 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5691 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5692 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5693 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5694 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5695 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5696 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5697 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5698 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5699 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5700 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5701 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5702 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5703 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5704 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5705 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5706 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5707 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5708 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5709 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5710 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5711 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5712 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5713 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5714 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5715 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5716 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5717 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5718 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5719 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5720 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5721 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5722 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5723 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5724 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5725 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5726 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5727 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5728 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5729 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5730 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5731 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5732 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5733 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5734 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5735 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5736 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5737 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5738 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5739 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5740 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5741 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5742 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5743 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5744 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5745 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5746 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5747 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5748 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5749 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5750 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5751 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5752 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5753 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5754 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5755 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5756 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5757 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5758
5759
5760 Version 1.8.0 (2016-04-14)
5761 ==========================
5762
5763 Language
5764 --------
5765
5766 * Rust supports overloading of compound assignment statements like
5767   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5768   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5769   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5770   traits. [RFC 953].
5771 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5772   addition to the non-braced form, `struct Foo;`. [RFC 218].
5773
5774 Libraries
5775 ---------
5776
5777 * Stabilized APIs:
5778   * [`str::encode_utf16`] (renamed from `utf16_units`)
5779   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5780   * [`Ref::map`]
5781   * [`RefMut::map`]
5782   * [`ptr::drop_in_place`]
5783   * [`time::Instant`]
5784   * [`time::SystemTime`]
5785   * [`Instant::now`]
5786   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5787   * [`Instant::elapsed`]
5788   * [`SystemTime::now`]
5789   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5790   * [`SystemTime::elapsed`]
5791   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5792   * [`SystemTimeError`]
5793   * [`SystemTimeError::duration`]
5794   * Various impls for `SystemTimeError`
5795   * [`UNIX_EPOCH`]
5796   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5797     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5798     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5799 * [The `write!` and `writeln!` macros correctly emit errors if any of
5800   their arguments can't be formatted][1.8w].
5801 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5802 * [The Unix-specific `raw` modules, which contain a number of
5803   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5804   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5805   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5806   across platforms was making it difficult to implement `std`
5807   correctly. Those that need these definitions should use the `libc`
5808   crate. [RFC 1415].
5809 * The Unix-specific `MetadataExt` traits, including
5810   `os::unix::fs::MetadataExt`, which expose values such as inode
5811   numbers [no longer return platform-specific types][1.8r], but
5812   instead return widened integers. [RFC 1415].
5813 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5814 * [Atomic loads and stores are not volatile][1.8a].
5815 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5816
5817 Performance
5818 -----------
5819
5820 * [Inlining hash functions lead to a 3% compile-time improvement in
5821   some workloads][1.8h].
5822 * When using jemalloc, its symbols are [unprefixed so that it
5823   overrides the libc malloc implementation][1.8h]. This means that for
5824   rustc, LLVM is now using jemalloc, which results in a 6%
5825   compile-time improvement on a specific workload.
5826 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5827
5828 Misc
5829 ----
5830
5831 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5832   i686-pc-windows-msvc is now considered a tier-1 platform.
5833 * [The `--print targets` flag prints a list of supported targets][1.8t].
5834 * [The `--print cfg` flag prints the `cfg`s defined for the current
5835   target][1.8cf].
5836 * [`rustc` can be built with an new Cargo-based build system, written
5837   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5838   build system. To enable it configure with `configure --rustbuild`.
5839 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5840   variants while also indicating the total number of missing variants
5841   if more than 3][1.8m].
5842 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5843 * The Rust Project now publishes binary releases of the standard
5844   library for a number of tier-2 targets:
5845   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5846   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5847   `x86_64-rumprun-netbsd`. These can be installed with
5848   tools such as [multirust][1.8mr].
5849
5850 Cargo
5851 -----
5852
5853 * [`cargo init` creates a new Cargo project in the current
5854   directory][1.8ci].  It is otherwise like `cargo new`.
5855 * [Cargo has configuration keys for `-v` and
5856   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5857   `[term]` section of `.cargo/config`.
5858 * [Configuration keys that evaluate to strings or integers can be set
5859   via environment variables][1.8ce]. For example the `build.jobs` key
5860   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5861   precedence over config files.
5862 * [Target-specific dependencies support Rust `cfg` syntax for
5863   describing targets][1.8cfg] so that dependencies for multiple
5864   targets can be specified together. [RFC 1361].
5865 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5866   `RUSTDOC` take precedence over the `build.target-dir`,
5867   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5868 * [The child process tree is killed on Windows when Cargo is
5869   killed][1.8ck].
5870 * [The `build.target` configuration value sets the target platform,
5871   like `--target`][1.8ct].
5872
5873 Compatibility Notes
5874 -------------------
5875
5876 * [Unstable compiler flags have been further restricted][1.8u]. Since
5877   1.0 `-Z` flags have been considered unstable, and other flags that
5878   were considered unstable additionally required passing `-Z
5879   unstable-options` to access. Unlike unstable language and library
5880   features though, these options have been accessible on the stable
5881   release channel. Going forward, *new unstable flags will not be
5882   available on the stable release channel*, and old unstable flags
5883   will warn about their usage. In the future, all unstable flags will
5884   be unavailable on the stable release channel.
5885 * [It is no longer possible to `match` on empty enum variants using
5886   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5887 * The Unix-specific `MetadataExt` traits, including
5888   `os::unix::fs::MetadataExt`, which expose values such as inode
5889   numbers [no longer return platform-specific types][1.8r], but
5890   instead return widened integers. [RFC 1415].
5891 * [Modules sourced from the filesystem cannot appear within arbitrary
5892   blocks, but only within other modules][1.8mf].
5893 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5894 * On Unix, [stack overflow triggers a runtime abort instead of a
5895   SIGSEGV][1.8so].
5896 * [`Command::spawn` and its equivalents return an error if any of
5897   its command-line arguments contain interior `NUL`s][1.8n].
5898 * [Tuple and unit enum variants from other crates are in the type
5899   namespace][1.8tn].
5900 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5901   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5902   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5903   instead of `foo.lib`.
5904
5905
5906 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5907 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5908 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5909 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5910 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5911 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5912 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5913 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5914 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5915 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5916 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5917 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5918 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5919 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5920 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5921 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5922 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5923 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5924 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5925 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5926 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5927 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5928 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5929 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5930 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5931 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5932 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5933 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5934 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5935 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5936 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5937 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5938 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5939 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5940 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5941 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5942 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5943 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5944 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5945 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5946 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5947 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5948 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5949 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5950 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5951 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5952 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5953 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5954 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5955 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5956 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5957 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5958 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5959 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5960 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5961 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5962 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5963 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5964 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5965 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5966
5967
5968 Version 1.7.0 (2016-03-03)
5969 ==========================
5970
5971 Libraries
5972 ---------
5973
5974 * Stabilized APIs
5975   * `Path`
5976     * [`Path::strip_prefix`] (renamed from relative_from)
5977     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
5978   * `Ipv4Addr`
5979     * [`Ipv4Addr::is_loopback`]
5980     * [`Ipv4Addr::is_private`]
5981     * [`Ipv4Addr::is_link_local`]
5982     * [`Ipv4Addr::is_multicast`]
5983     * [`Ipv4Addr::is_broadcast`]
5984     * [`Ipv4Addr::is_documentation`]
5985   * `Ipv6Addr`
5986     * [`Ipv6Addr::is_unspecified`]
5987     * [`Ipv6Addr::is_loopback`]
5988     * [`Ipv6Addr::is_multicast`]
5989   * `Vec`
5990     * [`Vec::as_slice`]
5991     * [`Vec::as_mut_slice`]
5992   * `String`
5993     * [`String::as_str`]
5994     * [`String::as_mut_str`]
5995   * Slices
5996     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5997     be the same length
5998     * `<[T]>::`[`sort_by_key`]
5999   * checked, saturated, and overflowing operations
6000     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6001     * [`i32::saturating_mul`]
6002     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6003     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6004     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6005     * [`u32::saturating_mul`]
6006     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6007     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6008     * and checked, saturated, and overflowing operations for other primitive types
6009   * FFI
6010     * [`ffi::IntoStringError`]
6011     * [`CString::into_string`]
6012     * [`CString::into_bytes`]
6013     * [`CString::into_bytes_with_nul`]
6014     * `From<CString> for Vec<u8>`
6015   * `IntoStringError`
6016     * [`IntoStringError::into_cstring`]
6017     * [`IntoStringError::utf8_error`]
6018     * `Error for IntoStringError`
6019   * Hashing
6020     * [`std::hash::BuildHasher`]
6021     * [`BuildHasher::Hasher`]
6022     * [`BuildHasher::build_hasher`]
6023     * [`std::hash::BuildHasherDefault`]
6024     * [`HashMap::with_hasher`]
6025     * [`HashMap::with_capacity_and_hasher`]
6026     * [`HashSet::with_hasher`]
6027     * [`HashSet::with_capacity_and_hasher`]
6028     * [`std::collections::hash_map::RandomState`]
6029     * [`RandomState::new`]
6030 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6031   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6032   from bytes is faster.
6033 * [The performance of `LineWriter` (and thus `io::stdout`) was
6034   improved by using `memchr` to search for newlines][1.7m].
6035 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6036   `f64` variants were stabilized previously.
6037 * [`BTreeMap` was rewritten to use less memory and improve the performance
6038   of insertion and iteration, the latter by as much as 5x][1.7bm].
6039 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6040   covariant over their contained type][1.7bt].
6041 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6042   over their contained type][1.7ll].
6043 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6044   searching methods.
6045 * [`Any` is implemented for unsized types][1.7a].
6046 * [`Hash` is implemented for `Duration`][1.7h].
6047
6048 Misc
6049 ----
6050
6051 * [When running tests with `--test`, rustdoc will pass `--cfg`
6052   arguments to the compiler][1.7dt].
6053 * [The compiler is built with RPATH information by default][1.7rpa].
6054   This means that it will be possible to run `rustc` when installed in
6055   unusual configurations without configuring the dynamic linker search
6056   path explicitly.
6057 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6058   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6059   over `LD_LIBRARY_PATH`.
6060
6061 Cargo
6062 -----
6063
6064 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6065   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6066 * [The `rerun-if-changed` build script directive no longer causes the
6067   build script to incorrectly run twice in certain scenarios][1.7rr].
6068
6069 Compatibility Notes
6070 -------------------
6071
6072 * Soundness fixes to the interactions between associated types and
6073   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6074   code that violates the new rules. This is a significant change that
6075   is known to break existing code, so it has emitted warnings for the
6076   new error cases since 1.4 to give crate authors time to adapt. The
6077   details of what is changing are subtle; read the RFC for more.
6078 * [Several bugs in the compiler's visibility calculations were
6079   fixed][1.7v]. Since this was found to break significant amounts of
6080   code, the new errors will be emitted as warnings for several release
6081   cycles, under the `private_in_public` lint.
6082 * Defaulted type parameters were accidentally accepted in positions
6083   that were not intended. In this release, [defaulted type parameters
6084   appearing outside of type definitions will generate a
6085   warning][1.7d], which will become an error in future releases.
6086 * [Parsing "." as a float results in an error instead of 0][1.7p].
6087   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6088 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6089
6090 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6091 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6092 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6093 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6094 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6095 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6096 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6097 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6098 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6099 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6100 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6101 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6102 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6103 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6104 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6105 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6106 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6107 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6108 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6109 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6110 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6111 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6112 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6113 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6114 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6115 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6116 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6117 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6118 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6119 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6120 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6121 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6122 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6123 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6124 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6125 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6126 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6127 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6128 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6129 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6130 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6131 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6132 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6133 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6134 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6135 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6136 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6137 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6138 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6139 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6140 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6141 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6142 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6143 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6144 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6145 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6146 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6147 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6148 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6149 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6150 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6151 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6152 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6153 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6154 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6155 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6156 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6157 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6158 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6159 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6160 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6161 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6162 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6163 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6164 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6165 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6166 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6167 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6168 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6169
6170
6171 Version 1.6.0 (2016-01-21)
6172 ==========================
6173
6174 Language
6175 --------
6176
6177 * The `#![no_std]` attribute causes a crate to not be linked to the
6178   standard library, but only the [core library][1.6co], as described
6179   in [RFC 1184]. The core library defines common types and traits but
6180   has no platform dependencies whatsoever, and is the basis for Rust
6181   software in environments that cannot support a full port of the
6182   standard library, such as operating systems. Most of the core
6183   library is now stable.
6184
6185 Libraries
6186 ---------
6187
6188 * Stabilized APIs:
6189   [`Read::read_exact`],
6190   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6191   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6192   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6193   [`os::unix::fs::DirBuilderExt`],
6194   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6195   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6196   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6197   [`collections::hash_map::Drain`],
6198   [`collections::hash_map::HashMap::drain`],
6199   [`collections::hash_set::Drain`],
6200   [`collections::hash_set::HashSet::drain`],
6201   [`collections::binary_heap::Drain`],
6202   [`collections::binary_heap::BinaryHeap::drain`],
6203   [`Vec::extend_from_slice`] (renamed from `push_all`),
6204   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6205   [`RwLock::into_inner`],
6206   [`Iterator::min_by_key`] (renamed from `min_by`),
6207   [`Iterator::max_by_key`] (renamed from `max_by`).
6208 * The [core library][1.6co] is stable, as are most of its APIs.
6209 * [The `assert_eq!` macro supports arguments that don't implement
6210   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6211   `assert!`.
6212 * Several timer functions that take duration in milliseconds [are
6213   deprecated in favor of those that take `Duration`][1.6ms]. These
6214   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6215   `thread::park_timeout_ms`.
6216 * The algorithm by which `Vec` reserves additional elements was
6217   [tweaked to not allocate excessive space][1.6a] while still growing
6218   exponentially.
6219 * `From` conversions are [implemented from integers to floats][1.6f]
6220   in cases where the conversion is lossless. Thus they are not
6221   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6222   or `f64`. They are also not implemented for `isize` and `usize`
6223   because the implementations would be platform-specific. `From` is
6224   also implemented from `f32` to `f64`.
6225 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6226 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6227 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6228 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6229   improvements.
6230 * Sorting slices that are already sorted [is 50% faster in some
6231   cases][1.6s].
6232
6233 Cargo
6234 -----
6235
6236 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6237 * Cargo build scripts can specify their dependencies by emitting the
6238   [`rerun-if-changed`][1.6rr] key.
6239 * crates.io will reject publication of crates with dependencies that
6240   have a wildcard version constraint. Crates with wildcard
6241   dependencies were seen to cause a variety of problems, as described
6242   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6243   warning.
6244 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6245   release folder.  A variety of artifacts that Cargo failed to clean
6246   are now correctly deleted.
6247
6248 Misc
6249 ----
6250
6251 * The `unreachable_code` lint [warns when a function call's argument
6252   diverges][1.6dv].
6253 * The parser indicates [failures that may be caused by
6254   confusingly-similar Unicode characters][1.6uc]
6255 * Certain macro errors [are reported at definition time][1.6m], not
6256   expansion.
6257
6258 Compatibility Notes
6259 -------------------
6260
6261 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6262   environment variable when locating crates. This was a pre-cargo
6263   feature for integrating with the package manager that was
6264   accidentally never removed.
6265 * [A number of bugs were fixed in the privacy checker][1.6p] that
6266   could cause previously-accepted code to break.
6267 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6268 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6269   struct pattern syntax (`Foo(..)`) can no longer be used to match
6270   unit structs. This is a warning now, but will become an error in
6271   future releases. Patterns that share the same name as a const are
6272   now an error.
6273 * A bug was fixed that causes [rustc not to apply default type
6274   parameters][1.6xc] when resolving certain method implementations of
6275   traits defined in other crates.
6276
6277 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6278 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6279 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6280 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6281 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6282 [1.6co]: http://doc.rust-lang.org/core/index.html
6283 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6284 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6285 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6286 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6287 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6288 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6289 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6290 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6291 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6292 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6293 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6294 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6295 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6296 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6297 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6298 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6299 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6300 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6301 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6302 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6303 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6304 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6305 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6306 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6307 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6308 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6309 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6310 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6311 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6312 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6313 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6314 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6315 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6316 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6317 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6318 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6319 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6320 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6321 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6322 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6323 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6324
6325
6326 Version 1.5.0 (2015-12-10)
6327 ==========================
6328
6329 * ~700 changes, numerous bugfixes
6330
6331 Highlights
6332 ----------
6333
6334 * Stabilized APIs:
6335   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6336   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6337   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6338   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6339   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6340   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6341   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6342   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6343   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6344   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6345   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6346   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6347   [`Path::read_link`], [`Path::symlink_metadata`],
6348   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6349   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6350   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6351   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6352   [`slice::split_first_mut`], [`slice::split_first`],
6353   [`slice::split_last_mut`], [`slice::split_last`],
6354   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6355   [`str::MatchIndices`], [`str::RMatchIndices`],
6356   [`str::match_indices`], [`str::rmatch_indices`],
6357   [`str::slice_mut_unchecked`], [`string::ParseError`].
6358 * Rust applications hosted on crates.io can be installed locally to
6359   `~/.cargo/bin` with the [`cargo install`] command. Among other
6360   things this makes it easier to augment Cargo with new subcommands:
6361   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6362   invoked as `cargo foo`.
6363 * Crates with wildcard (`*`) dependencies will [emit warnings when
6364   published][1.5w]. In 1.6 it will no longer be possible to publish
6365   crates with wildcard dependencies.
6366
6367 Breaking Changes
6368 ----------------
6369
6370 * The rules determining when a particular lifetime must outlive
6371   a particular value (known as '[dropck]') have been [modified
6372   to not rely on parametricity][1.5p].
6373 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6374   and `Arc`][1.5a]. Because these smart pointer types implement
6375   `Deref`, this causes breakage in cases where the interior type
6376   contains methods of the same name.
6377 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6378   that they could drop their content. Soundness fix.
6379 * All method invocations are [properly checked][1.5wf1] for
6380   [well-formedness][1.5wf2]. Soundness fix.
6381 * Traits whose supertraits contain `Self` are [not object
6382   safe][1.5o]. Soundness fix.
6383 * Target specifications support a [`no_default_libraries`][1.5nd]
6384   setting that controls whether `-nodefaultlibs` is passed to the
6385   linker, and in turn the `is_like_windows` setting no longer affects
6386   the `-nodefaultlibs` flag.
6387 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6388 * The `#[inline]` and `#[repr]` attributes [can only appear
6389   in valid locations][1.5at].
6390 * Native libraries linked from the local crate are [passed to
6391   the linker before native libraries from upstream crates][1.5nl].
6392 * Two rarely-used attributes, `#[no_debug]` and
6393   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6394 * Negation of unsigned integers, which has been a warning for
6395   several releases, [is now behind a feature gate and will
6396   generate errors][1.5nu].
6397 * The parser accidentally accepted visibility modifiers on
6398   enum variants, a bug [which has been fixed][1.5ev].
6399 * [A bug was fixed that allowed `use` statements to import unstable
6400   features][1.5use].
6401
6402 Language
6403 --------
6404
6405 * When evaluating expressions at compile-time that are not
6406   compile-time constants (const-evaluating expressions in non-const
6407   contexts), incorrect code such as overlong bitshifts and arithmetic
6408   overflow will [generate a warning instead of an error][1.5ce],
6409   delaying the error until runtime. This will allow the
6410   const-evaluator to be expanded in the future backwards-compatibly.
6411 * The `improper_ctypes` lint [no longer warns about using `isize` and
6412   `usize` in FFI][1.5ict].
6413
6414 Libraries
6415 ---------
6416
6417 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6418   invariant][1.5c].
6419 * `Default` is [implemented for mutable slices][1.5d].
6420 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6421 * There are now `From` conversions [between floating point
6422   types][1.5f] where the conversions are lossless.
6423 * There are now `From` conversions [between integer types][1.5i] where
6424   the conversions are lossless.
6425 * [`fs::Metadata` implements `Clone`][1.5fs].
6426 * The `parse` method [accepts a leading "+" when parsing
6427   integers][1.5pi].
6428 * [`AsMut` is implemented for `Vec`][1.5am].
6429 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6430   been optimized][1.5cf] and no longer rely on the default impl.
6431 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6432   `unsafe extern "C"` function types now [implement `Clone`,
6433   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6434   `fmt::Debug` for up to 12 arguments][1.5fp].
6435 * [Dropping `Vec`s is much faster in unoptimized builds when the
6436   element types don't implement `Drop`][1.5dv].
6437 * A bug that caused in incorrect behavior when [combining `VecDeque`
6438   with zero-sized types][1.5vdz] was resolved.
6439 * [`PartialOrd` for slices is faster][1.5po].
6440
6441 Miscellaneous
6442 -------------
6443
6444 * [Crate metadata size was reduced by 20%][1.5md].
6445 * [Improvements to code generation reduced the size of libcore by 3.3
6446   MB and rustc's memory usage by 18MB][1.5m].
6447 * [Improvements to deref translation increased performance in
6448   unoptimized builds][1.5dr].
6449 * Various errors in trait resolution [are deduplicated to only be
6450   reported once][1.5te].
6451 * Rust has preliminary [support for rumprun kernels][1.5rr].
6452 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6453
6454 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6455 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6456 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6457 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6458 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6459 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6460 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6461 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6462 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6463 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6464 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6465 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6466 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6467 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6468 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6469 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6470 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6471 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6472 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6473 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6474 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6475 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6476 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6477 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6478 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6479 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6480 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6481 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6482 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6483 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6484 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6485 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6486 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6487 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6488 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6489 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6490 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6491 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6492 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6493 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6494 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6495 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6496 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6497 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6498 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6499 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6500 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6501 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6502 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6503 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6504 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6505 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6506 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6507 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6508 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6509 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6510 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6511 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6512 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6513 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6514 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6515 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6516 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6517 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6518 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6519 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6520 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6521 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6522 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6523 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6524 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6525 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6526 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6527 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6528 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6529 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6530 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6531 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6532 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6533 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6534 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6535 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6536 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6537 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6538 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6539 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6540 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6541 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6542 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6543
6544 Version 1.4.0 (2015-10-29)
6545 ==========================
6546
6547 * ~1200 changes, numerous bugfixes
6548
6549 Highlights
6550 ----------
6551
6552 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6553   GNU) are now supported and recommended for use.
6554
6555 Breaking Changes
6556 ----------------
6557
6558 * [Several changes have been made to fix type soundness and improve
6559   the behavior of associated types][sound]. See [RFC 1214]. Although
6560   we have mostly introduced these changes as warnings this release, to
6561   become errors next release, there are still some scenarios that will
6562   see immediate breakage.
6563 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6564   line breaks in addition to `\n`][crlf].
6565 * [Loans of `'static` lifetime extend to the end of a function][stat].
6566 * [`str::parse` no longer introduces avoidable rounding error when
6567   parsing floating point numbers. Together with earlier changes to
6568   float formatting/output, "round trips" like f.to_string().parse()
6569   now preserve the value of f exactly. Additionally, leading plus
6570   signs are now accepted][fp3].
6571
6572
6573 Language
6574 --------
6575
6576 * `use` statements that import multiple items [can now rename
6577   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6578 * [Binops work correctly on fat pointers][binfat].
6579 * `pub extern crate`, which does not behave as expected, [issues a
6580   warning][pec] until a better solution is found.
6581
6582 Libraries
6583 ---------
6584
6585 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6586   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6587   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6588   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6589   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6590   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6591   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6592   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6593   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6594   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6595   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6596   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6597   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6598   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6599   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6600   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6601   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6602   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6603   [`thread::sleep`].
6604 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6605   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6606   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6607   `f64::from_str_radix`.
6608 * [Reverse-searching strings is faster with the 'two-way'
6609   algorithm][s].
6610 * [`std::io::copy` allows `?Sized` arguments][cc].
6611 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6612   [override `count`, `nth` and `last` with an O(1)
6613   implementation][it].
6614 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6615 * [`IntoRawFd` has been added to the Unix-specific prelude,
6616   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6617   prelude][pr].
6618 * [`Extend<String>` and `FromIterator<String` are both implemented for
6619   `String`][es].
6620 * [`IntoIterator` is implemented for references to `Option` and
6621   `Result`][into2].
6622 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6623   Copy`][ext] as part of [RFC 839]. This will cause type inference
6624   breakage in rare situations.
6625 * [`BinaryHeap` implements `Debug`][bh2].
6626 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6627   arrays][bm].
6628 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6629   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6630 * [String comparison is faster][faststr].
6631 * `&mut T` where `T: std::fmt::Write` [also implements
6632   `std::fmt::Write`][mutw].
6633 * [A stable regression in `VecDeque::push_back` and other
6634   capacity-altering methods that caused panics for zero-sized types
6635   was fixed][vd].
6636 * [Function pointers implement traits for up to 12 parameters][fp2].
6637
6638 Miscellaneous
6639 -------------
6640
6641 * The compiler [no longer uses the 'morestack' feature to prevent
6642   stack overflow][mm]. Instead it uses guard pages and stack
6643   probes (though stack probes are not yet implemented on any platform
6644   but Windows).
6645 * [The compiler matches traits faster when projections are involved][p].
6646 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6647   `usize`][ffi].
6648 * [Cargo now displays useful information about what its doing during
6649   `cargo update`][cu].
6650
6651 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6652 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6653 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6654 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6655 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6656 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6657 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6658 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6659 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6660 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6661 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6662 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6663 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6664 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6665 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6666 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6667 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6668 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6669 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6670 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6671 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6672 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6673 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6674 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6675 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6676 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6677 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6678 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6679 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6680 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6681 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6682 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6683 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6684 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6685 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6686 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6687 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6688 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6689 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6690 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6691 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6692 [bh2]: https://github.com/rust-lang/rust/pull/28156
6693 [binfat]: https://github.com/rust-lang/rust/pull/28270
6694 [bm]: https://github.com/rust-lang/rust/pull/28197
6695 [cc]: https://github.com/rust-lang/rust/pull/27531
6696 [crlf]: https://github.com/rust-lang/rust/pull/28034
6697 [cu]: https://github.com/rust-lang/cargo/pull/1931
6698 [d]: https://github.com/rust-lang/rust/pull/27825
6699 [dep]: https://github.com/rust-lang/rust/pull/28339
6700 [es]: https://github.com/rust-lang/rust/pull/27956
6701 [ext]: https://github.com/rust-lang/rust/pull/28094
6702 [faststr]: https://github.com/rust-lang/rust/pull/28338
6703 [ffi]: https://github.com/rust-lang/rust/pull/28779
6704 [fp]: https://github.com/rust-lang/rust/pull/28268
6705 [fp2]: https://github.com/rust-lang/rust/pull/28560
6706 [fp3]: https://github.com/rust-lang/rust/pull/27307
6707 [i]: https://github.com/rust-lang/rust/pull/27451
6708 [into2]: https://github.com/rust-lang/rust/pull/28039
6709 [it]: https://github.com/rust-lang/rust/pull/27652
6710 [mm]: https://github.com/rust-lang/rust/pull/27338
6711 [mutw]: https://github.com/rust-lang/rust/pull/28368
6712 [sound]: https://github.com/rust-lang/rust/pull/27641
6713 [p]: https://github.com/rust-lang/rust/pull/27866
6714 [pec]: https://github.com/rust-lang/rust/pull/28486
6715 [pr]: https://github.com/rust-lang/rust/pull/27896
6716 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6717 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6718 [s]: https://github.com/rust-lang/rust/pull/27474
6719 [stab]: https://github.com/rust-lang/rust/pull/28339
6720 [stat]: https://github.com/rust-lang/rust/pull/28321
6721 [vd]: https://github.com/rust-lang/rust/pull/28494
6722
6723 Version 1.3.0 (2015-09-17)
6724 ==============================
6725
6726 * ~900 changes, numerous bugfixes
6727
6728 Highlights
6729 ----------
6730
6731 * The [new object lifetime defaults][nold] have been [turned
6732   on][nold2] after a cycle of warnings about the change. Now types
6733   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6734   being interpreted as `&'a Box<Trait+'a>` to `&'a
6735   Box<Trait+'static>`.
6736 * [The Rustonomicon][nom] is a new book in the official documentation
6737   that dives into writing unsafe Rust.
6738 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6739   timekeeping is employed by other std APIs, as well as out-of-tree
6740   time crates.
6741
6742 Breaking Changes
6743 ----------------
6744
6745 * The [new object lifetime defaults][nold] have been [turned
6746   on][nold2] after a cycle of warnings about the change.
6747 * There is a known [regression][lr] in how object lifetime elision is
6748   interpreted, the proper solution for which is undetermined.
6749 * The `#[prelude_import]` attribute, an internal implementation
6750   detail, was accidentally stabilized previously. [It has been put
6751   behind the `prelude_import` feature gate][pi]. This change is
6752   believed to break no existing code.
6753 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6754   [more sane for dynamically sized types][dst3]. Code that relied on
6755   the previous behavior is thought to be broken.
6756 * The `dropck` rules, which checks that destructors can't access
6757   destroyed values, [have been updated][dropck] to match the
6758   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6759   cause some previously-compiling code to no longer build.
6760
6761 Language
6762 --------
6763
6764 * The [new object lifetime defaults][nold] have been [turned
6765   on][nold2] after a cycle of warnings about the change.
6766 * Semicolons may [now follow types and paths in
6767   macros](https://github.com/rust-lang/rust/pull/27000).
6768 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6769   [more sane for dynamically sized types][dst3]. Code that relied on
6770   the previous behavior is not known to exist, and suspected to be
6771   broken.
6772 * `'static` variables [may now be recursive][st].
6773 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6774   implementations correctly.
6775 * The `dropck` rules, which checks that destructors can't access
6776   destroyed values, [have been updated][dropck] to match the
6777   [RFC][dropckrfc].
6778
6779 Libraries
6780 ---------
6781
6782 * The [`Duration`] API, [has been stabilized][ds], as well as the
6783   `std::time` module, which presently contains only `Duration`.
6784 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6785 * The owned C string, [`CString`], implements [`Borrow`] and the
6786   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6787   these allow C strings to be borrowed and cloned in generic code.
6788 * [`CStr`] implements [`Debug`].
6789 * [`AtomicPtr`] implements [`Debug`].
6790 * [`Error`] trait objects [can be downcast to their concrete types][e]
6791   in many common configurations, using the [`is`], [`downcast`],
6792   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6793   [`Any`] trait.
6794 * Searching for substrings now [employs the two-way algorithm][search]
6795   instead of doing a naive search. This gives major speedups to a
6796   number of methods, including [`contains`][sc], [`find`][sf],
6797   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6798   [`ends_with`][sew] are also faster.
6799 * The performance of `PartialEq` for slices is [much faster][ps].
6800 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6801   is overridden and optimized by the implementations for scalars.
6802 * The [`Hasher`] trait now has a number of specialized `write_*`
6803   methods for primitive types, for efficiency.
6804 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6805   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6806   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6807   of [`std::error::Error::cause`][iec] also delegates to the inner
6808   error.
6809 * [`process::Child`][pc] gained the [`id`] method, which returns a
6810   `u32` representing the platform-specific process identifier.
6811 * The [`connect`] method on slices is deprecated, replaced by the new
6812   [`join`] method (note that both of these are on the *unstable*
6813   [`SliceConcatExt`] trait, but through the magic of the prelude are
6814   available to stable code anyway).
6815 * The [`Div`] operator is implemented for [`Wrapping`] types.
6816 * [`DerefMut` is implemented for `String`][dms].
6817 * Performance of SipHash (the default hasher for `HashMap`) is
6818   [better for long data][sh].
6819 * [`AtomicPtr`] implements [`Send`].
6820 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6821   are now [specialized to use uninitialized buffers for increased
6822   performance][rte].
6823 * Lifetime parameters of foreign functions [are now resolved
6824   properly][f].
6825
6826 Misc
6827 ----
6828
6829 * Rust can now, with some coercion, [produce programs that run on
6830   Windows XP][xp], though XP is not considered a supported platform.
6831 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6832   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6833   recommended for use in 1.3, though should be fully-functional
6834   in the [64-bit 1.4 beta][b14].
6835 * On Fedora-based systems installation will [properly configure the
6836   dynamic linker][fl].
6837 * The compiler gained many new extended error descriptions, which can
6838   be accessed with the `--explain` flag.
6839 * The `dropck` pass, which checks that destructors can't access
6840   destroyed values, [has been rewritten][dropck]. This fixes some
6841   soundness holes, and as such will cause some previously-compiling
6842   code to no longer build.
6843 * `rustc` now uses [LLVM to write archive files where possible][ar].
6844   Eventually this will eliminate the compiler's dependency on the ar
6845   utility.
6846 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6847   supported FreeBSD on x86_64).
6848 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6849   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6850   more strict.
6851 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6852   will kill the process instead of leaking][nlp].
6853
6854 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6855 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6856 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6857 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6858 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6859 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6860 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6861 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6862 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6863 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6864 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6865 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6866 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6867 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6868 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6869 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6870 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6871 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6872 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6873 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6874 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6875 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6876 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6877 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6878 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6879 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6880 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6881 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6882 [ar]: https://github.com/rust-lang/rust/pull/26926
6883 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6884 [dms]: https://github.com/rust-lang/rust/pull/26241
6885 [dropck]: https://github.com/rust-lang/rust/pull/27261
6886 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6887 [ds]: https://github.com/rust-lang/rust/pull/26818
6888 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6889 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6890 [dst3]: https://github.com/rust-lang/rust/pull/27351
6891 [e]: https://github.com/rust-lang/rust/pull/24793
6892 [f]: https://github.com/rust-lang/rust/pull/26588
6893 [fb]: https://github.com/rust-lang/rust/pull/26959
6894 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6895 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6896 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6897 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6898 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6899 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6900 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6901 [lic]: https://github.com/rust-lang/rust/pull/26583
6902 [lnu]: https://github.com/rust-lang/rust/pull/27026
6903 [lr]: https://github.com/rust-lang/rust/issues/27248
6904 [lum]: https://github.com/rust-lang/rust/pull/26378
6905 [lur]: https://github.com/rust-lang/rust/pull/26783
6906 [nlp]: https://github.com/rust-lang/rust/pull/27176
6907 [nold2]: https://github.com/rust-lang/rust/pull/27045
6908 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6909 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6910 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6911 [pi]: https://github.com/rust-lang/rust/pull/26699
6912 [ps]: https://github.com/rust-lang/rust/pull/26884
6913 [rte]: https://github.com/rust-lang/rust/pull/26950
6914 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6915 [search]: https://github.com/rust-lang/rust/pull/26327
6916 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6917 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6918 [sh]: https://github.com/rust-lang/rust/pull/27280
6919 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6920 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6921 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6922 [st]: https://github.com/rust-lang/rust/pull/26630
6923 [win1]: https://github.com/rust-lang/rust/pull/26569
6924 [win2]: https://github.com/rust-lang/rust/pull/26741
6925 [win3]: https://github.com/rust-lang/rust/pull/26741
6926 [win4]: https://github.com/rust-lang/rust/pull/27210
6927 [xp]: https://github.com/rust-lang/rust/pull/26569
6928
6929 Version 1.2.0 (2015-08-07)
6930 ==========================
6931
6932 * ~1200 changes, numerous bugfixes
6933
6934 Highlights
6935 ----------
6936
6937 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6938   like `Rc` to contain types without a fixed size, arrays and trait
6939   objects, finally enabling use of `Rc<[T]>` and completing the
6940   implementation of DST.
6941 * [Parallel codegen][parcodegen] is now working again, which can
6942   substantially speed up large builds in debug mode; It also gets
6943   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6944   jobs). It's not enabled by default, but will be "in the near
6945   future". It can be activated with the `-C codegen-units=N` flag to
6946   `rustc`.
6947 * This is the first release with [experimental support for linking
6948   with the MSVC linker and lib C on Windows (instead of using the GNU
6949   variants via MinGW)][win]. It is yet recommended only for the most
6950   intrepid Rustaceans.
6951 * Benchmark compilations are showing a 30% improvement in
6952   bootstrapping over 1.1.
6953
6954 Breaking Changes
6955 ----------------
6956
6957 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6958   unicode case mapping, which is a previously-planned change in
6959   behavior and considered a bugfix.
6960 * [`mem::align_of`] now specifies [the *minimum alignment* for
6961   T][align], which is usually the alignment programs are interested
6962   in, and the same value reported by clang's
6963   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6964   break real code.
6965 * [The `#[packed]` attribute is no longer silently accepted by the
6966   compiler][packed]. This attribute did nothing and code that
6967   mentioned it likely did not work as intended.
6968 * Associated type defaults are [now behind the
6969   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6970   defaults *did not work*, but could be mentioned syntactically. As
6971   such this breakage has minimal impact.
6972
6973 Language
6974 --------
6975
6976 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6977   matching against dereferenceable values.
6978
6979 Libraries
6980 ---------
6981
6982 * The [`Extend`] trait, which grows a collection from an iterator, is
6983   implemented over iterators of references, for `String`, `Vec`,
6984   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6985   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6986 * The [`iter::once`] function returns an iterator that yields a single
6987   element, and [`iter::empty`] returns an iterator that yields no
6988   elements.
6989 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6990   over substring matches.
6991 * [`Cell`] and [`RefCell`] both implement `Eq`.
6992 * A number of methods for wrapping arithmetic are added to the
6993   integral types, [`wrapping_div`], [`wrapping_rem`],
6994   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6995   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6996   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6997   type.. It is illegal for the default arithmetic operations in Rust
6998   to overflow; the desire to wrap must be explicit.
6999 * The `{:#?}` formatting specifier [displays the alternate,
7000   pretty-printed][debugfmt] form of the `Debug` formatter. This
7001   feature was actually introduced prior to 1.0 with little
7002   fanfare.
7003 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7004   for writing data to formatted strings, similar to [`io::Write`].
7005 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7006   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7007   are used by code generators to emit implementations of [`Debug`].
7008 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7009   methods that convert case, following Unicode case mapping.
7010 * It is now easier to handle poisoned locks. The [`PoisonError`]
7011   type, returned by failing lock operations, exposes `into_inner`,
7012   `get_ref`, and `get_mut`, which all give access to the inner lock
7013   guard, and allow the poisoned lock to continue to operate. The
7014   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7015   poisoned lock without attempting to take the lock.
7016 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7017   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7018   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7019   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7020   `ChildStderr`.
7021 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7022   malformed input.
7023
7024 Misc
7025 ----
7026
7027 * `rustc` employs smarter heuristics for guessing at [typos].
7028 * `rustc` emits more efficient code for [no-op conversions between
7029   unsafe pointers][nop].
7030 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7031   resulting in faster compile times and smaller code.
7032
7033 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7034 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7035 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7036 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7037 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7038 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7039 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7040 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7041 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7042 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7043 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7044 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7045 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7046 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7047 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7048 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7049 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7050 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7051 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7052 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7053 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7054 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7055 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7056 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7057 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7058 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7059 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7060 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7061 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7062 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7063 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7064 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7065 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7066 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7067 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7068 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7069 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7070 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7071 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7072 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7073 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7074 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7075 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7076 [align]: https://github.com/rust-lang/rust/pull/25646
7077 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7078 [typos]: https://github.com/rust-lang/rust/pull/26087
7079 [nop]: https://github.com/rust-lang/rust/pull/26336
7080 [fat]: https://github.com/rust-lang/rust/pull/26411
7081 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7082 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7083 [packed]: https://github.com/rust-lang/rust/pull/25541
7084 [ad]: https://github.com/rust-lang/rust/pull/27382
7085 [win]: https://github.com/rust-lang/rust/pull/25350
7086
7087 Version 1.1.0 (2015-06-25)
7088 =========================
7089
7090 * ~850 changes, numerous bugfixes
7091
7092 Highlights
7093 ----------
7094
7095 * The [`std::fs` module has been expanded][fs] to expand the set of
7096   functionality exposed:
7097   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7098     don't incur a syscall on some platforms.
7099   * A `symlink_metadata` function has been added.
7100   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7101     access to all underlying information.
7102 * The compiler now contains extended explanations of many errors. When an error
7103   with an explanation occurs the compiler suggests using the `--explain` flag
7104   to read the explanation. Error explanations are also [available online][err-index].
7105 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7106   well as other work, the time to bootstrap the compiler decreased by
7107   32%.
7108
7109 Libraries
7110 ---------
7111
7112 * The [`str::split_whitespace`] method splits a string on unicode
7113   whitespace boundaries.
7114 * On both Windows and Unix, new extension traits provide conversion of
7115   I/O types to and from the underlying system handles. On Unix, these
7116   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7117   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7118   `TcpListener`, and `UpdSocket`. Further implementations for
7119   `std::process` will be stabilized later.
7120 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7121   Windows, symlinks can be created with
7122   `std::os::windows::symlink_dir` and
7123   `std::os::windows::symlink_file`.
7124 * The `mpsc::Receiver` type can now be converted into an iterator with
7125   `into_iter` on the [`IntoIterator`] trait.
7126 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7127   implementation of the [`From`] trait.
7128 * The `Debug` implementation for `RangeFull` [creates output that is
7129   more consistent with other implementations][rf].
7130 * [`Debug` is implemented for `File`][file].
7131 * The `Default` implementation for `Arc` [no longer requires `Sync +
7132   Send`][arc].
7133 * [The `Iterator` methods `count`, `nth`, and `last` have been
7134   overridden for slices to have O(1) performance instead of O(n)][si].
7135 * Incorrect handling of paths on Windows has been improved in both the
7136   compiler and the standard library.
7137 * [`AtomicPtr` gained a `Default` implementation][ap].
7138 * In accordance with Rust's policy on arithmetic overflow `abs` now
7139   [panics on overflow when debug assertions are enabled][abs].
7140 * The [`Cloned`] iterator, which was accidentally left unstable for
7141   1.0 [has been stabilized][c].
7142 * The [`Incoming`] iterator, which iterates over incoming TCP
7143   connections, and which was accidentally unnamable in 1.0, [is now
7144   properly exported][inc].
7145 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7146   `sift_up` or `sift_down` panic][bh].
7147 * The [`split_off`] method of `LinkedList` [no longer corrupts
7148   the list in certain scenarios][ll].
7149
7150 Misc
7151 ----
7152
7153 * Type checking performance [has improved notably][sk] with
7154   [multiple improvements][pre].
7155 * The compiler [suggests code changes][ch] for more errors.
7156 * rustc and it's build system have experimental support for [building
7157   toolchains against MUSL][m] instead of glibc on Linux.
7158 * The compiler defines the `target_env` cfg value, which is used for
7159   distinguishing toolchains that are otherwise for the same
7160   platform. Presently this is set to `gnu` for common GNU Linux
7161   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7162 * The [`cargo rustc`][crc] command invokes a build with custom flags
7163   to rustc.
7164 * [Android executables are always position independent][pie].
7165 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7166   with `Drop`][drop].
7167
7168 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7169 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7170 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7171 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7172 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7173 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7174 [rf]: https://github.com/rust-lang/rust/pull/24491
7175 [err-index]: https://doc.rust-lang.org/error-index.html
7176 [sk]: https://github.com/rust-lang/rust/pull/24615
7177 [pre]: https://github.com/rust-lang/rust/pull/25323
7178 [file]: https://github.com/rust-lang/rust/pull/24598
7179 [ch]: https://github.com/rust-lang/rust/pull/24683
7180 [arc]: https://github.com/rust-lang/rust/pull/24695
7181 [si]: https://github.com/rust-lang/rust/pull/24701
7182 [ap]: https://github.com/rust-lang/rust/pull/24834
7183 [m]: https://github.com/rust-lang/rust/pull/24777
7184 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7185 [crc]: https://github.com/rust-lang/cargo/pull/1568
7186 [pie]: https://github.com/rust-lang/rust/pull/24953
7187 [abs]: https://github.com/rust-lang/rust/pull/25441
7188 [c]: https://github.com/rust-lang/rust/pull/25496
7189 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7190 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7191 [inc]: https://github.com/rust-lang/rust/pull/25522
7192 [bh]: https://github.com/rust-lang/rust/pull/25856
7193 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7194 [ll]: https://github.com/rust-lang/rust/pull/26022
7195 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7196 [drop]: https://github.com/rust-lang/rust/pull/24935
7197
7198 Version 1.0.0 (2015-05-15)
7199 ========================
7200
7201 * ~1500 changes, numerous bugfixes
7202
7203 Highlights
7204 ----------
7205
7206 * The vast majority of the standard library is now `#[stable]`. It is
7207   no longer possible to use unstable features with a stable build of
7208   the compiler.
7209 * Many popular crates on [crates.io] now work on the stable release
7210   channel.
7211 * Arithmetic on basic integer types now [checks for overflow in debug
7212   builds][overflow].
7213
7214 Language
7215 --------
7216
7217 * Several [restrictions have been added to trait coherence][coh] in
7218   order to make it easier for upstream authors to change traits
7219   without breaking downstream code.
7220 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7221   improve error messages and macro behavior. For example, `0b1234` is
7222   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7223 * Trait bounds [are always invariant][inv], eliminating the need for
7224   the `PhantomFn` and `MarkerTrait` lang items, which have been
7225   removed.
7226 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7227   "foo" as bar` syntax has been replaced with `extern crate foo as
7228   bar`, and Cargo now automatically translates "-" in *package* names
7229   to underscore for the crate name.
7230 * [Lifetime shadowing is an error][lt].
7231 * [`Send` no longer implies `'static`][send-rfc].
7232 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7233   `MyType::default()`.
7234 * Primitive types [now have inherent methods][prim-inherent],
7235   obviating the need for extension traits like `SliceExt`.
7236 * Methods with `Self: Sized` in their `where` clause are [considered
7237   object-safe][self-sized], allowing many extension traits like
7238   `IteratorExt` to be merged into the traits they extended.
7239 * You can now [refer to associated types][assoc-where] whose
7240   corresponding trait bounds appear only in a `where` clause.
7241 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7242   like `Send` and `Sync` are now library-defined.
7243 * A [Reflect trait][reflect] was introduced, which means that
7244   downcasting via the `Any` trait is effectively limited to concrete
7245   types. This helps retain the potentially-important "parametricity"
7246   property: generic code cannot behave differently for different type
7247   arguments except in minor ways.
7248 * The `unsafe_destructor` feature is now deprecated in favor of the
7249   [new `dropck`][dropck]. This change is a major reduction in unsafe
7250   code.
7251
7252 Libraries
7253 ---------
7254
7255 * The `thread_local` module [has been renamed to `std::thread`][th].
7256 * The methods of `IteratorExt` [have been moved to the `Iterator`
7257   trait itself][ie].
7258 * Several traits that implement Rust's conventions for type
7259   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7260   [centralized in the `std::convert` module][con].
7261 * The `FromError` trait [was removed in favor of `From`][fe].
7262 * The basic sleep function [has moved to
7263   `std::thread::sleep_ms`][slp].
7264 * The `splitn` function now takes an `n` parameter that represents the
7265   number of items yielded by the returned iterator [instead of the
7266   number of 'splits'][spl].
7267 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7268 * [Derived implementations of `PartialOrd` now order enums according
7269   to their explicitly-assigned discriminants][po].
7270 * [Methods for searching strings are generic over `Pattern`s][pat],
7271   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7272   some others.
7273 * [In method resolution, object methods are resolved before inherent
7274   methods][meth].
7275 * [`String::from_str` has been deprecated in favor of the `From` impl,
7276   `String::from`][sf].
7277 * [`io::Error` implements `Sync`][ios].
7278 * [The `words` method on `&str` has been replaced with
7279   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7280   a word?'
7281 * The new path and IO modules are complete and `#[stable]`. This
7282   was the major library focus for this cycle.
7283 * The path API was [revised][path-normalize] to normalize `.`,
7284   adjusting the tradeoffs in favor of the most common usage.
7285 * A large number of remaining APIs in `std` were also stabilized
7286   during this cycle; about 75% of the non-deprecated API surface
7287   is now stable.
7288 * The new [string pattern API][string-pattern] landed, which makes
7289   the string slice API much more internally consistent and flexible.
7290 * A new set of [generic conversion traits][conversion] replaced
7291   many existing ad hoc traits.
7292 * Generic numeric traits were [completely removed][num-traits]. This
7293   was made possible thanks to inherent methods for primitive types,
7294   and the removal gives maximal flexibility for designing a numeric
7295   hierarchy in the future.
7296 * The `Fn` traits are now related via [inheritance][fn-inherit]
7297   and provide ergonomic [blanket implementations][fn-blanket].
7298 * The `Index` and `IndexMut` traits were changed to
7299   [take the index by value][index-value], enabling code like
7300   `hash_map["string"]` to work.
7301 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7302   `Copy` data is known to be `Clone` as well.
7303
7304 Misc
7305 ----
7306
7307 * Many errors now have extended explanations that can be accessed with
7308   the `--explain` flag to `rustc`.
7309 * Many new examples have been added to the standard library
7310   documentation.
7311 * rustdoc has received a number of improvements focused on completion
7312   and polish.
7313 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7314 * Much headway was made on ecosystem-wide CI, making it possible
7315   to [compare builds for breakage][ci-compare].
7316
7317
7318 [crates.io]: http://crates.io
7319 [clo]: https://github.com/rust-lang/rust/pull/24034
7320 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7321 [con]: https://github.com/rust-lang/rust/pull/23875
7322 [cr]: https://github.com/rust-lang/rust/pull/23419
7323 [fe]: https://github.com/rust-lang/rust/pull/23879
7324 [ie]: https://github.com/rust-lang/rust/pull/23300
7325 [inv]: https://github.com/rust-lang/rust/pull/23938
7326 [ios]: https://github.com/rust-lang/rust/pull/24133
7327 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7328 [lt]: https://github.com/rust-lang/rust/pull/24057
7329 [meth]: https://github.com/rust-lang/rust/pull/24056
7330 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7331 [po]: https://github.com/rust-lang/rust/pull/24270
7332 [sf]: https://github.com/rust-lang/rust/pull/24517
7333 [slp]: https://github.com/rust-lang/rust/pull/23949
7334 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7335 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7336 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7337 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7338 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7339 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7340 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7341 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7342 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7343 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7344 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7345 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7346 [reflect]: https://github.com/rust-lang/rust/pull/23712
7347 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7348 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7349 [index-value]: https://github.com/rust-lang/rust/pull/23601
7350 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7351 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7352 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7353 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7354 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7355 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7356
7357
7358 Version 1.0.0-alpha.2 (2015-02-20)
7359 =====================================
7360
7361 * ~1300 changes, numerous bugfixes
7362
7363 * Highlights
7364
7365     * The various I/O modules were [overhauled][io-rfc] to reduce
7366       unnecessary abstractions and provide better interoperation with
7367       the underlying platform. The old `io` module remains temporarily
7368       at `std::old_io`.
7369     * The standard library now [participates in feature gating][feat],
7370       so use of unstable libraries now requires a `#![feature(...)]`
7371       attribute. The impact of this change is [described on the
7372       forum][feat-forum]. [RFC][feat-rfc].
7373
7374 * Language
7375
7376     * `for` loops [now operate on the `IntoIterator` trait][into],
7377       which eliminates the need to call `.iter()`, etc. to iterate
7378       over collections. There are some new subtleties to remember
7379       though regarding what sort of iterators various types yield, in
7380       particular that `for foo in bar { }` yields values from a move
7381       iterator, destroying the original collection. [RFC][into-rfc].
7382     * Objects now have [default lifetime bounds][obj], so you don't
7383       have to write `Box<Trait+'static>` when you don't care about
7384       storing references. [RFC][obj-rfc].
7385     * In types that implement `Drop`, [lifetimes must outlive the
7386       value][drop]. This will soon make it possible to safely
7387       implement `Drop` for types where `#[unsafe_destructor]` is now
7388       required. Read the [gorgeous RFC][drop-rfc] for details.
7389     * The fully qualified <T as Trait>::X syntax lets you set the Self
7390       type for a trait method or associated type. [RFC][ufcs-rfc].
7391     * References to types that implement `Deref<U>` now [automatically
7392       coerce to references][deref] to the dereferenced type `U`,
7393       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7394       should eliminate many unsightly uses of `&*`, as when converting
7395       from references to vectors into references to
7396       slices. [RFC][deref-rfc].
7397     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7398       `|:|`) is obsolete and closure kind is inferred from context.
7399     * [`Self` is a keyword][Self].
7400
7401 * Libraries
7402
7403     * The `Show` and `String` formatting traits [have been
7404       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7405       their related purposes. Automatically getting a string
7406       conversion to use with `format!("{:?}", something_to_debug)` is
7407       now written `#[derive(Debug)]`.
7408     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7409       OsStr}`, provide strings in platform-specific encodings for easier
7410       interop with system APIs. [RFC][osstr-rfc].
7411     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7412       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7413       creating raw pointers.
7414
7415 * Tooling
7416
7417     * Certain long error messages of the form 'expected foo found bar'
7418       are now [split neatly across multiple
7419       lines][multiline]. Examples in the PR.
7420     * On Unix Rust can be [uninstalled][un] by running
7421       `/usr/local/lib/rustlib/uninstall.sh`.
7422     * The `#[rustc_on_unimplemented]` attribute, requiring the
7423       'on_unimplemented' feature, lets rustc [display custom error
7424       messages when a trait is expected to be implemented for a type
7425       but is not][onun].
7426
7427 * Misc
7428
7429     * Rust is tested against a [LALR grammar][lalr], which parses
7430       almost all the Rust files that rustc does.
7431
7432 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7433 [close]: https://github.com/rust-lang/rust/pull/21843
7434 [deref]: https://github.com/rust-lang/rust/pull/21351
7435 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7436 [drop]: https://github.com/rust-lang/rust/pull/21972
7437 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7438 [feat]: https://github.com/rust-lang/rust/pull/21248
7439 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7440 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7441 [fmt]: https://github.com/rust-lang/rust/pull/21457
7442 [into]: https://github.com/rust-lang/rust/pull/20790
7443 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7444 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7445 [lalr]: https://github.com/rust-lang/rust/pull/21452
7446 [multiline]: https://github.com/rust-lang/rust/pull/19870
7447 [obj]: https://github.com/rust-lang/rust/pull/22230
7448 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7449 [onun]: https://github.com/rust-lang/rust/pull/20889
7450 [osstr]: https://github.com/rust-lang/rust/pull/21488
7451 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7452 [Self]: https://github.com/rust-lang/rust/pull/22158
7453 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7454 [un]: https://github.com/rust-lang/rust/pull/22256
7455
7456
7457 Version 1.0.0-alpha (2015-01-09)
7458 ==================================
7459
7460   * ~2400 changes, numerous bugfixes
7461
7462   * Highlights
7463
7464     * The language itself is considered feature complete for 1.0,
7465       though there will be many usability improvements and bugfixes
7466       before the final release.
7467     * Nearly 50% of the public API surface of the standard library has
7468       been declared 'stable'. Those interfaces are unlikely to change
7469       before 1.0.
7470     * The long-running debate over integer types has been
7471       [settled][ints]: Rust will ship with types named `isize` and
7472       `usize`, rather than `int` and `uint`, for pointer-sized
7473       integers. Guidelines will be rolled out during the alpha cycle.
7474     * Most crates that are not `std` have been moved out of the Rust
7475       distribution into the Cargo ecosystem so they can evolve
7476       separately and don't need to be stabilized as quickly, including
7477       'time', 'getopts', 'num', 'regex', and 'term'.
7478     * Documentation continues to be expanded with more API coverage, more
7479       examples, and more in-depth explanations. The guides have been
7480       consolidated into [The Rust Programming Language][trpl].
7481     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7482     * All official Rust binary installers now come with [Cargo], the
7483       Rust package manager.
7484
7485 * Language
7486
7487     * Closures have been [completely redesigned][unboxed] to be
7488       implemented in terms of traits, can now be used as generic type
7489       bounds and thus monomorphized and inlined, or via an opaque
7490       pointer (boxed) as in the old system. The new system is often
7491       referred to as 'unboxed' closures.
7492     * Traits now support [associated types][assoc], allowing families
7493       of related types to be defined together and used generically in
7494       powerful ways.
7495     * Enum variants are [namespaced by their type names][enum].
7496     * [`where` clauses][where] provide a more versatile and attractive
7497       syntax for specifying generic bounds, though the previous syntax
7498       remains valid.
7499     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7500       numeric types.
7501     * Rust [no longer has a runtime][rt] of any description, and only
7502       supports OS threads, not green threads.
7503     * At long last, Rust has been overhauled for 'dynamically-sized
7504       types' ([DST]), which integrates 'fat pointers' (object types,
7505       arrays, and `str`) more deeply into the type system, making it
7506       more consistent.
7507     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7508       `..j` that produce range types and which, when combined with the
7509       `Index` operator and multidispatch, leads to a convenient slice
7510       notation, `[i..j]`.
7511     * The new range syntax revealed an ambiguity in the fixed-length
7512       array syntax, so now fixed length arrays [are written `[T;
7513       N]`][arrays].
7514     * The `Copy` trait is no longer implemented automatically. Unsafe
7515       pointers no longer implement `Sync` and `Send` so types
7516       containing them don't automatically either. `Sync` and `Send`
7517       are now 'unsafe traits' so one can "forcibly" implement them via
7518       `unsafe impl` if a type confirms to the requirements for them
7519       even though the internals do not (e.g. structs containing unsafe
7520       pointers like `Arc`). These changes are intended to prevent some
7521       footguns and are collectively known as [opt-in built-in
7522       traits][oibit] (though `Sync` and `Send` will soon become pure
7523       library types unknown to the compiler).
7524     * Operator traits now take their operands [by value][ops], and
7525       comparison traits can use multidispatch to compare one type
7526       against multiple other types, allowing e.g. `String` to be
7527       compared with `&str`.
7528     * `if let` and `while let` are no longer feature-gated.
7529     * Rust has adopted a more [uniform syntax for escaping unicode
7530       characters][unicode].
7531     * `macro_rules!` [has been declared stable][mac]. Though it is a
7532       flawed system it is sufficiently popular that it must be usable
7533       for 1.0. Effort has gone into [future-proofing][mac-future] it
7534       in ways that will allow other macro systems to be developed in
7535       parallel, and won't otherwise impact the evolution of the
7536       language.
7537     * The prelude has been [pared back significantly][prelude] such
7538       that it is the minimum necessary to support the most pervasive
7539       code patterns, and through [generalized where clauses][where]
7540       many of the prelude extension traits have been consolidated.
7541     * Rust's rudimentary reflection [has been removed][refl], as it
7542       incurred too much code generation for little benefit.
7543     * [Struct variants][structvars] are no longer feature-gated.
7544     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7545       known as 'higher-ranked trait bounds', this crucially allows
7546       unboxed closures to work.
7547     * Macros invocations surrounded by parens or square brackets and
7548       not terminated by a semicolon are [parsed as
7549       expressions][macros], which makes expressions like `vec![1i32,
7550       2, 3].len()` work as expected.
7551     * Trait objects now implement their traits automatically, and
7552       traits that can be coerced to objects now must be [object
7553       safe][objsafe].
7554     * Automatically deriving traits is now done with `#[derive(...)]`
7555       not `#[deriving(...)]` for [consistency with other naming
7556       conventions][derive].
7557     * Importing the containing module or enum at the same time as
7558       items or variants they contain is [now done with `self` instead
7559       of `mod`][self], as in use `foo::{self, bar}`
7560     * Glob imports are no longer feature-gated.
7561     * The `box` operator and `box` patterns have been feature-gated
7562       pending a redesign. For now unique boxes should be allocated
7563       like other containers, with `Box::new`.
7564
7565 * Libraries
7566
7567     * A [series][coll1] of [efforts][coll2] to establish
7568       [conventions][coll3] for collections types has resulted in API
7569       improvements throughout the standard library.
7570     * New [APIs for error handling][err] provide ergonomic interop
7571       between error types, and [new conventions][err-conv] describe
7572       more clearly the recommended error handling strategies in Rust.
7573     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7574       it is easier to discuss failure in the context of error handling
7575       without making clarifications as to whether you are referring to
7576       the 'fail' macro or failure more generally.
7577     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7578       syscall when available.
7579     * The 'serialize' crate has been renamed 'rustc-serialize' and
7580       moved out of the distribution to Cargo. Although it is widely
7581       used now, it is expected to be superseded in the near future.
7582     * The `Show` formatter, typically implemented with
7583       `#[derive(Show)]` is [now requested with the `{:?}`
7584       specifier][show] and is intended for use by all types, for uses
7585       such as `println!` debugging. The new `String` formatter must be
7586       implemented by hand, uses the `{}` specifier, and is intended
7587       for full-fidelity conversions of things that can logically be
7588       represented as strings.
7589
7590 * Tooling
7591
7592     * [Flexible target specification][flex] allows rustc's code
7593       generation to be configured to support otherwise-unsupported
7594       platforms.
7595     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7596       respective debuggers with Rust-appropriate pretty-printing.
7597     * The Windows installation of Rust is distributed with the
7598       MinGW components currently required to link binaries on that
7599       platform.
7600
7601 * Misc
7602
7603     * Nullable enum optimizations have been extended to more types so
7604       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7605       space than the inner types themselves.
7606     * Work has begun on supporting AArch64.
7607
7608 [Cargo]: https://crates.io
7609 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7610 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7611 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7612 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7613 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7614 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7615 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7616 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7617 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7618 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7619 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7620 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7621 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7622 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7623 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7624 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7625 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7626 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7627 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7628 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7629 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7630 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7631 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7632 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7633 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7634 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7635 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7636 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7637 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7638 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7639 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7640 [trpl]: https://doc.rust-lang.org/book/index.html
7641 [rbe]: http://rustbyexample.com/
7642
7643
7644 Version 0.12.0 (2014-10-09)
7645 =============================
7646
7647   * ~1900 changes, numerous bugfixes
7648
7649   * Highlights
7650
7651     * The introductory documentation (now called The Rust Guide) has
7652       been completely rewritten, as have a number of supplementary
7653       guides.
7654     * Rust's package manager, Cargo, continues to improve and is
7655       sometimes considered to be quite awesome.
7656     * Many API's in `std` have been reviewed and updated for
7657       consistency with the in-development Rust coding
7658       guidelines. The standard library documentation tracks
7659       stabilization progress.
7660     * Minor libraries have been moved out-of-tree to the rust-lang org
7661       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7662       be installed with Cargo.
7663     * Lifetime elision allows lifetime annotations to be left off of
7664       function declarations in many common scenarios.
7665     * Rust now works on 64-bit Windows.
7666
7667   * Language
7668     * Indexing can be overloaded with the `Index` and `IndexMut`
7669       traits.
7670     * The `if let` construct takes a branch only if the `let` pattern
7671       matches, currently behind the 'if_let' feature gate.
7672     * 'where clauses', a more flexible syntax for specifying trait
7673       bounds that is more aesthetic, have been added for traits and
7674       free functions. Where clauses will in the future make it
7675       possible to constrain associated types, which would be
7676       impossible with the existing syntax.
7677     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7678       the 'slicing_syntax' feature gate, and can be overloaded with
7679       the `Slice` or `SliceMut` traits.
7680     * The syntax for matching of sub-slices has been changed to use a
7681       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7682       consistency with other uses of `..` and to future-proof
7683       potential additional uses of the syntax.
7684     * The syntax for matching inclusive ranges in patterns has changed
7685       from `0..3` to `0...4` to be consistent with the exclusive range
7686       syntax for slicing.
7687     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7688       c]`) has been put behind the 'advanced_slice_patterns' feature
7689       gate and may be removed in the future.
7690     * Components of tuples and tuple structs can be extracted using
7691       the `value.0` syntax, currently behind the `tuple_indexing`
7692       feature gate.
7693     * The `#[crate_id]` attribute is no longer supported; versioning
7694       is handled by the package manager.
7695     * Renaming crate imports are now written `extern crate foo as bar`
7696       instead of `extern crate bar = foo`.
7697     * Renaming use statements are now written `use foo as bar` instead
7698       of `use bar = foo`.
7699     * `let` and `match` bindings and argument names in macros are now
7700       hygienic.
7701     * The new, more efficient, closure types ('unboxed closures') have
7702       been added under a feature gate, 'unboxed_closures'. These will
7703       soon replace the existing closure types, once higher-ranked
7704       trait lifetimes are added to the language.
7705     * `move` has been added as a keyword, for indicating closures
7706       that capture by value.
7707     * Mutation and assignment is no longer allowed in pattern guards.
7708     * Generic structs and enums can now have trait bounds.
7709     * The `Share` trait is now called `Sync` to free up the term
7710       'shared' to refer to 'shared reference' (the default reference
7711       type.
7712     * Dynamically-sized types have been mostly implemented,
7713       unifying the behavior of fat-pointer types with the rest of the
7714       type system.
7715     * As part of dynamically-sized types, the `Sized` trait has been
7716       introduced, which qualifying types implement by default, and
7717       which type parameters expect by default. To specify that a type
7718       parameter does not need to be sized, write `<Sized? T>`. Most
7719       types are `Sized`, notable exceptions being unsized arrays
7720       (`[T]`) and trait types.
7721     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7722     * Lifetime bounds can now be applied to type parameters and object
7723       types.
7724     * The old, reference counted GC type, `Gc<T>` which was once
7725       denoted by the `@` sigil, has finally been removed. GC will be
7726       revisited in the future.
7727
7728   * Libraries
7729     * Library documentation has been improved for a number of modules.
7730     * Bit-vectors, collections::bitv has been modernized.
7731     * The url crate is deprecated in favor of
7732       http://github.com/servo/rust-url, which can be installed with
7733       Cargo.
7734     * Most I/O stream types can be cloned and subsequently closed from
7735       a different thread.
7736     * A `std::time::Duration` type has been added for use in I/O
7737       methods that rely on timers, as well as in the 'time' crate's
7738       `Timespec` arithmetic.
7739     * The runtime I/O abstraction layer that enabled the green thread
7740       scheduler to do non-thread-blocking I/O has been removed, along
7741       with the libuv-based implementation employed by the green thread
7742       scheduler. This will greatly simplify the future I/O work.
7743     * `collections::btree` has been rewritten to have a more
7744       idiomatic and efficient design.
7745
7746   * Tooling
7747     * rustdoc output now indicates the stability levels of API's.
7748     * The `--crate-name` flag can specify the name of the crate
7749       being compiled, like `#[crate_name]`.
7750     * The `-C metadata` specifies additional metadata to hash into
7751       symbol names, and `-C extra-filename` specifies additional
7752       information to put into the output filename, for use by the
7753       package manager for versioning.
7754     * debug info generation has continued to improve and should be
7755       more reliable under both gdb and lldb.
7756     * rustc has experimental support for compiling in parallel
7757       using the `-C codegen-units` flag.
7758     * rustc no longer encodes rpath information into binaries by
7759       default.
7760
7761   * Misc
7762     * Stack usage has been optimized with LLVM lifetime annotations.
7763     * Official Rust binaries on Linux are more compatible with older
7764       kernels and distributions, built on CentOS 5.10.
7765
7766
7767 Version 0.11.0 (2014-07-02)
7768 ==========================
7769
7770   * ~1700 changes, numerous bugfixes
7771
7772   * Language
7773     * ~[T] has been removed from the language. This type is superseded by
7774       the Vec<T> type.
7775     * ~str has been removed from the language. This type is superseded by
7776       the String type.
7777     * ~T has been removed from the language. This type is superseded by the
7778       Box<T> type.
7779     * @T has been removed from the language. This type is superseded by the
7780       standard library's std::gc::Gc<T> type.
7781     * Struct fields are now all private by default.
7782     * Vector indices and shift amounts are both required to be a `uint`
7783       instead of any integral type.
7784     * Byte character, byte string, and raw byte string literals are now all
7785       supported by prefixing the normal literal with a `b`.
7786     * Multiple ABIs are no longer allowed in an ABI string
7787     * The syntax for lifetimes on closures/procedures has been tweaked
7788       slightly: `<'a>|A, B|: 'b + K -> T`
7789     * Floating point modulus has been removed from the language; however it
7790       is still provided by a library implementation.
7791     * Private enum variants are now disallowed.
7792     * The `priv` keyword has been removed from the language.
7793     * A closure can no longer be invoked through a &-pointer.
7794     * The `use foo, bar, baz;` syntax has been removed from the language.
7795     * The transmute intrinsic no longer works on type parameters.
7796     * Statics now allow blocks/items in their definition.
7797     * Trait bounds are separated from objects with + instead of : now.
7798     * Objects can no longer be read while they are mutably borrowed.
7799     * The address of a static is now marked as insignificant unless the
7800       #[inline(never)] attribute is placed it.
7801     * The #[unsafe_destructor] attribute is now behind a feature gate.
7802     * Struct literals are no longer allowed in ambiguous positions such as
7803       if, while, match, and for..in.
7804     * Declaration of lang items and intrinsics are now feature-gated by
7805       default.
7806     * Integral literals no longer default to `int`, and floating point
7807       literals no longer default to `f64`. Literals must be suffixed with an
7808       appropriate type if inference cannot determine the type of the
7809       literal.
7810     * The Box<T> type is no longer implicitly borrowed to &mut T.
7811     * Procedures are now required to not capture borrowed references.
7812
7813   * Libraries
7814     * The standard library is now a "facade" over a number of underlying
7815       libraries. This means that development on the standard library should
7816       be speedier due to smaller crates, as well as a clearer line between
7817       all dependencies.
7818     * A new library, libcore, lives under the standard library's facade
7819       which is Rust's "0-assumption" library, suitable for embedded and
7820       kernel development for example.
7821     * A regex crate has been added to the standard distribution. This crate
7822       includes statically compiled regular expressions.
7823     * The unwrap/unwrap_err methods on Result require a Show bound for
7824       better error messages.
7825     * The return types of the std::comm primitives have been centralized
7826       around the Result type.
7827     * A number of I/O primitives have gained the ability to time out their
7828       operations.
7829     * A number of I/O primitives have gained the ability to close their
7830       reading/writing halves to cancel pending operations.
7831     * Reverse iterator methods have been removed in favor of `rev()` on
7832       their forward-iteration counterparts.
7833     * A bitflags! macro has been added to enable easy interop with C and
7834       management of bit flags.
7835     * A debug_assert! macro is now provided which is disabled when
7836       `--cfg ndebug` is passed to the compiler.
7837     * A graphviz crate has been added for creating .dot files.
7838     * The std::cast module has been migrated into std::mem.
7839     * The std::local_data api has been migrated from freestanding functions
7840       to being based on methods.
7841     * The Pod trait has been renamed to Copy.
7842     * jemalloc has been added as the default allocator for types.
7843     * The API for allocating memory has been changed to use proper alignment
7844       and sized deallocation
7845     * Connecting a TcpStream or binding a TcpListener is now based on a
7846       string address and a u16 port. This allows connecting to a hostname as
7847       opposed to an IP.
7848     * The Reader trait now contains a core method, read_at_least(), which
7849       correctly handles many repeated 0-length reads.
7850     * The process-spawning API is now centered around a builder-style
7851       Command struct.
7852     * The :? printing qualifier has been moved from the standard library to
7853       an external libdebug crate.
7854     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7855       have been renamed to Eq/Ord.
7856     * The select/plural methods have been removed from format!. The escapes
7857       for { and } have also changed from \{ and \} to {{ and }},
7858       respectively.
7859     * The TaskBuilder API has been re-worked to be a true builder, and
7860       extension traits for spawning native/green tasks have been added.
7861
7862   * Tooling
7863     * All breaking changes to the language or libraries now have their
7864       commit message annotated with `[breaking-change]` to allow for easy
7865       discovery of breaking changes.
7866     * The compiler will now try to suggest how to annotate lifetimes if a
7867       lifetime-related error occurs.
7868     * Debug info continues to be improved greatly with general bug fixes and
7869       better support for situations like link time optimization (LTO).
7870     * Usage of syntax extensions when cross-compiling has been fixed.
7871     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7872       -fdata-sections and --gc-sections has been enabled by default
7873     * The compiler is now stricter about where it will load module files
7874       from when a module is declared via `mod foo;`.
7875     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7876       Syntax extensions are now discovered via a "plugin registrar" type
7877       which will be extended in the future to other various plugins.
7878     * Lints have been restructured to allow for dynamically loadable lints.
7879     * A number of rustdoc improvements:
7880       * The HTML output has been visually redesigned.
7881       * Markdown is now powered by hoedown instead of sundown.
7882       * Searching heuristics have been greatly improved.
7883       * The search index has been reduced in size by a great amount.
7884       * Cross-crate documentation via `pub use` has been greatly improved.
7885       * Primitive types are now hyperlinked and documented.
7886     * Documentation has been moved from static.rust-lang.org/doc to
7887       doc.rust-lang.org
7888     * A new sandbox, play.rust-lang.org, is available for running and
7889       sharing rust code examples on-line.
7890     * Unused attributes are now more robustly warned about.
7891     * The dead_code lint now warns about unused struct fields.
7892     * Cross-compiling to iOS is now supported.
7893     * Cross-compiling to mipsel is now supported.
7894     * Stability attributes are now inherited by default and no longer apply
7895       to intra-crate usage, only inter-crate usage.
7896     * Error message related to non-exhaustive match expressions have been
7897       greatly improved.
7898
7899
7900 Version 0.10 (2014-04-03)
7901 =========================
7902
7903   * ~1500 changes, numerous bugfixes
7904
7905   * Language
7906     * A new RFC process is now in place for modifying the language.
7907     * Patterns with `@`-pointers have been removed from the language.
7908     * Patterns with unique vectors (`~[T]`) have been removed from the
7909       language.
7910     * Patterns with unique strings (`~str`) have been removed from the
7911       language.
7912     * `@str` has been removed from the language.
7913     * `@[T]` has been removed from the language.
7914     * `@self` has been removed from the language.
7915     * `@Trait` has been removed from the language.
7916     * Headers on `~` allocations which contain `@` boxes inside the type for
7917       reference counting have been removed.
7918     * The semantics around the lifetimes of temporary expressions have changed,
7919       see #3511 and #11585 for more information.
7920     * Cross-crate syntax extensions are now possible, but feature gated. See
7921       #11151 for more information. This includes both `macro_rules!` macros as
7922       well as syntax extensions such as `format!`.
7923     * New lint modes have been added, and older ones have been turned on to be
7924       warn-by-default.
7925       * Unnecessary parentheses
7926       * Uppercase statics
7927       * Camel Case types
7928       * Uppercase variables
7929       * Publicly visible private types
7930       * `#[deriving]` with raw pointers
7931     * Unsafe functions can no longer be coerced to closures.
7932     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7933     * The `#[simd]` attribute is now behind a feature gate.
7934     * Visibility is no longer allowed on `extern crate` statements, and
7935       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7936     * Trailing commas are now allowed in argument lists and tuple patterns.
7937     * The `do` keyword has been removed, it is now a reserved keyword.
7938     * Default type parameters have been implemented, but are feature gated.
7939     * Borrowed variables through captures in closures are now considered soundly.
7940     * `extern mod` is now `extern crate`
7941     * The `Freeze` trait has been removed.
7942     * The `Share` trait has been added for types that can be shared among
7943       threads.
7944     * Labels in macros are now hygienic.
7945     * Expression/statement macro invocations can be delimited with `{}` now.
7946     * Treatment of types allowed in `static mut` locations has been tweaked.
7947     * The `*` and `.` operators are now overloadable through the `Deref` and
7948       `DerefMut` traits.
7949     * `~Trait` and `proc` no longer have `Send` bounds by default.
7950     * Partial type hints are now supported with the `_` type marker.
7951     * An `Unsafe` type was introduced for interior mutability. It is now
7952       considered undefined to transmute from `&T` to `&mut T` without using the
7953       `Unsafe` type.
7954     * The #[linkage] attribute was implemented for extern statics/functions.
7955     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7956     * `Pod` was renamed to `Copy`.
7957
7958   * Libraries
7959     * The `libextra` library has been removed. It has now been decomposed into
7960       component libraries with smaller and more focused nuggets of
7961       functionality. The full list of libraries can be found on the
7962       documentation index page.
7963     * std: `std::condition` has been removed. All I/O errors are now propagated
7964       through the `Result` type. In order to assist with error handling, a
7965       `try!` macro for unwrapping errors with an early return and a lint for
7966       unused results has been added. See #12039 for more information.
7967     * std: The `vec` module has been renamed to `slice`.
7968     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7969       This will become the only growable vector in the future.
7970     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7971       are now found at `std::io::BufferedReader` instead of
7972       `std::io::buffered::BufferedReader`.
7973     * std: `print` and `println` are no longer in the prelude, the `print!` and
7974       `println!` macros are intended to be used instead.
7975     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7976       attempts to statically prevent cycles.
7977     * std: The standard distribution is adopting the policy of pushing failure
7978       to the user rather than failing in libraries. Many functions (such as
7979       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7980     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7981       deriving mode: `#[deriving(Show)]`.
7982     * std: `ToStr` is now implemented for all types implementing `Show`.
7983     * std: The formatting trait methods now take `&self` instead of `&T`
7984     * std: The `invert()` method on iterators has been renamed to `rev()`
7985     * std: `std::num` has seen a reduction in the genericity of its traits,
7986       consolidating functionality into a few core traits.
7987     * std: Backtraces are now printed on task failure if the environment
7988       variable `RUST_BACKTRACE` is present.
7989     * std: Naming conventions for iterators have been standardized. More details
7990       can be found on the wiki's style guide.
7991     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7992       still implement the function.
7993     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7994     * std: `assert_approx_eq!` has been removed
7995     * std: The `e` and `E` formatting specifiers for floats have been added to
7996       print them in exponential notation.
7997     * std: The `Times` trait has been removed
7998     * std: Indications of variance and opting out of builtin bounds is done
7999       through marker types in `std::kinds::marker` now
8000     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8001       `#[deriving(Hash)]` is now possible.
8002     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8003     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8004     * std: `Chan::new` is now `channel()`.
8005     * std: A new synchronous channel type has been implemented.
8006     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8007     * std: `hashmap` and `trie` have been moved to `libcollections`
8008     * std: `run` has been rolled into `io::process`
8009     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8010     * std: The equality and comparison traits have seen some reorganization.
8011     * std: `rand` has moved to `librand`.
8012     * std: `to_{lower,upper}case` has been implemented for `char`.
8013     * std: Logging has been moved to `liblog`.
8014     * collections: `HashMap` has been rewritten for higher performance and less
8015       memory usage.
8016     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8017       it can be booted manually. The runtime guide has more information and
8018       examples.
8019     * native: All I/O functionality except signals has been implemented.
8020     * green: Task spawning with `libgreen` has been optimized with stack caching
8021       and various trimming of code.
8022     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8023     * sync: The `extra::sync` module has been updated to modern rust (and moved
8024       to the `sync` library), tweaking and improving various interfaces while
8025       dropping redundant functionality.
8026     * sync: A new `Barrier` type has been added to the `sync` library.
8027     * sync: An efficient mutex for native and green tasks has been implemented.
8028     * serialize: The `base64` module has seen some improvement. It treats
8029       newlines better, has non-string error values, and has seen general
8030       cleanup.
8031     * fourcc: A `fourcc!` macro was introduced
8032     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8033       hexadecimal literal.
8034
8035   * Tooling
8036     * `rustpkg` has been deprecated and removed from the main repository. Its
8037       replacement, `cargo`, is under development.
8038     * Nightly builds of rust are now available
8039     * The memory usage of rustc has been improved many times throughout this
8040       release cycle.
8041     * The build process supports disabling rpath support for the rustc binary
8042       itself.
8043     * Code generation has improved in some cases, giving more information to the
8044       LLVM optimization passes to enable more extensive optimizations.
8045     * Debuginfo compatibility with lldb on OSX has been restored.
8046     * The master branch is now gated on an android bot, making building for
8047       android much more reliable.
8048     * Output flags have been centralized into one `--emit` flag.
8049     * Crate type flags have been centralized into one `--crate-type` flag.
8050     * Codegen flags have been consolidated behind a `-C` flag.
8051     * Linking against outdated crates now has improved error messages.
8052     * Error messages with lifetimes will often suggest how to annotate the
8053       function to fix the error.
8054     * Many more types are documented in the standard library, and new guides
8055       were written.
8056     * Many `rustdoc` improvements:
8057       * code blocks are syntax highlighted.
8058       * render standalone markdown files.
8059       * the --test flag tests all code blocks by default.
8060       * exported macros are displayed.
8061       * re-exported types have their documentation inlined at the location of the
8062         first re-export.
8063       * search works across crates that have been rendered to the same output
8064         directory.
8065
8066
8067 Version 0.9 (2014-01-09)
8068 ==========================
8069
8070    * ~1800 changes, numerous bugfixes
8071
8072    * Language
8073       * The `float` type has been removed. Use `f32` or `f64` instead.
8074       * A new facility for enabling experimental features (feature gating) has
8075         been added, using the crate-level `#[feature(foo)]` attribute.
8076       * Managed boxes (@) are now behind a feature gate
8077         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8078         standard library's `Gc` or `Rc` types instead.
8079       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8080       * Jumping back to the top of a loop is now done with `continue` instead of
8081         `loop`.
8082       * Strings can no longer be mutated through index assignment.
8083       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8084         hash delimiters, as in `r###"foo"###`.
8085       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8086         called once.
8087       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8088       * `@fn`s have been removed.
8089       * `do` only works with procs in order to make it obvious what the cost
8090         of `do` is.
8091       * Single-element tuple-like structs can no longer be dereferenced to
8092         obtain the inner value. A more comprehensive solution for overloading
8093         the dereference operator will be provided in the future.
8094       * The `#[link(...)]` attribute has been replaced with
8095         `#[crate_id = "name#vers"]`.
8096       * Empty `impl`s must be terminated with empty braces and may not be
8097         terminated with a semicolon.
8098       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8099         no longer has any special meaning.
8100       * The old `fmt!` string formatting macro has been removed.
8101       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8102         `print!` and `println!`.
8103       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8104       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8105         `extern mod foo = "bar"` instead.
8106       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8107       * Macros can have attributes.
8108       * Macros can expand to items with attributes.
8109       * Macros can expand to multiple items.
8110       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8111       * Comments may be nested.
8112       * Values automatically coerce to trait objects they implement, without
8113         an explicit `as`.
8114       * Enum discriminants are no longer an entire word but as small as needed to
8115         contain all the variants. The `repr` attribute can be used to override
8116         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8117         `#[repr(C)]` to match C enums.
8118       * Non-string literals are not allowed in attributes (they never worked).
8119       * The FFI now supports variadic functions.
8120       * Octal numeric literals, as in `0o7777`.
8121       * The `concat!` syntax extension performs compile-time string concatenation.
8122       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8123         removed as Rust no longer uses segmented stacks.
8124       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8125       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8126         not `*`; ignoring remaining fields of a struct is also done with `..`,
8127         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8128       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8129       * `rustc` supports the "system" calling convention, which defaults to the
8130         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8131         "C" elsewhere.
8132       * The `type_overflow` lint (default: warn) checks literals for overflow.
8133       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8134       * The `attribute_usage` lint (default: warn) warns about unknown
8135         attributes.
8136       * The `unknown_features` lint (default: warn) warns about unknown
8137         feature gates.
8138       * The `dead_code` lint (default: warn) checks for dead code.
8139       * Rust libraries can be linked statically to one another
8140       * `#[link_args]` is behind the `link_args` feature gate.
8141       * Native libraries are now linked with `#[link(name = "foo")]`
8142       * Native libraries can be statically linked to a rust crate
8143         (`#[link(name = "foo", kind = "static")]`).
8144       * Native OS X frameworks are now officially supported
8145         (`#[link(name = "foo", kind = "framework")]`).
8146       * The `#[thread_local]` attribute creates thread-local (not task-local)
8147         variables. Currently behind the `thread_local` feature gate.
8148       * The `return` keyword may be used in closures.
8149       * Types that can be copied via a memcpy implement the `Pod` kind.
8150       * The `cfg` attribute can now be used on struct fields and enum variants.
8151
8152    * Libraries
8153       * std: The `option` and `result` API's have been overhauled to make them
8154         simpler, more consistent, and more composable.
8155       * std: The entire `std::io` module has been replaced with one that is
8156         more comprehensive and that properly interfaces with the underlying
8157         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8158         implemented.
8159       * std: `io::util` contains a number of useful implementations of
8160         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8161         `ZeroReader`, `TeeReader`.
8162       * std: The reference counted pointer type `extra::rc` moved into std.
8163       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8164         just a wrapper around it).
8165       * std: The `Either` type has been removed.
8166       * std: `fmt::Default` can be implemented for any type to provide default
8167         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8168       * std: The `rand` API continues to be tweaked.
8169       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8170         on failure in gdb, is now named `rust_fail`.
8171       * std: The `each_key` and `each_value` methods on `HashMap` have been
8172         replaced by the `keys` and `values` iterators.
8173       * std: Functions dealing with type size and alignment have moved from the
8174         `sys` module to the `mem` module.
8175       * std: The `path` module was written and API changed.
8176       * std: `str::from_utf8` has been changed to cast instead of allocate.
8177       * std: `starts_with` and `ends_with` methods added to vectors via the
8178         `ImmutableEqVector` trait, which is in the prelude.
8179       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8180         if the index is out of bounds.
8181       * std: Task failure no longer propagates between tasks, as the model was
8182         complex, expensive, and incompatible with thread-based tasks.
8183       * std: The `Any` type can be used for dynamic typing.
8184       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8185         `task::try`.
8186       * std: Methods that produce iterators generally do not have an `_iter`
8187         suffix now.
8188       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8189         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8190       * std: `util::ignore` renamed to `prelude::drop`.
8191       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8192         trait.
8193       * std: `vec::raw` has seen a lot of cleanup and API changes.
8194       * std: The standard library no longer includes any C++ code, and very
8195         minimal C, eliminating the dependency on libstdc++.
8196       * std: Runtime scheduling and I/O functionality has been factored out into
8197         extensible interfaces and is now implemented by two different crates:
8198         libnative, for native threading and I/O; and libgreen, for green threading
8199         and I/O. This paves the way for using the standard library in more limited
8200         embedded environments.
8201       * std: The `comm` module has been rewritten to be much faster, have a
8202         simpler, more consistent API, and to work for both native and green
8203         threading.
8204       * std: All libuv dependencies have been moved into the rustuv crate.
8205       * native: New implementations of runtime scheduling on top of OS threads.
8206       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8207         and other I/O.
8208       * green: The green thread scheduler and message passing types are almost
8209         entirely lock-free.
8210       * extra: The `flatpipes` module had bitrotted and was removed.
8211       * extra: All crypto functions have been removed and Rust now has a policy of
8212         not reimplementing crypto in the standard library. In the future crypto
8213         will be provided by external crates with bindings to established libraries.
8214       * extra: `c_vec` has been modernized.
8215       * extra: The `sort` module has been removed. Use the `sort` method on
8216         mutable slices.
8217
8218    * Tooling
8219       * The `rust` and `rusti` commands have been removed, due to lack of
8220         maintenance.
8221       * `rustdoc` was completely rewritten.
8222       * `rustdoc` can test code examples in documentation.
8223       * `rustpkg` can test packages with the argument, 'test'.
8224       * `rustpkg` supports arbitrary dependencies, including C libraries.
8225       * `rustc`'s support for generating debug info is improved again.
8226       * `rustc` has better error reporting for unbalanced delimiters.
8227       * `rustc`'s JIT support was removed due to bitrot.
8228       * Executables and static libraries can be built with LTO (-Z lto)
8229       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8230         build tools.
8231
8232
8233 Version 0.8 (2013-09-26)
8234 ============================
8235
8236    * ~2200 changes, numerous bugfixes
8237
8238    * Language
8239       * The `for` loop syntax has changed to work with the `Iterator` trait.
8240       * At long last, unwinding works on Windows.
8241       * Default methods are ready for use.
8242       * Many trait inheritance bugs fixed.
8243       * Owned and borrowed trait objects work more reliably.
8244       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8245       * rustc can omit emission of code for the `debug!` macro if it is passed
8246         `--cfg ndebug`
8247       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8248         for foo.rs, then foo/mod.rs, and will generate an error when both are
8249         present.
8250       * Strings no longer contain trailing nulls. The new `std::c_str` module
8251         provides new mechanisms for converting to C strings.
8252       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8253       * The FFI has been overhauled such that foreign functions are called directly,
8254         instead of through a stack-switching wrapper.
8255       * Calling a foreign function must be done through a Rust function with the
8256         `#[fixed_stack_segment]` attribute.
8257       * The `externfn!` macro can be used to declare both a foreign function and
8258         a `#[fixed_stack_segment]` wrapper at once.
8259       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8260       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8261       * `priv` is disallowed everywhere except for struct fields and enum variants.
8262       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8263       * `ref` bindings in irrefutable patterns work correctly now.
8264       * `char` is now prevented from containing invalid code points.
8265       * Casting to `bool` is no longer allowed.
8266       * `\0` is now accepted as an escape in chars and strings.
8267       * `yield` is a reserved keyword.
8268       * `typeof` is a reserved keyword.
8269       * Crates may be imported by URL with `extern mod foo = "url";`.
8270       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8271       * Static vectors can be initialized with repeating elements,
8272         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8273       * Static structs can be initialized with functional record update,
8274         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8275       * `cfg!` can be used to conditionally execute code based on the crate
8276         configuration, similarly to `#[cfg(...)]`.
8277       * The `unnecessary_qualification` lint detects unneeded module
8278         prefixes (default: allow).
8279       * Arithmetic operations have been implemented on the SIMD types in
8280         `std::unstable::simd`.
8281       * Exchange allocation headers were removed, reducing memory usage.
8282       * `format!` implements a completely new, extensible, and higher-performance
8283         string formatting system. It will replace `fmt!`.
8284       * `print!` and `println!` write formatted strings (using the `format!`
8285         extension) to stdout.
8286       * `write!` and `writeln!` write formatted strings (using the `format!`
8287         extension) to the new Writers in `std::rt::io`.
8288       * The library section in which a function or static is placed may
8289         be specified with `#[link_section = "..."]`.
8290       * The `proto!` syntax extension for defining bounded message protocols
8291         was removed.
8292       * `macro_rules!` is hygienic for `let` declarations.
8293       * The `#[export_name]` attribute specifies the name of a symbol.
8294       * `unreachable!` can be used to indicate unreachable code, and fails
8295         if executed.
8296
8297    * Libraries
8298       * std: Transitioned to the new runtime, written in Rust.
8299       * std: Added an experimental I/O library, `rt::io`, based on the new
8300         runtime.
8301       * std: A new generic `range` function was added to the prelude, replacing
8302         `uint::range` and friends.
8303       * std: `range_rev` no longer exists. Since range is an iterator it can be
8304         reversed with `range(lo, hi).invert()`.
8305       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8306         renamed to `unwrap_or`.
8307       * std: The `iterator` module was renamed to `iter`.
8308       * std: Integral types now support the `checked_add`, `checked_sub`, and
8309         `checked_mul` operations for detecting overflow.
8310       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8311         consistency.
8312       * std: Methods are standardizing on conventions for casting methods:
8313         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8314         and cheap casts.
8315       * std: The `CString` type in `c_str` provides new ways to convert to and
8316         from C strings.
8317       * std: `DoubleEndedIterator` can yield elements in two directions.
8318       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8319         two splices.
8320       * std: `str::from_bytes` renamed to `str::from_utf8`.
8321       * std: `pop_opt` and `shift_opt` methods added to vectors.
8322       * std: The task-local data interface no longer uses @, and keys are
8323         no longer function pointers.
8324       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8325       * std: Added `SharedPort` to `comm`.
8326       * std: `Eq` has a default method for `ne`; only `eq` is required
8327         in implementations.
8328       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8329         is required in implementations.
8330       * std: `is_utf8` performance is improved, impacting many string functions.
8331       * std: `os::MemoryMap` provides cross-platform mmap.
8332       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8333         are not 'in-bounds' are considered undefined.
8334       * std: Many freestanding functions in `vec` removed in favor of methods.
8335       * std: Many freestanding functions on scalar types removed in favor of
8336         methods.
8337       * std: Many options to task builders were removed since they don't make
8338         sense in the new scheduler design.
8339       * std: More containers implement `FromIterator` so can be created by the
8340         `collect` method.
8341       * std: More complete atomic types in `unstable::atomics`.
8342       * std: `comm::PortSet` removed.
8343       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8344         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8345         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8346         default implementations.
8347       * std: Various `from_str` functions were removed in favor of a generic
8348         `from_str` which is available in the prelude.
8349       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8350       * extra: `dlist`, the doubly-linked list was modernized.
8351       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8352       * extra: Added `glob` module, replacing `std::os::glob`.
8353       * extra: `rope` was removed.
8354       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8355       * extra: `net`, and `timer` were removed. The experimental replacements
8356         are `std::rt::io::net` and `std::rt::io::timer`.
8357       * extra: Iterators implemented for `SmallIntMap`.
8358       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8359       * extra: `SmallIntSet` removed. Use `BitvSet`.
8360       * extra: Performance of JSON parsing greatly improved.
8361       * extra: `semver` updated to SemVer 2.0.0.
8362       * extra: `term` handles more terminals correctly.
8363       * extra: `dbg` module removed.
8364       * extra: `par` module removed.
8365       * extra: `future` was cleaned up, with some method renames.
8366       * extra: Most free functions in `getopts` were converted to methods.
8367
8368    * Other
8369       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8370       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8371         similarly to gcc's `--march` flag.
8372       * rustc's performance compiling small crates is much better.
8373       * rustpkg has received many improvements.
8374       * rustpkg supports git tags as package IDs.
8375       * rustpkg builds into target-specific directories so it can be used for
8376         cross-compiling.
8377       * The number of concurrent test tasks is controlled by the environment
8378         variable RUST_TEST_TASKS.
8379       * The test harness can now report metrics for benchmarks.
8380       * All tools have man pages.
8381       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8382       * The runtime uses jemalloc for allocations.
8383       * Segmented stacks are temporarily disabled as part of the transition to
8384         the new runtime. Stack overflows are possible!
8385       * A new documentation backend, rustdoc_ng, is available for use. It is
8386         still invoked through the normal `rustdoc` command.
8387
8388
8389 Version 0.7 (2013-07-03)
8390 =======================
8391
8392    * ~2000 changes, numerous bugfixes
8393
8394    * Language
8395       * `impl`s no longer accept a visibility qualifier. Put them on methods
8396         instead.
8397       * The borrow checker has been rewritten with flow-sensitivity, fixing
8398         many bugs and inconveniences.
8399       * The `self` parameter no longer implicitly means `&'self self`,
8400         and can be explicitly marked with a lifetime.
8401       * Overloadable compound operators (`+=`, etc.) have been temporarily
8402         removed due to bugs.
8403       * The `for` loop protocol now requires `for`-iterators to return `bool`
8404         so they compose better.
8405       * The `Durable` trait is replaced with the `'static` bounds.
8406       * Trait default methods work more often.
8407       * Structs with the `#[packed]` attribute have byte alignment and
8408         no padding between fields.
8409       * Type parameters bound by `Copy` must now be copied explicitly with
8410         the `copy` keyword.
8411       * It is now illegal to move out of a dereferenced unsafe pointer.
8412       * `Option<~T>` is now represented as a nullable pointer.
8413       * `@mut` does dynamic borrow checks correctly.
8414       * The `main` function is only detected at the topmost level of the crate.
8415         The `#[main]` attribute is still valid anywhere.
8416       * Struct fields may no longer be mutable. Use inherited mutability.
8417       * The `#[no_send]` attribute makes a type that would otherwise be
8418         `Send`, not.
8419       * The `#[no_freeze]` attribute makes a type that would otherwise be
8420         `Freeze`, not.
8421       * Unbounded recursion will abort the process after reaching the limit
8422         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8423       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8424         are never implicitly copyable.
8425       * `#[static_assert]` makes compile-time assertions about static bools.
8426       * At long last, 'argument modes' no longer exist.
8427       * The rarely used `use mod` statement no longer exists.
8428
8429    * Syntax extensions
8430       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8431         argument list.
8432       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8433         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8434         `#[deriving(...)]`.
8435       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8436         and unsuffixed integer literals.
8437
8438    * Libraries
8439       * The `core` crate was renamed to `std`.
8440       * The `std` crate was renamed to `extra`.
8441       * More and improved documentation.
8442       * std: `iterator` module for external iterator objects.
8443       * Many old-style (internal, higher-order function) iterators replaced by
8444         implementations of `Iterator`.
8445       * std: Many old internal vector and string iterators,
8446         incl. `any`, `all`. removed.
8447       * std: The `finalize` method of `Drop` renamed to `drop`.
8448       * std: The `drop` method now takes `&mut self` instead of `&self`.
8449       * std: The prelude no longer re-exports any modules, only types and traits.
8450       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8451         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8452       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8453         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8454       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8455         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8456       * std: Many types implement `Clone`.
8457       * std: `path` type renamed to `Path`.
8458       * std: `mut` module and `Mut` type removed.
8459       * std: Many standalone functions removed in favor of methods and iterators
8460         in `vec`, `str`. In the future methods will also work as functions.
8461       * std: `reinterpret_cast` removed. Use `transmute`.
8462       * std: ascii string handling in `std::ascii`.
8463       * std: `Rand` is implemented for ~/@.
8464       * std: `run` module for spawning processes overhauled.
8465       * std: Various atomic types added to `unstable::atomic`.
8466       * std: Various types implement `Zero`.
8467       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8468       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8469       * std: Added `os::mkdir_recursive`.
8470       * std: Added `os::glob` function performs filesystems globs.
8471       * std: `FuzzyEq` renamed to `ApproxEq`.
8472       * std: `Map` now defines `pop` and `swap` methods.
8473       * std: `Cell` constructors converted to static methods.
8474       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8475       * extra: `flate` module moved from `std` to `extra`.
8476       * extra: `fileinput` module for iterating over a series of files.
8477       * extra: `Complex` number type and `complex` module.
8478       * extra: `Rational` number type and `rational` module.
8479       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8480       * extra: `term` uses terminfo now, is more correct.
8481       * extra: `arc` functions converted to methods.
8482       * extra: Implementation of fixed output size variations of SHA-2.
8483
8484    * Tooling
8485       * `unused_variables` lint mode for unused variables (default: warn).
8486       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8487         (default: warn).
8488       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8489         (default: warn).
8490       * `dead_assignment` lint mode for unread variables (default: warn).
8491       * `unnecessary_allocation` lint mode detects some heap allocations that are
8492         immediately borrowed so could be written without allocating (default: warn).
8493       * `missing_doc` lint mode (default: allow).
8494       * `unreachable_code` lint mode (default: warn).
8495       * The `rusti` command has been rewritten and a number of bugs addressed.
8496       * rustc outputs in color on more terminals.
8497       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8498       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8499       * Compiling with `-g` will make the binary record information about
8500         dynamic borrowcheck failures for debugging.
8501       * rustdoc has a nicer stylesheet.
8502       * Various improvements to rustdoc.
8503       * Improvements to rustpkg (see the detailed release notes).
8504
8505
8506 Version 0.6 (2013-04-03)
8507 ========================
8508
8509    * ~2100 changes, numerous bugfixes
8510
8511    * Syntax changes
8512       * The self type parameter in traits is now spelled `Self`
8513       * The `self` parameter in trait and impl methods must now be explicitly
8514         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8515       * Static methods no longer require the `static` keyword and instead
8516         are distinguished by the lack of a `self` parameter
8517       * Replaced the `Durable` trait with the `'static` lifetime
8518       * The old closure type syntax with the trailing sigil has been
8519         removed in favor of the more consistent leading sigil
8520       * `super` is a keyword, and may be prefixed to paths
8521       * Trait bounds are separated with `+` instead of whitespace
8522       * Traits are implemented with `impl Trait for Type`
8523         instead of `impl Type: Trait`
8524       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8525       * The `export` keyword has finally been removed
8526       * The `move` keyword has been removed (see "Semantic changes")
8527       * The interior mutability qualifier on vectors, `[mut T]`, has been
8528         removed. Use `&mut [T]`, etc.
8529       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8530       * `fail` is no longer a keyword. Use `fail!()`
8531       * `assert` is no longer a keyword. Use `assert!()`
8532       * `log` is no longer a keyword. use `debug!`, etc.
8533       * 1-tuples may be represented as `(T,)`
8534       * Struct fields may no longer be `mut`. Use inherited mutability,
8535         `@mut T`, `core::mut` or `core::cell`
8536       * `extern mod { ... }` is no longer valid syntax for foreign
8537         function modules. Use extern blocks: `extern { ... }`
8538       * Newtype enums removed. Use tuple-structs.
8539       * Trait implementations no longer support visibility modifiers
8540       * Pattern matching over vectors improved and expanded
8541       * `const` renamed to `static` to correspond to lifetime name,
8542         and make room for future `static mut` unsafe mutable globals.
8543       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8544       * `Clone` implementations can be automatically generated with
8545         `#[deriving(Clone)]`
8546       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8547         instead of `foo as Bar`.
8548       * Fixed length vector types are now written as `[int, .. 3]`
8549         instead of `[int * 3]`.
8550       * Fixed length vector types can express the length as a constant
8551         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8552
8553    * Semantic changes
8554       * Types with owned pointers or custom destructors move by default,
8555         eliminating the `move` keyword
8556       * All foreign functions are considered unsafe
8557       * &mut is now unaliasable
8558       * Writes to borrowed @mut pointers are prevented dynamically
8559       * () has size 0
8560       * The name of the main function can be customized using #[main]
8561       * The default type of an inferred closure is &fn instead of @fn
8562       * `use` statements may no longer be "chained" - they cannot import
8563         identifiers imported by previous `use` statements
8564       * `use` statements are crate relative, importing from the "top"
8565         of the crate by default. Paths may be prefixed with `super::`
8566         or `self::` to change the search behavior.
8567       * Method visibility is inherited from the implementation declaration
8568       * Structural records have been removed
8569       * Many more types can be used in static items, including enums
8570         'static-lifetime pointers and vectors
8571       * Pattern matching over vectors improved and expanded
8572       * Typechecking of closure types has been overhauled to
8573         improve inference and eliminate unsoundness
8574       * Macros leave scope at the end of modules, unless that module is
8575         tagged with #[macro_escape]
8576
8577    * Libraries
8578       * Added big integers to `std::bigint`
8579       * Removed `core::oldcomm` module
8580       * Added pipe-based `core::comm` module
8581       * Numeric traits have been reorganized under `core::num`
8582       * `vec::slice` finally returns a slice
8583       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8584       * Containers reorganized around traits in `core::container`
8585       * `core::dvec` removed, `~[T]` is a drop-in replacement
8586       * `core::send_map` renamed to `core::hashmap`
8587       * `std::map` removed; replaced with `core::hashmap`
8588       * `std::treemap` reimplemented as an owned balanced tree
8589       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8590       * `core::trie` added as a fast ordered map for integer keys
8591       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8592       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8593         overload the comparison operators, whereas `TotalOrd` is used
8594         by certain container types
8595
8596    * Other
8597       * Replaced the 'cargo' package manager with 'rustpkg'
8598       * Added all-purpose 'rust' tool
8599       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8600       * rustc now *attempts* to offer spelling suggestions
8601       * Improved support for ARM and Android
8602       * Preliminary MIPS backend
8603       * Improved foreign function ABI implementation for x86, x86_64
8604       * Various memory usage improvements
8605       * Rust code may be embedded in foreign code under limited circumstances
8606       * Inline assembler supported by new asm!() syntax extension.
8607
8608
8609 Version 0.5 (2012-12-21)
8610 ===========================
8611
8612    * ~900 changes, numerous bugfixes
8613
8614    * Syntax changes
8615       * Removed `<-` move operator
8616       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8617       * Removed old fixed length vector syntax - `[T]/N`
8618       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8619       * Macros may now expand to items and statements
8620       * `a.b()` is always parsed as a method call, never as a field projection
8621       * `Eq` and `IterBytes` implementations can be automatically generated
8622         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8623       * Removed the special crate language for `.rc` files
8624       * Function arguments may consist of any irrefutable pattern
8625
8626    * Semantic changes
8627       * `&` and `~` pointers may point to objects
8628       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8629       * Enum variants may be structs
8630       * Destructors can be added to all nominal types with the Drop trait
8631       * Structs and nullary enum variants may be constants
8632       * Values that cannot be implicitly copied are now automatically moved
8633         without writing `move` explicitly
8634       * `&T` may now be coerced to `*T`
8635       * Coercions happen in `let` statements as well as function calls
8636       * `use` statements now take crate-relative paths
8637       * The module and type namespaces have been merged so that static
8638         method names can be resolved under the trait in which they are
8639         declared
8640
8641    * Improved support for language features
8642       * Trait inheritance works in many scenarios
8643       * More support for explicit self arguments in methods - `self`, `&self`
8644         `@self`, and `~self` all generally work as expected
8645       * Static methods work in more situations
8646       * Experimental: Traits may declare default methods for the implementations
8647         to use
8648
8649    * Libraries
8650       * New condition handling system in `core::condition`
8651       * Timsort added to `std::sort`
8652       * New priority queue, `std::priority_queue`
8653       * Pipes for serializable types, `std::flatpipes'
8654       * Serialization overhauled to be trait-based
8655       * Expanded `getopts` definitions
8656       * Moved futures to `std`
8657       * More functions are pure now
8658       * `core::comm` renamed to `oldcomm`. Still deprecated
8659       * `rustdoc` and `cargo` are libraries now
8660
8661    * Misc
8662       * Added a preliminary REPL, `rusti`
8663       * License changed from MIT to dual MIT/APL2
8664
8665
8666 Version 0.4 (2012-10-15)
8667 ==========================
8668
8669    * ~2000 changes, numerous bugfixes
8670
8671    * Syntax
8672       * All keywords are now strict and may not be used as identifiers anywhere
8673       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8674         'of', 'with', 'to', 'class'.
8675       * Classes are replaced with simpler structs
8676       * Explicit method self types
8677       * `ret` became `return` and `alt` became `match`
8678       * `import` is now `use`; `use is now `extern mod`
8679       * `extern mod { ... }` is now `extern { ... }`
8680       * `use mod` is the recommended way to import modules
8681       * `pub` and `priv` replace deprecated export lists
8682       * The syntax of `match` pattern arms now uses fat arrow (=>)
8683       * `main` no longer accepts an args vector; use `os::args` instead
8684
8685    * Semantics
8686       * Trait implementations are now coherent, ala Haskell typeclasses
8687       * Trait methods may be static
8688       * Argument modes are deprecated
8689       * Borrowed pointers are much more mature and recommended for use
8690       * Strings and vectors in the static region are stored in constant memory
8691       * Typestate was removed
8692       * Resolution rewritten to be more reliable
8693       * Support for 'dual-mode' data structures (freezing and thawing)
8694
8695    * Libraries
8696       * Most binary operators can now be overloaded via the traits in
8697         `core::ops'
8698       * `std::net::url` for representing URLs
8699       * Sendable hash maps in `core::send_map`
8700       * `core::task' gained a (currently unsafe) task-local storage API
8701
8702    * Concurrency
8703       * An efficient new intertask communication primitive called the pipe,
8704         along with a number of higher-level channel types, in `core::pipes`
8705       * `std::arc`, an atomically reference counted, immutable, shared memory
8706         type
8707       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8708       * Futures are now based on pipes and sendable
8709       * More robust linked task failure
8710       * Improved task builder API
8711
8712    * Other
8713       * Improved error reporting
8714       * Preliminary JIT support
8715       * Preliminary work on precise GC
8716       * Extensive architectural improvements to rustc
8717       * Begun a transition away from buggy C++-based reflection (shape) code to
8718         Rust-based (visitor) code
8719       * All hash functions and tables converted to secure, randomized SipHash
8720
8721
8722 Version 0.3  (2012-07-12)
8723 ========================
8724
8725    * ~1900 changes, numerous bugfixes
8726
8727    * New coding conveniences
8728       * Integer-literal suffix inference
8729       * Per-item control over warnings, errors
8730       * #[cfg(windows)] and #[cfg(unix)] attributes
8731       * Documentation comments
8732       * More compact closure syntax
8733       * 'do' expressions for treating higher-order functions as
8734         control structures
8735       * *-patterns (wildcard extended to all constructor fields)
8736
8737    * Semantic cleanup
8738       * Name resolution pass and exhaustiveness checker rewritten
8739       * Region pointers and borrow checking supersede alias
8740         analysis
8741       * Init-ness checking is now provided by a region-based liveness
8742         pass instead of the typestate pass; same for last-use analysis
8743       * Extensive work on region pointers
8744
8745    * Experimental new language features
8746       * Slices and fixed-size, interior-allocated vectors
8747       * #!-comments for lang versioning, shell execution
8748       * Destructors and iface implementation for classes;
8749         type-parameterized classes and class methods
8750       * 'const' type kind for types that can be used to implement
8751         shared-memory concurrency patterns
8752
8753    * Type reflection
8754
8755    * Removal of various obsolete features
8756       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8757                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8758
8759       * Constructs: do-while loops ('do' repurposed), fn binding,
8760                     resources (replaced by destructors)
8761
8762    * Compiler reorganization
8763       * Syntax-layer of compiler split into separate crate
8764       * Clang (from LLVM project) integrated into build
8765       * Typechecker split into sub-modules
8766
8767    * New library code
8768       * New time functions
8769       * Extension methods for many built-in types
8770       * Arc: atomic-refcount read-only / exclusive-use shared cells
8771       * Par: parallel map and search routines
8772       * Extensive work on libuv interface
8773       * Much vector code moved to libraries
8774       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8775         #include, #include_str, #include_bin
8776
8777    * Tool improvements
8778       * Cargo automatically resolves dependencies
8779
8780
8781 Version 0.2  (2012-03-29)
8782 =========================
8783
8784    * >1500 changes, numerous bugfixes
8785
8786    * New docs and doc tooling
8787
8788    * New port: FreeBSD x86_64
8789
8790    * Compilation model enhancements
8791       * Generics now specialized, multiply instantiated
8792       * Functions now inlined across separate crates
8793
8794    * Scheduling, stack and threading fixes
8795       * Noticeably improved message-passing performance
8796       * Explicit schedulers
8797       * Callbacks from C
8798       * Helgrind clean
8799
8800    * Experimental new language features
8801       * Operator overloading
8802       * Region pointers
8803       * Classes
8804
8805    * Various language extensions
8806       * C-callback function types: 'crust fn ...'
8807       * Infinite-loop construct: 'loop { ... }'
8808       * Shorten 'mutable' to 'mut'
8809       * Required mutable-local qualifier: 'let mut ...'
8810       * Basic glob-exporting: 'export foo::*;'
8811       * Alt now exhaustive, 'alt check' for runtime-checked
8812       * Block-function form of 'for' loop, with 'break' and 'ret'.
8813
8814    * New library code
8815       * AST quasi-quote syntax extension
8816       * Revived libuv interface
8817       * New modules: core::{future, iter}, std::arena
8818       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8819       * Extensive cleanup, regularization in libstd, libcore
8820
8821
8822 Version 0.1  (2012-01-20)
8823 ===============================
8824
8825    * Most language features work, including:
8826       * Unique pointers, unique closures, move semantics
8827       * Interface-constrained generics
8828       * Static interface dispatch
8829       * Stack growth
8830       * Multithread task scheduling
8831       * Typestate predicates
8832       * Failure unwinding, destructors
8833       * Pattern matching and destructuring assignment
8834       * Lightweight block-lambda syntax
8835       * Preliminary macro-by-example
8836
8837    * Compiler works with the following configurations:
8838       * Linux: x86 and x86_64 hosts and targets
8839       * macOS: x86 and x86_64 hosts and targets
8840       * Windows: x86 hosts and targets
8841
8842    * Cross compilation / multi-target configuration supported.
8843
8844    * Preliminary API-documentation and package-management tools included.
8845
8846 Known issues:
8847
8848    * Documentation is incomplete.
8849
8850    * Performance is below intended target.
8851
8852    * Standard library APIs are subject to extensive change, reorganization.
8853
8854    * Language-level versioning is not yet operational - future code will
8855      break unexpectedly.