]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Auto merge of #71911 - wesleywiser:const_prop_small_cleanups, r=oli-obk
[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 at most 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   You can also display dependencies on multiple versions of the same crate with
89   `cargo tree -d` (short for `cargo tree --duplicates`).
90
91 Misc
92 ----
93 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
94   the version in the sidebar.][69494]
95
96 Compatibility Notes
97 -------------------
98 - [Rustc now correctly generates static libraries on Windows GNU targets with
99   the `.a` extension, rather than the previous `.lib`.][70937]
100 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
101 - [The `file_name` property in JSON output of macro errors now points the actual
102   source file rather than the previous format of `<NAME macros>`.][70969]
103   **Note:** this may not point to a file that actually exists on the user's system.
104 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
105 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
106   not allow zero initialization such as `NonZeroU8`.][66059] This was
107   previously a warning.
108 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
109   operator has been defined as a saturating operation.][71269] This was previously
110   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
111   continue using the current behaviour, which may be desirable in rare performance
112   sensitive situations.
113
114 Internal Only
115 -------------
116 These changes provide no direct user facing benefits, but represent significant
117 improvements to the internals and overall performance of rustc and
118 related tools.
119
120 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
121 - [Replace big JS dict with JSON parsing.][71250]
122
123 [69373]: https://github.com/rust-lang/rust/pull/69373/
124 [66059]: https://github.com/rust-lang/rust/pull/66059/
125 [68191]: https://github.com/rust-lang/rust/pull/68191/
126 [68899]: https://github.com/rust-lang/rust/pull/68899/
127 [71147]: https://github.com/rust-lang/rust/pull/71147/
128 [71250]: https://github.com/rust-lang/rust/pull/71250/
129 [70937]: https://github.com/rust-lang/rust/pull/70937/
130 [70969]: https://github.com/rust-lang/rust/pull/70969/
131 [70632]: https://github.com/rust-lang/rust/pull/70632/
132 [70281]: https://github.com/rust-lang/rust/pull/70281/
133 [70345]: https://github.com/rust-lang/rust/pull/70345/
134 [70048]: https://github.com/rust-lang/rust/pull/70048/
135 [70081]: https://github.com/rust-lang/rust/pull/70081/
136 [70156]: https://github.com/rust-lang/rust/pull/70156/
137 [71269]: https://github.com/rust-lang/rust/pull/71269/
138 [69838]: https://github.com/rust-lang/rust/pull/69838/
139 [69929]: https://github.com/rust-lang/rust/pull/69929/
140 [69661]: https://github.com/rust-lang/rust/pull/69661/
141 [69778]: https://github.com/rust-lang/rust/pull/69778/
142 [69494]: https://github.com/rust-lang/rust/pull/69494/
143 [69403]: https://github.com/rust-lang/rust/pull/69403/
144 [69033]: https://github.com/rust-lang/rust/pull/69033/
145 [68692]: https://github.com/rust-lang/rust/pull/68692/
146 [68334]: https://github.com/rust-lang/rust/pull/68334/
147 [67502]: https://github.com/rust-lang/rust/pull/67502/
148 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
149 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
150 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
151 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
152 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
153 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
154 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
155 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
156 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
157 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
158 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
159 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
160 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
161
162
163 Version 1.43.1 (2020-05-07)
164 ===========================
165
166 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
167 * [Fixed the stabilization of AVX-512 features.][71473]
168 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
169
170 [71430]: https://github.com/rust-lang/rust/pull/71430
171 [71473]: https://github.com/rust-lang/rust/issues/71473
172 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
173
174
175 Version 1.43.0 (2020-04-23)
176 ==========================
177
178 Language
179 --------
180 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
181   the type inferred correctly.][68129]
182 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
183
184 **Syntax only changes**
185 - [Allow `type Foo: Ord` syntactically.][69361]
186 - [Fuse associated and extern items up to defaultness.][69194]
187 - [Syntactically allow `self` in all `fn` contexts.][68764]
188 - [Merge `fn` syntax + cleanup item parsing.][68728]
189 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
190   For example, you may now write:
191   ```rust
192   macro_rules! mac_trait {
193       ($i:item) => {
194           trait T { $i }
195       }
196   }
197   mac_trait! {
198       fn foo() {}
199   }
200   ```
201
202 These are still rejected *semantically*, so you will likely receive an error but
203 these changes can be seen and parsed by macros and
204 conditional compilation.
205
206
207 Compiler
208 --------
209 - [You can now pass multiple lint flags to rustc to override the previous
210   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
211   everything in the `unused` lint group except `unused-variables` which
212   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
213   everything in the `unused` lint group **including** `unused-variables` since
214   the allow flag is specified before the deny flag (and therefore overridden).
215 - [rustc will now prefer your system MinGW libraries over its bundled libraries
216   if they are available on `windows-gnu`.][67429]
217 - [rustc now buffers errors/warnings printed in JSON.][69227]
218
219 Libraries
220 ---------
221 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
222   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
223   respectively.][69538] **Note** These conversions are only available when `N`
224   is `0..=32`.
225 - [You can now use associated constants on floats and integers directly, rather
226   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
227   `f32::NAN` with no imports.
228 - [`u8::is_ascii` is now `const`.][68984]
229 - [`String` now implements `AsMut<str>`.][68742]
230 - [Added the `primitive` module to `std` and `core`.][67637] This module
231   reexports Rust's primitive types. This is mainly useful in macros
232   where you want avoid these types being shadowed.
233 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
234 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
235
236 Stabilized APIs
237 ---------------
238 - [`Once::is_completed`]
239 - [`f32::LOG10_2`]
240 - [`f32::LOG2_10`]
241 - [`f64::LOG10_2`]
242 - [`f64::LOG2_10`]
243 - [`iter::once_with`]
244
245 Cargo
246 -----
247 - [You can now set config `[profile]`s in your `.cargo/config`, or through
248   your environment.][cargo/7823]
249 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
250   executable path when running integration tests or benchmarks.][cargo/7697]
251   `<name>` is the name of your binary as-is e.g. If you wanted the executable
252   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
253
254 Misc
255 ----
256 - [Certain checks in the `const_err` lint were deemed unrelated to const
257   evaluation][69185], and have been moved to the `unconditional_panic` and
258   `arithmetic_overflow` lints.
259
260 Compatibility Notes
261 -------------------
262
263 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
264   has been a warning since 1.36.0.
265 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
266   led to some instances being accepted, and now correctly emits a hard error.
267
268 [69340]: https://github.com/rust-lang/rust/pull/69340
269
270 Internal Only
271 -------------
272 These changes provide no direct user facing benefits, but represent significant
273 improvements to the internals and overall performance of `rustc` and
274 related tools.
275
276 - [All components are now built with `opt-level=3` instead of `2`.][67878]
277 - [Improved how rustc generates drop code.][67332]
278 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
279 - [traits: preallocate 2 Vecs of known initial size][69022]
280 - [Avoid exponential behaviour when relating types][68772]
281 - [Skip `Drop` terminators for enum variants without drop glue][68943]
282 - [Improve performance of coherence checks][68966]
283 - [Deduplicate types in the generator witness][68672]
284 - [Invert control in struct_lint_level.][68725]
285
286 [67332]: https://github.com/rust-lang/rust/pull/67332/
287 [67429]: https://github.com/rust-lang/rust/pull/67429/
288 [67637]: https://github.com/rust-lang/rust/pull/67637/
289 [67642]: https://github.com/rust-lang/rust/pull/67642/
290 [67878]: https://github.com/rust-lang/rust/pull/67878/
291 [67885]: https://github.com/rust-lang/rust/pull/67885/
292 [68129]: https://github.com/rust-lang/rust/pull/68129/
293 [68672]: https://github.com/rust-lang/rust/pull/68672/
294 [68725]: https://github.com/rust-lang/rust/pull/68725/
295 [68728]: https://github.com/rust-lang/rust/pull/68728/
296 [68738]: https://github.com/rust-lang/rust/pull/68738/
297 [68742]: https://github.com/rust-lang/rust/pull/68742/
298 [68764]: https://github.com/rust-lang/rust/pull/68764/
299 [68772]: https://github.com/rust-lang/rust/pull/68772/
300 [68943]: https://github.com/rust-lang/rust/pull/68943/
301 [68952]: https://github.com/rust-lang/rust/pull/68952/
302 [68966]: https://github.com/rust-lang/rust/pull/68966/
303 [68984]: https://github.com/rust-lang/rust/pull/68984/
304 [69022]: https://github.com/rust-lang/rust/pull/69022/
305 [69185]: https://github.com/rust-lang/rust/pull/69185/
306 [69194]: https://github.com/rust-lang/rust/pull/69194/
307 [69201]: https://github.com/rust-lang/rust/pull/69201/
308 [69227]: https://github.com/rust-lang/rust/pull/69227/
309 [69548]: https://github.com/rust-lang/rust/pull/69548/
310 [69256]: https://github.com/rust-lang/rust/pull/69256/
311 [69361]: https://github.com/rust-lang/rust/pull/69361/
312 [69366]: https://github.com/rust-lang/rust/pull/69366/
313 [69538]: https://github.com/rust-lang/rust/pull/69538/
314 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
315 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
316 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
317 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
318 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
319 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
320 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
321 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
322
323
324 Version 1.42.0 (2020-03-12)
325 ==========================
326
327 Language
328 --------
329 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
330   ```rust
331   fn foo(words: &[&str]) {
332       match words {
333           ["Hello", "World", "!", ..] => println!("Hello World!"),
334           ["Foo", "Bar", ..] => println!("Baz"),
335           rest => println!("{:?}", rest),
336       }
337   }
338   ```
339 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
340   that you can create an enum that has the exact layout and ABI of the type
341   it contains.
342 - [There are some *syntax-only* changes:][67131]
343    - `default` is syntactically allowed before items in `trait` definitions.
344    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
345      leave out their bodies in favor of `;`.
346    - Bounds on associated types in `impl`s are now syntactically allowed
347      (e.g. `type Foo: Ord;`).
348    - `...` (the C-variadic type) may occur syntactically directly as the type of
349       any function parameter.
350
351   These are still rejected *semantically*, so you will likely receive an error
352   but these changes can be seen and parsed by procedural macros and
353   conditional compilation.
354
355 Compiler
356 --------
357 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
358 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
359 - [`Option::{expect,unwrap}` and
360    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
361    pointing to the location where they were called, rather than
362    `core`'s internals. ][67887]
363
364 \* Refer to Rust's [platform support page][forge-platform-support] for more
365 information on Rust's tiered platform support.
366
367 Libraries
368 ---------
369 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
370 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
371    to implement `Sized`.][67935]
372 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
373 - [`Layout::new` is now `const`.][66254]
374 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
375
376
377 Stabilized APIs
378 ---------------
379 - [`CondVar::wait_while`]
380 - [`CondVar::wait_timeout_while`]
381 - [`DebugMap::key`]
382 - [`DebugMap::value`]
383 - [`ManuallyDrop::take`]
384 - [`matches!`]
385 - [`ptr::slice_from_raw_parts_mut`]
386 - [`ptr::slice_from_raw_parts`]
387
388 Cargo
389 -----
390 - [You no longer need to include `extern crate proc_macro;` to be able to
391   `use proc_macro;` in the `2018` edition.][cargo/7700]
392
393 Compatibility Notes
394 -------------------
395 - [`Error::description` has been deprecated, and its use will now produce a
396   warning.][66919] It's recommended to use `Display`/`to_string` instead.
397
398 [68253]: https://github.com/rust-lang/rust/pull/68253/
399 [68348]: https://github.com/rust-lang/rust/pull/68348/
400 [67935]: https://github.com/rust-lang/rust/pull/67935/
401 [68339]: https://github.com/rust-lang/rust/pull/68339/
402 [68122]: https://github.com/rust-lang/rust/pull/68122/
403 [67712]: https://github.com/rust-lang/rust/pull/67712/
404 [67887]: https://github.com/rust-lang/rust/pull/67887/
405 [67131]: https://github.com/rust-lang/rust/pull/67131/
406 [67233]: https://github.com/rust-lang/rust/pull/67233/
407 [66899]: https://github.com/rust-lang/rust/pull/66899/
408 [66919]: https://github.com/rust-lang/rust/pull/66919/
409 [66254]: https://github.com/rust-lang/rust/pull/66254/
410 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
411 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
412 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
413 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
414 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
415 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
416 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
417 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
418 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
419
420
421 Version 1.41.1 (2020-02-27)
422 ===========================
423
424 * [Always check types of static items][69145]
425 * [Always check lifetime bounds of `Copy` impls][69145]
426 * [Fix miscompilation in callers of `Layout::repeat`][69225]
427
428 [69225]: https://github.com/rust-lang/rust/issues/69225
429 [69145]: https://github.com/rust-lang/rust/pull/69145
430
431
432 Version 1.41.0 (2020-01-30)
433 ===========================
434
435 Language
436 --------
437
438 - [You can now pass type parameters to foreign items when implementing
439   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
440 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
441   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
442   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
443 - [You can now use any valid identifier in a `format_args` macro.][66847]
444   Previously identifiers starting with an underscore were not allowed.
445 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
446   enum variants.][66183] These are still rejected semantically, but
447   can be seen and parsed by procedural macros and conditional compilation.
448
449 Compiler
450 --------
451
452 - [Rustc will now warn if you have unused loop `'label`s.][66325]
453 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
454 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
455 - [You can now pass an arguments file passing the `@path` syntax
456   to rustc.][66172] Note that the format differs somewhat from what is
457   found in other tooling; please see [the documentation][argfile-docs] for
458   more information.
459 - [You can now provide `--extern` flag without a path, indicating that it is
460   available from the search path or specified with an `-L` flag.][64882]
461
462 \* Refer to Rust's [platform support page][forge-platform-support] for more
463 information on Rust's tiered platform support.
464
465 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
466
467 Libraries
468 ---------
469
470 - [The `core::panic` module is now stable.][66771] It was already stable
471   through `std`.
472 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
473   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
474 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
475
476 Stabilized APIs
477 ---------------
478
479 - [`Result::map_or`]
480 - [`Result::map_or_else`]
481 - [`std::rc::Weak::weak_count`]
482 - [`std::rc::Weak::strong_count`]
483 - [`std::sync::Weak::weak_count`]
484 - [`std::sync::Weak::strong_count`]
485
486 Cargo
487 -----
488
489 - [Cargo will now document all the private items for binary crates
490   by default.][cargo/7593]
491 - [`cargo-install` will now reinstall the package if it detects that it is out
492   of date.][cargo/7560]
493 - [Cargo.lock now uses a more git friendly format that should help to reduce
494   merge conflicts.][cargo/7579]
495 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
496   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
497   optimisation level to `2` for debug builds. You can also use
498   `[profile.<profile>.build-override]` to override build scripts and
499   their dependencies.
500
501 Misc
502 ----
503
504 - [You can now specify `edition` in documentation code blocks to compile the block
505   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
506   should be compiled the 2018 edition of Rust.
507 - [You can now provide custom themes to rustdoc with `--theme`, and check the
508   current theme with `--check-theme`.][54733]
509 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
510
511 Compatibility Notes
512 -------------------
513
514 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
515   Apple targets.][apple-32bit-drop] This means that the source code is still
516   available to build, but the targets are no longer being tested and release
517   binaries for those platforms will no longer be distributed by the Rust project.
518   Please refer to the linked blog post for more information.
519
520 [54733]: https://github.com/rust-lang/rust/pull/54733/
521 [61351]: https://github.com/rust-lang/rust/pull/61351/
522 [67255]: https://github.com/rust-lang/rust/pull/67255/
523 [66661]: https://github.com/rust-lang/rust/pull/66661/
524 [66771]: https://github.com/rust-lang/rust/pull/66771/
525 [66847]: https://github.com/rust-lang/rust/pull/66847/
526 [66238]: https://github.com/rust-lang/rust/pull/66238/
527 [66277]: https://github.com/rust-lang/rust/pull/66277/
528 [66325]: https://github.com/rust-lang/rust/pull/66325/
529 [66172]: https://github.com/rust-lang/rust/pull/66172/
530 [66183]: https://github.com/rust-lang/rust/pull/66183/
531 [65879]: https://github.com/rust-lang/rust/pull/65879/
532 [65013]: https://github.com/rust-lang/rust/pull/65013/
533 [64882]: https://github.com/rust-lang/rust/pull/64882/
534 [64325]: https://github.com/rust-lang/rust/pull/64325/
535 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
536 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
537 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
538 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
539 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
540 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
541 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
542 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
543 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
544 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
545 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
546
547 Version 1.40.0 (2019-12-19)
548 ===========================
549
550 Language
551 --------
552 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
553   `const` contexts.][65188] e.g.
554
555   ```rust
556   pub struct Point(i32, i32);
557
558   const ORIGIN: Point = {
559       let constructor = Point;
560
561       constructor(0, 0)
562   };
563   ```
564
565 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
566   indicate that there may be variants or fields added in the future.][64639]
567   For example this requires adding a wild-card branch (`_ => {}`) to any match
568   statements on a non-exhaustive `enum`. [(RFC 2008)]
569 - [You can now use function-like procedural macros in `extern` blocks and in
570   type positions.][63931] e.g. `type Generated = macro!();`
571 - [Function-like and attribute procedural macros can now emit
572   `macro_rules!` items, so you can now have your macros generate macros.][64035]
573 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
574   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
575   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
576
577 Compiler
578 --------
579 - [Added tier 3 support\* for the
580   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
581 - [Added tier 3 support for the
582   `aarch64-unknown-none-softfloat` target.][64589]
583 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
584   `mips64el-unknown-linux-muslabi64` targets.][65843]
585
586 \* Refer to Rust's [platform support page][forge-platform-support] for more
587   information on Rust's tiered platform support.
588
589 Libraries
590 ---------
591 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
592
593 Stabilized APIs
594 ---------------
595 - [`BTreeMap::get_key_value`]
596 - [`HashMap::get_key_value`]
597 - [`Option::as_deref_mut`]
598 - [`Option::as_deref`]
599 - [`Option::flatten`]
600 - [`UdpSocket::peer_addr`]
601 - [`f32::to_be_bytes`]
602 - [`f32::to_le_bytes`]
603 - [`f32::to_ne_bytes`]
604 - [`f64::to_be_bytes`]
605 - [`f64::to_le_bytes`]
606 - [`f64::to_ne_bytes`]
607 - [`f32::from_be_bytes`]
608 - [`f32::from_le_bytes`]
609 - [`f32::from_ne_bytes`]
610 - [`f64::from_be_bytes`]
611 - [`f64::from_le_bytes`]
612 - [`f64::from_ne_bytes`]
613 - [`mem::take`]
614 - [`slice::repeat`]
615 - [`todo!`]
616
617 Cargo
618 -----
619 - [Cargo will now always display warnings, rather than only on
620   fresh builds.][cargo/7450]
621 - [Feature flags (except `--all-features`) passed to a virtual workspace will
622   now produce an error.][cargo/7507] Previously these flags were ignored.
623 - [You can now publish `dev-dependencies` without including
624   a `version`.][cargo/7333]
625
626 Misc
627 ----
628 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
629   when running documentation tests with `rustdoc`.][63803]
630
631 Compatibility Notes
632 -------------------
633 - [As previously announced, any previous NLL warnings in the 2015 edition are
634   now hard errors.][64221]
635 - [The `include!` macro will now warn if it failed to include the
636   entire file.][64284] The `include!` macro unintentionally only includes the
637   first _expression_ in a file, and this can be unintuitive. This will become
638   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
639 - [Using `#[inline]` on function prototypes and consts now emits a warning under
640   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
641   or `extern` blocks now correctly emits a hard error.
642
643 [65294]: https://github.com/rust-lang/rust/pull/65294/
644 [66103]: https://github.com/rust-lang/rust/pull/66103/
645 [65843]: https://github.com/rust-lang/rust/pull/65843/
646 [65188]: https://github.com/rust-lang/rust/pull/65188/
647 [65092]: https://github.com/rust-lang/rust/pull/65092/
648 [64589]: https://github.com/rust-lang/rust/pull/64589/
649 [64639]: https://github.com/rust-lang/rust/pull/64639/
650 [64221]: https://github.com/rust-lang/rust/pull/64221/
651 [64284]: https://github.com/rust-lang/rust/pull/64284/
652 [63931]: https://github.com/rust-lang/rust/pull/63931/
653 [64035]: https://github.com/rust-lang/rust/pull/64035/
654 [63674]: https://github.com/rust-lang/rust/pull/63674/
655 [63803]: https://github.com/rust-lang/rust/pull/63803/
656 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
657 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
658 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
659 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
660 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
661 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
662 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
663 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
664 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
665 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
666 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
667 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
668 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
669 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
670 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
671 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
672 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
673 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
674 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
675 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
676 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
677 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
678 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
679 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
680 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
681 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
682
683
684 Version 1.39.0 (2019-11-07)
685 ===========================
686
687 Language
688 --------
689 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
690   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
691 - [You can now use certain attributes on function, closure, and function pointer
692   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
693   `deny`, `forbid` as well as inert helper attributes used by procedural macro
694   attributes applied to items. e.g.
695   ```rust
696   fn len(
697       #[cfg(windows)] slice: &[u16],
698       #[cfg(not(windows))] slice: &[u8],
699   ) -> usize {
700       slice.len()
701   }
702   ```
703 - [You can now take shared references to bind-by-move patterns in the `if` guards
704   of `match` arms.][63118] e.g.
705   ```rust
706   fn main() {
707       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
708
709       match array {
710           nums
711   //      ---- `nums` is bound by move.
712               if nums.iter().sum::<u8>() == 10
713   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
714           => {
715               drop(nums);
716   //          ----------- Legal as `nums` was bound by move and so we have ownership.
717           }
718           _ => unreachable!(),
719       }
720   }
721   ```
722
723
724
725 Compiler
726 --------
727 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
728 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
729 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
730   **Note** Cargo currently doesn't use this feature. Refer to
731   [cargo#7315][cargo/7315] to track this feature's progress.
732 - [You can now pass `--show-output` argument to test binaries to print the
733   output of successful tests.][62600]
734
735
736 \* Refer to Rust's [platform support page][forge-platform-support] for more
737 information on Rust's tiered platform support.
738
739 Libraries
740 ---------
741 - [`Vec::new` and `String::new` are now `const` functions.][64028]
742 - [`LinkedList::new` is now a `const` function.][63684]
743 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
744 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
745   now `const`.][63786]
746
747 Stabilized APIs
748 ---------------
749 - [`Pin::into_inner`]
750 - [`Instant::checked_duration_since`]
751 - [`Instant::saturating_duration_since`]
752
753 Cargo
754 -----
755 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
756 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
757   `--all` is now deprecated.
758
759 Misc
760 ----
761 - [You can now pass `-Clinker` to rustdoc to control the linker used
762   for compiling doctests.][63834]
763
764 Compatibility Notes
765 -------------------
766 - [Code that was previously accepted by the old borrow checker, but rejected by
767   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
768   previously a warning, and will also become a hard error in the Rust 2015
769   edition in the 1.40.0 release.
770 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
771   run tests.][63827] This should improve performance when running a large
772   amount of doctests.
773 - [The `try!` macro will now issue a deprecation warning.][62672] It is
774   recommended to use the `?` operator instead.
775 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
776   returned `0.0`.
777
778 [62600]: https://github.com/rust-lang/rust/pull/62600/
779 [62672]: https://github.com/rust-lang/rust/pull/62672/
780 [63118]: https://github.com/rust-lang/rust/pull/63118/
781 [63209]: https://github.com/rust-lang/rust/pull/63209/
782 [63402]: https://github.com/rust-lang/rust/pull/63402/
783 [63565]: https://github.com/rust-lang/rust/pull/63565/
784 [63595]: https://github.com/rust-lang/rust/pull/63595/
785 [63684]: https://github.com/rust-lang/rust/pull/63684/
786 [63698]: https://github.com/rust-lang/rust/pull/63698/
787 [63770]: https://github.com/rust-lang/rust/pull/63770/
788 [63786]: https://github.com/rust-lang/rust/pull/63786/
789 [63827]: https://github.com/rust-lang/rust/pull/63827/
790 [63834]: https://github.com/rust-lang/rust/pull/63834/
791 [63927]: https://github.com/rust-lang/rust/pull/63927/
792 [63933]: https://github.com/rust-lang/rust/pull/63933/
793 [63934]: https://github.com/rust-lang/rust/pull/63934/
794 [63938]: https://github.com/rust-lang/rust/pull/63938/
795 [63940]: https://github.com/rust-lang/rust/pull/63940/
796 [63941]: https://github.com/rust-lang/rust/pull/63941/
797 [63945]: https://github.com/rust-lang/rust/pull/63945/
798 [64010]: https://github.com/rust-lang/rust/pull/64010/
799 [64028]: https://github.com/rust-lang/rust/pull/64028/
800 [64334]: https://github.com/rust-lang/rust/pull/64334/
801 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
802 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
803 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
804 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
805 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
806 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
807
808 Version 1.38.0 (2019-09-26)
809 ==========================
810
811 Language
812 --------
813 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
814 - [The `#[deprecated]` attribute can now be used on macros.][62042]
815
816 Compiler
817 --------
818 - [Added pipelined compilation support to `rustc`.][62766] This will
819   improve compilation times in some cases. For further information please refer
820   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
821 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
822   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
823   `x86_64-uwp-windows-msvc` targets.][60260]
824 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
825   `armv7-unknown-linux-musleabi` targets.][63107]
826 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
827 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
828
829 \* Refer to Rust's [platform support page][forge-platform-support] for more
830 information on Rust's tiered platform support.
831
832 Libraries
833 ---------
834 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
835 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
836   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
837   is available at `std::clone::Clone`). This also makes all built-in macros
838   available in `std`/`core` root. e.g. `std::include_bytes!`.
839 - [`str::Chars` now implements `Debug`.][63000]
840 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
841 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
842 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
843 - [Added euclidean remainder and division operations (`div_euclid`,
844   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
845   `overflowing`, and `wrapping` versions are available for all
846   integer primitives.
847 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
848   `PartialEq`.][61491]
849 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
850
851 Stabilized APIs
852 ---------------
853 - [`<*const T>::cast`]
854 - [`<*mut T>::cast`]
855 - [`Duration::as_secs_f32`]
856 - [`Duration::as_secs_f64`]
857 - [`Duration::div_f32`]
858 - [`Duration::div_f64`]
859 - [`Duration::from_secs_f32`]
860 - [`Duration::from_secs_f64`]
861 - [`Duration::mul_f32`]
862 - [`Duration::mul_f64`]
863 - [`any::type_name`]
864
865 Cargo
866 -----
867 - [Added pipelined compilation support to `cargo`.][cargo/7143]
868 - [You can now pass the `--features` option multiple times to enable
869   multiple features.][cargo/7084]
870
871 Misc
872 ----
873 - [`rustc` will now warn about some incorrect uses of
874   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
875
876 Compatibility Notes
877 -------------------
878 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
879   1.38.0.
880 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
881   issues][62896] with certain crates such as libc.
882
883 [60260]: https://github.com/rust-lang/rust/pull/60260/
884 [61457]: https://github.com/rust-lang/rust/pull/61457/
885 [61491]: https://github.com/rust-lang/rust/pull/61491/
886 [61884]: https://github.com/rust-lang/rust/pull/61884/
887 [61953]: https://github.com/rust-lang/rust/pull/61953/
888 [62042]: https://github.com/rust-lang/rust/pull/62042/
889 [62528]: https://github.com/rust-lang/rust/pull/62528/
890 [62583]: https://github.com/rust-lang/rust/pull/62583/
891 [62735]: https://github.com/rust-lang/rust/pull/62735/
892 [62766]: https://github.com/rust-lang/rust/pull/62766/
893 [62784]: https://github.com/rust-lang/rust/pull/62784/
894 [62785]: https://github.com/rust-lang/rust/issues/62785/
895 [62814]: https://github.com/rust-lang/rust/pull/62814/
896 [62896]: https://github.com/rust-lang/rust/issues/62896/
897 [63000]: https://github.com/rust-lang/rust/pull/63000/
898 [63056]: https://github.com/rust-lang/rust/pull/63056/
899 [63107]: https://github.com/rust-lang/rust/pull/63107/
900 [63346]: https://github.com/rust-lang/rust/pull/63346/
901 [63421]: https://github.com/rust-lang/rust/pull/63421/
902 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
903 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
904 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
905 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
906 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
907 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
908 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
909 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
910 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
911 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
912 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
913 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
914 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
915 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
916 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
917
918 Version 1.37.0 (2019-08-15)
919 ==========================
920
921 Language
922 --------
923 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
924   [`Box`][62228], or an [array][62235] and unused.
925 - [You can now use the `cfg` and `cfg_attr` attributes on
926   generic parameters.][61547]
927 - [You can now use enum variants through type alias.][61682] e.g. You can
928   write the following:
929   ```rust
930   type MyOption = Option<u8>;
931
932   fn increment_or_zero(x: MyOption) -> u8 {
933       match x {
934           MyOption::Some(y) => y + 1,
935           MyOption::None => 0,
936       }
937   }
938   ```
939 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
940   `const _: u32 = 5;`.
941 - [You can now use `#[repr(align(X)]` on enums.][61229]
942 - [The  `?` Kleene macro operator is now available in the
943   2015 edition.][60932]
944
945 Compiler
946 --------
947 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
948   and `-C profile-use` flags.][61268] For more information on how to use profile
949   guided optimization, please refer to the [rustc book][rustc-book-pgo].
950 - [The `rust-lldb` wrapper script should now work again.][61827]
951
952 Libraries
953 ---------
954 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
955
956 Stabilized APIs
957 ---------------
958 - [`BufReader::buffer`]
959 - [`BufWriter::buffer`]
960 - [`Cell::from_mut`]
961 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
962 - [`DoubleEndedIterator::nth_back`]
963 - [`Option::xor`]
964 - [`Wrapping::reverse_bits`]
965 - [`i128::reverse_bits`]
966 - [`i16::reverse_bits`]
967 - [`i32::reverse_bits`]
968 - [`i64::reverse_bits`]
969 - [`i8::reverse_bits`]
970 - [`isize::reverse_bits`]
971 - [`slice::copy_within`]
972 - [`u128::reverse_bits`]
973 - [`u16::reverse_bits`]
974 - [`u32::reverse_bits`]
975 - [`u64::reverse_bits`]
976 - [`u8::reverse_bits`]
977 - [`usize::reverse_bits`]
978
979 Cargo
980 -----
981 - [`Cargo.lock` files are now included by default when publishing executable crates
982   with executables.][cargo/7026]
983 - [You can now specify `default-run="foo"` in `[package]` to specify the
984   default executable to use for `cargo run`.][cargo/7056]
985
986 Misc
987 ----
988
989 Compatibility Notes
990 -------------------
991 - [Using `...` for inclusive range patterns will now warn by default.][61342]
992   Please transition your code to using the `..=` syntax for inclusive
993   ranges instead.
994 - [Using a trait object without the `dyn` will now warn by default.][61203]
995   Please transition your code to use `dyn Trait` for trait objects instead.
996
997 [62228]: https://github.com/rust-lang/rust/pull/62228/
998 [62235]: https://github.com/rust-lang/rust/pull/62235/
999 [61802]: https://github.com/rust-lang/rust/pull/61802/
1000 [61827]: https://github.com/rust-lang/rust/pull/61827/
1001 [61547]: https://github.com/rust-lang/rust/pull/61547/
1002 [61682]: https://github.com/rust-lang/rust/pull/61682/
1003 [61268]: https://github.com/rust-lang/rust/pull/61268/
1004 [61342]: https://github.com/rust-lang/rust/pull/61342/
1005 [61347]: https://github.com/rust-lang/rust/pull/61347/
1006 [61100]: https://github.com/rust-lang/rust/pull/61100/
1007 [61203]: https://github.com/rust-lang/rust/pull/61203/
1008 [61229]: https://github.com/rust-lang/rust/pull/61229/
1009 [60932]: https://github.com/rust-lang/rust/pull/60932/
1010 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1011 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1012 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1013 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1014 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1015 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1016 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1017 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1018 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1019 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1020 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1021 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1022 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1023 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1024 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1025 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1026 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1027 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1028 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1029 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1030 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1031 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1032 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1033 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1034
1035
1036 Version 1.36.0 (2019-07-04)
1037 ==========================
1038
1039 Language
1040 --------
1041 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1042 - [The order of traits in trait objects no longer affects the semantics of that
1043   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1044   `dyn fmt::Debug + Send`, where this was previously not the case.
1045
1046 Libraries
1047 ---------
1048 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1049 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1050 - [`mem::needs_drop` is now available as a const fn.][60364]
1051 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1052 - [`String` now implements `BorrowMut<str>`.][60404]
1053 - [`io::Cursor` now implements `Default`.][60234]
1054 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1055 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1056   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1057   environment has access to heap memory allocation.
1058 - [`String` now implements `From<&String>`.][59825]
1059 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1060   return a tuple of each argument when there is multiple arguments.
1061 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1062   not used.][59648]
1063
1064 Stabilized APIs
1065 ---------------
1066 - [`VecDeque::rotate_left`]
1067 - [`VecDeque::rotate_right`]
1068 - [`Iterator::copied`]
1069 - [`io::IoSlice`]
1070 - [`io::IoSliceMut`]
1071 - [`Read::read_vectored`]
1072 - [`Write::write_vectored`]
1073 - [`str::as_mut_ptr`]
1074 - [`mem::MaybeUninit`]
1075 - [`pointer::align_offset`]
1076 - [`future::Future`]
1077 - [`task::Context`]
1078 - [`task::RawWaker`]
1079 - [`task::RawWakerVTable`]
1080 - [`task::Waker`]
1081 - [`task::Poll`]
1082
1083 Cargo
1084 -----
1085 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1086 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1087
1088 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1089
1090 Clippy
1091 ------
1092 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1093
1094 Misc
1095 ----
1096
1097 Compatibility Notes
1098 -------------------
1099 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1100   longer recommended, and will be deprecated in 1.39.0.
1101
1102 [60318]: https://github.com/rust-lang/rust/pull/60318/
1103 [60364]: https://github.com/rust-lang/rust/pull/60364/
1104 [60370]: https://github.com/rust-lang/rust/pull/60370/
1105 [60404]: https://github.com/rust-lang/rust/pull/60404/
1106 [60234]: https://github.com/rust-lang/rust/pull/60234/
1107 [60244]: https://github.com/rust-lang/rust/pull/60244/
1108 [58623]: https://github.com/rust-lang/rust/pull/58623/
1109 [59648]: https://github.com/rust-lang/rust/pull/59648/
1110 [59675]: https://github.com/rust-lang/rust/pull/59675/
1111 [59825]: https://github.com/rust-lang/rust/pull/59825/
1112 [59826]: https://github.com/rust-lang/rust/pull/59826/
1113 [59445]: https://github.com/rust-lang/rust/pull/59445/
1114 [59114]: https://github.com/rust-lang/rust/pull/59114/
1115 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1116 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1117 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1118 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1119 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1120 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1121 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1122 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1123 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1124 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1125 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1126 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1127 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1128 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1129 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1130 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1131 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1132 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1133 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1134 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1135
1136
1137 Version 1.35.0 (2019-05-23)
1138 ==========================
1139
1140 Language
1141 --------
1142 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1143   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1144 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1145   ```rust
1146   unsafe fn call_unsafe(func: unsafe fn()) {
1147       func()
1148   }
1149
1150   pub fn main() {
1151       unsafe { call_unsafe(|| {}); }
1152   }
1153   ```
1154
1155
1156 Compiler
1157 --------
1158 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1159   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1160 - [Added the `wasm32-unknown-wasi` target.][59464]
1161
1162
1163 Libraries
1164 ---------
1165 - [`Thread` will now show its ID in `Debug` output.][59460]
1166 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1167 - [`alloc::System` now implements `Default`.][59451]
1168 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1169   last field.][59076]
1170 - [`char::{ToLowercase, ToUppercase}` now
1171   implement `ExactSizeIterator`.][58778]
1172 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1173 - [Removed the `Read` trait bounds
1174   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1175 - [You can now call the `dbg!` macro without any parameters to print the file
1176   and line where it is called.][57847]
1177 - [In place ASCII case conversions are now up to 4× faster.][59283]
1178   e.g. `str::make_ascii_lowercase`
1179 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1180   and `Send`.][58369]
1181
1182 Stabilized APIs
1183 ---------------
1184 - [`f32::copysign`]
1185 - [`f64::copysign`]
1186 - [`RefCell::replace_with`]
1187 - [`RefCell::map_split`]
1188 - [`ptr::hash`]
1189 - [`Range::contains`]
1190 - [`RangeFrom::contains`]
1191 - [`RangeTo::contains`]
1192 - [`RangeInclusive::contains`]
1193 - [`RangeToInclusive::contains`]
1194 - [`Option::copied`]
1195
1196 Cargo
1197 -----
1198 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1199   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1200   platform specific.
1201
1202 Misc
1203 ----
1204 - [The Rust toolchain is now available natively for musl based distros.][58575]
1205
1206 [59460]: https://github.com/rust-lang/rust/pull/59460/
1207 [59464]: https://github.com/rust-lang/rust/pull/59464/
1208 [59500]: https://github.com/rust-lang/rust/pull/59500/
1209 [59512]: https://github.com/rust-lang/rust/pull/59512/
1210 [59580]: https://github.com/rust-lang/rust/pull/59580/
1211 [59283]: https://github.com/rust-lang/rust/pull/59283/
1212 [59451]: https://github.com/rust-lang/rust/pull/59451/
1213 [59076]: https://github.com/rust-lang/rust/pull/59076/
1214 [58778]: https://github.com/rust-lang/rust/pull/58778/
1215 [58717]: https://github.com/rust-lang/rust/pull/58717/
1216 [58369]: https://github.com/rust-lang/rust/pull/58369/
1217 [58423]: https://github.com/rust-lang/rust/pull/58423/
1218 [58080]: https://github.com/rust-lang/rust/pull/58080/
1219 [57847]: https://github.com/rust-lang/rust/pull/57847/
1220 [58575]: https://github.com/rust-lang/rust/pull/58575
1221 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1222 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1223 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1224 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1225 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1226 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1227 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1228 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1229 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1230 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1231 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1232 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1233
1234 Version 1.34.2 (2019-05-14)
1235 ===========================
1236
1237 * [Destabilize the `Error::type_id` function due to a security
1238    vulnerability][60785] ([CVE-2019-12083])
1239
1240 [60785]: https://github.com/rust-lang/rust/pull/60785
1241 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1242
1243 Version 1.34.1 (2019-04-25)
1244 ===========================
1245
1246 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1247 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1248 * [Fix Clippy panic when checking some macros][clippy/3805]
1249
1250 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1251 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1252 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1253
1254 Version 1.34.0 (2019-04-11)
1255 ==========================
1256
1257 Language
1258 --------
1259 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1260   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1261   but had no effect.
1262 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1263   `#[attr{}]` procedural macros.][57367]
1264 - [You can now write `extern crate self as foo;`][57407] to import your
1265   crate's root into the extern prelude.
1266
1267
1268 Compiler
1269 --------
1270 - [You can now target `riscv64imac-unknown-none-elf` and
1271   `riscv64gc-unknown-none-elf`.][58406]
1272 - [You can now enable linker plugin LTO optimisations with
1273   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1274   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1275   boundaries.
1276 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1277
1278
1279 Libraries
1280 ---------
1281 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1282   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1283   the `Hash` trait to create an iterator.
1284 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1285   methods.][58421] Most notably you no longer require the `Ord` trait to create
1286   an iterator.
1287 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1288   for all numeric types.][58044]
1289 - [Indexing a `str` is now generic over all types that
1290   implement `SliceIndex<str>`.][57604]
1291 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1292   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1293   produce a warning if their returning type is unused.
1294 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1295   `overflowing_pow` are now available for all numeric types.][57873] These are
1296   equivalent to methods such as `wrapping_add` for the `pow` operation.
1297
1298
1299 Stabilized APIs
1300 ---------------
1301
1302 #### std & core
1303 * [`Any::type_id`]
1304 * [`Error::type_id`]
1305 * [`atomic::AtomicI16`]
1306 * [`atomic::AtomicI32`]
1307 * [`atomic::AtomicI64`]
1308 * [`atomic::AtomicI8`]
1309 * [`atomic::AtomicU16`]
1310 * [`atomic::AtomicU32`]
1311 * [`atomic::AtomicU64`]
1312 * [`atomic::AtomicU8`]
1313 * [`convert::Infallible`]
1314 * [`convert::TryFrom`]
1315 * [`convert::TryInto`]
1316 * [`iter::from_fn`]
1317 * [`iter::successors`]
1318 * [`num::NonZeroI128`]
1319 * [`num::NonZeroI16`]
1320 * [`num::NonZeroI32`]
1321 * [`num::NonZeroI64`]
1322 * [`num::NonZeroI8`]
1323 * [`num::NonZeroIsize`]
1324 * [`slice::sort_by_cached_key`]
1325 * [`str::escape_debug`]
1326 * [`str::escape_default`]
1327 * [`str::escape_unicode`]
1328 * [`str::split_ascii_whitespace`]
1329
1330 #### std
1331 * [`Instant::checked_add`]
1332 * [`Instant::checked_sub`]
1333 * [`SystemTime::checked_add`]
1334 * [`SystemTime::checked_sub`]
1335
1336 Cargo
1337 -----
1338 - [You can now use alternative registries to crates.io.][cargo/6654]
1339
1340 Misc
1341 ----
1342 - [You can now use the `?` operator in your documentation tests without manually
1343   adding `fn main() -> Result<(), _> {}`.][56470]
1344
1345 Compatibility Notes
1346 -------------------
1347 - [`Command::before_exec` is being replaced by the unsafe method
1348   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1349 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1350   can now use `const` functions in `static` variables.
1351
1352 [58370]: https://github.com/rust-lang/rust/pull/58370/
1353 [58406]: https://github.com/rust-lang/rust/pull/58406/
1354 [58421]: https://github.com/rust-lang/rust/pull/58421/
1355 [58166]: https://github.com/rust-lang/rust/pull/58166/
1356 [58044]: https://github.com/rust-lang/rust/pull/58044/
1357 [58057]: https://github.com/rust-lang/rust/pull/58057/
1358 [58059]: https://github.com/rust-lang/rust/pull/58059/
1359 [57809]: https://github.com/rust-lang/rust/pull/57809/
1360 [57873]: https://github.com/rust-lang/rust/pull/57873/
1361 [57604]: https://github.com/rust-lang/rust/pull/57604/
1362 [57367]: https://github.com/rust-lang/rust/pull/57367/
1363 [57407]: https://github.com/rust-lang/rust/pull/57407/
1364 [57425]: https://github.com/rust-lang/rust/pull/57425/
1365 [57106]: https://github.com/rust-lang/rust/pull/57106/
1366 [56470]: https://github.com/rust-lang/rust/pull/56470/
1367 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1368 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1369 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1370 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1371 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1372 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1373 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1374 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1375 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1376 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1377 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1378 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1379 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1380 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1381 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1382 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1383 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1384 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1385 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1386 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1387 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1388 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1389 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1390 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1391 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1392 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1393 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1394 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1395 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1396 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1397 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1398
1399
1400 Version 1.33.0 (2019-02-28)
1401 ==========================
1402
1403 Language
1404 --------
1405 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1406   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1407 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1408   E.g. You can have match statement on a `u8` that covers `0..=255` and
1409   you would no longer be required to have a `_ => unreachable!()` case.
1410 - [You can now have multiple patterns in `if let` and `while let`
1411   expressions.][57532] You can do this with the same syntax as a `match`
1412   expression. E.g.
1413   ```rust
1414   enum Creature {
1415       Crab(String),
1416       Lobster(String),
1417       Person(String),
1418   }
1419
1420   fn main() {
1421       let state = Creature::Crab("Ferris");
1422
1423       if let Creature::Crab(name) | Creature::Person(name) = state {
1424           println!("This creature's name is: {}", name);
1425       }
1426   }
1427   ```
1428 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1429   this feature will by default produce a warning as this behaviour can be
1430   unintuitive. E.g. `if let _ = 5 {}`
1431 - [You can now use `let` bindings, assignments, expression statements,
1432   and irrefutable pattern destructuring in const functions.][57175]
1433 - [You can now call unsafe const functions.][57067] E.g.
1434   ```rust
1435   const unsafe fn foo() -> i32 { 5 }
1436   const fn bar() -> i32 {
1437       unsafe { foo() }
1438   }
1439   ```
1440 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1441   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1442 - [You can now specify a specific alignment with the `#[repr(packed)]`
1443   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1444   with an alignment of 2 bytes and a size of 6 bytes.
1445 - [You can now import an item from a module as an `_`.][56303] This allows you to
1446   import a trait's impls, and not have the name in the namespace. E.g.
1447   ```rust
1448   use std::io::Read as _;
1449
1450   // Allowed as there is only one `Read` in the module.
1451   pub trait Read {}
1452   ```
1453 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1454
1455 Compiler
1456 --------
1457 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1458   command line argument.][56351]
1459 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1460 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1461 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1462   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1463   information on Rust's platform support.
1464 - [Added support for the `thumbv7neon-linux-androideabi` and
1465   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1466 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1467
1468 Libraries
1469 ---------
1470 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1471   functions for all numeric types.][57566]
1472 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1473   are now `const` functions for all numeric types.][57105]
1474 - [The methods `is_positive` and `is_negative` are now `const` functions for
1475   all signed numeric types.][57105]
1476 - [The `get` method for all `NonZero` types is now `const`.][57167]
1477 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1478   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1479   numeric types.][57234]
1480 - [`Ipv4Addr::new` is now a `const` function][57234]
1481
1482 Stabilized APIs
1483 ---------------
1484 - [`unix::FileExt::read_exact_at`]
1485 - [`unix::FileExt::write_all_at`]
1486 - [`Option::transpose`]
1487 - [`Result::transpose`]
1488 - [`convert::identity`]
1489 - [`pin::Pin`]
1490 - [`marker::Unpin`]
1491 - [`marker::PhantomPinned`]
1492 - [`Vec::resize_with`]
1493 - [`VecDeque::resize_with`]
1494 - [`Duration::as_millis`]
1495 - [`Duration::as_micros`]
1496 - [`Duration::as_nanos`]
1497
1498
1499 Cargo
1500 -----
1501 - [You can now publish crates that require a feature flag to compile with
1502   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1503 - [Cargo should now rebuild a crate if a file was modified during the initial
1504   build.][cargo/6484]
1505
1506 Compatibility Notes
1507 -------------------
1508 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1509   are now deprecated in the standard library, and their usage will now produce a warning.
1510   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1511   methods instead.
1512 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1513   downcasting.
1514 - [Libtest no longer creates a new thread for each test when
1515   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1516
1517 [55982]: https://github.com/rust-lang/rust/pull/55982/
1518 [56243]: https://github.com/rust-lang/rust/pull/56243
1519 [56303]: https://github.com/rust-lang/rust/pull/56303/
1520 [56351]: https://github.com/rust-lang/rust/pull/56351/
1521 [56362]: https://github.com/rust-lang/rust/pull/56362
1522 [56642]: https://github.com/rust-lang/rust/pull/56642/
1523 [56769]: https://github.com/rust-lang/rust/pull/56769/
1524 [56805]: https://github.com/rust-lang/rust/pull/56805
1525 [56947]: https://github.com/rust-lang/rust/pull/56947/
1526 [57049]: https://github.com/rust-lang/rust/pull/57049/
1527 [57067]: https://github.com/rust-lang/rust/pull/57067/
1528 [57105]: https://github.com/rust-lang/rust/pull/57105
1529 [57130]: https://github.com/rust-lang/rust/pull/57130/
1530 [57167]: https://github.com/rust-lang/rust/pull/57167/
1531 [57175]: https://github.com/rust-lang/rust/pull/57175/
1532 [57234]: https://github.com/rust-lang/rust/pull/57234/
1533 [57332]: https://github.com/rust-lang/rust/pull/57332/
1534 [57465]: https://github.com/rust-lang/rust/pull/57465/
1535 [57532]: https://github.com/rust-lang/rust/pull/57532/
1536 [57535]: https://github.com/rust-lang/rust/pull/57535/
1537 [57566]: https://github.com/rust-lang/rust/pull/57566/
1538 [57615]: https://github.com/rust-lang/rust/pull/57615/
1539 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1540 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1541 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1542 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1543 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1544 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1545 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1546 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1547 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1548 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1549 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1550 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1551 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1552 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1553 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1554 [platform-support]: https://forge.rust-lang.org/platform-support.html
1555
1556 Version 1.32.0 (2019-01-17)
1557 ==========================
1558
1559 Language
1560 --------
1561 #### 2018 edition
1562 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1563   operator allows you to specify zero or one repetitions similar to the `*` and
1564   `+` operators.
1565 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1566   now always resolve to the item (`enum`, `struct`, etc.) available in the
1567   module if present, before resolving to a external crate or an item the prelude.][56759]
1568   E.g.
1569   ```rust
1570   enum Color { Red, Green, Blue }
1571
1572   use Color::*;
1573   ```
1574
1575 #### All editions
1576 - [You can now match against `PhantomData<T>` types.][55837]
1577 - [You can now match against literals in macros with the `literal`
1578   specifier.][56072] This will match against a literal of any type.
1579   E.g. `1`, `'A'`, `"Hello World"`
1580 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1581   ```rust
1582   struct Point(i32, i32);
1583
1584   impl Point {
1585       pub fn new(x: i32, y: i32) -> Self {
1586           Self(x, y)
1587       }
1588
1589       pub fn is_origin(&self) -> bool {
1590           match self {
1591               Self(0, 0) => true,
1592               _ => false,
1593           }
1594       }
1595   }
1596   ```
1597 - [Self can also now be used in type definitions.][56366] E.g.
1598   ```rust
1599   enum List<T>
1600   where
1601       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1602   {
1603       Nil,
1604       Cons(T, Box<Self>) // likewise here
1605   }
1606   ```
1607 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1608   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1609
1610 Compiler
1611 --------
1612 - [The default allocator has changed from jemalloc to the default allocator on
1613   your system.][55238] The compiler itself on Linux & macOS will still use
1614   jemalloc, but programs compiled with it will use the system allocator.
1615 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1616
1617 Libraries
1618 ---------
1619 - [`PathBuf` now implements `FromStr`.][55148]
1620 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1621 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1622   easily debug expressions in your rust program. E.g.
1623   ```rust
1624   let a = 2;
1625   let b = dbg!(a * 2) + 1;
1626   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1627   assert_eq!(b, 5);
1628   ```
1629
1630 The following APIs are now `const` functions and can be used in a
1631 `const` context.
1632
1633 - [`Cell::as_ptr`]
1634 - [`UnsafeCell::get`]
1635 - [`char::is_ascii`]
1636 - [`iter::empty`]
1637 - [`ManuallyDrop::new`]
1638 - [`ManuallyDrop::into_inner`]
1639 - [`RangeInclusive::start`]
1640 - [`RangeInclusive::end`]
1641 - [`NonNull::as_ptr`]
1642 - [`slice::as_ptr`]
1643 - [`str::as_ptr`]
1644 - [`Duration::as_secs`]
1645 - [`Duration::subsec_millis`]
1646 - [`Duration::subsec_micros`]
1647 - [`Duration::subsec_nanos`]
1648 - [`CStr::as_ptr`]
1649 - [`Ipv4Addr::is_unspecified`]
1650 - [`Ipv6Addr::new`]
1651 - [`Ipv6Addr::octets`]
1652
1653 Stabilized APIs
1654 ---------------
1655 - [`i8::to_be_bytes`]
1656 - [`i8::to_le_bytes`]
1657 - [`i8::to_ne_bytes`]
1658 - [`i8::from_be_bytes`]
1659 - [`i8::from_le_bytes`]
1660 - [`i8::from_ne_bytes`]
1661 - [`i16::to_be_bytes`]
1662 - [`i16::to_le_bytes`]
1663 - [`i16::to_ne_bytes`]
1664 - [`i16::from_be_bytes`]
1665 - [`i16::from_le_bytes`]
1666 - [`i16::from_ne_bytes`]
1667 - [`i32::to_be_bytes`]
1668 - [`i32::to_le_bytes`]
1669 - [`i32::to_ne_bytes`]
1670 - [`i32::from_be_bytes`]
1671 - [`i32::from_le_bytes`]
1672 - [`i32::from_ne_bytes`]
1673 - [`i64::to_be_bytes`]
1674 - [`i64::to_le_bytes`]
1675 - [`i64::to_ne_bytes`]
1676 - [`i64::from_be_bytes`]
1677 - [`i64::from_le_bytes`]
1678 - [`i64::from_ne_bytes`]
1679 - [`i128::to_be_bytes`]
1680 - [`i128::to_le_bytes`]
1681 - [`i128::to_ne_bytes`]
1682 - [`i128::from_be_bytes`]
1683 - [`i128::from_le_bytes`]
1684 - [`i128::from_ne_bytes`]
1685 - [`isize::to_be_bytes`]
1686 - [`isize::to_le_bytes`]
1687 - [`isize::to_ne_bytes`]
1688 - [`isize::from_be_bytes`]
1689 - [`isize::from_le_bytes`]
1690 - [`isize::from_ne_bytes`]
1691 - [`u8::to_be_bytes`]
1692 - [`u8::to_le_bytes`]
1693 - [`u8::to_ne_bytes`]
1694 - [`u8::from_be_bytes`]
1695 - [`u8::from_le_bytes`]
1696 - [`u8::from_ne_bytes`]
1697 - [`u16::to_be_bytes`]
1698 - [`u16::to_le_bytes`]
1699 - [`u16::to_ne_bytes`]
1700 - [`u16::from_be_bytes`]
1701 - [`u16::from_le_bytes`]
1702 - [`u16::from_ne_bytes`]
1703 - [`u32::to_be_bytes`]
1704 - [`u32::to_le_bytes`]
1705 - [`u32::to_ne_bytes`]
1706 - [`u32::from_be_bytes`]
1707 - [`u32::from_le_bytes`]
1708 - [`u32::from_ne_bytes`]
1709 - [`u64::to_be_bytes`]
1710 - [`u64::to_le_bytes`]
1711 - [`u64::to_ne_bytes`]
1712 - [`u64::from_be_bytes`]
1713 - [`u64::from_le_bytes`]
1714 - [`u64::from_ne_bytes`]
1715 - [`u128::to_be_bytes`]
1716 - [`u128::to_le_bytes`]
1717 - [`u128::to_ne_bytes`]
1718 - [`u128::from_be_bytes`]
1719 - [`u128::from_le_bytes`]
1720 - [`u128::from_ne_bytes`]
1721 - [`usize::to_be_bytes`]
1722 - [`usize::to_le_bytes`]
1723 - [`usize::to_ne_bytes`]
1724 - [`usize::from_be_bytes`]
1725 - [`usize::from_le_bytes`]
1726 - [`usize::from_ne_bytes`]
1727
1728 Cargo
1729 -----
1730 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1731 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1732
1733 Misc
1734 ----
1735 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1736
1737 Compatibility Notes
1738 -------------------
1739 - [The argument types for AVX's
1740   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1741   been changed from `*const` to `*mut` as the previous implementation
1742   was unsound.
1743
1744
1745 [55148]: https://github.com/rust-lang/rust/pull/55148/
1746 [55238]: https://github.com/rust-lang/rust/pull/55238/
1747 [55280]: https://github.com/rust-lang/rust/pull/55280/
1748 [55610]: https://github.com/rust-lang/rust/pull/55610/
1749 [55663]: https://github.com/rust-lang/rust/pull/55663/
1750 [55702]: https://github.com/rust-lang/rust/pull/55702/
1751 [55837]: https://github.com/rust-lang/rust/pull/55837/
1752 [55843]: https://github.com/rust-lang/rust/pull/55843/
1753 [56072]: https://github.com/rust-lang/rust/pull/56072/
1754 [56245]: https://github.com/rust-lang/rust/pull/56245/
1755 [56365]: https://github.com/rust-lang/rust/pull/56365/
1756 [56366]: https://github.com/rust-lang/rust/pull/56366/
1757 [56395]: https://github.com/rust-lang/rust/pull/56395/
1758 [56759]: https://github.com/rust-lang/rust/pull/56759/
1759 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1760 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1761 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1762 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1763 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1764 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1765 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1766 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1767 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1768 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1769 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1770 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1771 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1772 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1773 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1774 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1775 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1776 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1777 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1778 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1779 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1780 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1781 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1782 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1783 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1784 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1785 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1786 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1787 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1788 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1789 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1790 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1791 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1792 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1793 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1794 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1795 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1796 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1797 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1798 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1799 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1800 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1801 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1802 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1803 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1804 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1805 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1806 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1807 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1808 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1809 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1810 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1811 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1812 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1813 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1814 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1815 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1816 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1817 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1818 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1819 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1820 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1821 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1822 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1823 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1824 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1825 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1826 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1827 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1828 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1829 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1830 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1831 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1832 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1833 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1834 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1835 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1836 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1837 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1838 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1839 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1840 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1841 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1842 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1843 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1844 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1845 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1846 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1847 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1848 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1849 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1850 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1851 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1852
1853
1854 Version 1.31.1 (2018-12-20)
1855 ===========================
1856
1857 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1858 - [Fix broken go-to-definition in RLS][rls/1171]
1859 - [Fix infinite loop on hover in RLS][rls/1170]
1860
1861 [56562]: https://github.com/rust-lang/rust/pull/56562
1862 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1863 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1864
1865 Version 1.31.0 (2018-12-06)
1866 ==========================
1867
1868 Language
1869 --------
1870 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1871 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1872   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1873   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1874   in structs.
1875 - [You can now define and use `const` functions.][54835] These are currently
1876   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1877   [language reference][const-reference] for what exactly is available.
1878 - [You can now use tool lints, which allow you to scope lints from external
1879   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1880 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1881   a crate, not just in exported functions.][54451]
1882 - [You can now use parentheses in pattern matches.][54497]
1883
1884 Compiler
1885 --------
1886 - [Updated musl to 1.1.20][54430]
1887
1888 Libraries
1889 ---------
1890 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1891   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1892 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1893   into `Option<&mut T>` using the `From` trait.][53218]
1894 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1895
1896
1897 Stabilized APIs
1898 ---------------
1899 - [`slice::align_to`]
1900 - [`slice::align_to_mut`]
1901 - [`slice::chunks_exact`]
1902 - [`slice::chunks_exact_mut`]
1903 - [`slice::rchunks`]
1904 - [`slice::rchunks_mut`]
1905 - [`slice::rchunks_exact`]
1906 - [`slice::rchunks_exact_mut`]
1907 - [`Option::replace`]
1908
1909 Cargo
1910 -----
1911 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1912 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1913   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1914
1915 [52813]: https://github.com/rust-lang/rust/pull/52813/
1916 [53218]: https://github.com/rust-lang/rust/pull/53218/
1917 [53555]: https://github.com/rust-lang/rust/issues/53555/
1918 [54057]: https://github.com/rust-lang/rust/pull/54057/
1919 [54240]: https://github.com/rust-lang/rust/pull/54240/
1920 [54430]: https://github.com/rust-lang/rust/pull/54430/
1921 [54451]: https://github.com/rust-lang/rust/pull/54451/
1922 [54497]: https://github.com/rust-lang/rust/pull/54497/
1923 [54778]: https://github.com/rust-lang/rust/pull/54778/
1924 [54835]: https://github.com/rust-lang/rust/pull/54835/
1925 [54870]: https://github.com/rust-lang/rust/pull/54870/
1926 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1927 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1928 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1929 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1930 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1931 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1932 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1933 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1934 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1935 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1936 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1937 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1938 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1939 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1940
1941 Version 1.30.1 (2018-11-08)
1942 ===========================
1943
1944 - [Fixed overflow ICE in rustdoc][54199]
1945 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1946
1947 [54199]: https://github.com/rust-lang/rust/pull/54199
1948 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1949
1950 Version 1.30.0 (2018-10-25)
1951 ==========================
1952
1953 Language
1954 --------
1955 - [Procedural macros are now available.][52081] These kinds of macros allow for
1956   more powerful code generation. There is a [new chapter available][proc-macros]
1957   in the Rust Programming Language book that goes further in depth.
1958 - [You can now use keywords as identifiers using the raw identifiers
1959   syntax (`r#`),][53236] e.g. `let r#for = true;`
1960 - [Using anonymous parameters in traits is now deprecated with a warning and
1961   will be a hard error in the 2018 edition.][53272]
1962 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1963   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1964 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1965   Previously, using a external crate in a module without a use statement
1966   required `let json = ::serde_json::from_str(foo);` but can now be written
1967   as `let json = serde_json::from_str(foo);`.
1968 - [You can now apply the `#[used]` attribute to static items to prevent the
1969   compiler from optimising them away, even if they appear to be unused,][51363]
1970   e.g. `#[used] static FOO: u32 = 1;`
1971 - [You can now import and reexport macros from other crates with the `use`
1972   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1973   the root module of the crate. If your macro relies on calling other local
1974   macros, it is recommended to export with the
1975   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1976   those macros.
1977 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1978   using the `vis` specifier.][53370]
1979 - [Non-macro attributes now allow all forms of literals, not just
1980   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1981   write `#[attr(true)]`.
1982 - [You can now specify a function to handle a panic in the Rust runtime with the
1983   `#[panic_handler]` attribute.][51366]
1984
1985 Compiler
1986 --------
1987 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1988 - [Added the `aarch64-unknown-netbsd` target][53165]
1989
1990 Libraries
1991 ---------
1992 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1993
1994 Stabilized APIs
1995 ---------------
1996 - [`Ipv4Addr::BROADCAST`]
1997 - [`Ipv4Addr::LOCALHOST`]
1998 - [`Ipv4Addr::UNSPECIFIED`]
1999 - [`Ipv6Addr::LOCALHOST`]
2000 - [`Ipv6Addr::UNSPECIFIED`]
2001 - [`Iterator::find_map`]
2002
2003   The following methods are replacement methods for `trim_left`, `trim_right`,
2004   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2005   in 1.33.0:
2006 - [`str::trim_end_matches`]
2007 - [`str::trim_end`]
2008 - [`str::trim_start_matches`]
2009 - [`str::trim_start`]
2010
2011 Cargo
2012 ----
2013 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2014 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2015   equivalent to calling `rustdoc --error-format=json`.
2016 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2017
2018 Misc
2019 ----
2020 - [`rustdoc` allows you to specify what edition to treat your code as with the
2021   `--edition` option.][54057]
2022 - [`rustdoc` now has the `--color` (specify whether to output color) and
2023   `--error-format` (specify error format, e.g. `json`) options.][53003]
2024 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2025   debug symbols.][53774]
2026 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2027   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2028
2029 [50911]: https://github.com/rust-lang/rust/pull/50911/
2030 [51363]: https://github.com/rust-lang/rust/pull/51363/
2031 [51366]: https://github.com/rust-lang/rust/pull/51366/
2032 [52081]: https://github.com/rust-lang/rust/pull/52081/
2033 [53003]: https://github.com/rust-lang/rust/pull/53003/
2034 [53033]: https://github.com/rust-lang/rust/pull/53033/
2035 [53044]: https://github.com/rust-lang/rust/pull/53044/
2036 [53165]: https://github.com/rust-lang/rust/pull/53165/
2037 [53213]: https://github.com/rust-lang/rust/pull/53213/
2038 [53236]: https://github.com/rust-lang/rust/pull/53236/
2039 [53272]: https://github.com/rust-lang/rust/pull/53272/
2040 [53370]: https://github.com/rust-lang/rust/pull/53370/
2041 [53459]: https://github.com/rust-lang/rust/pull/53459/
2042 [53774]: https://github.com/rust-lang/rust/pull/53774/
2043 [53822]: https://github.com/rust-lang/rust/pull/53822/
2044 [54057]: https://github.com/rust-lang/rust/pull/54057/
2045 [54146]: https://github.com/rust-lang/rust/pull/54146/
2046 [54404]: https://github.com/rust-lang/rust/pull/54404/
2047 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2048 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2049 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2050 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2051
2052 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2053 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2054 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2055 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2056 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2057 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2058 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2059 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2060 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2061 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2062
2063
2064 Version 1.29.2 (2018-10-11)
2065 ===========================
2066
2067 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2068 - The `rls-preview` component on the windows-gnu targets has been restored.
2069
2070 [54639]: https://github.com/rust-lang/rust/pull/54639
2071
2072
2073 Version 1.29.1 (2018-09-25)
2074 ===========================
2075
2076 Security Notes
2077 --------------
2078
2079 - The standard library's `str::repeat` function contained an out of bounds write
2080   caused by an integer overflow. This has been fixed by deterministically
2081   panicking when an overflow happens.
2082
2083   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2084   us.
2085
2086
2087 Version 1.29.0 (2018-09-13)
2088 ==========================
2089
2090 Compiler
2091 --------
2092 - [Bumped minimum LLVM version to 5.0.][51899]
2093 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2094 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2095
2096 Libraries
2097 ---------
2098 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2099 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2100 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2101 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2102   for `&str`.][51178]
2103 - [`Cell<T>` now allows `T` to be unsized.][50494]
2104 - [`SocketAddr` is now stable on Redox.][52656]
2105
2106 Stabilized APIs
2107 ---------------
2108 - [`Arc::downcast`]
2109 - [`Iterator::flatten`]
2110 - [`Rc::downcast`]
2111
2112 Cargo
2113 -----
2114 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2115   `--locked` to disable this behavior.
2116 - [`cargo-install` will now allow you to cross compile an install
2117   using `--target`.][cargo/5614]
2118 - [Added the `cargo-fix` subcommand to automatically move project code from
2119   2015 edition to 2018.][cargo/5723]
2120 - [`cargo doc` can now optionally document private types using the
2121   `--document-private-items` flag.][cargo/5543]
2122
2123 Misc
2124 ----
2125 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2126   the specified level to that level.][52354] For example `--cap-lints warn`
2127   will demote `deny` and `forbid` lints to `warn`.
2128 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2129   fails and `101` if there is a panic.][52197]
2130 - [A preview of clippy has been made available through rustup.][51122]
2131   You can install the preview with `rustup component add clippy-preview`.
2132
2133 Compatibility Notes
2134 -------------------
2135 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2136   Use `str::get_unchecked(begin..end)` instead.
2137 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2138   Consider using the `home_dir` function from
2139   https://crates.io/crates/dirs instead.
2140 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2141 - [`cfg` attributes and `--cfg` command line flags are now more
2142   strictly validated.][53893]
2143
2144 [53893]: https://github.com/rust-lang/rust/pull/53893/
2145 [52861]: https://github.com/rust-lang/rust/pull/52861/
2146 [52656]: https://github.com/rust-lang/rust/pull/52656/
2147 [52239]: https://github.com/rust-lang/rust/pull/52239/
2148 [52330]: https://github.com/rust-lang/rust/pull/52330/
2149 [52354]: https://github.com/rust-lang/rust/pull/52354/
2150 [52402]: https://github.com/rust-lang/rust/pull/52402/
2151 [52103]: https://github.com/rust-lang/rust/pull/52103/
2152 [52197]: https://github.com/rust-lang/rust/pull/52197/
2153 [51807]: https://github.com/rust-lang/rust/pull/51807/
2154 [51899]: https://github.com/rust-lang/rust/pull/51899/
2155 [51912]: https://github.com/rust-lang/rust/pull/51912/
2156 [51511]: https://github.com/rust-lang/rust/pull/51511/
2157 [51619]: https://github.com/rust-lang/rust/pull/51619/
2158 [51656]: https://github.com/rust-lang/rust/pull/51656/
2159 [51178]: https://github.com/rust-lang/rust/pull/51178/
2160 [51122]: https://github.com/rust-lang/rust/pull/51122
2161 [50494]: https://github.com/rust-lang/rust/pull/50494/
2162 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2163 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2164 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2165 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2166 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2167 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2168 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2169
2170
2171 Version 1.28.0 (2018-08-02)
2172 ===========================
2173
2174 Language
2175 --------
2176 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2177   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2178   the inner type across Foreign Function Interface (FFI) boundaries.
2179 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2180   and can now be used as identifiers.][51196]
2181 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2182   stable.][51241] This will allow users to specify a global allocator for
2183   their program.
2184 - [Unit test functions marked with the `#[test]` attribute can now return
2185   `Result<(), E: Debug>` in addition to `()`.][51298]
2186 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2187   allows macros to easily target lifetimes.
2188
2189 Compiler
2190 --------
2191 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2192   prioritise making smaller binary sizes. `z` is the same as `s` with the
2193   exception that it does not vectorise loops, which typically results in an even
2194   smaller binary.
2195 - [The short error format is now stable.][49546] Specified with
2196   `--error-format=short` this option will provide a more compressed output of
2197   rust error messages.
2198 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2199 - [Reduced the number of allocations in the macro parser.][50855] This can
2200   improve compile times of macro heavy crates on average by 5%.
2201
2202 Libraries
2203 ---------
2204 - [Implemented `Default` for `&mut str`.][51306]
2205 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2206 - [Implemented `Extend` for `()`.][50234]
2207 - [The `Debug` implementation of `time::Duration` should now be more easily
2208   human readable.][50364] Previously a `Duration` of one second would printed as
2209   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2210 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2211   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2212   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2213   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2214   for `PathBuf`.][50170]
2215 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2216   and `Wrapping<i128>`.][50465]
2217 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2218   possible.][51050] This can provide up to a 40% speed increase.
2219 - [Improved error messages when using `format!`.][50610]
2220
2221 Stabilized APIs
2222 ---------------
2223 - [`Iterator::step_by`]
2224 - [`Path::ancestors`]
2225 - [`SystemTime::UNIX_EPOCH`]
2226 - [`alloc::GlobalAlloc`]
2227 - [`alloc::Layout`]
2228 - [`alloc::LayoutErr`]
2229 - [`alloc::System`]
2230 - [`alloc::alloc`]
2231 - [`alloc::alloc_zeroed`]
2232 - [`alloc::dealloc`]
2233 - [`alloc::realloc`]
2234 - [`alloc::handle_alloc_error`]
2235 - [`btree_map::Entry::or_default`]
2236 - [`fmt::Alignment`]
2237 - [`hash_map::Entry::or_default`]
2238 - [`iter::repeat_with`]
2239 - [`num::NonZeroUsize`]
2240 - [`num::NonZeroU128`]
2241 - [`num::NonZeroU16`]
2242 - [`num::NonZeroU32`]
2243 - [`num::NonZeroU64`]
2244 - [`num::NonZeroU8`]
2245 - [`ops::RangeBounds`]
2246 - [`slice::SliceIndex`]
2247 - [`slice::from_mut`]
2248 - [`slice::from_ref`]
2249 - [`{Any + Send + Sync}::downcast_mut`]
2250 - [`{Any + Send + Sync}::downcast_ref`]
2251 - [`{Any + Send + Sync}::is`]
2252
2253 Cargo
2254 -----
2255 - [Cargo will now no longer allow you to publish crates with build scripts that
2256   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2257   considered to be immutable.
2258
2259 Misc
2260 ----
2261 - [The `suggestion_applicability` field in `rustc`'s json output is now
2262   stable.][50486] This will allow dev tools to check whether a code suggestion
2263   would apply to them.
2264
2265 Compatibility Notes
2266 -------------------
2267 - [Rust will consider trait objects with duplicated constraints to be the same
2268   type as without the duplicated constraint.][51276] For example the below code will
2269   now fail to compile.
2270   ```rust
2271   trait Trait {}
2272
2273   impl Trait + Send {
2274       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2275   }
2276
2277   impl Trait + Send + Send {
2278       fn test(&self) { println!("two"); }
2279   }
2280   ```
2281
2282 [49546]: https://github.com/rust-lang/rust/pull/49546/
2283 [50143]: https://github.com/rust-lang/rust/pull/50143/
2284 [50170]: https://github.com/rust-lang/rust/pull/50170/
2285 [50234]: https://github.com/rust-lang/rust/pull/50234/
2286 [50265]: https://github.com/rust-lang/rust/pull/50265/
2287 [50364]: https://github.com/rust-lang/rust/pull/50364/
2288 [50385]: https://github.com/rust-lang/rust/pull/50385/
2289 [50465]: https://github.com/rust-lang/rust/pull/50465/
2290 [50486]: https://github.com/rust-lang/rust/pull/50486/
2291 [50554]: https://github.com/rust-lang/rust/pull/50554/
2292 [50610]: https://github.com/rust-lang/rust/pull/50610/
2293 [50855]: https://github.com/rust-lang/rust/pull/50855/
2294 [51050]: https://github.com/rust-lang/rust/pull/51050/
2295 [51196]: https://github.com/rust-lang/rust/pull/51196/
2296 [51200]: https://github.com/rust-lang/rust/pull/51200/
2297 [51241]: https://github.com/rust-lang/rust/pull/51241/
2298 [51276]: https://github.com/rust-lang/rust/pull/51276/
2299 [51298]: https://github.com/rust-lang/rust/pull/51298/
2300 [51306]: https://github.com/rust-lang/rust/pull/51306/
2301 [51562]: https://github.com/rust-lang/rust/pull/51562/
2302 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2303 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2304 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2305 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2306 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2307 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2308 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2309 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2310 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2311 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2312 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2313 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2314 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2315 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2316 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2317 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2318 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2319 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2320 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2321 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2322 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2323 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2324 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2325 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2326 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2327 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2328 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2329 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2330 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2331 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2332
2333 Version 1.27.2 (2018-07-20)
2334 ===========================
2335
2336 Compatibility Notes
2337 -------------------
2338
2339 - The borrow checker was fixed to avoid potential unsoundness when using
2340   match ergonomics: [#52213][52213].
2341
2342 [52213]: https://github.com/rust-lang/rust/issues/52213
2343
2344 Version 1.27.1 (2018-07-10)
2345 ===========================
2346
2347 Security Notes
2348 --------------
2349
2350 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2351   when running, which enabled executing code as some other user on a
2352   given machine. This release fixes that vulnerability; you can read
2353   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2354
2355   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2356
2357 Compatibility Notes
2358 -------------------
2359
2360 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2361   match ergonomics: [#51415][51415], [#49534][49534].
2362
2363 [51415]: https://github.com/rust-lang/rust/issues/51415
2364 [49534]: https://github.com/rust-lang/rust/issues/49534
2365 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2366 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2367
2368 Version 1.27.0 (2018-06-21)
2369 ==========================
2370
2371 Language
2372 --------
2373 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2374   be used as an identifier.
2375 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2376   bare `Trait` syntax, and should make it clearer when being used in tandem with
2377   `impl Trait` because it is equivalent to the following syntax:
2378   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2379   `Box<Trait> == Box<dyn Trait>`.
2380 - [Attributes on generic parameters such as types and lifetimes are
2381   now stable.][48851] e.g.
2382   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2383 - [The `#[must_use]` attribute can now also be used on functions as well as
2384   types.][48925] It provides a lint that by default warns users when the
2385   value returned by a function has not been used.
2386
2387 Compiler
2388 --------
2389 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2390
2391 Libraries
2392 ---------
2393 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2394   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2395   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2396   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2397   the `cfg` attribute.
2398 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2399   std are now available in core.][49896]
2400 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2401   to `Self`.][49630]
2402 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2403   that the operation isn't done in place.
2404 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2405   the `#[must_use]` attribute][49533] to warn about unused potentially
2406   expensive allocations.
2407
2408 Stabilized APIs
2409 ---------------
2410 - [`DoubleEndedIterator::rfind`]
2411 - [`DoubleEndedIterator::rfold`]
2412 - [`DoubleEndedIterator::try_rfold`]
2413 - [`Duration::from_micros`]
2414 - [`Duration::from_nanos`]
2415 - [`Duration::subsec_micros`]
2416 - [`Duration::subsec_millis`]
2417 - [`HashMap::remove_entry`]
2418 - [`Iterator::try_fold`]
2419 - [`Iterator::try_for_each`]
2420 - [`NonNull::cast`]
2421 - [`Option::filter`]
2422 - [`String::replace_range`]
2423 - [`Take::set_limit`]
2424 - [`hint::unreachable_unchecked`]
2425 - [`os::unix::process::parent_id`]
2426 - [`ptr::swap_nonoverlapping`]
2427 - [`slice::rsplit_mut`]
2428 - [`slice::rsplit`]
2429 - [`slice::swap_with_slice`]
2430
2431 Cargo
2432 -----
2433 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2434   `readme`, and `repository` fields.][cargo/5386]
2435 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2436 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2437   a different directory than `target` for placing compilation artifacts.
2438 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2439   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2440   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2441   where cargo would infer a binary, Cargo will produce a warning. You can
2442   disable this feature ahead of time by setting any of the following to false:
2443   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2444 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2445   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2446
2447 Misc
2448 ----
2449 - [Added “The Rustc book” into the official documentation.][49707]
2450   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2451 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2452
2453 Compatibility Notes
2454 -------------------
2455 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2456   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2457   compile, `"".is_empty()` will still compile.
2458 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2459   will only print the inner type.][48553] E.g.
2460   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2461   not `AtomicBool(true)`.
2462 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2463   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2464   alignment should cover all use cases.
2465 - The `.description()` method on the `std::error::Error` trait
2466   [has been soft-deprecated][50163]. It is no longer required to implement it.
2467
2468 [48553]: https://github.com/rust-lang/rust/pull/48553/
2469 [48851]: https://github.com/rust-lang/rust/pull/48851/
2470 [48925]: https://github.com/rust-lang/rust/pull/48925/
2471 [49533]: https://github.com/rust-lang/rust/pull/49533/
2472 [49623]: https://github.com/rust-lang/rust/pull/49623/
2473 [49630]: https://github.com/rust-lang/rust/pull/49630/
2474 [49664]: https://github.com/rust-lang/rust/pull/49664/
2475 [49699]: https://github.com/rust-lang/rust/pull/49699/
2476 [49707]: https://github.com/rust-lang/rust/pull/49707/
2477 [49719]: https://github.com/rust-lang/rust/pull/49719/
2478 [49896]: https://github.com/rust-lang/rust/pull/49896/
2479 [49968]: https://github.com/rust-lang/rust/pull/49968/
2480 [50163]: https://github.com/rust-lang/rust/pull/50163
2481 [50177]: https://github.com/rust-lang/rust/pull/50177/
2482 [50378]: https://github.com/rust-lang/rust/pull/50378/
2483 [50398]: https://github.com/rust-lang/rust/pull/50398/
2484 [50423]: https://github.com/rust-lang/rust/pull/50423/
2485 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2486 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2487 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2488 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2489 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2490 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2491 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2492 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2493 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2494 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2495 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2496 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2497 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2498 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2499 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2500 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2501 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2502 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2503 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2504 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2505 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2506 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2507 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2508 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2509 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2510 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2511 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2512 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2513 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2514 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2515
2516
2517 Version 1.26.2 (2018-06-05)
2518 ==========================
2519
2520 Compatibility Notes
2521 -------------------
2522
2523 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2524
2525 [51117]: https://github.com/rust-lang/rust/issues/51117
2526
2527
2528 Version 1.26.1 (2018-05-29)
2529 ==========================
2530
2531 Tools
2532 -----
2533
2534 - [RLS now works on Windows.][50646]
2535 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2536
2537
2538 Compatibility Notes
2539 --------
2540
2541 - [`fn main() -> impl Trait` no longer works for non-Termination
2542   trait.][50656]
2543   This reverts an accidental stabilization.
2544 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2545 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2546
2547 [50646]: https://github.com/rust-lang/rust/issues/50646
2548 [50656]: https://github.com/rust-lang/rust/pull/50656
2549 [50812]: https://github.com/rust-lang/rust/pull/50812
2550 [50950]: https://github.com/rust-lang/rust/issues/50950
2551 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2552
2553 Version 1.26.0 (2018-05-10)
2554 ==========================
2555
2556 Language
2557 --------
2558 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2559   implement either or both traits.][49299]
2560 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2561 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2562   lifetime can be elided.][49458]
2563 - [`impl Trait` is now stable allowing you to have abstract types in returns
2564    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2565   `fn open(path: impl AsRef<Path>)`.
2566 - [Pattern matching will now automatically apply dereferences.][49394]
2567 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2568 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2569 - [A lot of operations are now available in a const context.][46882] E.g. You
2570   can now index into constant arrays, reference and dereference into constants,
2571   and use tuple struct constructors.
2572 - [Fixed entry slice patterns are now stable.][48516] E.g.
2573   ```rust
2574   let points = [1, 2, 3, 4];
2575   match points {
2576       [1, 2, 3, 4] => println!("All points were sequential."),
2577       _ => println!("Not all points were sequential."),
2578   }
2579   ```
2580
2581
2582 Compiler
2583 --------
2584 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2585 - [Fixed exponential projection complexity on nested types.][48296]
2586   This can provide up to a ~12% reduction in compile times for certain crates.
2587 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2588   to remap path prefixes outputted by the compiler.
2589 - [Added `powerpc-unknown-netbsd` target.][48281]
2590
2591 Libraries
2592 ---------
2593 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2594 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2595   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2596 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2597 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2598 - [`ascii::escape_default` is now available in libcore.][48735]
2599 - [Trailing commas are now supported in std and core macros.][48056]
2600 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2601 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2602
2603 Stabilized APIs
2604 ---------------
2605 - [`*const T::add`]
2606 - [`*const T::copy_to_nonoverlapping`]
2607 - [`*const T::copy_to`]
2608 - [`*const T::read_unaligned`]
2609 - [`*const T::read_volatile`]
2610 - [`*const T::read`]
2611 - [`*const T::sub`]
2612 - [`*const T::wrapping_add`]
2613 - [`*const T::wrapping_sub`]
2614 - [`*mut T::add`]
2615 - [`*mut T::copy_to_nonoverlapping`]
2616 - [`*mut T::copy_to`]
2617 - [`*mut T::read_unaligned`]
2618 - [`*mut T::read_volatile`]
2619 - [`*mut T::read`]
2620 - [`*mut T::replace`]
2621 - [`*mut T::sub`]
2622 - [`*mut T::swap`]
2623 - [`*mut T::wrapping_add`]
2624 - [`*mut T::wrapping_sub`]
2625 - [`*mut T::write_bytes`]
2626 - [`*mut T::write_unaligned`]
2627 - [`*mut T::write_volatile`]
2628 - [`*mut T::write`]
2629 - [`Box::leak`]
2630 - [`FromUtf8Error::as_bytes`]
2631 - [`LocalKey::try_with`]
2632 - [`Option::cloned`]
2633 - [`btree_map::Entry::and_modify`]
2634 - [`fs::read_to_string`]
2635 - [`fs::read`]
2636 - [`fs::write`]
2637 - [`hash_map::Entry::and_modify`]
2638 - [`iter::FusedIterator`]
2639 - [`ops::RangeInclusive`]
2640 - [`ops::RangeToInclusive`]
2641 - [`process::id`]
2642 - [`slice::rotate_left`]
2643 - [`slice::rotate_right`]
2644 - [`String::retain`]
2645
2646
2647 Cargo
2648 -----
2649 - [Cargo will now output path to custom commands when `-v` is
2650   passed with `--list`][cargo/5041]
2651 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2652
2653 Misc
2654 ----
2655 - [The second edition of "The Rust Programming Language" book is now recommended
2656   over the first.][48404]
2657
2658 Compatibility Notes
2659 -------------------
2660
2661 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2662   syntax is now invalid.
2663   ```
2664   use std::ops::Fn as dyn;
2665   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2666   ```
2667 - [The result of dereferences are no longer promoted to `'static`.][47408]
2668   e.g.
2669   ```rust
2670   fn main() {
2671       const PAIR: &(i32, i32) = &(0, 1);
2672       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2673   }
2674   ```
2675 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2676 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2677   an error.][48235]
2678 - [Removed hoedown from rustdoc.][48274]
2679 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2680
2681 [46882]: https://github.com/rust-lang/rust/pull/46882
2682 [47379]: https://github.com/rust-lang/rust/pull/47379
2683 [47408]: https://github.com/rust-lang/rust/pull/47408
2684 [47813]: https://github.com/rust-lang/rust/pull/47813
2685 [48056]: https://github.com/rust-lang/rust/pull/48056
2686 [48125]: https://github.com/rust-lang/rust/pull/48125
2687 [48166]: https://github.com/rust-lang/rust/pull/48166
2688 [48235]: https://github.com/rust-lang/rust/pull/48235
2689 [48274]: https://github.com/rust-lang/rust/pull/48274
2690 [48281]: https://github.com/rust-lang/rust/pull/48281
2691 [48296]: https://github.com/rust-lang/rust/pull/48296
2692 [48326]: https://github.com/rust-lang/rust/pull/48326
2693 [48359]: https://github.com/rust-lang/rust/pull/48359
2694 [48404]: https://github.com/rust-lang/rust/pull/48404
2695 [48481]: https://github.com/rust-lang/rust/pull/48481
2696 [48516]: https://github.com/rust-lang/rust/pull/48516
2697 [48628]: https://github.com/rust-lang/rust/pull/48628
2698 [48629]: https://github.com/rust-lang/rust/pull/48629
2699 [48657]: https://github.com/rust-lang/rust/pull/48657
2700 [48735]: https://github.com/rust-lang/rust/pull/48735
2701 [48978]: https://github.com/rust-lang/rust/pull/48978
2702 [49101]: https://github.com/rust-lang/rust/pull/49101
2703 [49109]: https://github.com/rust-lang/rust/pull/49109
2704 [49121]: https://github.com/rust-lang/rust/pull/49121
2705 [49162]: https://github.com/rust-lang/rust/pull/49162
2706 [49184]: https://github.com/rust-lang/rust/pull/49184
2707 [49234]: https://github.com/rust-lang/rust/pull/49234
2708 [49255]: https://github.com/rust-lang/rust/pull/49255
2709 [49299]: https://github.com/rust-lang/rust/pull/49299
2710 [49305]: https://github.com/rust-lang/rust/pull/49305
2711 [49394]: https://github.com/rust-lang/rust/pull/49394
2712 [49458]: https://github.com/rust-lang/rust/pull/49458
2713 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2714 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2715 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2716 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2717 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2718 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2719 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2720 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2721 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2722 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2723 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2724 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2725 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2726 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2727 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2728 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2729 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2730 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2731 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2732 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2733 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2734 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2735 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2736 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2737 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2738 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2739 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2740 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2741 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2742 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2743 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2744 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2745 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2746 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2747 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2748 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2749 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2750 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2751 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2752 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2753 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2754 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2755
2756
2757 Version 1.25.0 (2018-03-29)
2758 ==========================
2759
2760 Language
2761 --------
2762 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2763 - [You can now use nested groups of imports.][47948]
2764   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2765 - [You can now have `|` at the start of a match arm.][47947] e.g.
2766 ```rust
2767 enum Foo { A, B, C }
2768
2769 fn main() {
2770     let x = Foo::A;
2771     match x {
2772         | Foo::A
2773         | Foo::B => println!("AB"),
2774         | Foo::C => println!("C"),
2775     }
2776 }
2777 ```
2778
2779 Compiler
2780 --------
2781 - [Upgraded to LLVM 6.][47828]
2782 - [Added `-C lto=val` option.][47521]
2783 - [Added `i586-unknown-linux-musl` target][47282]
2784
2785 Libraries
2786 ---------
2787 - [Impl Send for `process::Command` on Unix.][47760]
2788 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2789 - [`UnsafeCell::into_inner` is now safe.][47204]
2790 - [Implement libstd for CloudABI.][47268]
2791 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2792 - [Implement `AsRef<Path>` for Component][46985]
2793 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2794 - [Moved `Duration` to libcore.][46666]
2795
2796 Stabilized APIs
2797 ---------------
2798 - [`Location::column`]
2799 - [`ptr::NonNull`]
2800
2801 The following functions can now be used in a constant expression.
2802 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2803 - [`Duration::new`][47300]
2804 - [`Duration::from_secs`][47300]
2805 - [`Duration::from_millis`][47300]
2806
2807 Cargo
2808 -----
2809 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2810 - [`cargo new` now defaults to creating a binary crate, instead of a
2811   library crate.][cargo/5029]
2812
2813 Misc
2814 ----
2815 - [Rust by example is now shipped with new releases][46196]
2816
2817 Compatibility Notes
2818 -------------------
2819 - [Deprecated `net::lookup_host`.][47510]
2820 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2821 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2822   around indexing operations (see [#47349][47349]). This has been fixed (which also
2823   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2824 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2825
2826 [33903]: https://github.com/rust-lang/rust/pull/33903
2827 [47947]: https://github.com/rust-lang/rust/pull/47947
2828 [47948]: https://github.com/rust-lang/rust/pull/47948
2829 [47760]: https://github.com/rust-lang/rust/pull/47760
2830 [47790]: https://github.com/rust-lang/rust/pull/47790
2831 [47828]: https://github.com/rust-lang/rust/pull/47828
2832 [47398]: https://github.com/rust-lang/rust/pull/47398
2833 [47510]: https://github.com/rust-lang/rust/pull/47510
2834 [47521]: https://github.com/rust-lang/rust/pull/47521
2835 [47204]: https://github.com/rust-lang/rust/pull/47204
2836 [47251]: https://github.com/rust-lang/rust/pull/47251
2837 [47268]: https://github.com/rust-lang/rust/pull/47268
2838 [47282]: https://github.com/rust-lang/rust/pull/47282
2839 [47300]: https://github.com/rust-lang/rust/pull/47300
2840 [47349]: https://github.com/rust-lang/rust/pull/47349
2841 [46931]: https://github.com/rust-lang/rust/pull/46931
2842 [46985]: https://github.com/rust-lang/rust/pull/46985
2843 [47006]: https://github.com/rust-lang/rust/pull/47006
2844 [46830]: https://github.com/rust-lang/rust/pull/46830
2845 [46095]: https://github.com/rust-lang/rust/pull/46095
2846 [46666]: https://github.com/rust-lang/rust/pull/46666
2847 [46196]: https://github.com/rust-lang/rust/pull/46196
2848 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2849 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2850 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2851 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2852 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2853
2854
2855 Version 1.24.1 (2018-03-01)
2856 ==========================
2857
2858  - [Do not abort when unwinding through FFI][48251]
2859  - [Emit UTF-16 files for linker arguments on Windows][48318]
2860  - [Make the error index generator work again][48308]
2861  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2862
2863 [48251]: https://github.com/rust-lang/rust/issues/48251
2864 [48308]: https://github.com/rust-lang/rust/issues/48308
2865 [48318]: https://github.com/rust-lang/rust/issues/48318
2866 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2867
2868
2869 Version 1.24.0 (2018-02-15)
2870 ==========================
2871
2872 Language
2873 --------
2874 - [External `sysv64` ffi is now available.][46528]
2875   eg. `extern "sysv64" fn foo () {}`
2876
2877 Compiler
2878 --------
2879 - [rustc now uses 16 codegen units by default for release builds.][46910]
2880   For the fastest builds, utilize `codegen-units=1`.
2881 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2882 - [Add `aarch64-unknown-openbsd` support][46760]
2883
2884 Libraries
2885 ---------
2886 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2887   improvement in performance in the majority of cases.
2888 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2889   with Windows.][46798]
2890 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2891 - [impl `From<bool>` for `AtomicBool`][46293]
2892 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2893 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2894 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2895 - [float::from_bits now just uses transmute.][46012] This provides
2896   some optimisations from LLVM.
2897 - [Copied `AsciiExt` methods onto `char`][46077]
2898 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2899 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2900 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2901 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2902
2903 Stabilized APIs
2904 ---------------
2905 - [`RefCell::replace`]
2906 - [`RefCell::swap`]
2907 - [`atomic::spin_loop_hint`]
2908
2909 The following functions can now be used in a constant expression.
2910 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2911
2912 - [`AtomicBool::new`][46287]
2913 - [`AtomicUsize::new`][46287]
2914 - [`AtomicIsize::new`][46287]
2915 - [`AtomicPtr::new`][46287]
2916 - [`Cell::new`][46287]
2917 - [`{integer}::min_value`][46287]
2918 - [`{integer}::max_value`][46287]
2919 - [`mem::size_of`][46287]
2920 - [`mem::align_of`][46287]
2921 - [`ptr::null`][46287]
2922 - [`ptr::null_mut`][46287]
2923 - [`RefCell::new`][46287]
2924 - [`UnsafeCell::new`][46287]
2925
2926 Cargo
2927 -----
2928 - [Added a `workspace.default-members` config that
2929   overrides implied `--all` in virtual workspaces.][cargo/4743]
2930 - [Enable incremental by default on development builds.][cargo/4817] Also added
2931   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2932   per-project or global basis respectively.
2933
2934 Misc
2935 ----
2936
2937 Compatibility Notes
2938 -------------------
2939 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2940 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2941   in accordance with IETF RFC 4291 §2.2.
2942 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2943 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2944   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2945 - [Leading zeros in tuple struct members is now an error][47084]
2946 - [`column!()` macro is one-based instead of zero-based][46977]
2947 - [`fmt::Arguments` can no longer be shared across threads][45198]
2948 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2949 - [Cargo sets a different working directory for the compiler][cargo/4788]
2950
2951 [44884]: https://github.com/rust-lang/rust/pull/44884
2952 [45198]: https://github.com/rust-lang/rust/pull/45198
2953 [45506]: https://github.com/rust-lang/rust/pull/45506
2954 [45904]: https://github.com/rust-lang/rust/pull/45904
2955 [45990]: https://github.com/rust-lang/rust/pull/45990
2956 [46012]: https://github.com/rust-lang/rust/pull/46012
2957 [46077]: https://github.com/rust-lang/rust/pull/46077
2958 [46094]: https://github.com/rust-lang/rust/pull/46094
2959 [46284]: https://github.com/rust-lang/rust/pull/46284
2960 [46287]: https://github.com/rust-lang/rust/pull/46287
2961 [46293]: https://github.com/rust-lang/rust/pull/46293
2962 [46528]: https://github.com/rust-lang/rust/pull/46528
2963 [46671]: https://github.com/rust-lang/rust/pull/46671
2964 [46713]: https://github.com/rust-lang/rust/pull/46713
2965 [46735]: https://github.com/rust-lang/rust/pull/46735
2966 [46749]: https://github.com/rust-lang/rust/pull/46749
2967 [46760]: https://github.com/rust-lang/rust/pull/46760
2968 [46798]: https://github.com/rust-lang/rust/pull/46798
2969 [46828]: https://github.com/rust-lang/rust/pull/46828
2970 [46831]: https://github.com/rust-lang/rust/pull/46831
2971 [46833]: https://github.com/rust-lang/rust/pull/46833
2972 [46910]: https://github.com/rust-lang/rust/pull/46910
2973 [46977]: https://github.com/rust-lang/rust/pull/46977
2974 [47018]: https://github.com/rust-lang/rust/pull/47018
2975 [47080]: https://github.com/rust-lang/rust/pull/47080
2976 [47084]: https://github.com/rust-lang/rust/pull/47084
2977 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2978 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2979 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2980 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2981 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2982 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2983
2984
2985 Version 1.23.0 (2018-01-04)
2986 ==========================
2987
2988 Language
2989 --------
2990 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2991 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2992   Which should fix some confusing errors in some operations.
2993
2994 Compiler
2995 --------
2996 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2997   undefined behavior.][45920]
2998 - [rustc now suggests renaming import if names clash.][45660]
2999 - [Display errors/warnings correctly when there are zero-width or
3000   wide characters.][45711]
3001 - [rustc now avoids unnecessary copies of arguments that are
3002   simple bindings][45380] This should improve memory usage on average by 5-10%.
3003 - [Updated musl used to build musl rustc to 1.1.17][45393]
3004
3005 Libraries
3006 ---------
3007 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3008 - [Implement Hash for raw pointers to unsized types][45483]
3009 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3010 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3011 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3012 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3013   and `<*mut T>::as_mut`][44932]
3014 - [Optimized `Thread::{park, unpark}` implementation][45524]
3015 - [Improved `SliceExt::binary_search` performance.][45333]
3016 - [impl `FromIterator<()>` for `()`][45379]
3017 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3018   is now deprecated.
3019
3020 Stabilized APIs
3021 ---------------
3022
3023 Cargo
3024 -----
3025 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3026   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3027 - [Added unit test checking to `cargo check`][cargo/4592]
3028 - [Cargo now lets you install a specific version
3029   using `cargo install --version`][cargo/4637]
3030
3031 Misc
3032 ----
3033 - [Releases now ship with the Cargo book documentation.][45692]
3034 - [rustdoc now prints rendering warnings on every run.][45324]
3035
3036 Compatibility Notes
3037 -------------------
3038 - [Changes have been made to type equality to make it more correct,
3039   in rare cases this could break some code.][45853] [Tracking issue for
3040   further information][45852]
3041 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3042 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3043   Android 9, the minimum supported version is Android 14.
3044 - [Bumped the minimum LLVM to 3.9][45326]
3045
3046 [44042]: https://github.com/rust-lang/rust/pull/44042
3047 [44932]: https://github.com/rust-lang/rust/pull/44932
3048 [45267]: https://github.com/rust-lang/rust/pull/45267
3049 [45324]: https://github.com/rust-lang/rust/pull/45324
3050 [45326]: https://github.com/rust-lang/rust/pull/45326
3051 [45333]: https://github.com/rust-lang/rust/pull/45333
3052 [45379]: https://github.com/rust-lang/rust/pull/45379
3053 [45380]: https://github.com/rust-lang/rust/pull/45380
3054 [45393]: https://github.com/rust-lang/rust/pull/45393
3055 [45435]: https://github.com/rust-lang/rust/pull/45435
3056 [45483]: https://github.com/rust-lang/rust/pull/45483
3057 [45524]: https://github.com/rust-lang/rust/pull/45524
3058 [45571]: https://github.com/rust-lang/rust/pull/45571
3059 [45580]: https://github.com/rust-lang/rust/pull/45580
3060 [45610]: https://github.com/rust-lang/rust/pull/45610
3061 [45660]: https://github.com/rust-lang/rust/pull/45660
3062 [45692]: https://github.com/rust-lang/rust/pull/45692
3063 [45711]: https://github.com/rust-lang/rust/pull/45711
3064 [45772]: https://github.com/rust-lang/rust/pull/45772
3065 [45852]: https://github.com/rust-lang/rust/issues/45852
3066 [45853]: https://github.com/rust-lang/rust/pull/45853
3067 [45887]: https://github.com/rust-lang/rust/pull/45887
3068 [45920]: https://github.com/rust-lang/rust/pull/45920
3069 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3070 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3071 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3072
3073
3074 Version 1.22.1 (2017-11-22)
3075 ==========================
3076
3077 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3078
3079 [46183]: https://github.com/rust-lang/rust/pull/46183
3080
3081 Version 1.22.0 (2017-11-22)
3082 ==========================
3083
3084 Language
3085 --------
3086 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3087 - [Now accepts underscores in unicode escapes][43716]
3088 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3089 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3090
3091 Compiler
3092 --------
3093 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3094 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3095   This should decrease compile times for debug builds.
3096 - [strict memory alignment now enabled on ARMv6][45094]
3097 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3098
3099 Libraries
3100 ---------
3101 - [Allow atomic operations up to 32 bits
3102   on `armv5te_unknown_linux_gnueabi`][44978]
3103 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3104 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3105 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3106 - [Properly detect overflow in `Instant += Duration`.][44220]
3107 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3108 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3109 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3110
3111 Stabilized APIs
3112 ---------------
3113
3114 Cargo
3115 -----
3116 - [Cargo will now build multi file examples in subdirectories of the `examples`
3117   folder that have a `main.rs` file.][cargo/4496]
3118 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3119   the old format will continue to work and can be updated with `cargo update`.
3120 - [Now supports vendoring git repositories][cargo/3992]
3121
3122 Misc
3123 ----
3124 - [`libbacktrace` is now available on Apple platforms.][44251]
3125 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3126   This now lets you specify that a given code example will fail to compile.
3127
3128 Compatibility Notes
3129 -------------------
3130 - [The minimum Android version that rustc can build for has been bumped
3131   to `4.0` from `2.3`][45656]
3132 - [Allowing `T op= &T` for numeric types has broken some type
3133   inference cases][45480]
3134
3135
3136 [42526]: https://github.com/rust-lang/rust/pull/42526
3137 [43017]: https://github.com/rust-lang/rust/pull/43017
3138 [43716]: https://github.com/rust-lang/rust/pull/43716
3139 [43949]: https://github.com/rust-lang/rust/pull/43949
3140 [44015]: https://github.com/rust-lang/rust/pull/44015
3141 [44220]: https://github.com/rust-lang/rust/pull/44220
3142 [44251]: https://github.com/rust-lang/rust/pull/44251
3143 [44287]: https://github.com/rust-lang/rust/pull/44287
3144 [44303]: https://github.com/rust-lang/rust/pull/44303
3145 [44456]: https://github.com/rust-lang/rust/pull/44456
3146 [44466]: https://github.com/rust-lang/rust/pull/44466
3147 [44895]: https://github.com/rust-lang/rust/pull/44895
3148 [44966]: https://github.com/rust-lang/rust/pull/44966
3149 [44978]: https://github.com/rust-lang/rust/pull/44978
3150 [45041]: https://github.com/rust-lang/rust/pull/45041
3151 [45064]: https://github.com/rust-lang/rust/pull/45064
3152 [45075]: https://github.com/rust-lang/rust/pull/45075
3153 [45094]: https://github.com/rust-lang/rust/pull/45094
3154 [45095]: https://github.com/rust-lang/rust/pull/45095
3155 [45480]: https://github.com/rust-lang/rust/issues/45480
3156 [45656]: https://github.com/rust-lang/rust/pull/45656
3157 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3158 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3159 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3160
3161
3162
3163
3164
3165
3166 Version 1.21.0 (2017-10-12)
3167 ==========================
3168
3169 Language
3170 --------
3171 - [You can now use static references for literals.][43838]
3172   Example:
3173   ```rust
3174   fn main() {
3175       let x: &'static u32 = &0;
3176   }
3177   ```
3178 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3179   Example:
3180   ```rust
3181   my_macro!(Vec<i32>::new); // Always worked
3182   my_macro!(Vec::<i32>::new); // Now works
3183   ```
3184
3185 Compiler
3186 --------
3187 - [Upgraded jemalloc to 4.5.0][43911]
3188 - [Enabled unwinding panics on Redox][43917]
3189 - [Now runs LLVM in parallel during translation phase.][43506]
3190   This should reduce peak memory usage.
3191
3192 Libraries
3193 ---------
3194 - [Generate builtin impls for `Clone` for all arrays and tuples that
3195   are `T: Clone`][43690]
3196 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3197 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3198   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3199
3200 Stabilized APIs
3201 ---------------
3202
3203 [`std::mem::discriminant`]
3204
3205 Cargo
3206 -----
3207 - [You can now call `cargo install` with multiple package names][cargo/4216]
3208 - [Cargo commands inside a virtual workspace will now implicitly
3209   pass `--all`][cargo/4335]
3210 - [Added a `[patch]` section to `Cargo.toml` to handle
3211   prepublication dependencies][cargo/4123] [RFC 1969]
3212 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3213   like patterns][cargo/4270]
3214 - [Added the `--all-targets` option][cargo/4400]
3215 - [Using required dependencies as a feature is now deprecated and emits
3216   a warning][cargo/4364]
3217
3218
3219 Misc
3220 ----
3221 - [Cargo docs are moving][43916]
3222   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3223 - [The rustdoc book is now available][43863]
3224   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3225 - [Added a preview of RLS has been made available through rustup][44204]
3226   Install with `rustup component add rls-preview`
3227 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3228   Previously only showed `std::os::unix`.
3229
3230 Compatibility Notes
3231 -------------------
3232 - [Changes in method matching against higher-ranked types][43880] This may cause
3233   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3234 - [rustc's JSON error output's byte position start at top of file.][42973]
3235   Was previously relative to the rustc's internal `CodeMap` struct which
3236   required the unstable library `libsyntax` to correctly use.
3237 - [`unused_results` lint no longer ignores booleans][43728]
3238
3239 [42565]: https://github.com/rust-lang/rust/pull/42565
3240 [42973]: https://github.com/rust-lang/rust/pull/42973
3241 [43348]: https://github.com/rust-lang/rust/pull/43348
3242 [43459]: https://github.com/rust-lang/rust/pull/43459
3243 [43506]: https://github.com/rust-lang/rust/pull/43506
3244 [43540]: https://github.com/rust-lang/rust/pull/43540
3245 [43690]: https://github.com/rust-lang/rust/pull/43690
3246 [43728]: https://github.com/rust-lang/rust/pull/43728
3247 [43838]: https://github.com/rust-lang/rust/pull/43838
3248 [43863]: https://github.com/rust-lang/rust/pull/43863
3249 [43880]: https://github.com/rust-lang/rust/pull/43880
3250 [43911]: https://github.com/rust-lang/rust/pull/43911
3251 [43916]: https://github.com/rust-lang/rust/pull/43916
3252 [43917]: https://github.com/rust-lang/rust/pull/43917
3253 [44204]: https://github.com/rust-lang/rust/pull/44204
3254 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3255 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3256 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3257 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3258 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3259 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3260 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3261 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3262 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3263
3264 Version 1.20.0 (2017-08-31)
3265 ===========================
3266
3267 Language
3268 --------
3269 - [Associated constants are now stabilised.][42809]
3270 - [A lot of macro bugs are now fixed.][42913]
3271
3272 Compiler
3273 --------
3274
3275 - [Struct fields are now properly coerced to the expected field type.][42807]
3276 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3277   `wasm32-experimental-emscripten` target.
3278 - [Changed some of the error messages to be more helpful.][42033]
3279 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3280   it.][43170]
3281 - [rustc now reports the total number of errors on compilation failure][43015]
3282   previously this was only the number of errors in the pass that failed.
3283 - [Expansion in rustc has been sped up 29x.][42533]
3284 - [added `msp430-none-elf` target.][43099]
3285 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3286   applicable][43178]
3287 - [Fixes backtraces on Redox][43228]
3288 - [rustc now identifies different versions of same crate when absolute paths of
3289   different types match in an error message.][42826]
3290
3291 Libraries
3292 ---------
3293
3294
3295 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3296 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3297   tuples.][43011]
3298 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3299   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3300 - [Impl `Clone` for `DefaultHasher`.][42799]
3301 - [Impl `Sync` for `SyncSender`.][42397]
3302 - [Impl `FromStr` for `char`][42271]
3303 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3304   NaN.][42431]
3305 - [allow messages in the `unimplemented!()` macro.][42155]
3306   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3307 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3308 - [Upgrade to Unicode 10.0.0][42999]
3309 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3310 - [Skip the main thread's manual stack guard on Linux][43072]
3311 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3312 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3313   previously 2^15.
3314 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3315
3316 Stabilized APIs
3317 ---------------
3318
3319 - [`CStr::into_c_string`]
3320 - [`CString::as_c_str`]
3321 - [`CString::into_boxed_c_str`]
3322 - [`Chain::get_mut`]
3323 - [`Chain::get_ref`]
3324 - [`Chain::into_inner`]
3325 - [`Option::get_or_insert_with`]
3326 - [`Option::get_or_insert`]
3327 - [`OsStr::into_os_string`]
3328 - [`OsString::into_boxed_os_str`]
3329 - [`Take::get_mut`]
3330 - [`Take::get_ref`]
3331 - [`Utf8Error::error_len`]
3332 - [`char::EscapeDebug`]
3333 - [`char::escape_debug`]
3334 - [`compile_error!`]
3335 - [`f32::from_bits`]
3336 - [`f32::to_bits`]
3337 - [`f64::from_bits`]
3338 - [`f64::to_bits`]
3339 - [`mem::ManuallyDrop`]
3340 - [`slice::sort_unstable_by_key`]
3341 - [`slice::sort_unstable_by`]
3342 - [`slice::sort_unstable`]
3343 - [`str::from_boxed_utf8_unchecked`]
3344 - [`str::as_bytes_mut`]
3345 - [`str::as_bytes_mut`]
3346 - [`str::from_utf8_mut`]
3347 - [`str::from_utf8_unchecked_mut`]
3348 - [`str::get_mut`]
3349 - [`str::get_unchecked_mut`]
3350 - [`str::get_unchecked`]
3351 - [`str::get`]
3352 - [`str::into_boxed_bytes`]
3353
3354
3355 Cargo
3356 -----
3357 - [Cargo API token location moved from `~/.cargo/config` to
3358   `~/.cargo/credentials`.][cargo/3978]
3359 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3360   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3361   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3362 - [You can now specify version of a binary when installed through
3363   `cargo install` using `--vers`.][cargo/4229]
3364 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3365   failure.][cargo/4248]
3366 - [Changed the convention around which file is the crate root.][cargo/4259]
3367 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3368   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3369
3370 Compatibility Notes
3371 -------------------
3372
3373 - [Functions with `'static` in their return types will now not be as usable as
3374   if they were using lifetime parameters instead.][42417]
3375 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3376   takes the sign of NaN into account where previously didn't.][42430]
3377
3378 [42033]: https://github.com/rust-lang/rust/pull/42033
3379 [42155]: https://github.com/rust-lang/rust/pull/42155
3380 [42271]: https://github.com/rust-lang/rust/pull/42271
3381 [42397]: https://github.com/rust-lang/rust/pull/42397
3382 [42417]: https://github.com/rust-lang/rust/pull/42417
3383 [42430]: https://github.com/rust-lang/rust/pull/42430
3384 [42431]: https://github.com/rust-lang/rust/pull/42431
3385 [42533]: https://github.com/rust-lang/rust/pull/42533
3386 [42571]: https://github.com/rust-lang/rust/pull/42571
3387 [42613]: https://github.com/rust-lang/rust/pull/42613
3388 [42799]: https://github.com/rust-lang/rust/pull/42799
3389 [42807]: https://github.com/rust-lang/rust/pull/42807
3390 [42809]: https://github.com/rust-lang/rust/pull/42809
3391 [42822]: https://github.com/rust-lang/rust/pull/42822
3392 [42826]: https://github.com/rust-lang/rust/pull/42826
3393 [42854]: https://github.com/rust-lang/rust/pull/42854
3394 [42913]: https://github.com/rust-lang/rust/pull/42913
3395 [42999]: https://github.com/rust-lang/rust/pull/42999
3396 [43011]: https://github.com/rust-lang/rust/pull/43011
3397 [43015]: https://github.com/rust-lang/rust/pull/43015
3398 [43072]: https://github.com/rust-lang/rust/pull/43072
3399 [43077]: https://github.com/rust-lang/rust/pull/43077
3400 [43097]: https://github.com/rust-lang/rust/pull/43097
3401 [43099]: https://github.com/rust-lang/rust/pull/43099
3402 [43170]: https://github.com/rust-lang/rust/pull/43170
3403 [43178]: https://github.com/rust-lang/rust/pull/43178
3404 [43185]: https://github.com/rust-lang/rust/pull/43185
3405 [43228]: https://github.com/rust-lang/rust/pull/43228
3406 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3407 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3408 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3409 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3410 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3411 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3412 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3413 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3414 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3415 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3416 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3417 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3418 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3419 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3420 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3421 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3422 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3423 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3424 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3425 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3426 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3427 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3428 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3429 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3430 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3431 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3432 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3433 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3434 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3435 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3436 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3437 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3438 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3439 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3440 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3441 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3442 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3443 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3444 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3445
3446
3447 Version 1.19.0 (2017-07-20)
3448 ===========================
3449
3450 Language
3451 --------
3452
3453 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3454   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3455 - [Macro recursion limit increased to 1024 from 64.][41676]
3456 - [Added lint for detecting unused macros.][41907]
3457 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3458   For example: `let x = loop { break 7; };`
3459 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3460   contain `Copy` types and cannot have a `Drop` implementation.
3461   Example: `union Foo { bar: u8, baz: usize }`
3462 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3463   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3464
3465 Compiler
3466 --------
3467
3468 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3469 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3470   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3471   you should use `--target armv7-linux-androideabi`.
3472 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3473 - [Minor optimisation of string operations.][42037]
3474 - [Compiler error message is now `aborting due to previous error(s)` instead of
3475   `aborting due to N previous errors`][42150] This was previously inaccurate and
3476   would only count certain kinds of errors.
3477 - [The compiler now supports Visual Studio 2017][42225]
3478 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3479 - [Added a lot][42264] of [new error codes][42302]
3480 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3481   libraries with C Run-time Libraries(CRT) to be statically linked.
3482 - [Fixed various ARM codegen bugs][42740]
3483
3484 Libraries
3485 ---------
3486
3487 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3488   `Extend<Cow<'a, str>>`][41449]
3489 - [`Vec` now implements `From<&mut [T]>`][41530]
3490 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3491 - [`SplitWhitespace` now implements `Clone`][41659]
3492 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3493   1.5x faster][41764]
3494 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3495   macros, but for printing to stderr.
3496
3497 Stabilized APIs
3498 ---------------
3499
3500 - [`OsString::shrink_to_fit`]
3501 - [`cmp::Reverse`]
3502 - [`Command::envs`]
3503 - [`thread::ThreadId`]
3504
3505 Cargo
3506 -----
3507
3508 - [Build scripts can now add environment variables to the environment
3509   the crate is being compiled in.
3510   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3511 - [Subcommands now replace the current process rather than spawning a new
3512   child process][cargo/3970]
3513 - [Workspace members can now accept glob file patterns][cargo/3979]
3514 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3515   the members in a given workspace.][cargo/3988]
3516 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3517 - [Target directory path is now in the cargo metadata][cargo/4022]
3518 - [Cargo no longer checks out a local working directory for the
3519   crates.io index][cargo/4026] This should provide smaller file size for the
3520   registry, and improve cloning times, especially on Windows machines.
3521 - [Added an `--exclude` option for excluding certain packages when using the
3522   `--all` option][cargo/4031]
3523 - [Cargo will now automatically retry when receiving a 5xx error
3524   from crates.io][cargo/4032]
3525 - [The `--features` option now accepts multiple comma or space
3526   delimited values.][cargo/4084]
3527 - [Added support for custom target specific runners][cargo/3954]
3528
3529 Misc
3530 ----
3531
3532 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3533   Windows Debugger.
3534 - [Rust will now release XZ compressed packages][rust-installer/57]
3535 - [rustup will now prefer to download rust packages with
3536   XZ compression][rustup/1100] over GZip packages.
3537 - [Added the ability to escape `#` in rust documentation][41785] By adding
3538   additional `#`'s ie. `##` is now `#`
3539
3540 Compatibility Notes
3541 -------------------
3542
3543 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3544 - [`-Z` flags are now no longer allowed to be used on the stable
3545   compiler.][41751] This has been a warning for a year previous to this.
3546 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3547   longer works][42844]. Users should migrate to the built-in `check`
3548   command, which has been available since 1.16.
3549 - [Ending a float literal with `._` is now a hard error.
3550   Example: `42._` .][41946]
3551 - [Any use of a private `extern crate` outside of its module is now a
3552   hard error.][36886] This was previously a warning.
3553 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3554   relative while the `::` prefix makes a path absolute, but was ignored and the
3555   path was relative regardless.
3556 - [Floating point constants in match patterns is now a hard error][36890]
3557   This was previously a warning.
3558 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3559   match patterns is now a hard error][36891] This was previously a warning.
3560 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3561   a warning.
3562 - [From the pound escape, lines consisting of multiple `#`s are
3563   now visible][41785]
3564 - [It is an error to re-export private enum variants][42460]. This is
3565   known to break a number of crates that depend on an older version of
3566   mustache.
3567 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3568   to use it to find the linker, and the build will fail where it did
3569   not previously][42607]
3570
3571 [36886]: https://github.com/rust-lang/rust/issues/36886
3572 [36888]: https://github.com/rust-lang/rust/issues/36888
3573 [36890]: https://github.com/rust-lang/rust/issues/36890
3574 [36891]: https://github.com/rust-lang/rust/issues/36891
3575 [36892]: https://github.com/rust-lang/rust/issues/36892
3576 [37406]: https://github.com/rust-lang/rust/issues/37406
3577 [39983]: https://github.com/rust-lang/rust/pull/39983
3578 [41145]: https://github.com/rust-lang/rust/pull/41145
3579 [41192]: https://github.com/rust-lang/rust/pull/41192
3580 [41258]: https://github.com/rust-lang/rust/pull/41258
3581 [41370]: https://github.com/rust-lang/rust/pull/41370
3582 [41449]: https://github.com/rust-lang/rust/pull/41449
3583 [41530]: https://github.com/rust-lang/rust/pull/41530
3584 [41624]: https://github.com/rust-lang/rust/pull/41624
3585 [41656]: https://github.com/rust-lang/rust/pull/41656
3586 [41659]: https://github.com/rust-lang/rust/pull/41659
3587 [41676]: https://github.com/rust-lang/rust/pull/41676
3588 [41751]: https://github.com/rust-lang/rust/pull/41751
3589 [41764]: https://github.com/rust-lang/rust/pull/41764
3590 [41785]: https://github.com/rust-lang/rust/pull/41785
3591 [41873]: https://github.com/rust-lang/rust/pull/41873
3592 [41907]: https://github.com/rust-lang/rust/pull/41907
3593 [41946]: https://github.com/rust-lang/rust/pull/41946
3594 [42016]: https://github.com/rust-lang/rust/pull/42016
3595 [42037]: https://github.com/rust-lang/rust/pull/42037
3596 [42068]: https://github.com/rust-lang/rust/pull/42068
3597 [42150]: https://github.com/rust-lang/rust/pull/42150
3598 [42162]: https://github.com/rust-lang/rust/pull/42162
3599 [42225]: https://github.com/rust-lang/rust/pull/42225
3600 [42264]: https://github.com/rust-lang/rust/pull/42264
3601 [42302]: https://github.com/rust-lang/rust/pull/42302
3602 [42460]: https://github.com/rust-lang/rust/issues/42460
3603 [42607]: https://github.com/rust-lang/rust/issues/42607
3604 [42740]: https://github.com/rust-lang/rust/pull/42740
3605 [42844]: https://github.com/rust-lang/rust/issues/42844
3606 [42948]: https://github.com/rust-lang/rust/pull/42948
3607 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3608 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3609 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3610 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3611 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3612 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3613 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3614 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3615 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3616 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3617 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3618 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3619 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3620 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3621 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3622 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3623 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3624 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3625 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3626 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3627 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3628 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3629
3630
3631 Version 1.18.0 (2017-06-08)
3632 ===========================
3633
3634 Language
3635 --------
3636
3637 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3638   make the item visible to just that module tree. Also accepts the keyword
3639   `crate` to make something public to the whole crate but not users of the
3640   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3641 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3642   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3643 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3644   types like `Write + Send`, trailing `+` are now supported in trait objects,
3645   and better error reporting for trait objects starting with `?Sized`.
3646 - [0e+10 is now a valid floating point literal][40589]
3647 - [Now warns if you bind a lifetime parameter to 'static][40734]
3648 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3649   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3650   representation in some cases.][40377]
3651
3652 Compiler
3653 --------
3654
3655 - [rustc can now emit mir with `--emit mir`][39891]
3656 - [Improved LLVM IR for trivial functions][40367]
3657 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3658 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3659   opportunities found through profiling
3660 - [Improved backtrace formatting when panicking][38165]
3661
3662 Libraries
3663 ---------
3664
3665 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3666   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3667   iteration or reallocation.
3668 - [Simplified HashMap Bucket interface][40561] provides performance
3669   improvements for iterating and cloning.
3670 - [Specialize Vec::from_elem to use calloc][40409]
3671 - [Fixed Race condition in fs::create_dir_all][39799]
3672 - [No longer caching stdio on Windows][40516]
3673 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3674   2.50%~ faster and in one case now 12.50% faster.
3675 - [Optimized `AtomicBool::fetch_nand`][41143]
3676
3677 Stabilized APIs
3678 ---------------
3679
3680 - [`Child::try_wait`]
3681 - [`HashMap::retain`]
3682 - [`HashSet::retain`]
3683 - [`PeekMut::pop`]
3684 - [`TcpStream::peek`]
3685 - [`UdpSocket::peek`]
3686 - [`UdpSocket::peek_from`]
3687
3688 Cargo
3689 -----
3690
3691 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3692   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3693 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3694 - [Added Android build support][cargo/3885]
3695 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3696   of a certain type, for example `cargo build --bins` will build all
3697   binaries.
3698 - [Added support for haiku][cargo/3952]
3699
3700 Misc
3701 ----
3702
3703 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3704 - [Added rust-windbg script for better debugging on Windows][39983]
3705 - [Rust now uses the official cross compiler for NetBSD][40612]
3706 - [rustdoc now accepts `#` at the start of files][40828]
3707 - [Fixed jemalloc support for musl][41168]
3708
3709 Compatibility Notes
3710 -------------------
3711
3712 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3713   always placed after the sign if it exists and before the digits. With the `#`
3714   flag the zeroes are placed after the prefix and before the digits.
3715 - [Due to the struct field optimisation][40377], using `transmute` on structs
3716   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3717   always been undefined behavior, but is now more likely to break in practice.
3718 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3719   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3720   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3721 - [Overlapping inherent `impl`s are now a hard error][40728]
3722 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3723 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3724   `out.asm` and `out.ll` instead of only one of the filetypes.
3725 - [ calling a function that returns `Self` will no longer work][41805] when
3726   the size of `Self` cannot be statically determined.
3727 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3728   this has caused a few regressions namely:
3729
3730   - Changed the link order of local static/dynamic libraries (respecting the
3731     order on given rather than having the compiler reorder).
3732   - Changed how MinGW is linked, native code linked to dynamic libraries
3733     may require manually linking to the gcc support library (for the native
3734     code itself)
3735
3736 [38165]: https://github.com/rust-lang/rust/pull/38165
3737 [39799]: https://github.com/rust-lang/rust/pull/39799
3738 [39891]: https://github.com/rust-lang/rust/pull/39891
3739 [39983]: https://github.com/rust-lang/rust/pull/39983
3740 [40043]: https://github.com/rust-lang/rust/pull/40043
3741 [40241]: https://github.com/rust-lang/rust/pull/40241
3742 [40338]: https://github.com/rust-lang/rust/pull/40338
3743 [40367]: https://github.com/rust-lang/rust/pull/40367
3744 [40377]: https://github.com/rust-lang/rust/pull/40377
3745 [40409]: https://github.com/rust-lang/rust/pull/40409
3746 [40516]: https://github.com/rust-lang/rust/pull/40516
3747 [40556]: https://github.com/rust-lang/rust/pull/40556
3748 [40561]: https://github.com/rust-lang/rust/pull/40561
3749 [40589]: https://github.com/rust-lang/rust/pull/40589
3750 [40612]: https://github.com/rust-lang/rust/pull/40612
3751 [40723]: https://github.com/rust-lang/rust/pull/40723
3752 [40728]: https://github.com/rust-lang/rust/pull/40728
3753 [40731]: https://github.com/rust-lang/rust/pull/40731
3754 [40734]: https://github.com/rust-lang/rust/pull/40734
3755 [40805]: https://github.com/rust-lang/rust/pull/40805
3756 [40807]: https://github.com/rust-lang/rust/pull/40807
3757 [40828]: https://github.com/rust-lang/rust/pull/40828
3758 [40870]: https://github.com/rust-lang/rust/pull/40870
3759 [41085]: https://github.com/rust-lang/rust/pull/41085
3760 [41143]: https://github.com/rust-lang/rust/pull/41143
3761 [41168]: https://github.com/rust-lang/rust/pull/41168
3762 [41270]: https://github.com/rust-lang/rust/issues/41270
3763 [41469]: https://github.com/rust-lang/rust/pull/41469
3764 [41805]: https://github.com/rust-lang/rust/issues/41805
3765 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3766 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3767 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3768 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3769 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3770 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3771 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3772 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3773 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3774 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3775 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3776 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3777 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3778 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3779
3780
3781 Version 1.17.0 (2017-04-27)
3782 ===========================
3783
3784 Language
3785 --------
3786
3787 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3788 * [Fields of structs may be initialized without duplicating the field/variable
3789   names][39761]. [RFC 1682]
3790 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3791 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3792   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3793   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3794   `'b`. Soundness fix.
3795 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3796 * [Static variables may contain references to other statics][40027]
3797
3798 Compiler
3799 --------
3800
3801 * [Exit quickly on only `--emit dep-info`][40336]
3802 * [Make `-C relocation-model` more correctly determine whether the linker
3803   creates a position-independent executable][40245]
3804 * [Add `-C overflow-checks` to directly control whether integer overflow
3805   panics][40037]
3806 * [The rustc type checker now checks items on demand instead of in a single
3807   in-order pass][40008]. This is mostly an internal refactoring in support of
3808   future work, including incremental type checking, but also resolves [RFC
3809   1647], allowing `Self` to appear in `impl` `where` clauses.
3810 * [Optimize vtable loads][39995]
3811 * [Turn off vectorization for Emscripten targets][39990]
3812 * [Provide suggestions for unknown macros imported with `use`][39953]
3813 * [Fix ICEs in path resolution][39939]
3814 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3815 * [Add clearer error message using `&str + &str`][39116]
3816
3817 Stabilized APIs
3818 ---------------
3819
3820 * [`Arc::into_raw`]
3821 * [`Arc::from_raw`]
3822 * [`Arc::ptr_eq`]
3823 * [`Rc::into_raw`]
3824 * [`Rc::from_raw`]
3825 * [`Rc::ptr_eq`]
3826 * [`Ordering::then`]
3827 * [`Ordering::then_with`]
3828 * [`BTreeMap::range`]
3829 * [`BTreeMap::range_mut`]
3830 * [`collections::Bound`]
3831 * [`process::abort`]
3832 * [`ptr::read_unaligned`]
3833 * [`ptr::write_unaligned`]
3834 * [`Result::expect_err`]
3835 * [`Cell::swap`]
3836 * [`Cell::replace`]
3837 * [`Cell::into_inner`]
3838 * [`Cell::take`]
3839
3840 Libraries
3841 ---------
3842
3843 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3844 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3845 * [`String` implements `FromIterator<&char>`][40028]
3846 * `Box` [implements][40009] a number of new conversions:
3847   `From<Box<str>> for String`,
3848   `From<Box<[T]>> for Vec<T>`,
3849   `From<Box<CStr>> for CString`,
3850   `From<Box<OsStr>> for OsString`,
3851   `From<Box<Path>> for PathBuf`,
3852   `Into<Box<str>> for String`,
3853   `Into<Box<[T]>> for Vec<T>`,
3854   `Into<Box<CStr>> for CString`,
3855   `Into<Box<OsStr>> for OsString`,
3856   `Into<Box<Path>> for PathBuf`,
3857   `Default for Box<str>`,
3858   `Default for Box<CStr>`,
3859   `Default for Box<OsStr>`,
3860   `From<&CStr> for Box<CStr>`,
3861   `From<&OsStr> for Box<OsStr>`,
3862   `From<&Path> for Box<Path>`
3863 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3864 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3865 * [Slightly optimize `slice::sort`][39538]
3866 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3867 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3868   `Box<str>` implements `From<&str>`][39438]
3869 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3870   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3871 * [`format!` estimates the needed capacity before writing a string][39356]
3872 * [Support unprivileged symlink creation in Windows][38921]
3873 * [`PathBuf` implements `Default`][38764]
3874 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3875 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3876   and poor hash functions.
3877
3878 Cargo
3879 -----
3880
3881 * [Add `cargo check --all`][cargo/3731]
3882 * [Add an option to ignore SSL revocation checking][cargo/3699]
3883 * [Add `cargo run --package`][cargo/3691]
3884 * [Add `required_features`][cargo/3667]
3885 * [Assume `build.rs` is a build script][cargo/3664]
3886 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3887
3888 Misc
3889 ----
3890
3891 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3892   `rustbook`][39633]
3893 * [The "Unstable Book" documents nightly-only features][ubook]
3894 * [Improve the style of the sidebar in rustdoc output][40265]
3895 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3896 * [Fix MSP430 breakage due to `i128`][40257]
3897 * [Preliminary Solaris/SPARCv9 support][39903]
3898 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3899   run without installing the MSVC runtime.
3900 * [`rustdoc --test` includes file names in test names][39788]
3901 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3902   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3903 * [Initial support for `aarch64-unknown-freebsd`][39491]
3904 * [Initial support for `i686-unknown-netbsd`][39426]
3905 * [This release no longer includes the old makefile build system][39431]. Rust
3906   is built with a custom build system, written in Rust, and with Cargo.
3907 * [Add Debug implementations for libcollection structs][39002]
3908 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3909 * [`--test-threads=0` produces an error][38945]
3910 * [`rustup` installs documentation by default][40526]
3911 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3912   WinDbg and Visual Studio to improve the debugging experience.
3913
3914 Compatibility Notes
3915 -------------------
3916
3917 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3918   workaround, either use MSVC 2015 or run vcvars.bat.
3919 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3920   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3921   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3922   fix.
3923 * [`format!` and `Display::to_string` panic if an underlying formatting
3924   implementation returns an error][40117]. Previously the error was silently
3925   ignored. It is incorrect for `write_fmt` to return an error when writing
3926   to a string.
3927 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3928   crates were marked stable and could be accessed from the stable toolchain.
3929 * [Rust git source no longer includes vendored crates][39728]. Those that need
3930   to build with vendored crates should build from release tarballs.
3931 * [Fix inert attributes from `proc_macro_derives`][39572]
3932 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3933   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3934   build system.
3935 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3936   existing code generally ignores the type of dead-code unless a type-hint is
3937   provided; this can cause surprising inference interactions particularly around
3938   defaulting. The new code uniformly ignores the result type of dead-code.
3939 * [Tuple-struct constructors with private fields are no longer visible][38932]
3940 * [Lifetime parameters that do not appear in the arguments are now considered
3941   early-bound][38897], resolving a soundness bug (#[32330]). The
3942   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3943   April of 2016.
3944 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3945 * [Make transmuting from fn item types to pointer-sized types a hard
3946   error][34198]
3947
3948 [27787]: https://github.com/rust-lang/rust/issues/27787
3949 [32330]: https://github.com/rust-lang/rust/issues/32330
3950 [34198]: https://github.com/rust-lang/rust/pull/34198
3951 [38161]: https://github.com/rust-lang/rust/pull/38161
3952 [38368]: https://github.com/rust-lang/rust/pull/38368
3953 [38584]: https://github.com/rust-lang/rust/issues/38584
3954 [38661]: https://github.com/rust-lang/rust/pull/38661
3955 [38764]: https://github.com/rust-lang/rust/pull/38764
3956 [38864]: https://github.com/rust-lang/rust/issues/38864
3957 [38897]: https://github.com/rust-lang/rust/pull/38897
3958 [38921]: https://github.com/rust-lang/rust/pull/38921
3959 [38932]: https://github.com/rust-lang/rust/pull/38932
3960 [38945]: https://github.com/rust-lang/rust/pull/38945
3961 [38981]: https://github.com/rust-lang/rust/pull/38981
3962 [39002]: https://github.com/rust-lang/rust/pull/39002
3963 [39116]: https://github.com/rust-lang/rust/pull/39116
3964 [39193]: https://github.com/rust-lang/rust/pull/39193
3965 [39265]: https://github.com/rust-lang/rust/pull/39265
3966 [39356]: https://github.com/rust-lang/rust/pull/39356
3967 [39372]: https://github.com/rust-lang/rust/pull/39372
3968 [39426]: https://github.com/rust-lang/rust/pull/39426
3969 [39431]: https://github.com/rust-lang/rust/pull/39431
3970 [39438]: https://github.com/rust-lang/rust/pull/39438
3971 [39440]: https://github.com/rust-lang/rust/pull/39440
3972 [39485]: https://github.com/rust-lang/rust/pull/39485
3973 [39491]: https://github.com/rust-lang/rust/pull/39491
3974 [39518]: https://github.com/rust-lang/rust/pull/39518
3975 [39538]: https://github.com/rust-lang/rust/pull/39538
3976 [39572]: https://github.com/rust-lang/rust/pull/39572
3977 [39633]: https://github.com/rust-lang/rust/pull/39633
3978 [39642]: https://github.com/rust-lang/rust/pull/39642
3979 [39728]: https://github.com/rust-lang/rust/pull/39728
3980 [39761]: https://github.com/rust-lang/rust/pull/39761
3981 [39788]: https://github.com/rust-lang/rust/pull/39788
3982 [39793]: https://github.com/rust-lang/rust/pull/39793
3983 [39837]: https://github.com/rust-lang/rust/pull/39837
3984 [39843]: https://github.com/rust-lang/rust/pull/39843
3985 [39851]: https://github.com/rust-lang/rust/pull/39851
3986 [39903]: https://github.com/rust-lang/rust/pull/39903
3987 [39939]: https://github.com/rust-lang/rust/pull/39939
3988 [39953]: https://github.com/rust-lang/rust/pull/39953
3989 [39960]: https://github.com/rust-lang/rust/pull/39960
3990 [39990]: https://github.com/rust-lang/rust/pull/39990
3991 [39995]: https://github.com/rust-lang/rust/pull/39995
3992 [40008]: https://github.com/rust-lang/rust/pull/40008
3993 [40009]: https://github.com/rust-lang/rust/pull/40009
3994 [40027]: https://github.com/rust-lang/rust/pull/40027
3995 [40028]: https://github.com/rust-lang/rust/pull/40028
3996 [40037]: https://github.com/rust-lang/rust/pull/40037
3997 [40117]: https://github.com/rust-lang/rust/pull/40117
3998 [40166]: https://github.com/rust-lang/rust/pull/40166
3999 [40245]: https://github.com/rust-lang/rust/pull/40245
4000 [40257]: https://github.com/rust-lang/rust/pull/40257
4001 [40261]: https://github.com/rust-lang/rust/pull/40261
4002 [40265]: https://github.com/rust-lang/rust/pull/40265
4003 [40319]: https://github.com/rust-lang/rust/pull/40319
4004 [40336]: https://github.com/rust-lang/rust/pull/40336
4005 [40526]: https://github.com/rust-lang/rust/pull/40526
4006 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4007 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4008 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4009 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4010 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4011 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4012 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4013 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4014 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4015 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4016 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4017 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4018 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4019 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4020 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4021 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4022 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4023 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4024 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4025 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4026 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4027 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4028 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4029 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4030 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4031 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4032 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4033 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4034 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4035 [mdbook]: https://crates.io/crates/mdbook
4036 [ubook]: https://doc.rust-lang.org/unstable-book/
4037
4038
4039 Version 1.16.0 (2017-03-16)
4040 ===========================
4041
4042 Language
4043 --------
4044
4045 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4046 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4047   match patterns][38069]
4048 * [Clean up semantics of `self` in an import list][38313]
4049 * [`Self` may appear in `impl` headers][38920]
4050 * [`Self` may appear in struct expressions][39282]
4051
4052 Compiler
4053 --------
4054
4055 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4056   a `.rmeta` file containing only crate metadata][38571]. This can be
4057   used by tools like the Rust Language Service to perform
4058   metadata-only builds.
4059 * [Levenshtein based typo suggestions now work in most places, while
4060   previously they worked only for fields and sometimes for local
4061   variables][38927]. Together with the overhaul of "no
4062   resolution"/"unexpected resolution" errors (#[38154]) they result in
4063   large and systematic improvement in resolution diagnostics.
4064 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4065   `U`][38670]
4066 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4067 * [`rustc` no longer attempts to provide "consider using an explicit
4068   lifetime" suggestions][37057]. They were inaccurate.
4069
4070 Stabilized APIs
4071 ---------------
4072
4073 * [`VecDeque::truncate`]
4074 * [`VecDeque::resize`]
4075 * [`String::insert_str`]
4076 * [`Duration::checked_add`]
4077 * [`Duration::checked_sub`]
4078 * [`Duration::checked_div`]
4079 * [`Duration::checked_mul`]
4080 * [`str::replacen`]
4081 * [`str::repeat`]
4082 * [`SocketAddr::is_ipv4`]
4083 * [`SocketAddr::is_ipv6`]
4084 * [`IpAddr::is_ipv4`]
4085 * [`IpAddr::is_ipv6`]
4086 * [`Vec::dedup_by`]
4087 * [`Vec::dedup_by_key`]
4088 * [`Result::unwrap_or_default`]
4089 * [`<*const T>::wrapping_offset`]
4090 * [`<*mut T>::wrapping_offset`]
4091 * `CommandExt::creation_flags`
4092 * [`File::set_permissions`]
4093 * [`String::split_off`]
4094
4095 Libraries
4096 ---------
4097
4098 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4099   their argument by `Borrow` parameter][37761]
4100 * [All public types in std implement `Debug`][38006]
4101 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4102 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4103 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4104   Windows][38274]
4105 * [std: Fix partial writes in `LineWriter`][38062]
4106 * [std: Clamp max read/write sizes on Unix][38062]
4107 * [Use more specific panic message for `&str` slicing errors][38066]
4108 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4109   functionality cannot be achieved in std currently.
4110 * [`writeln!`, like `println!`, now accepts a form with no string
4111   or formatting arguments, to just print a newline][38469]
4112 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4113 * [Reduce the size of static data in `std_unicode::tables`][38781]
4114 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4115   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4116   `Display`][38909]
4117 * [`Duration` implements `Sum`][38712]
4118 * [`String` implements `ToSocketAddrs`][39048]
4119
4120 Cargo
4121 -----
4122
4123 * [The `cargo check` command does a type check of a project without
4124   building it][cargo/3296]
4125 * [crates.io will display CI badges from Travis and AppVeyor, if
4126   specified in Cargo.toml][cargo/3546]
4127 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4128 * [Compilation profiles accept integer values for `debug`, in addition
4129   to `true` and `false`. These are passed to `rustc` as the value to
4130   `-C debuginfo`][cargo/3534]
4131 * [Implement `cargo --version --verbose`][cargo/3604]
4132 * [All builds now output 'dep-info' build dependencies compatible with
4133   make and ninja][cargo/3557]
4134 * [Build all workspace members with `build --all`][cargo/3511]
4135 * [Document all workspace members with `doc --all`][cargo/3515]
4136 * [Path deps outside workspace are not members][cargo/3443]
4137
4138 Misc
4139 ----
4140
4141 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4142   the path to the Rust implementation][38589]
4143 * [The `armv7-linux-androideabi` target no longer enables NEON
4144   extensions, per Google's ABI guide][38413]
4145 * [The stock standard library can be compiled for Redox OS][38401]
4146 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4147   available.
4148 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4149   builds available.
4150 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4151
4152 Compatibility Notes
4153 -------------------
4154
4155 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4156   match patterns][38069]
4157 * In this release, references to uninhabited types can not be
4158   pattern-matched. This was accidentally allowed in 1.15.
4159 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4160 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4161   Windows][38274]
4162 * [Clean up semantics of `self` in an import list][38313]
4163 * Reimplemented lifetime elision. This change was almost entirely compatible
4164   with existing code, but it did close a number of small bugs and loopholes,
4165   as well as being more accepting in some other [cases][41105].
4166
4167 [37057]: https://github.com/rust-lang/rust/pull/37057
4168 [37761]: https://github.com/rust-lang/rust/pull/37761
4169 [38006]: https://github.com/rust-lang/rust/pull/38006
4170 [38051]: https://github.com/rust-lang/rust/pull/38051
4171 [38062]: https://github.com/rust-lang/rust/pull/38062
4172 [38062]: https://github.com/rust-lang/rust/pull/38622
4173 [38066]: https://github.com/rust-lang/rust/pull/38066
4174 [38069]: https://github.com/rust-lang/rust/pull/38069
4175 [38131]: https://github.com/rust-lang/rust/pull/38131
4176 [38154]: https://github.com/rust-lang/rust/pull/38154
4177 [38274]: https://github.com/rust-lang/rust/pull/38274
4178 [38304]: https://github.com/rust-lang/rust/pull/38304
4179 [38313]: https://github.com/rust-lang/rust/pull/38313
4180 [38314]: https://github.com/rust-lang/rust/pull/38314
4181 [38327]: https://github.com/rust-lang/rust/pull/38327
4182 [38401]: https://github.com/rust-lang/rust/pull/38401
4183 [38413]: https://github.com/rust-lang/rust/pull/38413
4184 [38469]: https://github.com/rust-lang/rust/pull/38469
4185 [38559]: https://github.com/rust-lang/rust/pull/38559
4186 [38571]: https://github.com/rust-lang/rust/pull/38571
4187 [38580]: https://github.com/rust-lang/rust/pull/38580
4188 [38589]: https://github.com/rust-lang/rust/pull/38589
4189 [38670]: https://github.com/rust-lang/rust/pull/38670
4190 [38712]: https://github.com/rust-lang/rust/pull/38712
4191 [38726]: https://github.com/rust-lang/rust/pull/38726
4192 [38781]: https://github.com/rust-lang/rust/pull/38781
4193 [38798]: https://github.com/rust-lang/rust/pull/38798
4194 [38909]: https://github.com/rust-lang/rust/pull/38909
4195 [38920]: https://github.com/rust-lang/rust/pull/38920
4196 [38927]: https://github.com/rust-lang/rust/pull/38927
4197 [39048]: https://github.com/rust-lang/rust/pull/39048
4198 [39282]: https://github.com/rust-lang/rust/pull/39282
4199 [39379]: https://github.com/rust-lang/rust/pull/39379
4200 [41105]: https://github.com/rust-lang/rust/issues/41105
4201 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4202 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4203 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4204 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4205 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4206 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4207 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4208 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4209 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4210 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4211 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4212 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4213 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4214 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4215 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4216 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4217 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4218 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4219 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4220 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4221 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4222 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4223 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4224 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4225 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4226 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4227 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4228 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4229 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4230 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4231
4232
4233 Version 1.15.1 (2017-02-09)
4234 ===========================
4235
4236 * [Fix IntoIter::as_mut_slice's signature][39466]
4237 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4238
4239 [39466]: https://github.com/rust-lang/rust/pull/39466
4240 [39523]: https://github.com/rust-lang/rust/pull/39523
4241
4242
4243 Version 1.15.0 (2017-02-02)
4244 ===========================
4245
4246 Language
4247 --------
4248
4249 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4250   stable. This allows popular code-generating crates like Serde and Diesel to
4251   work ergonomically. [RFC 1681].
4252 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4253   with curly braces][36868]. Part of [RFC 1506].
4254 * [A number of minor changes to name resolution have been activated][37127].
4255   They add up to more consistent semantics, allowing for future evolution of
4256   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4257   details of what is different. The breaking changes here have been transitioned
4258   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4259 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4260   bounds][38279]
4261 * [`?Sized` can be used in `where` clauses][37791]
4262 * [There is now a limit on the size of monomorphized types and it can be
4263   modified with the `#![type_size_limit]` crate attribute, similarly to
4264   the `#![recursion_limit]` attribute][37789]
4265
4266 Compiler
4267 --------
4268
4269 * [On Windows, the compiler will apply dllimport attributes when linking to
4270   extern functions][37973]. Additional attributes and flags can control which
4271   library kind is linked and its name. [RFC 1717].
4272 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4273 * [The `--test` flag works with procedural macro crates][38107]
4274 * [Fix `extern "aapcs" fn` ABI][37814]
4275 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4276 * [The `format!` expander recognizes incorrect `printf` and shell-style
4277   formatting directives and suggests the correct format][37613].
4278 * [Only report one error for all unused imports in an import list][37456]
4279
4280 Compiler Performance
4281 --------------------
4282
4283 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4284 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4285 * [Don't clone in `UnificationTable::probe`][37848]
4286 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4287 * [Use small vectors in type walker][37760]
4288 * [Macro expansion performance was improved][37701]
4289 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4290 * [Replace FNV with a faster hash function][37229]
4291
4292 Stabilized APIs
4293 ---------------
4294
4295 * [`std::iter::Iterator::min_by`]
4296 * [`std::iter::Iterator::max_by`]
4297 * [`std::os::*::fs::FileExt`]
4298 * [`std::sync::atomic::Atomic*::get_mut`]
4299 * [`std::sync::atomic::Atomic*::into_inner`]
4300 * [`std::vec::IntoIter::as_slice`]
4301 * [`std::vec::IntoIter::as_mut_slice`]
4302 * [`std::sync::mpsc::Receiver::try_iter`]
4303 * [`std::os::unix::process::CommandExt::before_exec`]
4304 * [`std::rc::Rc::strong_count`]
4305 * [`std::rc::Rc::weak_count`]
4306 * [`std::sync::Arc::strong_count`]
4307 * [`std::sync::Arc::weak_count`]
4308 * [`std::char::encode_utf8`]
4309 * [`std::char::encode_utf16`]
4310 * [`std::cell::Ref::clone`]
4311 * [`std::io::Take::into_inner`]
4312
4313 Libraries
4314 ---------
4315
4316 * [The standard sorting algorithm has been rewritten for dramatic performance
4317   improvements][38192]. It is a hybrid merge sort, drawing influences from
4318   Timsort. Previously it was a naive merge sort.
4319 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4320 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4321   performance.
4322 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4323   and `char_indices().last()`][37882]
4324 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4325 * [Chinese characters display correctly in `fmt::Debug`][37855]
4326 * [Derive `Default` for `Duration`][37699]
4327 * [Support creation of anonymous pipes on WinXP/2k][37677]
4328 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4329 * [Don't pass overlapped handles to processes][38835]
4330
4331 Cargo
4332 -----
4333
4334 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4335   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4336   should instead check the variable at runtime with `std::env`. That the value
4337   was set at build time was a bug, and incorrect when cross-compiling. This
4338   change is known to cause breakage.
4339 * [Add `--all` flag to `cargo test`][cargo/3221]
4340 * [Compile statically against the MSVC CRT][cargo/3363]
4341 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4342 * [Link OpenSSL statically on OSX][cargo/3311]
4343 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4344 * [Test for bad path overrides with summaries][cargo/3336]
4345 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4346 * [Fix retrying crate downloads for network errors][cargo/3348]
4347 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4348 * [Emit more info on --message-format=json][cargo/3319]
4349 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4350 * [Don't ignore errors in workspace manifest][cargo/3409]
4351 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4352
4353 Tooling
4354 -------
4355
4356 * [Test runners (binaries built with `--test`) now support a `--list` argument
4357   that lists the tests it contains][38185]
4358 * [Test runners now support a `--exact` argument that makes the test filter
4359   match exactly, instead of matching only a substring of the test name][38181]
4360 * [rustdoc supports a `--playground-url` flag][37763]
4361 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4362
4363 Misc
4364 ----
4365
4366 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4367   continue to be used in this release by passing `--disable-rustbuild` to the
4368   configure script, but they will be deleted soon. Note that the new build
4369   system uses a different on-disk layout that will likely affect any scripts
4370   building Rust.
4371 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4372   releases.
4373 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4374 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4375   releases.
4376
4377 Compatibility Notes
4378 -------------------
4379
4380 * [A number of minor changes to name resolution have been activated][37127].
4381   They add up to more consistent semantics, allowing for future evolution of
4382   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4383   details of what is different. The breaking changes here have been transitioned
4384   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4385 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4386   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4387   should instead check the variable at runtime with `std::env`. That the value
4388   was set at build time was a bug, and incorrect when cross-compiling. This
4389   change is known to cause breakage.
4390 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4391   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4392   1.10 and is now an error by default. It will become a hard error in the near
4393   future.
4394 * [The semantics relating modules to file system directories are changing in
4395   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4396   lint, which is a warning in this release, and will become a hard error in the
4397   future.
4398 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4399 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4400   the underlying iterator][37834]
4401
4402 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4403 [33685]: https://github.com/rust-lang/rust/issues/33685
4404 [36868]: https://github.com/rust-lang/rust/pull/36868
4405 [37127]: https://github.com/rust-lang/rust/pull/37127
4406 [37229]: https://github.com/rust-lang/rust/pull/37229
4407 [37456]: https://github.com/rust-lang/rust/pull/37456
4408 [37527]: https://github.com/rust-lang/rust/pull/37527
4409 [37602]: https://github.com/rust-lang/rust/pull/37602
4410 [37613]: https://github.com/rust-lang/rust/pull/37613
4411 [37615]: https://github.com/rust-lang/rust/pull/37615
4412 [37636]: https://github.com/rust-lang/rust/pull/37636
4413 [37627]: https://github.com/rust-lang/rust/pull/37627
4414 [37642]: https://github.com/rust-lang/rust/pull/37642
4415 [37677]: https://github.com/rust-lang/rust/pull/37677
4416 [37699]: https://github.com/rust-lang/rust/pull/37699
4417 [37701]: https://github.com/rust-lang/rust/pull/37701
4418 [37705]: https://github.com/rust-lang/rust/pull/37705
4419 [37749]: https://github.com/rust-lang/rust/pull/37749
4420 [37760]: https://github.com/rust-lang/rust/pull/37760
4421 [37763]: https://github.com/rust-lang/rust/pull/37763
4422 [37764]: https://github.com/rust-lang/rust/pull/37764
4423 [37789]: https://github.com/rust-lang/rust/pull/37789
4424 [37791]: https://github.com/rust-lang/rust/pull/37791
4425 [37814]: https://github.com/rust-lang/rust/pull/37814
4426 [37817]: https://github.com/rust-lang/rust/pull/37817
4427 [37834]: https://github.com/rust-lang/rust/pull/37834
4428 [37848]: https://github.com/rust-lang/rust/pull/37848
4429 [37855]: https://github.com/rust-lang/rust/pull/37855
4430 [37882]: https://github.com/rust-lang/rust/pull/37882
4431 [37888]: https://github.com/rust-lang/rust/pull/37888
4432 [37973]: https://github.com/rust-lang/rust/pull/37973
4433 [37979]: https://github.com/rust-lang/rust/pull/37979
4434 [38086]: https://github.com/rust-lang/rust/pull/38086
4435 [38107]: https://github.com/rust-lang/rust/pull/38107
4436 [38117]: https://github.com/rust-lang/rust/pull/38117
4437 [38134]: https://github.com/rust-lang/rust/pull/38134
4438 [38146]: https://github.com/rust-lang/rust/pull/38146
4439 [38181]: https://github.com/rust-lang/rust/pull/38181
4440 [38182]: https://github.com/rust-lang/rust/pull/38182
4441 [38185]: https://github.com/rust-lang/rust/pull/38185
4442 [38192]: https://github.com/rust-lang/rust/pull/38192
4443 [38279]: https://github.com/rust-lang/rust/pull/38279
4444 [38835]: https://github.com/rust-lang/rust/pull/38835
4445 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4446 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4447 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4448 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4449 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4450 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4451 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4452 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4453 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4454 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4455 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4456 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4457 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4458 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4459 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4460 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4461 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4462 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4463 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4464 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4465 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4466 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4467 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4468 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4469 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4470 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4471 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4472 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4473 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4474 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4475 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4476 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4477 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4478 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4479 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4480 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4481 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4482 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4483
4484
4485 Version 1.14.0 (2016-12-22)
4486 ===========================
4487
4488 Language
4489 --------
4490
4491 * [`..` matches multiple tuple fields in enum variants, structs
4492   and tuples][36843]. [RFC 1492].
4493 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4494 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4495 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4496   dereferencing][36822]
4497
4498 Compiler
4499 --------
4500
4501 * [Mark enums with non-zero discriminant as non-zero][37224]
4502 * [Lower-case `static mut` names are linted like other
4503   statics and consts][37162]
4504 * [Fix ICE on some macros in const integer positions
4505    (e.g. `[u8; m!()]`)][36819]
4506 * [Improve error message and snippet for "did you mean `x`"][36798]
4507 * [Add a panic-strategy field to the target specification][36794]
4508 * [Include LLVM version in `--version --verbose`][37200]
4509
4510 Compile-time Optimizations
4511 --------------------------
4512
4513 * [Improve macro expansion performance][37569]
4514 * [Shrink `Expr_::ExprInlineAsm`][37445]
4515 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4516 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4517 * [Avoid more allocations when compiling html5ever][37373]
4518 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4519 * [Avoid some allocations in the macro parser][37318]
4520 * [Use a faster deflate setting][37298]
4521 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4522   during interning of slices][37270]
4523 * [Optimize `write_metadata`][37267]
4524 * [Don't process obligation forest cycles when stalled][37231]
4525 * [Avoid many `CrateConfig` clones][37161]
4526 * [Optimize `Substs::super_fold_with`][37108]
4527 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4528 * [Speed up `plug_leaks`][36917]
4529
4530 Libraries
4531 ---------
4532
4533 * [`println!()`, with no arguments, prints newline][36825].
4534   Previously, an empty string was required to achieve the same.
4535 * [`Wrapping` impls standard binary and unary operators, as well as
4536    the `Sum` and `Product` iterators][37356]
4537 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4538   Vec<T>`][37326]
4539 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4540   `VecDeque` iterators][37315]
4541 * [Improve `SipHasher` performance on small values][37312]
4542 * [Add Iterator trait TrustedLen to enable better FromIterator /
4543   Extend][37306]
4544 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4545 * [`ReadDir` implements `Debug`][37221]
4546 * [Implement `RefUnwindSafe` for atomic types][37178]
4547 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4548 * [Avoid allocations in `Decoder::read_str`][37064]
4549 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4550 * [Impl `Debug` for raw pointers to unsized data][36880]
4551 * [Don't reuse `HashMap` random seeds][37470]
4552 * [The internal memory layout of `HashMap` is more cache-friendly, for
4553   significant improvements in some operations][36692]
4554 * [`HashMap` uses less memory on 32-bit architectures][36595]
4555 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4556
4557 Cargo
4558 -----
4559
4560 * [Expose rustc cfg values to build scripts][cargo/3243]
4561 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4562 * [Fix passing --features when testing multiple packages][cargo/3280]
4563 * [Use a single profile set per workspace][cargo/3249]
4564 * [Load `replace` sections from lock files][cargo/3220]
4565 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4566
4567 Tooling
4568 -------
4569
4570 * [rustup is the recommended Rust installation method][1.14rustup]
4571 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4572   S390x. These are [tier 2] platforms and may have major defects. Follow the
4573   instructions on the website to install, or add the targets to an existing
4574   installation with `rustup target add`. The new target triples are:
4575   - `mips-unknown-linux-gnu`
4576   - `mipsel-unknown-linux-gnu`
4577   - `mips64-unknown-linux-gnuabi64`
4578   - `mips64el-unknown-linux-gnuabi64 `
4579   - `powerpc-unknown-linux-gnu`
4580   - `powerpc64-unknown-linux-gnu`
4581   - `powerpc64le-unknown-linux-gnu`
4582   - `s390x-unknown-linux-gnu `
4583 * This release includes target (std) builds for ARM Linux running MUSL
4584   libc. These are [tier 2] platforms and may have major defects. Add the
4585   following triples to an existing rustup installation with `rustup target add`:
4586   - `arm-unknown-linux-musleabi`
4587   - `arm-unknown-linux-musleabihf`
4588   - `armv7-unknown-linux-musleabihf`
4589 * This release includes [experimental support for WebAssembly][1.14wasm], via
4590   the `wasm32-unknown-emscripten` target. This target is known to have major
4591   defects. Please test, report, and fix.
4592 * rustup no longer installs documentation by default. Run `rustup
4593   component add rust-docs` to install.
4594 * [Fix line stepping in debugger][37310]
4595 * [Enable line number debuginfo in releases][37280]
4596
4597 Misc
4598 ----
4599
4600 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4601 * [Add support for Fuchsia OS][37313]
4602 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4603
4604 Compatibility Notes
4605 -------------------
4606
4607 * [A number of forward-compatibility lints used by the compiler
4608   to gradually introduce language changes have been converted
4609   to deny by default][36894]:
4610   - ["use of inaccessible extern crate erroneously allowed"][36886]
4611   - ["type parameter default erroneously allowed in invalid location"][36887]
4612   - ["detects super or self keywords at the beginning of global path"][36888]
4613   - ["two overlapping inherent impls define an item with the same name
4614     were erroneously allowed"][36889]
4615   - ["floating-point constants cannot be used in patterns"][36890]
4616   - ["constants of struct or enum type can only be used in a pattern if
4617      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4618   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4619 * [Prohibit patterns in trait methods without bodies][37378]
4620 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4621 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4622 * [The `$crate` macro variable is accepted in fewer locations][37213]
4623 * [Impls specifying extra region requirements beyond the trait
4624   they implement are rejected][37167]
4625 * [Enums may not be unsized][37111]. Unsized enums are intended to
4626   work but never have. For now they are forbidden.
4627 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4628
4629 [tier 2]: https://forge.rust-lang.org/platform-support.html
4630 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4631 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4632 [36430]: https://github.com/rust-lang/rust/pull/36430
4633 [36595]: https://github.com/rust-lang/rust/pull/36595
4634 [36595]: https://github.com/rust-lang/rust/pull/36595
4635 [36692]: https://github.com/rust-lang/rust/pull/36692
4636 [36767]: https://github.com/rust-lang/rust/pull/36767
4637 [36794]: https://github.com/rust-lang/rust/pull/36794
4638 [36798]: https://github.com/rust-lang/rust/pull/36798
4639 [36819]: https://github.com/rust-lang/rust/pull/36819
4640 [36822]: https://github.com/rust-lang/rust/pull/36822
4641 [36825]: https://github.com/rust-lang/rust/pull/36825
4642 [36843]: https://github.com/rust-lang/rust/pull/36843
4643 [36880]: https://github.com/rust-lang/rust/pull/36880
4644 [36886]: https://github.com/rust-lang/rust/issues/36886
4645 [36887]: https://github.com/rust-lang/rust/issues/36887
4646 [36888]: https://github.com/rust-lang/rust/issues/36888
4647 [36889]: https://github.com/rust-lang/rust/issues/36889
4648 [36890]: https://github.com/rust-lang/rust/issues/36890
4649 [36891]: https://github.com/rust-lang/rust/issues/36891
4650 [36892]: https://github.com/rust-lang/rust/issues/36892
4651 [36894]: https://github.com/rust-lang/rust/pull/36894
4652 [36917]: https://github.com/rust-lang/rust/pull/36917
4653 [36993]: https://github.com/rust-lang/rust/pull/36993
4654 [37037]: https://github.com/rust-lang/rust/pull/37037
4655 [37064]: https://github.com/rust-lang/rust/pull/37064
4656 [37094]: https://github.com/rust-lang/rust/pull/37094
4657 [37108]: https://github.com/rust-lang/rust/pull/37108
4658 [37111]: https://github.com/rust-lang/rust/pull/37111
4659 [37161]: https://github.com/rust-lang/rust/pull/37161
4660 [37162]: https://github.com/rust-lang/rust/pull/37162
4661 [37167]: https://github.com/rust-lang/rust/pull/37167
4662 [37178]: https://github.com/rust-lang/rust/pull/37178
4663 [37200]: https://github.com/rust-lang/rust/pull/37200
4664 [37213]: https://github.com/rust-lang/rust/pull/37213
4665 [37221]: https://github.com/rust-lang/rust/pull/37221
4666 [37224]: https://github.com/rust-lang/rust/pull/37224
4667 [37230]: https://github.com/rust-lang/rust/pull/37230
4668 [37231]: https://github.com/rust-lang/rust/pull/37231
4669 [37247]: https://github.com/rust-lang/rust/pull/37247
4670 [37267]: https://github.com/rust-lang/rust/pull/37267
4671 [37270]: https://github.com/rust-lang/rust/pull/37270
4672 [37273]: https://github.com/rust-lang/rust/pull/37273
4673 [37280]: https://github.com/rust-lang/rust/pull/37280
4674 [37298]: https://github.com/rust-lang/rust/pull/37298
4675 [37306]: https://github.com/rust-lang/rust/pull/37306
4676 [37310]: https://github.com/rust-lang/rust/pull/37310
4677 [37312]: https://github.com/rust-lang/rust/pull/37312
4678 [37313]: https://github.com/rust-lang/rust/pull/37313
4679 [37315]: https://github.com/rust-lang/rust/pull/37315
4680 [37318]: https://github.com/rust-lang/rust/pull/37318
4681 [37322]: https://github.com/rust-lang/rust/pull/37322
4682 [37326]: https://github.com/rust-lang/rust/pull/37326
4683 [37351]: https://github.com/rust-lang/rust/pull/37351
4684 [37356]: https://github.com/rust-lang/rust/pull/37356
4685 [37367]: https://github.com/rust-lang/rust/pull/37367
4686 [37373]: https://github.com/rust-lang/rust/pull/37373
4687 [37378]: https://github.com/rust-lang/rust/pull/37378
4688 [37389]: https://github.com/rust-lang/rust/pull/37389
4689 [37392]: https://github.com/rust-lang/rust/pull/37392
4690 [37427]: https://github.com/rust-lang/rust/pull/37427
4691 [37439]: https://github.com/rust-lang/rust/pull/37439
4692 [37445]: https://github.com/rust-lang/rust/pull/37445
4693 [37470]: https://github.com/rust-lang/rust/pull/37470
4694 [37569]: https://github.com/rust-lang/rust/pull/37569
4695 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4696 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4697 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4698 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4699 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4700 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4701 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4702
4703
4704 Version 1.13.0 (2016-11-10)
4705 ===========================
4706
4707 Language
4708 --------
4709
4710 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4711   errors, like the `try!` macro, described in [RFC 0243].
4712 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4713 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4714 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4715 * [Fix lifetime rules for 'if' conditions][36029]
4716 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4717
4718 Compiler
4719 --------
4720
4721 * [Add the `-C link-arg` argument][36574]
4722 * [Remove the old AST-based backend from rustc_trans][35764]
4723 * [Don't enable NEON by default on armv7 Linux][35814]
4724 * [Fix debug line number info for macro expansions][35238]
4725 * [Do not emit "class method" debuginfo for types that are not
4726   DICompositeType][36008]
4727 * [Warn about multiple conflicting #[repr] hints][34623]
4728 * [When sizing DST, don't double-count nested struct prefixes][36351]
4729 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4730 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4731 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4732 * [Expand macros without recursing to avoid stack overflows][36214]
4733
4734 Diagnostics
4735 -----------
4736
4737 * [Replace macro backtraces with labeled local uses][35702]
4738 * [Improve error message for misplaced doc comments][33922]
4739 * [Buffer unix and lock windows to prevent message interleaving][35975]
4740 * [Update lifetime errors to specifically note temporaries][36171]
4741 * [Special case a few colors for Windows][36178]
4742 * [Suggest `use self` when such an import resolves][36289]
4743 * [Be more specific when type parameter shadows primitive type][36338]
4744 * Many minor improvements
4745
4746 Compile-time Optimizations
4747 --------------------------
4748
4749 * [Compute and cache HIR hashes at beginning][35854]
4750 * [Don't hash types in loan paths][36004]
4751 * [Cache projections in trans][35761]
4752 * [Optimize the parser's last token handling][36527]
4753 * [Only instantiate #[inline] functions in codegen units referencing
4754   them][36524]. This leads to big improvements in cases where crates export
4755   define many inline functions without using them directly.
4756 * [Lazily allocate TypedArena's first chunk][36592]
4757 * [Don't allocate during default HashSet creation][36734]
4758
4759 Stabilized APIs
4760 ---------------
4761
4762 * [`checked_abs`]
4763 * [`wrapping_abs`]
4764 * [`overflowing_abs`]
4765 * [`RefCell::try_borrow`]
4766 * [`RefCell::try_borrow_mut`]
4767
4768 Libraries
4769 ---------
4770
4771 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4772 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4773   covariant][35354]
4774 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4775 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4776 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4777 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4778 * [Use arc4rand on FreeBSD][35884]
4779 * [memrchr: Correct aligned offset computation][35969]
4780 * [Improve Demangling of Rust Symbols][36059]
4781 * [Use monotonic time in condition variables][35048]
4782 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4783 * [Implement conversion traits for `char`][35755]
4784 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4785 * [Zero first byte of CString on drop][36264]
4786 * [Inherit overflow checks for sum and product][36372]
4787 * [Add missing Eq implementations][36423]
4788 * [Implement `Debug` for `DirEntry`][36631]
4789 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4790   `errno`][36754]
4791 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4792 * [Implement more traits for `std::io::ErrorKind`][35911]
4793 * [Optimize BinaryHeap bounds checking][36072]
4794 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4795   `extend_with_element`][36355]
4796 * [Fix overflow checking in unsigned pow()][34942]
4797
4798 Cargo
4799 -----
4800
4801 * This release includes security fixes to both curl and OpenSSL.
4802 * [Fix transitive doctests when panic=abort][cargo/3021]
4803 * [Add --all-features flag to cargo][cargo/3038]
4804 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4805 * [Don't parse the home directory more than once][cargo/3078]
4806 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4807 * [Update OpenSSL to 1.0.2j][cargo/3121]
4808 * [Add license and license_file to cargo metadata output][cargo/3110]
4809 * [Make crates-io registry URL optional in config; ignore all changes to
4810   source.crates-io][cargo/3089]
4811 * [Don't download dependencies from other platforms][cargo/3123]
4812 * [Build transitive dev-dependencies when needed][cargo/3125]
4813 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4814 * [Avoid updating registry when adding existing deps][cargo/3144]
4815 * [Warn about path overrides that won't work][cargo/3136]
4816 * [Use workspaces during `cargo install`][cargo/3146]
4817 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4818 * [Add --message-format flag][cargo/3000]
4819 * [Pass target environment for rustdoc][cargo/3205]
4820 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4821 * [Update curl and curl-sys][cargo/3241]
4822 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4823
4824 Tooling
4825 -------
4826
4827 * [rustdoc: Add the `--sysroot` argument][36586]
4828 * [rustdoc: Fix a couple of issues with the search results][35655]
4829 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4830 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4831 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4832
4833 Misc
4834 ----
4835
4836 * [Remove unmaintained style guide][35124]
4837 * [Add s390x support][36369]
4838 * [Initial work at Haiku OS support][36727]
4839 * [Add mips-uclibc targets][35734]
4840 * [Crate-ify compiler-rt into compiler-builtins][35021]
4841 * [Add rustc version info (git hash + date) to dist tarball][36213]
4842 * Many documentation improvements
4843
4844 Compatibility Notes
4845 -------------------
4846
4847 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4848 * [Deny (by default) transmuting from fn item types to pointer-sized
4849   types][34923]. Continuing the long transition to zero-sized fn items,
4850   per [RFC 401].
4851 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4852   Part of [RFC 1506].
4853 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4854 * [Fix lifetime rules for 'if' conditions][36029].
4855 * [Inherit overflow checks for sum and product][36372].
4856 * [Forbid user-defined macros named "macro_rules"][36730].
4857
4858 [33922]: https://github.com/rust-lang/rust/pull/33922
4859 [34623]: https://github.com/rust-lang/rust/pull/34623
4860 [34923]: https://github.com/rust-lang/rust/pull/34923
4861 [34942]: https://github.com/rust-lang/rust/pull/34942
4862 [34982]: https://github.com/rust-lang/rust/pull/34982
4863 [35021]: https://github.com/rust-lang/rust/pull/35021
4864 [35048]: https://github.com/rust-lang/rust/pull/35048
4865 [35074]: https://github.com/rust-lang/rust/pull/35074
4866 [35124]: https://github.com/rust-lang/rust/pull/35124
4867 [35234]: https://github.com/rust-lang/rust/pull/35234
4868 [35238]: https://github.com/rust-lang/rust/pull/35238
4869 [35354]: https://github.com/rust-lang/rust/pull/35354
4870 [35559]: https://github.com/rust-lang/rust/pull/35559
4871 [35585]: https://github.com/rust-lang/rust/pull/35585
4872 [35627]: https://github.com/rust-lang/rust/pull/35627
4873 [35655]: https://github.com/rust-lang/rust/pull/35655
4874 [35702]: https://github.com/rust-lang/rust/pull/35702
4875 [35707]: https://github.com/rust-lang/rust/pull/35707
4876 [35728]: https://github.com/rust-lang/rust/pull/35728
4877 [35734]: https://github.com/rust-lang/rust/pull/35734
4878 [35755]: https://github.com/rust-lang/rust/pull/35755
4879 [35761]: https://github.com/rust-lang/rust/pull/35761
4880 [35764]: https://github.com/rust-lang/rust/pull/35764
4881 [35814]: https://github.com/rust-lang/rust/pull/35814
4882 [35854]: https://github.com/rust-lang/rust/pull/35854
4883 [35871]: https://github.com/rust-lang/rust/pull/35871
4884 [35884]: https://github.com/rust-lang/rust/pull/35884
4885 [35911]: https://github.com/rust-lang/rust/pull/35911
4886 [35969]: https://github.com/rust-lang/rust/pull/35969
4887 [35975]: https://github.com/rust-lang/rust/pull/35975
4888 [36004]: https://github.com/rust-lang/rust/pull/36004
4889 [36008]: https://github.com/rust-lang/rust/pull/36008
4890 [36014]: https://github.com/rust-lang/rust/pull/36014
4891 [36029]: https://github.com/rust-lang/rust/pull/36029
4892 [36059]: https://github.com/rust-lang/rust/pull/36059
4893 [36072]: https://github.com/rust-lang/rust/pull/36072
4894 [36101]: https://github.com/rust-lang/rust/pull/36101
4895 [36104]: https://github.com/rust-lang/rust/pull/36104
4896 [36171]: https://github.com/rust-lang/rust/pull/36171
4897 [36173]: https://github.com/rust-lang/rust/pull/36173
4898 [36178]: https://github.com/rust-lang/rust/pull/36178
4899 [36213]: https://github.com/rust-lang/rust/pull/36213
4900 [36214]: https://github.com/rust-lang/rust/pull/36214
4901 [36264]: https://github.com/rust-lang/rust/pull/36264
4902 [36266]: https://github.com/rust-lang/rust/pull/36266
4903 [36289]: https://github.com/rust-lang/rust/pull/36289
4904 [36338]: https://github.com/rust-lang/rust/pull/36338
4905 [36351]: https://github.com/rust-lang/rust/pull/36351
4906 [36355]: https://github.com/rust-lang/rust/pull/36355
4907 [36369]: https://github.com/rust-lang/rust/pull/36369
4908 [36372]: https://github.com/rust-lang/rust/pull/36372
4909 [36423]: https://github.com/rust-lang/rust/pull/36423
4910 [36482]: https://github.com/rust-lang/rust/pull/36482
4911 [36505]: https://github.com/rust-lang/rust/pull/36505
4912 [36524]: https://github.com/rust-lang/rust/pull/36524
4913 [36527]: https://github.com/rust-lang/rust/pull/36527
4914 [36551]: https://github.com/rust-lang/rust/pull/36551
4915 [36574]: https://github.com/rust-lang/rust/pull/36574
4916 [36586]: https://github.com/rust-lang/rust/pull/36586
4917 [36592]: https://github.com/rust-lang/rust/pull/36592
4918 [36631]: https://github.com/rust-lang/rust/pull/36631
4919 [36639]: https://github.com/rust-lang/rust/pull/36639
4920 [36721]: https://github.com/rust-lang/rust/pull/36721
4921 [36727]: https://github.com/rust-lang/rust/pull/36727
4922 [36730]: https://github.com/rust-lang/rust/pull/36730
4923 [36734]: https://github.com/rust-lang/rust/pull/36734
4924 [36754]: https://github.com/rust-lang/rust/pull/36754
4925 [36995]: https://github.com/rust-lang/rust/pull/36995
4926 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4927 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4928 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4929 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4930 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4931 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4932 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4933 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4934 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4935 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4936 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4937 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4938 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4939 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4940 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4941 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4942 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4943 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4944 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4945 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4946 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4947 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4948 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4949 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4950 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4951 [rustup]: https://www.rustup.rs
4952 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4953 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4954 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4955 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4956 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4957 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4958 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4959
4960
4961 Version 1.12.1 (2016-10-20)
4962 ===========================
4963
4964 Regression Fixes
4965 ----------------
4966
4967 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4968 * [Confusion with double negation and booleans][36856]
4969 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4970 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4971 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4972 * [Corrupted memory after updated to 1.12][36936]
4973 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4974 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4975 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4976
4977 [36381]: https://github.com/rust-lang/rust/issues/36381
4978 [36856]: https://github.com/rust-lang/rust/issues/36856
4979 [36875]: https://github.com/rust-lang/rust/issues/36875
4980 [36924]: https://github.com/rust-lang/rust/issues/36924
4981 [36926]: https://github.com/rust-lang/rust/issues/36926
4982 [36936]: https://github.com/rust-lang/rust/issues/36936
4983 [37026]: https://github.com/rust-lang/rust/issues/37026
4984 [37112]: https://github.com/rust-lang/rust/issues/37112
4985 [37153]: https://github.com/rust-lang/rust/issues/37153
4986
4987
4988 Version 1.12.0 (2016-09-29)
4989 ===========================
4990
4991 Highlights
4992 ----------
4993
4994 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4995   This translation pass is far simpler than the previous AST->LLVM pass, and
4996   creates opportunities to perform new optimizations directly on the MIR. It
4997   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4998 * [`rustc` presents a new, more readable error format, along with
4999   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5000   Most common editors supporting Rust have been updated to work with it. It was
5001   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5002
5003 Compiler
5004 --------
5005
5006 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5007   This translation pass is far simpler than the previous AST->LLVM pass, and
5008   creates opportunities to perform new optimizations directly on the MIR. It
5009   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5010 * [Print the Rust target name, not the LLVM target name, with
5011   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5012 * [The computation of `TypeId` is correct in some cases where it was previously
5013   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5014 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5015 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5016   `--print relocation-models`, and `--print code-models` print the available
5017   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5018   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5019 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5020   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5021   These targets produce statically-linked binaries. There are no binary release
5022   builds yet though.
5023
5024 Diagnostics
5025 -----------
5026
5027 * [`rustc` presents a new, more readable error format, along with
5028   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5029   Most common editors supporting Rust have been updated to work with it. It was
5030   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5031 * [In error descriptions, references are now described in plain English,
5032   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5033 * [In error type descriptions, unknown numeric types are named `{integer}` or
5034   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5035 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5036
5037 Language
5038 --------
5039
5040 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5041 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5042 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5043   useful](https://github.com/rust-lang/rust/pull/34908)
5044 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5045   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5046 * [Semicolons are properly required as statement delimiters inside
5047   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5048 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5049
5050 Stabilized APIs
5051 ---------------
5052
5053 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5054 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5055 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5056 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5057 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5058 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5059 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5060 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5061 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5062 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5063   Both on Unix and Windows.
5064 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5065 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5066 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5067 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5068 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5069 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5070 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5071 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5072
5073 Libraries
5074 ---------
5075
5076 * [The `format!` macro and friends now allow a single argument to be formatted
5077   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5078 * [The lifetime bounds on `[T]::binary_search_by` and
5079   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5080 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5081 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5082 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5083 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5084 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5085 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5086 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5087 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5088   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5089 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5090   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5091 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5092 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5093   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5094 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5095 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5096 * [`mpsc::sync_channel` `Receiver`s return any available message before
5097   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5098 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5099 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5100
5101 Cargo
5102 -----
5103
5104 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5105 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5106 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5107 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5108 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5109 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5110 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5111 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5112 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5113 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5114 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5115 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5116 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5117 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5118 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5119 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5120
5121 Performance
5122 -----------
5123
5124 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5125 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5126
5127 Tooling
5128 -------
5129
5130 * [Test binaries now support a `--test-threads` argument to specify the number
5131   of threads used to run tests, and which acts the same as the
5132   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5133 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5134 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5135 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5136 * [Rust releases now come with source packages that can be installed by rustup
5137   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5138   The resulting source code can be used by tools and IDES, located in the
5139   sysroot under `lib/rustlib/src`.
5140
5141 Misc
5142 ----
5143
5144 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5145 * Many minor improvements to the documentation.
5146 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5147
5148 Compatibility Notes
5149 -------------------
5150
5151 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5152   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5153 * [When formatting strings, if "precision" is specified, the "fill",
5154   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5155 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5156
5157
5158 Version 1.11.0 (2016-08-18)
5159 ===========================
5160
5161 Language
5162 --------
5163
5164 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5165 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5166 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5167 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5168
5169 Stabilized APIs
5170 ---------------
5171
5172 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5173 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5174 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5175 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5176 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5177 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5178   (in libcore - previously stabilized in libstd)
5179 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5180   (in libcore - previously stabilized in libstd)
5181 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5182   (in libcore - previously stabilized in libstd)
5183 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5184   (in libcore - previously stabilized in libstd)
5185 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5186 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5187 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5188 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5189
5190 Libraries
5191 ---------
5192
5193 * [The `thread_local!` macro supports multiple definitions in a single
5194    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5195 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5196 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5197   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5198 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5199 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5200 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5201 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5202
5203 Cargo
5204 -----
5205
5206 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5207 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5208 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5209 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5210 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5211   and `-vv` prints warnings for all crates.
5212 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5213 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5214   This provides room for expansion by arbitrary tools.
5215 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5216 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5217 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5218 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5219 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5220 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5221 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5222
5223 Performance
5224 -----------
5225
5226 * [Caching projections speeds up type check dramatically for some
5227   workloads](https://github.com/rust-lang/rust/pull/33816)
5228 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5229   This hasher is faster, but is believed to provide sufficient
5230   protection from collision attacks.
5231 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5232
5233 Rustdoc
5234 -------
5235
5236 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5237 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5238 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5239 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5240 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5241
5242 Tooling
5243 -------
5244
5245 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5246 * [When emitting debug info, rustc emits frame pointers for closures,
5247   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5248 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5249 * Many more errors have been given error codes and extended
5250   explanations
5251 * API documentation continues to be improved, with many new examples
5252
5253 Misc
5254 ----
5255
5256 * [rustc no longer hangs when dependencies recursively re-export
5257   submodules](https://github.com/rust-lang/rust/pull/34542)
5258 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5259 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5260   rewritten](https://github.com/rust-lang/rust/pull/33895)
5261 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5262   No targets use this yet, but it works toward AVR support.
5263
5264 Compatibility Notes
5265 -------------------
5266
5267 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5268 * [The new follow-set rules that place restrictions on `macro_rules!`
5269   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5270   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5271   and has been a warning since 1.10.
5272 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5273   This causes breakage in some corner cases.
5274
5275
5276 Version 1.10.0 (2016-07-07)
5277 ===========================
5278
5279 Language
5280 --------
5281
5282 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5283   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5284 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5285 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5286 * [`panic!` can be converted to a runtime abort with the
5287   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5288   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5289 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5290   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5291   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5292   Note that Cargo does not yet directly support cdylibs.
5293
5294 Stabilized APIs
5295 ---------------
5296
5297 * `os::windows::fs::OpenOptionsExt::access_mode`
5298 * `os::windows::fs::OpenOptionsExt::share_mode`
5299 * `os::windows::fs::OpenOptionsExt::custom_flags`
5300 * `os::windows::fs::OpenOptionsExt::attributes`
5301 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5302 * `os::unix::fs::OpenOptionsExt::custom_flags`
5303 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5304 * `Default for sync::Weak`
5305 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5306 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5307 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5308 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5309 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5310 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5311 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5312 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5313 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5314 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5315 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5316 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5317 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5318 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5319 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5320 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5321 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5322 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5323 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5324 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5325 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5326 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5327 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5328 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5329 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5330 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5331 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5332 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5333 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5334 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5335 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5336 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5337 * Read/Write/RawFd impls for `UnixStream`
5338 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5339 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5340 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5341 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5342 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5343 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5344 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5345 * RawFd impls for `UnixListener`
5346 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5347 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5348 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5349 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5350 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5351 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5352 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5353 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5354 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5355 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5356 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5357 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5358 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5359 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5360 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5361 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5362 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5363 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5364 * RawFd impls for `UnixDatagram`
5365 * `{BTree,Hash}Map::values_mut`
5366 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5367
5368 Libraries
5369 ---------
5370
5371 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5372   The semantics of this minor method are subtle and probably not what
5373   most people want.
5374 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5375 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5376   will fall back to `/dev/urandom` temporarily to avoid blocking
5377   during early boot](https://github.com/rust-lang/rust/pull/33086).
5378 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5379 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5380 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5381 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5382 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5383 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5384   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5385
5386 Cargo
5387 -----
5388 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5389   This controls the runtime behavior of the `panic!` macro
5390   and can be either "unwind" (the default), or "abort".
5391   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5392 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5393 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5394 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5395   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5396 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5397 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5398 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5399   By default they are retried twice, which can be customized with the
5400   `net.retry` value in `.cargo/config`.
5401 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5402 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5403 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5404 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5405   Makes it possible to install multiple crates in parallel.
5406 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5407 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5408 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5409 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5410 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5411 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5412
5413 Performance
5414 -----------
5415
5416 * [rustc memory usage was reduced by refactoring the context used for
5417   type checking](https://github.com/rust-lang/rust/pull/33425).
5418 * [Speed up creation of `HashMap`s by caching the random keys used
5419   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5420 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5421 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5422 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5423   10x faster than the previous lookup tables.
5424 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5425
5426 Usability
5427 ---------
5428
5429 * Many incremental improvements to documentation and rustdoc.
5430 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5431 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5432 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5433 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5434 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5435 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5436 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5437
5438 Misc
5439 ----
5440
5441 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5442 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5443 * [`std` no longer prints backtraces on platforms where the running
5444   module must be loaded with `env::current_exe`, which can't be relied
5445   on](https://github.com/rust-lang/rust/pull/33554).
5446 * This release includes std binaries for the i586-unknown-linux-gnu,
5447   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5448   i586 target is for old x86 hardware without SSE2, and the armv7
5449   target is for Android running on modern ARM architectures.
5450 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5451   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5452 * [On Unix the runtime aborts by calling `libc::abort` instead of
5453   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5454 * [Rust is now bootstrapped from the previous release of Rust,
5455   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5456
5457 Compatibility Notes
5458 -------------------
5459
5460 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5461 * [`target_env` for Linux ARM targets is just `gnu`, not
5462   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5463 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5464 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5465 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5466   Affects how macros are parsed.
5467 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5468 * [Feature-gated attributes on macro-generated macro invocations are
5469   now rejected](https://github.com/rust-lang/rust/pull/32791).
5470 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5471   This caused some minor changes to type inference.
5472
5473
5474 Version 1.9.0 (2016-05-26)
5475 ==========================
5476
5477 Language
5478 --------
5479
5480 * The `#[deprecated]` attribute when applied to an API will generate
5481   warnings when used. The warnings may be suppressed with
5482   `#[allow(deprecated)]`. [RFC 1270].
5483 * [`fn` item types are zero sized, and each `fn` names a unique
5484   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5485   `transmute` on a `fn` type will generate a warning for a few cycles,
5486   then will be converted to an error.
5487 * [Field and method resolution understand visibility, so private
5488   fields and methods cannot prevent the proper use of public fields
5489   and methods][1.9fv].
5490 * [The parser considers unicode codepoints in the
5491   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5492
5493 Stabilized APIs
5494 ---------------
5495
5496 * [`std::panic`]
5497 * [`std::panic::catch_unwind`] (renamed from `recover`)
5498 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5499 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5500 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5501 * [`str::is_char_boundary`]
5502 * [`<*const T>::as_ref`]
5503 * [`<*mut T>::as_ref`]
5504 * [`<*mut T>::as_mut`]
5505 * [`AsciiExt::make_ascii_uppercase`]
5506 * [`AsciiExt::make_ascii_lowercase`]
5507 * [`char::decode_utf16`]
5508 * [`char::DecodeUtf16`]
5509 * [`char::DecodeUtf16Error`]
5510 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5511 * [`BTreeSet::take`]
5512 * [`BTreeSet::replace`]
5513 * [`BTreeSet::get`]
5514 * [`HashSet::take`]
5515 * [`HashSet::replace`]
5516 * [`HashSet::get`]
5517 * [`OsString::with_capacity`]
5518 * [`OsString::clear`]
5519 * [`OsString::capacity`]
5520 * [`OsString::reserve`]
5521 * [`OsString::reserve_exact`]
5522 * [`OsStr::is_empty`]
5523 * [`OsStr::len`]
5524 * [`std::os::unix::thread`]
5525 * [`RawPthread`]
5526 * [`JoinHandleExt`]
5527 * [`JoinHandleExt::as_pthread_t`]
5528 * [`JoinHandleExt::into_pthread_t`]
5529 * [`HashSet::hasher`]
5530 * [`HashMap::hasher`]
5531 * [`CommandExt::exec`]
5532 * [`File::try_clone`]
5533 * [`SocketAddr::set_ip`]
5534 * [`SocketAddr::set_port`]
5535 * [`SocketAddrV4::set_ip`]
5536 * [`SocketAddrV4::set_port`]
5537 * [`SocketAddrV6::set_ip`]
5538 * [`SocketAddrV6::set_port`]
5539 * [`SocketAddrV6::set_flowinfo`]
5540 * [`SocketAddrV6::set_scope_id`]
5541 * [`slice::copy_from_slice`]
5542 * [`ptr::read_volatile`]
5543 * [`ptr::write_volatile`]
5544 * [`OpenOptions::create_new`]
5545 * [`TcpStream::set_nodelay`]
5546 * [`TcpStream::nodelay`]
5547 * [`TcpStream::set_ttl`]
5548 * [`TcpStream::ttl`]
5549 * [`TcpStream::set_only_v6`]
5550 * [`TcpStream::only_v6`]
5551 * [`TcpStream::take_error`]
5552 * [`TcpStream::set_nonblocking`]
5553 * [`TcpListener::set_ttl`]
5554 * [`TcpListener::ttl`]
5555 * [`TcpListener::set_only_v6`]
5556 * [`TcpListener::only_v6`]
5557 * [`TcpListener::take_error`]
5558 * [`TcpListener::set_nonblocking`]
5559 * [`UdpSocket::set_broadcast`]
5560 * [`UdpSocket::broadcast`]
5561 * [`UdpSocket::set_multicast_loop_v4`]
5562 * [`UdpSocket::multicast_loop_v4`]
5563 * [`UdpSocket::set_multicast_ttl_v4`]
5564 * [`UdpSocket::multicast_ttl_v4`]
5565 * [`UdpSocket::set_multicast_loop_v6`]
5566 * [`UdpSocket::multicast_loop_v6`]
5567 * [`UdpSocket::set_multicast_ttl_v6`]
5568 * [`UdpSocket::multicast_ttl_v6`]
5569 * [`UdpSocket::set_ttl`]
5570 * [`UdpSocket::ttl`]
5571 * [`UdpSocket::set_only_v6`]
5572 * [`UdpSocket::only_v6`]
5573 * [`UdpSocket::join_multicast_v4`]
5574 * [`UdpSocket::join_multicast_v6`]
5575 * [`UdpSocket::leave_multicast_v4`]
5576 * [`UdpSocket::leave_multicast_v6`]
5577 * [`UdpSocket::take_error`]
5578 * [`UdpSocket::connect`]
5579 * [`UdpSocket::send`]
5580 * [`UdpSocket::recv`]
5581 * [`UdpSocket::set_nonblocking`]
5582
5583 Libraries
5584 ---------
5585
5586 * [`std::sync::Once` is poisoned if its initialization function
5587   fails][1.9o].
5588 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5589 * [Most types implement `fmt::Debug`][1.9db].
5590 * [The default buffer size used by `BufReader` and `BufWriter` was
5591   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5592   used by other languages.
5593 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5594   `Duration` additionally implements `*=` and `/=`][1.9ta].
5595 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5596 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5597 * [`Chain` implements `BufRead`][1.9ch].
5598 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5599
5600 Cargo
5601 -----
5602
5603 * [Cargo can now run concurrently][1.9cc].
5604 * [Top-level overrides allow specific revisions of crates to be
5605   overridden through the entire crate graph][1.9ct].  This is intended
5606   to make upgrades easier for large projects, by allowing crates to be
5607   forked temporarily until they've been upgraded and republished.
5608 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5609 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5610   on the commandline][1.9cf]. `rustc` arguments can also be specified
5611   in the `build.rustflags` configuration key.
5612
5613 Performance
5614 -----------
5615
5616 * [The time complexity of comparing variables for equivalence during type
5617   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5618   to major compilation time improvement in some scenarios.
5619 * [`ToString` is specialized for `str`, giving it the same performance
5620   as `to_owned`][1.9ts].
5621 * [Spawning processes with `Command::output` no longer creates extra
5622   threads][1.9sp].
5623 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5624   for C-like enums][1.9cl].
5625
5626 Misc
5627 ----
5628
5629 * [Passing the `--quiet` flag to a test runner will produce
5630   much-abbreviated output][1.9q].
5631 * The Rust Project now publishes std binaries for the
5632   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5633   `i586-pc-windows-msvc` targets.
5634
5635 Compatibility Notes
5636 -------------------
5637
5638 * [`std::sync::Once` is poisoned if its initialization function
5639   fails][1.9o].
5640 * [It is illegal to define methods with the same name in overlapping
5641   inherent `impl` blocks][1.9sn].
5642 * [`fn` item types are zero sized, and each `fn` names a unique
5643   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5644   `transmute` on a `fn` type will generate a warning for a few cycles,
5645   then will be converted to an error.
5646 * [Improvements to const evaluation may trigger new errors when integer
5647   literals are out of range][1.9ce].
5648
5649
5650 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5651 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5652 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5653 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5654 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5655 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5656 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5657 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5658 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5659 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5660 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5661 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5662 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5663 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5664 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5665 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5666 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5667 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5668 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5669 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5670 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5671 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5672 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5673 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5674 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5675 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5676 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5677 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5678 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5679 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5680 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5681 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5682 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5683 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5684 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5685 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5686 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5687 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5688 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5689 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5690 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5691 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5692 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5693 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5694 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5695 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5696 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5697 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5698 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5699 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5700 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5701 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5702 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5703 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5704 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5705 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5706 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5707 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5708 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5709 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5710 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5711 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5712 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5713 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5714 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5715 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5716 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5717 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5718 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5719 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5720 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5721 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5722 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5723 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5724 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5725 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5726 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5727 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5728 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5729 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5730 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5731 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5732 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5733 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5734 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5735 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5736 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5737 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5738 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5739 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5740 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5741 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5742 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5743 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5744 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5745 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5746 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5747 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5748 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5749 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5750 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5751 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5752 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5753 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5754 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5755 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5756 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5757 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5758 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5759 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5760
5761
5762 Version 1.8.0 (2016-04-14)
5763 ==========================
5764
5765 Language
5766 --------
5767
5768 * Rust supports overloading of compound assignment statements like
5769   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5770   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5771   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5772   traits. [RFC 953].
5773 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5774   addition to the non-braced form, `struct Foo;`. [RFC 218].
5775
5776 Libraries
5777 ---------
5778
5779 * Stabilized APIs:
5780   * [`str::encode_utf16`] (renamed from `utf16_units`)
5781   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5782   * [`Ref::map`]
5783   * [`RefMut::map`]
5784   * [`ptr::drop_in_place`]
5785   * [`time::Instant`]
5786   * [`time::SystemTime`]
5787   * [`Instant::now`]
5788   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5789   * [`Instant::elapsed`]
5790   * [`SystemTime::now`]
5791   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5792   * [`SystemTime::elapsed`]
5793   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5794   * [`SystemTimeError`]
5795   * [`SystemTimeError::duration`]
5796   * Various impls for `SystemTimeError`
5797   * [`UNIX_EPOCH`]
5798   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5799     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5800     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5801 * [The `write!` and `writeln!` macros correctly emit errors if any of
5802   their arguments can't be formatted][1.8w].
5803 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5804 * [The Unix-specific `raw` modules, which contain a number of
5805   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5806   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5807   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5808   across platforms was making it difficult to implement `std`
5809   correctly. Those that need these definitions should use the `libc`
5810   crate. [RFC 1415].
5811 * The Unix-specific `MetadataExt` traits, including
5812   `os::unix::fs::MetadataExt`, which expose values such as inode
5813   numbers [no longer return platform-specific types][1.8r], but
5814   instead return widened integers. [RFC 1415].
5815 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5816 * [Atomic loads and stores are not volatile][1.8a].
5817 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5818
5819 Performance
5820 -----------
5821
5822 * [Inlining hash functions lead to a 3% compile-time improvement in
5823   some workloads][1.8h].
5824 * When using jemalloc, its symbols are [unprefixed so that it
5825   overrides the libc malloc implementation][1.8h]. This means that for
5826   rustc, LLVM is now using jemalloc, which results in a 6%
5827   compile-time improvement on a specific workload.
5828 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5829
5830 Misc
5831 ----
5832
5833 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5834   i686-pc-windows-msvc is now considered a tier-1 platform.
5835 * [The `--print targets` flag prints a list of supported targets][1.8t].
5836 * [The `--print cfg` flag prints the `cfg`s defined for the current
5837   target][1.8cf].
5838 * [`rustc` can be built with an new Cargo-based build system, written
5839   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5840   build system. To enable it configure with `configure --rustbuild`.
5841 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5842   variants while also indicating the total number of missing variants
5843   if more than 3][1.8m].
5844 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5845 * The Rust Project now publishes binary releases of the standard
5846   library for a number of tier-2 targets:
5847   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5848   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5849   `x86_64-rumprun-netbsd`. These can be installed with
5850   tools such as [multirust][1.8mr].
5851
5852 Cargo
5853 -----
5854
5855 * [`cargo init` creates a new Cargo project in the current
5856   directory][1.8ci].  It is otherwise like `cargo new`.
5857 * [Cargo has configuration keys for `-v` and
5858   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5859   `[term]` section of `.cargo/config`.
5860 * [Configuration keys that evaluate to strings or integers can be set
5861   via environment variables][1.8ce]. For example the `build.jobs` key
5862   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5863   precedence over config files.
5864 * [Target-specific dependencies support Rust `cfg` syntax for
5865   describing targets][1.8cfg] so that dependencies for multiple
5866   targets can be specified together. [RFC 1361].
5867 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5868   `RUSTDOC` take precedence over the `build.target-dir`,
5869   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5870 * [The child process tree is killed on Windows when Cargo is
5871   killed][1.8ck].
5872 * [The `build.target` configuration value sets the target platform,
5873   like `--target`][1.8ct].
5874
5875 Compatibility Notes
5876 -------------------
5877
5878 * [Unstable compiler flags have been further restricted][1.8u]. Since
5879   1.0 `-Z` flags have been considered unstable, and other flags that
5880   were considered unstable additionally required passing `-Z
5881   unstable-options` to access. Unlike unstable language and library
5882   features though, these options have been accessible on the stable
5883   release channel. Going forward, *new unstable flags will not be
5884   available on the stable release channel*, and old unstable flags
5885   will warn about their usage. In the future, all unstable flags will
5886   be unavailable on the stable release channel.
5887 * [It is no longer possible to `match` on empty enum variants using
5888   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5889 * The Unix-specific `MetadataExt` traits, including
5890   `os::unix::fs::MetadataExt`, which expose values such as inode
5891   numbers [no longer return platform-specific types][1.8r], but
5892   instead return widened integers. [RFC 1415].
5893 * [Modules sourced from the filesystem cannot appear within arbitrary
5894   blocks, but only within other modules][1.8mf].
5895 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5896 * On Unix, [stack overflow triggers a runtime abort instead of a
5897   SIGSEGV][1.8so].
5898 * [`Command::spawn` and its equivalents return an error if any of
5899   its command-line arguments contain interior `NUL`s][1.8n].
5900 * [Tuple and unit enum variants from other crates are in the type
5901   namespace][1.8tn].
5902 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5903   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5904   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5905   instead of `foo.lib`.
5906
5907
5908 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5909 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5910 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5911 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5912 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5913 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5914 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5915 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5916 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5917 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5918 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5919 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5920 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5921 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5922 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5923 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5924 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5925 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5926 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5927 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5928 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5929 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5930 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5931 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5932 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5933 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5934 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5935 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5936 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5937 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5938 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5939 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5940 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5941 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5942 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5943 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5944 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5945 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5946 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5947 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5948 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5949 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5950 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5951 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5952 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5953 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5954 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5955 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5956 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5957 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5958 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5959 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5960 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5961 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5962 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5963 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5964 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5965 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5966 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5967 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5968
5969
5970 Version 1.7.0 (2016-03-03)
5971 ==========================
5972
5973 Libraries
5974 ---------
5975
5976 * Stabilized APIs
5977   * `Path`
5978     * [`Path::strip_prefix`] (renamed from relative_from)
5979     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
5980   * `Ipv4Addr`
5981     * [`Ipv4Addr::is_loopback`]
5982     * [`Ipv4Addr::is_private`]
5983     * [`Ipv4Addr::is_link_local`]
5984     * [`Ipv4Addr::is_multicast`]
5985     * [`Ipv4Addr::is_broadcast`]
5986     * [`Ipv4Addr::is_documentation`]
5987   * `Ipv6Addr`
5988     * [`Ipv6Addr::is_unspecified`]
5989     * [`Ipv6Addr::is_loopback`]
5990     * [`Ipv6Addr::is_multicast`]
5991   * `Vec`
5992     * [`Vec::as_slice`]
5993     * [`Vec::as_mut_slice`]
5994   * `String`
5995     * [`String::as_str`]
5996     * [`String::as_mut_str`]
5997   * Slices
5998     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5999     be the same length
6000     * `<[T]>::`[`sort_by_key`]
6001   * checked, saturated, and overflowing operations
6002     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6003     * [`i32::saturating_mul`]
6004     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6005     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6006     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6007     * [`u32::saturating_mul`]
6008     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6009     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6010     * and checked, saturated, and overflowing operations for other primitive types
6011   * FFI
6012     * [`ffi::IntoStringError`]
6013     * [`CString::into_string`]
6014     * [`CString::into_bytes`]
6015     * [`CString::into_bytes_with_nul`]
6016     * `From<CString> for Vec<u8>`
6017   * `IntoStringError`
6018     * [`IntoStringError::into_cstring`]
6019     * [`IntoStringError::utf8_error`]
6020     * `Error for IntoStringError`
6021   * Hashing
6022     * [`std::hash::BuildHasher`]
6023     * [`BuildHasher::Hasher`]
6024     * [`BuildHasher::build_hasher`]
6025     * [`std::hash::BuildHasherDefault`]
6026     * [`HashMap::with_hasher`]
6027     * [`HashMap::with_capacity_and_hasher`]
6028     * [`HashSet::with_hasher`]
6029     * [`HashSet::with_capacity_and_hasher`]
6030     * [`std::collections::hash_map::RandomState`]
6031     * [`RandomState::new`]
6032 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6033   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6034   from bytes is faster.
6035 * [The performance of `LineWriter` (and thus `io::stdout`) was
6036   improved by using `memchr` to search for newlines][1.7m].
6037 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6038   `f64` variants were stabilized previously.
6039 * [`BTreeMap` was rewritten to use less memory and improve the performance
6040   of insertion and iteration, the latter by as much as 5x][1.7bm].
6041 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6042   covariant over their contained type][1.7bt].
6043 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6044   over their contained type][1.7ll].
6045 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6046   searching methods.
6047 * [`Any` is implemented for unsized types][1.7a].
6048 * [`Hash` is implemented for `Duration`][1.7h].
6049
6050 Misc
6051 ----
6052
6053 * [When running tests with `--test`, rustdoc will pass `--cfg`
6054   arguments to the compiler][1.7dt].
6055 * [The compiler is built with RPATH information by default][1.7rpa].
6056   This means that it will be possible to run `rustc` when installed in
6057   unusual configurations without configuring the dynamic linker search
6058   path explicitly.
6059 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6060   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6061   over `LD_LIBRARY_PATH`.
6062
6063 Cargo
6064 -----
6065
6066 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6067   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6068 * [The `rerun-if-changed` build script directive no longer causes the
6069   build script to incorrectly run twice in certain scenarios][1.7rr].
6070
6071 Compatibility Notes
6072 -------------------
6073
6074 * Soundness fixes to the interactions between associated types and
6075   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6076   code that violates the new rules. This is a significant change that
6077   is known to break existing code, so it has emitted warnings for the
6078   new error cases since 1.4 to give crate authors time to adapt. The
6079   details of what is changing are subtle; read the RFC for more.
6080 * [Several bugs in the compiler's visibility calculations were
6081   fixed][1.7v]. Since this was found to break significant amounts of
6082   code, the new errors will be emitted as warnings for several release
6083   cycles, under the `private_in_public` lint.
6084 * Defaulted type parameters were accidentally accepted in positions
6085   that were not intended. In this release, [defaulted type parameters
6086   appearing outside of type definitions will generate a
6087   warning][1.7d], which will become an error in future releases.
6088 * [Parsing "." as a float results in an error instead of 0][1.7p].
6089   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6090 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6091
6092 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6093 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6094 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6095 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6096 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6097 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6098 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6099 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6100 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6101 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6102 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6103 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6104 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6105 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6106 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6107 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6108 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6109 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6110 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6111 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6112 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6113 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6114 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6115 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6116 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6117 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6118 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6119 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6120 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6121 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6122 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6123 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6124 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6125 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6126 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6127 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6128 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6129 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6130 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6131 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6132 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6133 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6134 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6135 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6136 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6137 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6138 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6139 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6140 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6141 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6142 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6143 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6144 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6145 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6146 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6147 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6148 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6149 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6150 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6151 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6152 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6153 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6154 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6155 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6156 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6157 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6158 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6159 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6160 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6161 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6162 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6163 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6164 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6165 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6166 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6167 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6168 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6169 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6170 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6171
6172
6173 Version 1.6.0 (2016-01-21)
6174 ==========================
6175
6176 Language
6177 --------
6178
6179 * The `#![no_std]` attribute causes a crate to not be linked to the
6180   standard library, but only the [core library][1.6co], as described
6181   in [RFC 1184]. The core library defines common types and traits but
6182   has no platform dependencies whatsoever, and is the basis for Rust
6183   software in environments that cannot support a full port of the
6184   standard library, such as operating systems. Most of the core
6185   library is now stable.
6186
6187 Libraries
6188 ---------
6189
6190 * Stabilized APIs:
6191   [`Read::read_exact`],
6192   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6193   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6194   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6195   [`os::unix::fs::DirBuilderExt`],
6196   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6197   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6198   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6199   [`collections::hash_map::Drain`],
6200   [`collections::hash_map::HashMap::drain`],
6201   [`collections::hash_set::Drain`],
6202   [`collections::hash_set::HashSet::drain`],
6203   [`collections::binary_heap::Drain`],
6204   [`collections::binary_heap::BinaryHeap::drain`],
6205   [`Vec::extend_from_slice`] (renamed from `push_all`),
6206   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6207   [`RwLock::into_inner`],
6208   [`Iterator::min_by_key`] (renamed from `min_by`),
6209   [`Iterator::max_by_key`] (renamed from `max_by`).
6210 * The [core library][1.6co] is stable, as are most of its APIs.
6211 * [The `assert_eq!` macro supports arguments that don't implement
6212   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6213   `assert!`.
6214 * Several timer functions that take duration in milliseconds [are
6215   deprecated in favor of those that take `Duration`][1.6ms]. These
6216   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6217   `thread::park_timeout_ms`.
6218 * The algorithm by which `Vec` reserves additional elements was
6219   [tweaked to not allocate excessive space][1.6a] while still growing
6220   exponentially.
6221 * `From` conversions are [implemented from integers to floats][1.6f]
6222   in cases where the conversion is lossless. Thus they are not
6223   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6224   or `f64`. They are also not implemented for `isize` and `usize`
6225   because the implementations would be platform-specific. `From` is
6226   also implemented from `f32` to `f64`.
6227 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6228 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6229 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6230 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6231   improvements.
6232 * Sorting slices that are already sorted [is 50% faster in some
6233   cases][1.6s].
6234
6235 Cargo
6236 -----
6237
6238 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6239 * Cargo build scripts can specify their dependencies by emitting the
6240   [`rerun-if-changed`][1.6rr] key.
6241 * crates.io will reject publication of crates with dependencies that
6242   have a wildcard version constraint. Crates with wildcard
6243   dependencies were seen to cause a variety of problems, as described
6244   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6245   warning.
6246 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6247   release folder.  A variety of artifacts that Cargo failed to clean
6248   are now correctly deleted.
6249
6250 Misc
6251 ----
6252
6253 * The `unreachable_code` lint [warns when a function call's argument
6254   diverges][1.6dv].
6255 * The parser indicates [failures that may be caused by
6256   confusingly-similar Unicode characters][1.6uc]
6257 * Certain macro errors [are reported at definition time][1.6m], not
6258   expansion.
6259
6260 Compatibility Notes
6261 -------------------
6262
6263 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6264   environment variable when locating crates. This was a pre-cargo
6265   feature for integrating with the package manager that was
6266   accidentally never removed.
6267 * [A number of bugs were fixed in the privacy checker][1.6p] that
6268   could cause previously-accepted code to break.
6269 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6270 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6271   struct pattern syntax (`Foo(..)`) can no longer be used to match
6272   unit structs. This is a warning now, but will become an error in
6273   future releases. Patterns that share the same name as a const are
6274   now an error.
6275 * A bug was fixed that causes [rustc not to apply default type
6276   parameters][1.6xc] when resolving certain method implementations of
6277   traits defined in other crates.
6278
6279 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6280 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6281 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6282 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6283 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6284 [1.6co]: http://doc.rust-lang.org/core/index.html
6285 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6286 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6287 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6288 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6289 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6290 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6291 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6292 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6293 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6294 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6295 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6296 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6297 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6298 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6299 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6300 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6301 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6302 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6303 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6304 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6305 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6306 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6307 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6308 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6309 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6310 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6311 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6312 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6313 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6314 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6315 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6316 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6317 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6318 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6319 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6320 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6321 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6322 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6323 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6324 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6325 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6326
6327
6328 Version 1.5.0 (2015-12-10)
6329 ==========================
6330
6331 * ~700 changes, numerous bugfixes
6332
6333 Highlights
6334 ----------
6335
6336 * Stabilized APIs:
6337   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6338   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6339   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6340   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6341   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6342   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6343   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6344   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6345   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6346   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6347   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6348   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6349   [`Path::read_link`], [`Path::symlink_metadata`],
6350   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6351   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6352   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6353   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6354   [`slice::split_first_mut`], [`slice::split_first`],
6355   [`slice::split_last_mut`], [`slice::split_last`],
6356   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6357   [`str::MatchIndices`], [`str::RMatchIndices`],
6358   [`str::match_indices`], [`str::rmatch_indices`],
6359   [`str::slice_mut_unchecked`], [`string::ParseError`].
6360 * Rust applications hosted on crates.io can be installed locally to
6361   `~/.cargo/bin` with the [`cargo install`] command. Among other
6362   things this makes it easier to augment Cargo with new subcommands:
6363   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6364   invoked as `cargo foo`.
6365 * Crates with wildcard (`*`) dependencies will [emit warnings when
6366   published][1.5w]. In 1.6 it will no longer be possible to publish
6367   crates with wildcard dependencies.
6368
6369 Breaking Changes
6370 ----------------
6371
6372 * The rules determining when a particular lifetime must outlive
6373   a particular value (known as '[dropck]') have been [modified
6374   to not rely on parametricity][1.5p].
6375 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6376   and `Arc`][1.5a]. Because these smart pointer types implement
6377   `Deref`, this causes breakage in cases where the interior type
6378   contains methods of the same name.
6379 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6380   that they could drop their content. Soundness fix.
6381 * All method invocations are [properly checked][1.5wf1] for
6382   [well-formedness][1.5wf2]. Soundness fix.
6383 * Traits whose supertraits contain `Self` are [not object
6384   safe][1.5o]. Soundness fix.
6385 * Target specifications support a [`no_default_libraries`][1.5nd]
6386   setting that controls whether `-nodefaultlibs` is passed to the
6387   linker, and in turn the `is_like_windows` setting no longer affects
6388   the `-nodefaultlibs` flag.
6389 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6390 * The `#[inline]` and `#[repr]` attributes [can only appear
6391   in valid locations][1.5at].
6392 * Native libraries linked from the local crate are [passed to
6393   the linker before native libraries from upstream crates][1.5nl].
6394 * Two rarely-used attributes, `#[no_debug]` and
6395   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6396 * Negation of unsigned integers, which has been a warning for
6397   several releases, [is now behind a feature gate and will
6398   generate errors][1.5nu].
6399 * The parser accidentally accepted visibility modifiers on
6400   enum variants, a bug [which has been fixed][1.5ev].
6401 * [A bug was fixed that allowed `use` statements to import unstable
6402   features][1.5use].
6403
6404 Language
6405 --------
6406
6407 * When evaluating expressions at compile-time that are not
6408   compile-time constants (const-evaluating expressions in non-const
6409   contexts), incorrect code such as overlong bitshifts and arithmetic
6410   overflow will [generate a warning instead of an error][1.5ce],
6411   delaying the error until runtime. This will allow the
6412   const-evaluator to be expanded in the future backwards-compatibly.
6413 * The `improper_ctypes` lint [no longer warns about using `isize` and
6414   `usize` in FFI][1.5ict].
6415
6416 Libraries
6417 ---------
6418
6419 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6420   invariant][1.5c].
6421 * `Default` is [implemented for mutable slices][1.5d].
6422 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6423 * There are now `From` conversions [between floating point
6424   types][1.5f] where the conversions are lossless.
6425 * There are now `From` conversions [between integer types][1.5i] where
6426   the conversions are lossless.
6427 * [`fs::Metadata` implements `Clone`][1.5fs].
6428 * The `parse` method [accepts a leading "+" when parsing
6429   integers][1.5pi].
6430 * [`AsMut` is implemented for `Vec`][1.5am].
6431 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6432   been optimized][1.5cf] and no longer rely on the default impl.
6433 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6434   `unsafe extern "C"` function types now [implement `Clone`,
6435   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6436   `fmt::Debug` for up to 12 arguments][1.5fp].
6437 * [Dropping `Vec`s is much faster in unoptimized builds when the
6438   element types don't implement `Drop`][1.5dv].
6439 * A bug that caused in incorrect behavior when [combining `VecDeque`
6440   with zero-sized types][1.5vdz] was resolved.
6441 * [`PartialOrd` for slices is faster][1.5po].
6442
6443 Miscellaneous
6444 -------------
6445
6446 * [Crate metadata size was reduced by 20%][1.5md].
6447 * [Improvements to code generation reduced the size of libcore by 3.3
6448   MB and rustc's memory usage by 18MB][1.5m].
6449 * [Improvements to deref translation increased performance in
6450   unoptimized builds][1.5dr].
6451 * Various errors in trait resolution [are deduplicated to only be
6452   reported once][1.5te].
6453 * Rust has preliminary [support for rumprun kernels][1.5rr].
6454 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6455
6456 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6457 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6458 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6459 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6460 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6461 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6462 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6463 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6464 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6465 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6466 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6467 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6468 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6469 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6470 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6471 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6472 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6473 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6474 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6475 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6476 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6477 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6478 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6479 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6480 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6481 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6482 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6483 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6484 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6485 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6486 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6487 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6488 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6489 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6490 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6491 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6492 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6493 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6494 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6495 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6496 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6497 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6498 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6499 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6500 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6501 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6502 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6503 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6504 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6505 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6506 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6507 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6508 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6509 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6510 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6511 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6512 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6513 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6514 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6515 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6516 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6517 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6518 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6519 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6520 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6521 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6522 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6523 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6524 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6525 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6526 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6527 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6528 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6529 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6530 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6531 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6532 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6533 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6534 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6535 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6536 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6537 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6538 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6539 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6540 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6541 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6542 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6543 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6544 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6545
6546 Version 1.4.0 (2015-10-29)
6547 ==========================
6548
6549 * ~1200 changes, numerous bugfixes
6550
6551 Highlights
6552 ----------
6553
6554 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6555   GNU) are now supported and recommended for use.
6556
6557 Breaking Changes
6558 ----------------
6559
6560 * [Several changes have been made to fix type soundness and improve
6561   the behavior of associated types][sound]. See [RFC 1214]. Although
6562   we have mostly introduced these changes as warnings this release, to
6563   become errors next release, there are still some scenarios that will
6564   see immediate breakage.
6565 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6566   line breaks in addition to `\n`][crlf].
6567 * [Loans of `'static` lifetime extend to the end of a function][stat].
6568 * [`str::parse` no longer introduces avoidable rounding error when
6569   parsing floating point numbers. Together with earlier changes to
6570   float formatting/output, "round trips" like f.to_string().parse()
6571   now preserve the value of f exactly. Additionally, leading plus
6572   signs are now accepted][fp3].
6573
6574
6575 Language
6576 --------
6577
6578 * `use` statements that import multiple items [can now rename
6579   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6580 * [Binops work correctly on fat pointers][binfat].
6581 * `pub extern crate`, which does not behave as expected, [issues a
6582   warning][pec] until a better solution is found.
6583
6584 Libraries
6585 ---------
6586
6587 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6588   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6589   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6590   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6591   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6592   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6593   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6594   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6595   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6596   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6597   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6598   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6599   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6600   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6601   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6602   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6603   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6604   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6605   [`thread::sleep`].
6606 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6607   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6608   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6609   `f64::from_str_radix`.
6610 * [Reverse-searching strings is faster with the 'two-way'
6611   algorithm][s].
6612 * [`std::io::copy` allows `?Sized` arguments][cc].
6613 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6614   [override `count`, `nth` and `last` with an O(1)
6615   implementation][it].
6616 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6617 * [`IntoRawFd` has been added to the Unix-specific prelude,
6618   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6619   prelude][pr].
6620 * [`Extend<String>` and `FromIterator<String` are both implemented for
6621   `String`][es].
6622 * [`IntoIterator` is implemented for references to `Option` and
6623   `Result`][into2].
6624 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6625   Copy`][ext] as part of [RFC 839]. This will cause type inference
6626   breakage in rare situations.
6627 * [`BinaryHeap` implements `Debug`][bh2].
6628 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6629   arrays][bm].
6630 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6631   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6632 * [String comparison is faster][faststr].
6633 * `&mut T` where `T: std::fmt::Write` [also implements
6634   `std::fmt::Write`][mutw].
6635 * [A stable regression in `VecDeque::push_back` and other
6636   capacity-altering methods that caused panics for zero-sized types
6637   was fixed][vd].
6638 * [Function pointers implement traits for up to 12 parameters][fp2].
6639
6640 Miscellaneous
6641 -------------
6642
6643 * The compiler [no longer uses the 'morestack' feature to prevent
6644   stack overflow][mm]. Instead it uses guard pages and stack
6645   probes (though stack probes are not yet implemented on any platform
6646   but Windows).
6647 * [The compiler matches traits faster when projections are involved][p].
6648 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6649   `usize`][ffi].
6650 * [Cargo now displays useful information about what its doing during
6651   `cargo update`][cu].
6652
6653 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6654 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6655 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6656 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6657 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6658 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6659 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6660 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6661 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6662 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6663 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6664 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6665 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6666 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6667 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6668 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6669 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6670 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6671 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6672 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6673 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6674 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6675 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6676 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6677 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6678 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6679 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6680 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6681 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6682 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6683 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6684 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6685 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6686 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6687 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6688 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6689 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6690 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6691 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6692 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6693 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6694 [bh2]: https://github.com/rust-lang/rust/pull/28156
6695 [binfat]: https://github.com/rust-lang/rust/pull/28270
6696 [bm]: https://github.com/rust-lang/rust/pull/28197
6697 [cc]: https://github.com/rust-lang/rust/pull/27531
6698 [crlf]: https://github.com/rust-lang/rust/pull/28034
6699 [cu]: https://github.com/rust-lang/cargo/pull/1931
6700 [d]: https://github.com/rust-lang/rust/pull/27825
6701 [dep]: https://github.com/rust-lang/rust/pull/28339
6702 [es]: https://github.com/rust-lang/rust/pull/27956
6703 [ext]: https://github.com/rust-lang/rust/pull/28094
6704 [faststr]: https://github.com/rust-lang/rust/pull/28338
6705 [ffi]: https://github.com/rust-lang/rust/pull/28779
6706 [fp]: https://github.com/rust-lang/rust/pull/28268
6707 [fp2]: https://github.com/rust-lang/rust/pull/28560
6708 [fp3]: https://github.com/rust-lang/rust/pull/27307
6709 [i]: https://github.com/rust-lang/rust/pull/27451
6710 [into2]: https://github.com/rust-lang/rust/pull/28039
6711 [it]: https://github.com/rust-lang/rust/pull/27652
6712 [mm]: https://github.com/rust-lang/rust/pull/27338
6713 [mutw]: https://github.com/rust-lang/rust/pull/28368
6714 [sound]: https://github.com/rust-lang/rust/pull/27641
6715 [p]: https://github.com/rust-lang/rust/pull/27866
6716 [pec]: https://github.com/rust-lang/rust/pull/28486
6717 [pr]: https://github.com/rust-lang/rust/pull/27896
6718 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6719 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6720 [s]: https://github.com/rust-lang/rust/pull/27474
6721 [stab]: https://github.com/rust-lang/rust/pull/28339
6722 [stat]: https://github.com/rust-lang/rust/pull/28321
6723 [vd]: https://github.com/rust-lang/rust/pull/28494
6724
6725 Version 1.3.0 (2015-09-17)
6726 ==============================
6727
6728 * ~900 changes, numerous bugfixes
6729
6730 Highlights
6731 ----------
6732
6733 * The [new object lifetime defaults][nold] have been [turned
6734   on][nold2] after a cycle of warnings about the change. Now types
6735   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6736   being interpreted as `&'a Box<Trait+'a>` to `&'a
6737   Box<Trait+'static>`.
6738 * [The Rustonomicon][nom] is a new book in the official documentation
6739   that dives into writing unsafe Rust.
6740 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6741   timekeeping is employed by other std APIs, as well as out-of-tree
6742   time crates.
6743
6744 Breaking Changes
6745 ----------------
6746
6747 * The [new object lifetime defaults][nold] have been [turned
6748   on][nold2] after a cycle of warnings about the change.
6749 * There is a known [regression][lr] in how object lifetime elision is
6750   interpreted, the proper solution for which is undetermined.
6751 * The `#[prelude_import]` attribute, an internal implementation
6752   detail, was accidentally stabilized previously. [It has been put
6753   behind the `prelude_import` feature gate][pi]. This change is
6754   believed to break no existing code.
6755 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6756   [more sane for dynamically sized types][dst3]. Code that relied on
6757   the previous behavior is thought to be broken.
6758 * The `dropck` rules, which checks that destructors can't access
6759   destroyed values, [have been updated][dropck] to match the
6760   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6761   cause some previously-compiling code to no longer build.
6762
6763 Language
6764 --------
6765
6766 * The [new object lifetime defaults][nold] have been [turned
6767   on][nold2] after a cycle of warnings about the change.
6768 * Semicolons may [now follow types and paths in
6769   macros](https://github.com/rust-lang/rust/pull/27000).
6770 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6771   [more sane for dynamically sized types][dst3]. Code that relied on
6772   the previous behavior is not known to exist, and suspected to be
6773   broken.
6774 * `'static` variables [may now be recursive][st].
6775 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6776   implementations correctly.
6777 * The `dropck` rules, which checks that destructors can't access
6778   destroyed values, [have been updated][dropck] to match the
6779   [RFC][dropckrfc].
6780
6781 Libraries
6782 ---------
6783
6784 * The [`Duration`] API, [has been stabilized][ds], as well as the
6785   `std::time` module, which presently contains only `Duration`.
6786 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6787 * The owned C string, [`CString`], implements [`Borrow`] and the
6788   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6789   these allow C strings to be borrowed and cloned in generic code.
6790 * [`CStr`] implements [`Debug`].
6791 * [`AtomicPtr`] implements [`Debug`].
6792 * [`Error`] trait objects [can be downcast to their concrete types][e]
6793   in many common configurations, using the [`is`], [`downcast`],
6794   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6795   [`Any`] trait.
6796 * Searching for substrings now [employs the two-way algorithm][search]
6797   instead of doing a naive search. This gives major speedups to a
6798   number of methods, including [`contains`][sc], [`find`][sf],
6799   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6800   [`ends_with`][sew] are also faster.
6801 * The performance of `PartialEq` for slices is [much faster][ps].
6802 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6803   is overridden and optimized by the implementations for scalars.
6804 * The [`Hasher`] trait now has a number of specialized `write_*`
6805   methods for primitive types, for efficiency.
6806 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6807   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6808   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6809   of [`std::error::Error::cause`][iec] also delegates to the inner
6810   error.
6811 * [`process::Child`][pc] gained the [`id`] method, which returns a
6812   `u32` representing the platform-specific process identifier.
6813 * The [`connect`] method on slices is deprecated, replaced by the new
6814   [`join`] method (note that both of these are on the *unstable*
6815   [`SliceConcatExt`] trait, but through the magic of the prelude are
6816   available to stable code anyway).
6817 * The [`Div`] operator is implemented for [`Wrapping`] types.
6818 * [`DerefMut` is implemented for `String`][dms].
6819 * Performance of SipHash (the default hasher for `HashMap`) is
6820   [better for long data][sh].
6821 * [`AtomicPtr`] implements [`Send`].
6822 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6823   are now [specialized to use uninitialized buffers for increased
6824   performance][rte].
6825 * Lifetime parameters of foreign functions [are now resolved
6826   properly][f].
6827
6828 Misc
6829 ----
6830
6831 * Rust can now, with some coercion, [produce programs that run on
6832   Windows XP][xp], though XP is not considered a supported platform.
6833 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6834   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6835   recommended for use in 1.3, though should be fully-functional
6836   in the [64-bit 1.4 beta][b14].
6837 * On Fedora-based systems installation will [properly configure the
6838   dynamic linker][fl].
6839 * The compiler gained many new extended error descriptions, which can
6840   be accessed with the `--explain` flag.
6841 * The `dropck` pass, which checks that destructors can't access
6842   destroyed values, [has been rewritten][dropck]. This fixes some
6843   soundness holes, and as such will cause some previously-compiling
6844   code to no longer build.
6845 * `rustc` now uses [LLVM to write archive files where possible][ar].
6846   Eventually this will eliminate the compiler's dependency on the ar
6847   utility.
6848 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6849   supported FreeBSD on x86_64).
6850 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6851   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6852   more strict.
6853 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6854   will kill the process instead of leaking][nlp].
6855
6856 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6857 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6858 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6859 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6860 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6861 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6862 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6863 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6864 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6865 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6866 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6867 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6868 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6869 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6870 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6871 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6872 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6873 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6874 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6875 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6876 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6877 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6878 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6879 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6880 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6881 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6882 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6883 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6884 [ar]: https://github.com/rust-lang/rust/pull/26926
6885 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6886 [dms]: https://github.com/rust-lang/rust/pull/26241
6887 [dropck]: https://github.com/rust-lang/rust/pull/27261
6888 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6889 [ds]: https://github.com/rust-lang/rust/pull/26818
6890 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6891 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6892 [dst3]: https://github.com/rust-lang/rust/pull/27351
6893 [e]: https://github.com/rust-lang/rust/pull/24793
6894 [f]: https://github.com/rust-lang/rust/pull/26588
6895 [fb]: https://github.com/rust-lang/rust/pull/26959
6896 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6897 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6898 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6899 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6900 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6901 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6902 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6903 [lic]: https://github.com/rust-lang/rust/pull/26583
6904 [lnu]: https://github.com/rust-lang/rust/pull/27026
6905 [lr]: https://github.com/rust-lang/rust/issues/27248
6906 [lum]: https://github.com/rust-lang/rust/pull/26378
6907 [lur]: https://github.com/rust-lang/rust/pull/26783
6908 [nlp]: https://github.com/rust-lang/rust/pull/27176
6909 [nold2]: https://github.com/rust-lang/rust/pull/27045
6910 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6911 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6912 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6913 [pi]: https://github.com/rust-lang/rust/pull/26699
6914 [ps]: https://github.com/rust-lang/rust/pull/26884
6915 [rte]: https://github.com/rust-lang/rust/pull/26950
6916 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6917 [search]: https://github.com/rust-lang/rust/pull/26327
6918 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6919 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6920 [sh]: https://github.com/rust-lang/rust/pull/27280
6921 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6922 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6923 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6924 [st]: https://github.com/rust-lang/rust/pull/26630
6925 [win1]: https://github.com/rust-lang/rust/pull/26569
6926 [win2]: https://github.com/rust-lang/rust/pull/26741
6927 [win3]: https://github.com/rust-lang/rust/pull/26741
6928 [win4]: https://github.com/rust-lang/rust/pull/27210
6929 [xp]: https://github.com/rust-lang/rust/pull/26569
6930
6931 Version 1.2.0 (2015-08-07)
6932 ==========================
6933
6934 * ~1200 changes, numerous bugfixes
6935
6936 Highlights
6937 ----------
6938
6939 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6940   like `Rc` to contain types without a fixed size, arrays and trait
6941   objects, finally enabling use of `Rc<[T]>` and completing the
6942   implementation of DST.
6943 * [Parallel codegen][parcodegen] is now working again, which can
6944   substantially speed up large builds in debug mode; It also gets
6945   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6946   jobs). It's not enabled by default, but will be "in the near
6947   future". It can be activated with the `-C codegen-units=N` flag to
6948   `rustc`.
6949 * This is the first release with [experimental support for linking
6950   with the MSVC linker and lib C on Windows (instead of using the GNU
6951   variants via MinGW)][win]. It is yet recommended only for the most
6952   intrepid Rustaceans.
6953 * Benchmark compilations are showing a 30% improvement in
6954   bootstrapping over 1.1.
6955
6956 Breaking Changes
6957 ----------------
6958
6959 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6960   unicode case mapping, which is a previously-planned change in
6961   behavior and considered a bugfix.
6962 * [`mem::align_of`] now specifies [the *minimum alignment* for
6963   T][align], which is usually the alignment programs are interested
6964   in, and the same value reported by clang's
6965   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6966   break real code.
6967 * [The `#[packed]` attribute is no longer silently accepted by the
6968   compiler][packed]. This attribute did nothing and code that
6969   mentioned it likely did not work as intended.
6970 * Associated type defaults are [now behind the
6971   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6972   defaults *did not work*, but could be mentioned syntactically. As
6973   such this breakage has minimal impact.
6974
6975 Language
6976 --------
6977
6978 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6979   matching against dereferenceable values.
6980
6981 Libraries
6982 ---------
6983
6984 * The [`Extend`] trait, which grows a collection from an iterator, is
6985   implemented over iterators of references, for `String`, `Vec`,
6986   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6987   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6988 * The [`iter::once`] function returns an iterator that yields a single
6989   element, and [`iter::empty`] returns an iterator that yields no
6990   elements.
6991 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6992   over substring matches.
6993 * [`Cell`] and [`RefCell`] both implement `Eq`.
6994 * A number of methods for wrapping arithmetic are added to the
6995   integral types, [`wrapping_div`], [`wrapping_rem`],
6996   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6997   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6998   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6999   type.. It is illegal for the default arithmetic operations in Rust
7000   to overflow; the desire to wrap must be explicit.
7001 * The `{:#?}` formatting specifier [displays the alternate,
7002   pretty-printed][debugfmt] form of the `Debug` formatter. This
7003   feature was actually introduced prior to 1.0 with little
7004   fanfare.
7005 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7006   for writing data to formatted strings, similar to [`io::Write`].
7007 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7008   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7009   are used by code generators to emit implementations of [`Debug`].
7010 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7011   methods that convert case, following Unicode case mapping.
7012 * It is now easier to handle poisoned locks. The [`PoisonError`]
7013   type, returned by failing lock operations, exposes `into_inner`,
7014   `get_ref`, and `get_mut`, which all give access to the inner lock
7015   guard, and allow the poisoned lock to continue to operate. The
7016   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7017   poisoned lock without attempting to take the lock.
7018 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7019   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7020   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7021   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7022   `ChildStderr`.
7023 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7024   malformed input.
7025
7026 Misc
7027 ----
7028
7029 * `rustc` employs smarter heuristics for guessing at [typos].
7030 * `rustc` emits more efficient code for [no-op conversions between
7031   unsafe pointers][nop].
7032 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7033   resulting in faster compile times and smaller code.
7034
7035 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7036 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7037 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7038 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7039 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7040 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7041 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7042 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7043 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7044 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7045 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7046 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7047 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7048 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7049 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7050 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7051 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7052 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7053 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7054 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7055 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7056 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7057 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7058 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7059 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7060 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7061 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7062 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7063 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7064 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7065 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7066 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7067 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7068 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7069 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7070 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7071 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7072 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7073 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7074 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7075 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7076 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7077 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7078 [align]: https://github.com/rust-lang/rust/pull/25646
7079 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7080 [typos]: https://github.com/rust-lang/rust/pull/26087
7081 [nop]: https://github.com/rust-lang/rust/pull/26336
7082 [fat]: https://github.com/rust-lang/rust/pull/26411
7083 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7084 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7085 [packed]: https://github.com/rust-lang/rust/pull/25541
7086 [ad]: https://github.com/rust-lang/rust/pull/27382
7087 [win]: https://github.com/rust-lang/rust/pull/25350
7088
7089 Version 1.1.0 (2015-06-25)
7090 =========================
7091
7092 * ~850 changes, numerous bugfixes
7093
7094 Highlights
7095 ----------
7096
7097 * The [`std::fs` module has been expanded][fs] to expand the set of
7098   functionality exposed:
7099   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7100     don't incur a syscall on some platforms.
7101   * A `symlink_metadata` function has been added.
7102   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7103     access to all underlying information.
7104 * The compiler now contains extended explanations of many errors. When an error
7105   with an explanation occurs the compiler suggests using the `--explain` flag
7106   to read the explanation. Error explanations are also [available online][err-index].
7107 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7108   well as other work, the time to bootstrap the compiler decreased by
7109   32%.
7110
7111 Libraries
7112 ---------
7113
7114 * The [`str::split_whitespace`] method splits a string on unicode
7115   whitespace boundaries.
7116 * On both Windows and Unix, new extension traits provide conversion of
7117   I/O types to and from the underlying system handles. On Unix, these
7118   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7119   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7120   `TcpListener`, and `UpdSocket`. Further implementations for
7121   `std::process` will be stabilized later.
7122 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7123   Windows, symlinks can be created with
7124   `std::os::windows::symlink_dir` and
7125   `std::os::windows::symlink_file`.
7126 * The `mpsc::Receiver` type can now be converted into an iterator with
7127   `into_iter` on the [`IntoIterator`] trait.
7128 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7129   implementation of the [`From`] trait.
7130 * The `Debug` implementation for `RangeFull` [creates output that is
7131   more consistent with other implementations][rf].
7132 * [`Debug` is implemented for `File`][file].
7133 * The `Default` implementation for `Arc` [no longer requires `Sync +
7134   Send`][arc].
7135 * [The `Iterator` methods `count`, `nth`, and `last` have been
7136   overridden for slices to have O(1) performance instead of O(n)][si].
7137 * Incorrect handling of paths on Windows has been improved in both the
7138   compiler and the standard library.
7139 * [`AtomicPtr` gained a `Default` implementation][ap].
7140 * In accordance with Rust's policy on arithmetic overflow `abs` now
7141   [panics on overflow when debug assertions are enabled][abs].
7142 * The [`Cloned`] iterator, which was accidentally left unstable for
7143   1.0 [has been stabilized][c].
7144 * The [`Incoming`] iterator, which iterates over incoming TCP
7145   connections, and which was accidentally unnamable in 1.0, [is now
7146   properly exported][inc].
7147 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7148   `sift_up` or `sift_down` panic][bh].
7149 * The [`split_off`] method of `LinkedList` [no longer corrupts
7150   the list in certain scenarios][ll].
7151
7152 Misc
7153 ----
7154
7155 * Type checking performance [has improved notably][sk] with
7156   [multiple improvements][pre].
7157 * The compiler [suggests code changes][ch] for more errors.
7158 * rustc and it's build system have experimental support for [building
7159   toolchains against MUSL][m] instead of glibc on Linux.
7160 * The compiler defines the `target_env` cfg value, which is used for
7161   distinguishing toolchains that are otherwise for the same
7162   platform. Presently this is set to `gnu` for common GNU Linux
7163   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7164 * The [`cargo rustc`][crc] command invokes a build with custom flags
7165   to rustc.
7166 * [Android executables are always position independent][pie].
7167 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7168   with `Drop`][drop].
7169
7170 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7171 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7172 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7173 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7174 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7175 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7176 [rf]: https://github.com/rust-lang/rust/pull/24491
7177 [err-index]: https://doc.rust-lang.org/error-index.html
7178 [sk]: https://github.com/rust-lang/rust/pull/24615
7179 [pre]: https://github.com/rust-lang/rust/pull/25323
7180 [file]: https://github.com/rust-lang/rust/pull/24598
7181 [ch]: https://github.com/rust-lang/rust/pull/24683
7182 [arc]: https://github.com/rust-lang/rust/pull/24695
7183 [si]: https://github.com/rust-lang/rust/pull/24701
7184 [ap]: https://github.com/rust-lang/rust/pull/24834
7185 [m]: https://github.com/rust-lang/rust/pull/24777
7186 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7187 [crc]: https://github.com/rust-lang/cargo/pull/1568
7188 [pie]: https://github.com/rust-lang/rust/pull/24953
7189 [abs]: https://github.com/rust-lang/rust/pull/25441
7190 [c]: https://github.com/rust-lang/rust/pull/25496
7191 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7192 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7193 [inc]: https://github.com/rust-lang/rust/pull/25522
7194 [bh]: https://github.com/rust-lang/rust/pull/25856
7195 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7196 [ll]: https://github.com/rust-lang/rust/pull/26022
7197 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7198 [drop]: https://github.com/rust-lang/rust/pull/24935
7199
7200 Version 1.0.0 (2015-05-15)
7201 ========================
7202
7203 * ~1500 changes, numerous bugfixes
7204
7205 Highlights
7206 ----------
7207
7208 * The vast majority of the standard library is now `#[stable]`. It is
7209   no longer possible to use unstable features with a stable build of
7210   the compiler.
7211 * Many popular crates on [crates.io] now work on the stable release
7212   channel.
7213 * Arithmetic on basic integer types now [checks for overflow in debug
7214   builds][overflow].
7215
7216 Language
7217 --------
7218
7219 * Several [restrictions have been added to trait coherence][coh] in
7220   order to make it easier for upstream authors to change traits
7221   without breaking downstream code.
7222 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7223   improve error messages and macro behavior. For example, `0b1234` is
7224   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7225 * Trait bounds [are always invariant][inv], eliminating the need for
7226   the `PhantomFn` and `MarkerTrait` lang items, which have been
7227   removed.
7228 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7229   "foo" as bar` syntax has been replaced with `extern crate foo as
7230   bar`, and Cargo now automatically translates "-" in *package* names
7231   to underscore for the crate name.
7232 * [Lifetime shadowing is an error][lt].
7233 * [`Send` no longer implies `'static`][send-rfc].
7234 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7235   `MyType::default()`.
7236 * Primitive types [now have inherent methods][prim-inherent],
7237   obviating the need for extension traits like `SliceExt`.
7238 * Methods with `Self: Sized` in their `where` clause are [considered
7239   object-safe][self-sized], allowing many extension traits like
7240   `IteratorExt` to be merged into the traits they extended.
7241 * You can now [refer to associated types][assoc-where] whose
7242   corresponding trait bounds appear only in a `where` clause.
7243 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7244   like `Send` and `Sync` are now library-defined.
7245 * A [Reflect trait][reflect] was introduced, which means that
7246   downcasting via the `Any` trait is effectively limited to concrete
7247   types. This helps retain the potentially-important "parametricity"
7248   property: generic code cannot behave differently for different type
7249   arguments except in minor ways.
7250 * The `unsafe_destructor` feature is now deprecated in favor of the
7251   [new `dropck`][dropck]. This change is a major reduction in unsafe
7252   code.
7253
7254 Libraries
7255 ---------
7256
7257 * The `thread_local` module [has been renamed to `std::thread`][th].
7258 * The methods of `IteratorExt` [have been moved to the `Iterator`
7259   trait itself][ie].
7260 * Several traits that implement Rust's conventions for type
7261   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7262   [centralized in the `std::convert` module][con].
7263 * The `FromError` trait [was removed in favor of `From`][fe].
7264 * The basic sleep function [has moved to
7265   `std::thread::sleep_ms`][slp].
7266 * The `splitn` function now takes an `n` parameter that represents the
7267   number of items yielded by the returned iterator [instead of the
7268   number of 'splits'][spl].
7269 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7270 * [Derived implementations of `PartialOrd` now order enums according
7271   to their explicitly-assigned discriminants][po].
7272 * [Methods for searching strings are generic over `Pattern`s][pat],
7273   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7274   some others.
7275 * [In method resolution, object methods are resolved before inherent
7276   methods][meth].
7277 * [`String::from_str` has been deprecated in favor of the `From` impl,
7278   `String::from`][sf].
7279 * [`io::Error` implements `Sync`][ios].
7280 * [The `words` method on `&str` has been replaced with
7281   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7282   a word?'
7283 * The new path and IO modules are complete and `#[stable]`. This
7284   was the major library focus for this cycle.
7285 * The path API was [revised][path-normalize] to normalize `.`,
7286   adjusting the tradeoffs in favor of the most common usage.
7287 * A large number of remaining APIs in `std` were also stabilized
7288   during this cycle; about 75% of the non-deprecated API surface
7289   is now stable.
7290 * The new [string pattern API][string-pattern] landed, which makes
7291   the string slice API much more internally consistent and flexible.
7292 * A new set of [generic conversion traits][conversion] replaced
7293   many existing ad hoc traits.
7294 * Generic numeric traits were [completely removed][num-traits]. This
7295   was made possible thanks to inherent methods for primitive types,
7296   and the removal gives maximal flexibility for designing a numeric
7297   hierarchy in the future.
7298 * The `Fn` traits are now related via [inheritance][fn-inherit]
7299   and provide ergonomic [blanket implementations][fn-blanket].
7300 * The `Index` and `IndexMut` traits were changed to
7301   [take the index by value][index-value], enabling code like
7302   `hash_map["string"]` to work.
7303 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7304   `Copy` data is known to be `Clone` as well.
7305
7306 Misc
7307 ----
7308
7309 * Many errors now have extended explanations that can be accessed with
7310   the `--explain` flag to `rustc`.
7311 * Many new examples have been added to the standard library
7312   documentation.
7313 * rustdoc has received a number of improvements focused on completion
7314   and polish.
7315 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7316 * Much headway was made on ecosystem-wide CI, making it possible
7317   to [compare builds for breakage][ci-compare].
7318
7319
7320 [crates.io]: http://crates.io
7321 [clo]: https://github.com/rust-lang/rust/pull/24034
7322 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7323 [con]: https://github.com/rust-lang/rust/pull/23875
7324 [cr]: https://github.com/rust-lang/rust/pull/23419
7325 [fe]: https://github.com/rust-lang/rust/pull/23879
7326 [ie]: https://github.com/rust-lang/rust/pull/23300
7327 [inv]: https://github.com/rust-lang/rust/pull/23938
7328 [ios]: https://github.com/rust-lang/rust/pull/24133
7329 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7330 [lt]: https://github.com/rust-lang/rust/pull/24057
7331 [meth]: https://github.com/rust-lang/rust/pull/24056
7332 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7333 [po]: https://github.com/rust-lang/rust/pull/24270
7334 [sf]: https://github.com/rust-lang/rust/pull/24517
7335 [slp]: https://github.com/rust-lang/rust/pull/23949
7336 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7337 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7338 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7339 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7340 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7341 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7342 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7343 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7344 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7345 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7346 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7347 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7348 [reflect]: https://github.com/rust-lang/rust/pull/23712
7349 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7350 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7351 [index-value]: https://github.com/rust-lang/rust/pull/23601
7352 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7353 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7354 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7355 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7356 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7357 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7358
7359
7360 Version 1.0.0-alpha.2 (2015-02-20)
7361 =====================================
7362
7363 * ~1300 changes, numerous bugfixes
7364
7365 * Highlights
7366
7367     * The various I/O modules were [overhauled][io-rfc] to reduce
7368       unnecessary abstractions and provide better interoperation with
7369       the underlying platform. The old `io` module remains temporarily
7370       at `std::old_io`.
7371     * The standard library now [participates in feature gating][feat],
7372       so use of unstable libraries now requires a `#![feature(...)]`
7373       attribute. The impact of this change is [described on the
7374       forum][feat-forum]. [RFC][feat-rfc].
7375
7376 * Language
7377
7378     * `for` loops [now operate on the `IntoIterator` trait][into],
7379       which eliminates the need to call `.iter()`, etc. to iterate
7380       over collections. There are some new subtleties to remember
7381       though regarding what sort of iterators various types yield, in
7382       particular that `for foo in bar { }` yields values from a move
7383       iterator, destroying the original collection. [RFC][into-rfc].
7384     * Objects now have [default lifetime bounds][obj], so you don't
7385       have to write `Box<Trait+'static>` when you don't care about
7386       storing references. [RFC][obj-rfc].
7387     * In types that implement `Drop`, [lifetimes must outlive the
7388       value][drop]. This will soon make it possible to safely
7389       implement `Drop` for types where `#[unsafe_destructor]` is now
7390       required. Read the [gorgeous RFC][drop-rfc] for details.
7391     * The fully qualified <T as Trait>::X syntax lets you set the Self
7392       type for a trait method or associated type. [RFC][ufcs-rfc].
7393     * References to types that implement `Deref<U>` now [automatically
7394       coerce to references][deref] to the dereferenced type `U`,
7395       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7396       should eliminate many unsightly uses of `&*`, as when converting
7397       from references to vectors into references to
7398       slices. [RFC][deref-rfc].
7399     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7400       `|:|`) is obsolete and closure kind is inferred from context.
7401     * [`Self` is a keyword][Self].
7402
7403 * Libraries
7404
7405     * The `Show` and `String` formatting traits [have been
7406       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7407       their related purposes. Automatically getting a string
7408       conversion to use with `format!("{:?}", something_to_debug)` is
7409       now written `#[derive(Debug)]`.
7410     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7411       OsStr}`, provide strings in platform-specific encodings for easier
7412       interop with system APIs. [RFC][osstr-rfc].
7413     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7414       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7415       creating raw pointers.
7416
7417 * Tooling
7418
7419     * Certain long error messages of the form 'expected foo found bar'
7420       are now [split neatly across multiple
7421       lines][multiline]. Examples in the PR.
7422     * On Unix Rust can be [uninstalled][un] by running
7423       `/usr/local/lib/rustlib/uninstall.sh`.
7424     * The `#[rustc_on_unimplemented]` attribute, requiring the
7425       'on_unimplemented' feature, lets rustc [display custom error
7426       messages when a trait is expected to be implemented for a type
7427       but is not][onun].
7428
7429 * Misc
7430
7431     * Rust is tested against a [LALR grammar][lalr], which parses
7432       almost all the Rust files that rustc does.
7433
7434 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7435 [close]: https://github.com/rust-lang/rust/pull/21843
7436 [deref]: https://github.com/rust-lang/rust/pull/21351
7437 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7438 [drop]: https://github.com/rust-lang/rust/pull/21972
7439 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7440 [feat]: https://github.com/rust-lang/rust/pull/21248
7441 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7442 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7443 [fmt]: https://github.com/rust-lang/rust/pull/21457
7444 [into]: https://github.com/rust-lang/rust/pull/20790
7445 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7446 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7447 [lalr]: https://github.com/rust-lang/rust/pull/21452
7448 [multiline]: https://github.com/rust-lang/rust/pull/19870
7449 [obj]: https://github.com/rust-lang/rust/pull/22230
7450 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7451 [onun]: https://github.com/rust-lang/rust/pull/20889
7452 [osstr]: https://github.com/rust-lang/rust/pull/21488
7453 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7454 [Self]: https://github.com/rust-lang/rust/pull/22158
7455 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7456 [un]: https://github.com/rust-lang/rust/pull/22256
7457
7458
7459 Version 1.0.0-alpha (2015-01-09)
7460 ==================================
7461
7462   * ~2400 changes, numerous bugfixes
7463
7464   * Highlights
7465
7466     * The language itself is considered feature complete for 1.0,
7467       though there will be many usability improvements and bugfixes
7468       before the final release.
7469     * Nearly 50% of the public API surface of the standard library has
7470       been declared 'stable'. Those interfaces are unlikely to change
7471       before 1.0.
7472     * The long-running debate over integer types has been
7473       [settled][ints]: Rust will ship with types named `isize` and
7474       `usize`, rather than `int` and `uint`, for pointer-sized
7475       integers. Guidelines will be rolled out during the alpha cycle.
7476     * Most crates that are not `std` have been moved out of the Rust
7477       distribution into the Cargo ecosystem so they can evolve
7478       separately and don't need to be stabilized as quickly, including
7479       'time', 'getopts', 'num', 'regex', and 'term'.
7480     * Documentation continues to be expanded with more API coverage, more
7481       examples, and more in-depth explanations. The guides have been
7482       consolidated into [The Rust Programming Language][trpl].
7483     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7484     * All official Rust binary installers now come with [Cargo], the
7485       Rust package manager.
7486
7487 * Language
7488
7489     * Closures have been [completely redesigned][unboxed] to be
7490       implemented in terms of traits, can now be used as generic type
7491       bounds and thus monomorphized and inlined, or via an opaque
7492       pointer (boxed) as in the old system. The new system is often
7493       referred to as 'unboxed' closures.
7494     * Traits now support [associated types][assoc], allowing families
7495       of related types to be defined together and used generically in
7496       powerful ways.
7497     * Enum variants are [namespaced by their type names][enum].
7498     * [`where` clauses][where] provide a more versatile and attractive
7499       syntax for specifying generic bounds, though the previous syntax
7500       remains valid.
7501     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7502       numeric types.
7503     * Rust [no longer has a runtime][rt] of any description, and only
7504       supports OS threads, not green threads.
7505     * At long last, Rust has been overhauled for 'dynamically-sized
7506       types' ([DST]), which integrates 'fat pointers' (object types,
7507       arrays, and `str`) more deeply into the type system, making it
7508       more consistent.
7509     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7510       `..j` that produce range types and which, when combined with the
7511       `Index` operator and multidispatch, leads to a convenient slice
7512       notation, `[i..j]`.
7513     * The new range syntax revealed an ambiguity in the fixed-length
7514       array syntax, so now fixed length arrays [are written `[T;
7515       N]`][arrays].
7516     * The `Copy` trait is no longer implemented automatically. Unsafe
7517       pointers no longer implement `Sync` and `Send` so types
7518       containing them don't automatically either. `Sync` and `Send`
7519       are now 'unsafe traits' so one can "forcibly" implement them via
7520       `unsafe impl` if a type confirms to the requirements for them
7521       even though the internals do not (e.g. structs containing unsafe
7522       pointers like `Arc`). These changes are intended to prevent some
7523       footguns and are collectively known as [opt-in built-in
7524       traits][oibit] (though `Sync` and `Send` will soon become pure
7525       library types unknown to the compiler).
7526     * Operator traits now take their operands [by value][ops], and
7527       comparison traits can use multidispatch to compare one type
7528       against multiple other types, allowing e.g. `String` to be
7529       compared with `&str`.
7530     * `if let` and `while let` are no longer feature-gated.
7531     * Rust has adopted a more [uniform syntax for escaping unicode
7532       characters][unicode].
7533     * `macro_rules!` [has been declared stable][mac]. Though it is a
7534       flawed system it is sufficiently popular that it must be usable
7535       for 1.0. Effort has gone into [future-proofing][mac-future] it
7536       in ways that will allow other macro systems to be developed in
7537       parallel, and won't otherwise impact the evolution of the
7538       language.
7539     * The prelude has been [pared back significantly][prelude] such
7540       that it is the minimum necessary to support the most pervasive
7541       code patterns, and through [generalized where clauses][where]
7542       many of the prelude extension traits have been consolidated.
7543     * Rust's rudimentary reflection [has been removed][refl], as it
7544       incurred too much code generation for little benefit.
7545     * [Struct variants][structvars] are no longer feature-gated.
7546     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7547       known as 'higher-ranked trait bounds', this crucially allows
7548       unboxed closures to work.
7549     * Macros invocations surrounded by parens or square brackets and
7550       not terminated by a semicolon are [parsed as
7551       expressions][macros], which makes expressions like `vec![1i32,
7552       2, 3].len()` work as expected.
7553     * Trait objects now implement their traits automatically, and
7554       traits that can be coerced to objects now must be [object
7555       safe][objsafe].
7556     * Automatically deriving traits is now done with `#[derive(...)]`
7557       not `#[deriving(...)]` for [consistency with other naming
7558       conventions][derive].
7559     * Importing the containing module or enum at the same time as
7560       items or variants they contain is [now done with `self` instead
7561       of `mod`][self], as in use `foo::{self, bar}`
7562     * Glob imports are no longer feature-gated.
7563     * The `box` operator and `box` patterns have been feature-gated
7564       pending a redesign. For now unique boxes should be allocated
7565       like other containers, with `Box::new`.
7566
7567 * Libraries
7568
7569     * A [series][coll1] of [efforts][coll2] to establish
7570       [conventions][coll3] for collections types has resulted in API
7571       improvements throughout the standard library.
7572     * New [APIs for error handling][err] provide ergonomic interop
7573       between error types, and [new conventions][err-conv] describe
7574       more clearly the recommended error handling strategies in Rust.
7575     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7576       it is easier to discuss failure in the context of error handling
7577       without making clarifications as to whether you are referring to
7578       the 'fail' macro or failure more generally.
7579     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7580       syscall when available.
7581     * The 'serialize' crate has been renamed 'rustc-serialize' and
7582       moved out of the distribution to Cargo. Although it is widely
7583       used now, it is expected to be superseded in the near future.
7584     * The `Show` formatter, typically implemented with
7585       `#[derive(Show)]` is [now requested with the `{:?}`
7586       specifier][show] and is intended for use by all types, for uses
7587       such as `println!` debugging. The new `String` formatter must be
7588       implemented by hand, uses the `{}` specifier, and is intended
7589       for full-fidelity conversions of things that can logically be
7590       represented as strings.
7591
7592 * Tooling
7593
7594     * [Flexible target specification][flex] allows rustc's code
7595       generation to be configured to support otherwise-unsupported
7596       platforms.
7597     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7598       respective debuggers with Rust-appropriate pretty-printing.
7599     * The Windows installation of Rust is distributed with the
7600       MinGW components currently required to link binaries on that
7601       platform.
7602
7603 * Misc
7604
7605     * Nullable enum optimizations have been extended to more types so
7606       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7607       space than the inner types themselves.
7608     * Work has begun on supporting AArch64.
7609
7610 [Cargo]: https://crates.io
7611 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7612 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7613 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7614 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7615 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7616 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7617 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7618 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7619 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7620 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7621 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7622 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7623 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7624 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7625 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7626 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7627 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7628 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7629 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7630 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7631 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7632 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7633 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7634 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7635 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7636 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7637 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7638 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7639 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7640 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7641 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7642 [trpl]: https://doc.rust-lang.org/book/index.html
7643 [rbe]: http://rustbyexample.com/
7644
7645
7646 Version 0.12.0 (2014-10-09)
7647 =============================
7648
7649   * ~1900 changes, numerous bugfixes
7650
7651   * Highlights
7652
7653     * The introductory documentation (now called The Rust Guide) has
7654       been completely rewritten, as have a number of supplementary
7655       guides.
7656     * Rust's package manager, Cargo, continues to improve and is
7657       sometimes considered to be quite awesome.
7658     * Many API's in `std` have been reviewed and updated for
7659       consistency with the in-development Rust coding
7660       guidelines. The standard library documentation tracks
7661       stabilization progress.
7662     * Minor libraries have been moved out-of-tree to the rust-lang org
7663       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7664       be installed with Cargo.
7665     * Lifetime elision allows lifetime annotations to be left off of
7666       function declarations in many common scenarios.
7667     * Rust now works on 64-bit Windows.
7668
7669   * Language
7670     * Indexing can be overloaded with the `Index` and `IndexMut`
7671       traits.
7672     * The `if let` construct takes a branch only if the `let` pattern
7673       matches, currently behind the 'if_let' feature gate.
7674     * 'where clauses', a more flexible syntax for specifying trait
7675       bounds that is more aesthetic, have been added for traits and
7676       free functions. Where clauses will in the future make it
7677       possible to constrain associated types, which would be
7678       impossible with the existing syntax.
7679     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7680       the 'slicing_syntax' feature gate, and can be overloaded with
7681       the `Slice` or `SliceMut` traits.
7682     * The syntax for matching of sub-slices has been changed to use a
7683       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7684       consistency with other uses of `..` and to future-proof
7685       potential additional uses of the syntax.
7686     * The syntax for matching inclusive ranges in patterns has changed
7687       from `0..3` to `0...4` to be consistent with the exclusive range
7688       syntax for slicing.
7689     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7690       c]`) has been put behind the 'advanced_slice_patterns' feature
7691       gate and may be removed in the future.
7692     * Components of tuples and tuple structs can be extracted using
7693       the `value.0` syntax, currently behind the `tuple_indexing`
7694       feature gate.
7695     * The `#[crate_id]` attribute is no longer supported; versioning
7696       is handled by the package manager.
7697     * Renaming crate imports are now written `extern crate foo as bar`
7698       instead of `extern crate bar = foo`.
7699     * Renaming use statements are now written `use foo as bar` instead
7700       of `use bar = foo`.
7701     * `let` and `match` bindings and argument names in macros are now
7702       hygienic.
7703     * The new, more efficient, closure types ('unboxed closures') have
7704       been added under a feature gate, 'unboxed_closures'. These will
7705       soon replace the existing closure types, once higher-ranked
7706       trait lifetimes are added to the language.
7707     * `move` has been added as a keyword, for indicating closures
7708       that capture by value.
7709     * Mutation and assignment is no longer allowed in pattern guards.
7710     * Generic structs and enums can now have trait bounds.
7711     * The `Share` trait is now called `Sync` to free up the term
7712       'shared' to refer to 'shared reference' (the default reference
7713       type.
7714     * Dynamically-sized types have been mostly implemented,
7715       unifying the behavior of fat-pointer types with the rest of the
7716       type system.
7717     * As part of dynamically-sized types, the `Sized` trait has been
7718       introduced, which qualifying types implement by default, and
7719       which type parameters expect by default. To specify that a type
7720       parameter does not need to be sized, write `<Sized? T>`. Most
7721       types are `Sized`, notable exceptions being unsized arrays
7722       (`[T]`) and trait types.
7723     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7724     * Lifetime bounds can now be applied to type parameters and object
7725       types.
7726     * The old, reference counted GC type, `Gc<T>` which was once
7727       denoted by the `@` sigil, has finally been removed. GC will be
7728       revisited in the future.
7729
7730   * Libraries
7731     * Library documentation has been improved for a number of modules.
7732     * Bit-vectors, collections::bitv has been modernized.
7733     * The url crate is deprecated in favor of
7734       http://github.com/servo/rust-url, which can be installed with
7735       Cargo.
7736     * Most I/O stream types can be cloned and subsequently closed from
7737       a different thread.
7738     * A `std::time::Duration` type has been added for use in I/O
7739       methods that rely on timers, as well as in the 'time' crate's
7740       `Timespec` arithmetic.
7741     * The runtime I/O abstraction layer that enabled the green thread
7742       scheduler to do non-thread-blocking I/O has been removed, along
7743       with the libuv-based implementation employed by the green thread
7744       scheduler. This will greatly simplify the future I/O work.
7745     * `collections::btree` has been rewritten to have a more
7746       idiomatic and efficient design.
7747
7748   * Tooling
7749     * rustdoc output now indicates the stability levels of API's.
7750     * The `--crate-name` flag can specify the name of the crate
7751       being compiled, like `#[crate_name]`.
7752     * The `-C metadata` specifies additional metadata to hash into
7753       symbol names, and `-C extra-filename` specifies additional
7754       information to put into the output filename, for use by the
7755       package manager for versioning.
7756     * debug info generation has continued to improve and should be
7757       more reliable under both gdb and lldb.
7758     * rustc has experimental support for compiling in parallel
7759       using the `-C codegen-units` flag.
7760     * rustc no longer encodes rpath information into binaries by
7761       default.
7762
7763   * Misc
7764     * Stack usage has been optimized with LLVM lifetime annotations.
7765     * Official Rust binaries on Linux are more compatible with older
7766       kernels and distributions, built on CentOS 5.10.
7767
7768
7769 Version 0.11.0 (2014-07-02)
7770 ==========================
7771
7772   * ~1700 changes, numerous bugfixes
7773
7774   * Language
7775     * ~[T] has been removed from the language. This type is superseded by
7776       the Vec<T> type.
7777     * ~str has been removed from the language. This type is superseded by
7778       the String type.
7779     * ~T has been removed from the language. This type is superseded by the
7780       Box<T> type.
7781     * @T has been removed from the language. This type is superseded by the
7782       standard library's std::gc::Gc<T> type.
7783     * Struct fields are now all private by default.
7784     * Vector indices and shift amounts are both required to be a `uint`
7785       instead of any integral type.
7786     * Byte character, byte string, and raw byte string literals are now all
7787       supported by prefixing the normal literal with a `b`.
7788     * Multiple ABIs are no longer allowed in an ABI string
7789     * The syntax for lifetimes on closures/procedures has been tweaked
7790       slightly: `<'a>|A, B|: 'b + K -> T`
7791     * Floating point modulus has been removed from the language; however it
7792       is still provided by a library implementation.
7793     * Private enum variants are now disallowed.
7794     * The `priv` keyword has been removed from the language.
7795     * A closure can no longer be invoked through a &-pointer.
7796     * The `use foo, bar, baz;` syntax has been removed from the language.
7797     * The transmute intrinsic no longer works on type parameters.
7798     * Statics now allow blocks/items in their definition.
7799     * Trait bounds are separated from objects with + instead of : now.
7800     * Objects can no longer be read while they are mutably borrowed.
7801     * The address of a static is now marked as insignificant unless the
7802       #[inline(never)] attribute is placed it.
7803     * The #[unsafe_destructor] attribute is now behind a feature gate.
7804     * Struct literals are no longer allowed in ambiguous positions such as
7805       if, while, match, and for..in.
7806     * Declaration of lang items and intrinsics are now feature-gated by
7807       default.
7808     * Integral literals no longer default to `int`, and floating point
7809       literals no longer default to `f64`. Literals must be suffixed with an
7810       appropriate type if inference cannot determine the type of the
7811       literal.
7812     * The Box<T> type is no longer implicitly borrowed to &mut T.
7813     * Procedures are now required to not capture borrowed references.
7814
7815   * Libraries
7816     * The standard library is now a "facade" over a number of underlying
7817       libraries. This means that development on the standard library should
7818       be speedier due to smaller crates, as well as a clearer line between
7819       all dependencies.
7820     * A new library, libcore, lives under the standard library's facade
7821       which is Rust's "0-assumption" library, suitable for embedded and
7822       kernel development for example.
7823     * A regex crate has been added to the standard distribution. This crate
7824       includes statically compiled regular expressions.
7825     * The unwrap/unwrap_err methods on Result require a Show bound for
7826       better error messages.
7827     * The return types of the std::comm primitives have been centralized
7828       around the Result type.
7829     * A number of I/O primitives have gained the ability to time out their
7830       operations.
7831     * A number of I/O primitives have gained the ability to close their
7832       reading/writing halves to cancel pending operations.
7833     * Reverse iterator methods have been removed in favor of `rev()` on
7834       their forward-iteration counterparts.
7835     * A bitflags! macro has been added to enable easy interop with C and
7836       management of bit flags.
7837     * A debug_assert! macro is now provided which is disabled when
7838       `--cfg ndebug` is passed to the compiler.
7839     * A graphviz crate has been added for creating .dot files.
7840     * The std::cast module has been migrated into std::mem.
7841     * The std::local_data api has been migrated from freestanding functions
7842       to being based on methods.
7843     * The Pod trait has been renamed to Copy.
7844     * jemalloc has been added as the default allocator for types.
7845     * The API for allocating memory has been changed to use proper alignment
7846       and sized deallocation
7847     * Connecting a TcpStream or binding a TcpListener is now based on a
7848       string address and a u16 port. This allows connecting to a hostname as
7849       opposed to an IP.
7850     * The Reader trait now contains a core method, read_at_least(), which
7851       correctly handles many repeated 0-length reads.
7852     * The process-spawning API is now centered around a builder-style
7853       Command struct.
7854     * The :? printing qualifier has been moved from the standard library to
7855       an external libdebug crate.
7856     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7857       have been renamed to Eq/Ord.
7858     * The select/plural methods have been removed from format!. The escapes
7859       for { and } have also changed from \{ and \} to {{ and }},
7860       respectively.
7861     * The TaskBuilder API has been re-worked to be a true builder, and
7862       extension traits for spawning native/green tasks have been added.
7863
7864   * Tooling
7865     * All breaking changes to the language or libraries now have their
7866       commit message annotated with `[breaking-change]` to allow for easy
7867       discovery of breaking changes.
7868     * The compiler will now try to suggest how to annotate lifetimes if a
7869       lifetime-related error occurs.
7870     * Debug info continues to be improved greatly with general bug fixes and
7871       better support for situations like link time optimization (LTO).
7872     * Usage of syntax extensions when cross-compiling has been fixed.
7873     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7874       -fdata-sections and --gc-sections has been enabled by default
7875     * The compiler is now stricter about where it will load module files
7876       from when a module is declared via `mod foo;`.
7877     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7878       Syntax extensions are now discovered via a "plugin registrar" type
7879       which will be extended in the future to other various plugins.
7880     * Lints have been restructured to allow for dynamically loadable lints.
7881     * A number of rustdoc improvements:
7882       * The HTML output has been visually redesigned.
7883       * Markdown is now powered by hoedown instead of sundown.
7884       * Searching heuristics have been greatly improved.
7885       * The search index has been reduced in size by a great amount.
7886       * Cross-crate documentation via `pub use` has been greatly improved.
7887       * Primitive types are now hyperlinked and documented.
7888     * Documentation has been moved from static.rust-lang.org/doc to
7889       doc.rust-lang.org
7890     * A new sandbox, play.rust-lang.org, is available for running and
7891       sharing rust code examples on-line.
7892     * Unused attributes are now more robustly warned about.
7893     * The dead_code lint now warns about unused struct fields.
7894     * Cross-compiling to iOS is now supported.
7895     * Cross-compiling to mipsel is now supported.
7896     * Stability attributes are now inherited by default and no longer apply
7897       to intra-crate usage, only inter-crate usage.
7898     * Error message related to non-exhaustive match expressions have been
7899       greatly improved.
7900
7901
7902 Version 0.10 (2014-04-03)
7903 =========================
7904
7905   * ~1500 changes, numerous bugfixes
7906
7907   * Language
7908     * A new RFC process is now in place for modifying the language.
7909     * Patterns with `@`-pointers have been removed from the language.
7910     * Patterns with unique vectors (`~[T]`) have been removed from the
7911       language.
7912     * Patterns with unique strings (`~str`) have been removed from the
7913       language.
7914     * `@str` has been removed from the language.
7915     * `@[T]` has been removed from the language.
7916     * `@self` has been removed from the language.
7917     * `@Trait` has been removed from the language.
7918     * Headers on `~` allocations which contain `@` boxes inside the type for
7919       reference counting have been removed.
7920     * The semantics around the lifetimes of temporary expressions have changed,
7921       see #3511 and #11585 for more information.
7922     * Cross-crate syntax extensions are now possible, but feature gated. See
7923       #11151 for more information. This includes both `macro_rules!` macros as
7924       well as syntax extensions such as `format!`.
7925     * New lint modes have been added, and older ones have been turned on to be
7926       warn-by-default.
7927       * Unnecessary parentheses
7928       * Uppercase statics
7929       * Camel Case types
7930       * Uppercase variables
7931       * Publicly visible private types
7932       * `#[deriving]` with raw pointers
7933     * Unsafe functions can no longer be coerced to closures.
7934     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7935     * The `#[simd]` attribute is now behind a feature gate.
7936     * Visibility is no longer allowed on `extern crate` statements, and
7937       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7938     * Trailing commas are now allowed in argument lists and tuple patterns.
7939     * The `do` keyword has been removed, it is now a reserved keyword.
7940     * Default type parameters have been implemented, but are feature gated.
7941     * Borrowed variables through captures in closures are now considered soundly.
7942     * `extern mod` is now `extern crate`
7943     * The `Freeze` trait has been removed.
7944     * The `Share` trait has been added for types that can be shared among
7945       threads.
7946     * Labels in macros are now hygienic.
7947     * Expression/statement macro invocations can be delimited with `{}` now.
7948     * Treatment of types allowed in `static mut` locations has been tweaked.
7949     * The `*` and `.` operators are now overloadable through the `Deref` and
7950       `DerefMut` traits.
7951     * `~Trait` and `proc` no longer have `Send` bounds by default.
7952     * Partial type hints are now supported with the `_` type marker.
7953     * An `Unsafe` type was introduced for interior mutability. It is now
7954       considered undefined to transmute from `&T` to `&mut T` without using the
7955       `Unsafe` type.
7956     * The #[linkage] attribute was implemented for extern statics/functions.
7957     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7958     * `Pod` was renamed to `Copy`.
7959
7960   * Libraries
7961     * The `libextra` library has been removed. It has now been decomposed into
7962       component libraries with smaller and more focused nuggets of
7963       functionality. The full list of libraries can be found on the
7964       documentation index page.
7965     * std: `std::condition` has been removed. All I/O errors are now propagated
7966       through the `Result` type. In order to assist with error handling, a
7967       `try!` macro for unwrapping errors with an early return and a lint for
7968       unused results has been added. See #12039 for more information.
7969     * std: The `vec` module has been renamed to `slice`.
7970     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7971       This will become the only growable vector in the future.
7972     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7973       are now found at `std::io::BufferedReader` instead of
7974       `std::io::buffered::BufferedReader`.
7975     * std: `print` and `println` are no longer in the prelude, the `print!` and
7976       `println!` macros are intended to be used instead.
7977     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7978       attempts to statically prevent cycles.
7979     * std: The standard distribution is adopting the policy of pushing failure
7980       to the user rather than failing in libraries. Many functions (such as
7981       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7982     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7983       deriving mode: `#[deriving(Show)]`.
7984     * std: `ToStr` is now implemented for all types implementing `Show`.
7985     * std: The formatting trait methods now take `&self` instead of `&T`
7986     * std: The `invert()` method on iterators has been renamed to `rev()`
7987     * std: `std::num` has seen a reduction in the genericity of its traits,
7988       consolidating functionality into a few core traits.
7989     * std: Backtraces are now printed on task failure if the environment
7990       variable `RUST_BACKTRACE` is present.
7991     * std: Naming conventions for iterators have been standardized. More details
7992       can be found on the wiki's style guide.
7993     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7994       still implement the function.
7995     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7996     * std: `assert_approx_eq!` has been removed
7997     * std: The `e` and `E` formatting specifiers for floats have been added to
7998       print them in exponential notation.
7999     * std: The `Times` trait has been removed
8000     * std: Indications of variance and opting out of builtin bounds is done
8001       through marker types in `std::kinds::marker` now
8002     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8003       `#[deriving(Hash)]` is now possible.
8004     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8005     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8006     * std: `Chan::new` is now `channel()`.
8007     * std: A new synchronous channel type has been implemented.
8008     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8009     * std: `hashmap` and `trie` have been moved to `libcollections`
8010     * std: `run` has been rolled into `io::process`
8011     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8012     * std: The equality and comparison traits have seen some reorganization.
8013     * std: `rand` has moved to `librand`.
8014     * std: `to_{lower,upper}case` has been implemented for `char`.
8015     * std: Logging has been moved to `liblog`.
8016     * collections: `HashMap` has been rewritten for higher performance and less
8017       memory usage.
8018     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8019       it can be booted manually. The runtime guide has more information and
8020       examples.
8021     * native: All I/O functionality except signals has been implemented.
8022     * green: Task spawning with `libgreen` has been optimized with stack caching
8023       and various trimming of code.
8024     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8025     * sync: The `extra::sync` module has been updated to modern rust (and moved
8026       to the `sync` library), tweaking and improving various interfaces while
8027       dropping redundant functionality.
8028     * sync: A new `Barrier` type has been added to the `sync` library.
8029     * sync: An efficient mutex for native and green tasks has been implemented.
8030     * serialize: The `base64` module has seen some improvement. It treats
8031       newlines better, has non-string error values, and has seen general
8032       cleanup.
8033     * fourcc: A `fourcc!` macro was introduced
8034     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8035       hexadecimal literal.
8036
8037   * Tooling
8038     * `rustpkg` has been deprecated and removed from the main repository. Its
8039       replacement, `cargo`, is under development.
8040     * Nightly builds of rust are now available
8041     * The memory usage of rustc has been improved many times throughout this
8042       release cycle.
8043     * The build process supports disabling rpath support for the rustc binary
8044       itself.
8045     * Code generation has improved in some cases, giving more information to the
8046       LLVM optimization passes to enable more extensive optimizations.
8047     * Debuginfo compatibility with lldb on OSX has been restored.
8048     * The master branch is now gated on an android bot, making building for
8049       android much more reliable.
8050     * Output flags have been centralized into one `--emit` flag.
8051     * Crate type flags have been centralized into one `--crate-type` flag.
8052     * Codegen flags have been consolidated behind a `-C` flag.
8053     * Linking against outdated crates now has improved error messages.
8054     * Error messages with lifetimes will often suggest how to annotate the
8055       function to fix the error.
8056     * Many more types are documented in the standard library, and new guides
8057       were written.
8058     * Many `rustdoc` improvements:
8059       * code blocks are syntax highlighted.
8060       * render standalone markdown files.
8061       * the --test flag tests all code blocks by default.
8062       * exported macros are displayed.
8063       * re-exported types have their documentation inlined at the location of the
8064         first re-export.
8065       * search works across crates that have been rendered to the same output
8066         directory.
8067
8068
8069 Version 0.9 (2014-01-09)
8070 ==========================
8071
8072    * ~1800 changes, numerous bugfixes
8073
8074    * Language
8075       * The `float` type has been removed. Use `f32` or `f64` instead.
8076       * A new facility for enabling experimental features (feature gating) has
8077         been added, using the crate-level `#[feature(foo)]` attribute.
8078       * Managed boxes (@) are now behind a feature gate
8079         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8080         standard library's `Gc` or `Rc` types instead.
8081       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8082       * Jumping back to the top of a loop is now done with `continue` instead of
8083         `loop`.
8084       * Strings can no longer be mutated through index assignment.
8085       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8086         hash delimiters, as in `r###"foo"###`.
8087       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8088         called once.
8089       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8090       * `@fn`s have been removed.
8091       * `do` only works with procs in order to make it obvious what the cost
8092         of `do` is.
8093       * Single-element tuple-like structs can no longer be dereferenced to
8094         obtain the inner value. A more comprehensive solution for overloading
8095         the dereference operator will be provided in the future.
8096       * The `#[link(...)]` attribute has been replaced with
8097         `#[crate_id = "name#vers"]`.
8098       * Empty `impl`s must be terminated with empty braces and may not be
8099         terminated with a semicolon.
8100       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8101         no longer has any special meaning.
8102       * The old `fmt!` string formatting macro has been removed.
8103       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8104         `print!` and `println!`.
8105       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8106       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8107         `extern mod foo = "bar"` instead.
8108       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8109       * Macros can have attributes.
8110       * Macros can expand to items with attributes.
8111       * Macros can expand to multiple items.
8112       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8113       * Comments may be nested.
8114       * Values automatically coerce to trait objects they implement, without
8115         an explicit `as`.
8116       * Enum discriminants are no longer an entire word but as small as needed to
8117         contain all the variants. The `repr` attribute can be used to override
8118         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8119         `#[repr(C)]` to match C enums.
8120       * Non-string literals are not allowed in attributes (they never worked).
8121       * The FFI now supports variadic functions.
8122       * Octal numeric literals, as in `0o7777`.
8123       * The `concat!` syntax extension performs compile-time string concatenation.
8124       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8125         removed as Rust no longer uses segmented stacks.
8126       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8127       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8128         not `*`; ignoring remaining fields of a struct is also done with `..`,
8129         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8130       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8131       * `rustc` supports the "system" calling convention, which defaults to the
8132         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8133         "C" elsewhere.
8134       * The `type_overflow` lint (default: warn) checks literals for overflow.
8135       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8136       * The `attribute_usage` lint (default: warn) warns about unknown
8137         attributes.
8138       * The `unknown_features` lint (default: warn) warns about unknown
8139         feature gates.
8140       * The `dead_code` lint (default: warn) checks for dead code.
8141       * Rust libraries can be linked statically to one another
8142       * `#[link_args]` is behind the `link_args` feature gate.
8143       * Native libraries are now linked with `#[link(name = "foo")]`
8144       * Native libraries can be statically linked to a rust crate
8145         (`#[link(name = "foo", kind = "static")]`).
8146       * Native OS X frameworks are now officially supported
8147         (`#[link(name = "foo", kind = "framework")]`).
8148       * The `#[thread_local]` attribute creates thread-local (not task-local)
8149         variables. Currently behind the `thread_local` feature gate.
8150       * The `return` keyword may be used in closures.
8151       * Types that can be copied via a memcpy implement the `Pod` kind.
8152       * The `cfg` attribute can now be used on struct fields and enum variants.
8153
8154    * Libraries
8155       * std: The `option` and `result` API's have been overhauled to make them
8156         simpler, more consistent, and more composable.
8157       * std: The entire `std::io` module has been replaced with one that is
8158         more comprehensive and that properly interfaces with the underlying
8159         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8160         implemented.
8161       * std: `io::util` contains a number of useful implementations of
8162         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8163         `ZeroReader`, `TeeReader`.
8164       * std: The reference counted pointer type `extra::rc` moved into std.
8165       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8166         just a wrapper around it).
8167       * std: The `Either` type has been removed.
8168       * std: `fmt::Default` can be implemented for any type to provide default
8169         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8170       * std: The `rand` API continues to be tweaked.
8171       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8172         on failure in gdb, is now named `rust_fail`.
8173       * std: The `each_key` and `each_value` methods on `HashMap` have been
8174         replaced by the `keys` and `values` iterators.
8175       * std: Functions dealing with type size and alignment have moved from the
8176         `sys` module to the `mem` module.
8177       * std: The `path` module was written and API changed.
8178       * std: `str::from_utf8` has been changed to cast instead of allocate.
8179       * std: `starts_with` and `ends_with` methods added to vectors via the
8180         `ImmutableEqVector` trait, which is in the prelude.
8181       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8182         if the index is out of bounds.
8183       * std: Task failure no longer propagates between tasks, as the model was
8184         complex, expensive, and incompatible with thread-based tasks.
8185       * std: The `Any` type can be used for dynamic typing.
8186       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8187         `task::try`.
8188       * std: Methods that produce iterators generally do not have an `_iter`
8189         suffix now.
8190       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8191         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8192       * std: `util::ignore` renamed to `prelude::drop`.
8193       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8194         trait.
8195       * std: `vec::raw` has seen a lot of cleanup and API changes.
8196       * std: The standard library no longer includes any C++ code, and very
8197         minimal C, eliminating the dependency on libstdc++.
8198       * std: Runtime scheduling and I/O functionality has been factored out into
8199         extensible interfaces and is now implemented by two different crates:
8200         libnative, for native threading and I/O; and libgreen, for green threading
8201         and I/O. This paves the way for using the standard library in more limited
8202         embedded environments.
8203       * std: The `comm` module has been rewritten to be much faster, have a
8204         simpler, more consistent API, and to work for both native and green
8205         threading.
8206       * std: All libuv dependencies have been moved into the rustuv crate.
8207       * native: New implementations of runtime scheduling on top of OS threads.
8208       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8209         and other I/O.
8210       * green: The green thread scheduler and message passing types are almost
8211         entirely lock-free.
8212       * extra: The `flatpipes` module had bitrotted and was removed.
8213       * extra: All crypto functions have been removed and Rust now has a policy of
8214         not reimplementing crypto in the standard library. In the future crypto
8215         will be provided by external crates with bindings to established libraries.
8216       * extra: `c_vec` has been modernized.
8217       * extra: The `sort` module has been removed. Use the `sort` method on
8218         mutable slices.
8219
8220    * Tooling
8221       * The `rust` and `rusti` commands have been removed, due to lack of
8222         maintenance.
8223       * `rustdoc` was completely rewritten.
8224       * `rustdoc` can test code examples in documentation.
8225       * `rustpkg` can test packages with the argument, 'test'.
8226       * `rustpkg` supports arbitrary dependencies, including C libraries.
8227       * `rustc`'s support for generating debug info is improved again.
8228       * `rustc` has better error reporting for unbalanced delimiters.
8229       * `rustc`'s JIT support was removed due to bitrot.
8230       * Executables and static libraries can be built with LTO (-Z lto)
8231       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8232         build tools.
8233
8234
8235 Version 0.8 (2013-09-26)
8236 ============================
8237
8238    * ~2200 changes, numerous bugfixes
8239
8240    * Language
8241       * The `for` loop syntax has changed to work with the `Iterator` trait.
8242       * At long last, unwinding works on Windows.
8243       * Default methods are ready for use.
8244       * Many trait inheritance bugs fixed.
8245       * Owned and borrowed trait objects work more reliably.
8246       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8247       * rustc can omit emission of code for the `debug!` macro if it is passed
8248         `--cfg ndebug`
8249       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8250         for foo.rs, then foo/mod.rs, and will generate an error when both are
8251         present.
8252       * Strings no longer contain trailing nulls. The new `std::c_str` module
8253         provides new mechanisms for converting to C strings.
8254       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8255       * The FFI has been overhauled such that foreign functions are called directly,
8256         instead of through a stack-switching wrapper.
8257       * Calling a foreign function must be done through a Rust function with the
8258         `#[fixed_stack_segment]` attribute.
8259       * The `externfn!` macro can be used to declare both a foreign function and
8260         a `#[fixed_stack_segment]` wrapper at once.
8261       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8262       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8263       * `priv` is disallowed everywhere except for struct fields and enum variants.
8264       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8265       * `ref` bindings in irrefutable patterns work correctly now.
8266       * `char` is now prevented from containing invalid code points.
8267       * Casting to `bool` is no longer allowed.
8268       * `\0` is now accepted as an escape in chars and strings.
8269       * `yield` is a reserved keyword.
8270       * `typeof` is a reserved keyword.
8271       * Crates may be imported by URL with `extern mod foo = "url";`.
8272       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8273       * Static vectors can be initialized with repeating elements,
8274         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8275       * Static structs can be initialized with functional record update,
8276         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8277       * `cfg!` can be used to conditionally execute code based on the crate
8278         configuration, similarly to `#[cfg(...)]`.
8279       * The `unnecessary_qualification` lint detects unneeded module
8280         prefixes (default: allow).
8281       * Arithmetic operations have been implemented on the SIMD types in
8282         `std::unstable::simd`.
8283       * Exchange allocation headers were removed, reducing memory usage.
8284       * `format!` implements a completely new, extensible, and higher-performance
8285         string formatting system. It will replace `fmt!`.
8286       * `print!` and `println!` write formatted strings (using the `format!`
8287         extension) to stdout.
8288       * `write!` and `writeln!` write formatted strings (using the `format!`
8289         extension) to the new Writers in `std::rt::io`.
8290       * The library section in which a function or static is placed may
8291         be specified with `#[link_section = "..."]`.
8292       * The `proto!` syntax extension for defining bounded message protocols
8293         was removed.
8294       * `macro_rules!` is hygienic for `let` declarations.
8295       * The `#[export_name]` attribute specifies the name of a symbol.
8296       * `unreachable!` can be used to indicate unreachable code, and fails
8297         if executed.
8298
8299    * Libraries
8300       * std: Transitioned to the new runtime, written in Rust.
8301       * std: Added an experimental I/O library, `rt::io`, based on the new
8302         runtime.
8303       * std: A new generic `range` function was added to the prelude, replacing
8304         `uint::range` and friends.
8305       * std: `range_rev` no longer exists. Since range is an iterator it can be
8306         reversed with `range(lo, hi).invert()`.
8307       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8308         renamed to `unwrap_or`.
8309       * std: The `iterator` module was renamed to `iter`.
8310       * std: Integral types now support the `checked_add`, `checked_sub`, and
8311         `checked_mul` operations for detecting overflow.
8312       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8313         consistency.
8314       * std: Methods are standardizing on conventions for casting methods:
8315         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8316         and cheap casts.
8317       * std: The `CString` type in `c_str` provides new ways to convert to and
8318         from C strings.
8319       * std: `DoubleEndedIterator` can yield elements in two directions.
8320       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8321         two splices.
8322       * std: `str::from_bytes` renamed to `str::from_utf8`.
8323       * std: `pop_opt` and `shift_opt` methods added to vectors.
8324       * std: The task-local data interface no longer uses @, and keys are
8325         no longer function pointers.
8326       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8327       * std: Added `SharedPort` to `comm`.
8328       * std: `Eq` has a default method for `ne`; only `eq` is required
8329         in implementations.
8330       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8331         is required in implementations.
8332       * std: `is_utf8` performance is improved, impacting many string functions.
8333       * std: `os::MemoryMap` provides cross-platform mmap.
8334       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8335         are not 'in-bounds' are considered undefined.
8336       * std: Many freestanding functions in `vec` removed in favor of methods.
8337       * std: Many freestanding functions on scalar types removed in favor of
8338         methods.
8339       * std: Many options to task builders were removed since they don't make
8340         sense in the new scheduler design.
8341       * std: More containers implement `FromIterator` so can be created by the
8342         `collect` method.
8343       * std: More complete atomic types in `unstable::atomics`.
8344       * std: `comm::PortSet` removed.
8345       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8346         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8347         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8348         default implementations.
8349       * std: Various `from_str` functions were removed in favor of a generic
8350         `from_str` which is available in the prelude.
8351       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8352       * extra: `dlist`, the doubly-linked list was modernized.
8353       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8354       * extra: Added `glob` module, replacing `std::os::glob`.
8355       * extra: `rope` was removed.
8356       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8357       * extra: `net`, and `timer` were removed. The experimental replacements
8358         are `std::rt::io::net` and `std::rt::io::timer`.
8359       * extra: Iterators implemented for `SmallIntMap`.
8360       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8361       * extra: `SmallIntSet` removed. Use `BitvSet`.
8362       * extra: Performance of JSON parsing greatly improved.
8363       * extra: `semver` updated to SemVer 2.0.0.
8364       * extra: `term` handles more terminals correctly.
8365       * extra: `dbg` module removed.
8366       * extra: `par` module removed.
8367       * extra: `future` was cleaned up, with some method renames.
8368       * extra: Most free functions in `getopts` were converted to methods.
8369
8370    * Other
8371       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8372       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8373         similarly to gcc's `--march` flag.
8374       * rustc's performance compiling small crates is much better.
8375       * rustpkg has received many improvements.
8376       * rustpkg supports git tags as package IDs.
8377       * rustpkg builds into target-specific directories so it can be used for
8378         cross-compiling.
8379       * The number of concurrent test tasks is controlled by the environment
8380         variable RUST_TEST_TASKS.
8381       * The test harness can now report metrics for benchmarks.
8382       * All tools have man pages.
8383       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8384       * The runtime uses jemalloc for allocations.
8385       * Segmented stacks are temporarily disabled as part of the transition to
8386         the new runtime. Stack overflows are possible!
8387       * A new documentation backend, rustdoc_ng, is available for use. It is
8388         still invoked through the normal `rustdoc` command.
8389
8390
8391 Version 0.7 (2013-07-03)
8392 =======================
8393
8394    * ~2000 changes, numerous bugfixes
8395
8396    * Language
8397       * `impl`s no longer accept a visibility qualifier. Put them on methods
8398         instead.
8399       * The borrow checker has been rewritten with flow-sensitivity, fixing
8400         many bugs and inconveniences.
8401       * The `self` parameter no longer implicitly means `&'self self`,
8402         and can be explicitly marked with a lifetime.
8403       * Overloadable compound operators (`+=`, etc.) have been temporarily
8404         removed due to bugs.
8405       * The `for` loop protocol now requires `for`-iterators to return `bool`
8406         so they compose better.
8407       * The `Durable` trait is replaced with the `'static` bounds.
8408       * Trait default methods work more often.
8409       * Structs with the `#[packed]` attribute have byte alignment and
8410         no padding between fields.
8411       * Type parameters bound by `Copy` must now be copied explicitly with
8412         the `copy` keyword.
8413       * It is now illegal to move out of a dereferenced unsafe pointer.
8414       * `Option<~T>` is now represented as a nullable pointer.
8415       * `@mut` does dynamic borrow checks correctly.
8416       * The `main` function is only detected at the topmost level of the crate.
8417         The `#[main]` attribute is still valid anywhere.
8418       * Struct fields may no longer be mutable. Use inherited mutability.
8419       * The `#[no_send]` attribute makes a type that would otherwise be
8420         `Send`, not.
8421       * The `#[no_freeze]` attribute makes a type that would otherwise be
8422         `Freeze`, not.
8423       * Unbounded recursion will abort the process after reaching the limit
8424         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8425       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8426         are never implicitly copyable.
8427       * `#[static_assert]` makes compile-time assertions about static bools.
8428       * At long last, 'argument modes' no longer exist.
8429       * The rarely used `use mod` statement no longer exists.
8430
8431    * Syntax extensions
8432       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8433         argument list.
8434       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8435         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8436         `#[deriving(...)]`.
8437       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8438         and unsuffixed integer literals.
8439
8440    * Libraries
8441       * The `core` crate was renamed to `std`.
8442       * The `std` crate was renamed to `extra`.
8443       * More and improved documentation.
8444       * std: `iterator` module for external iterator objects.
8445       * Many old-style (internal, higher-order function) iterators replaced by
8446         implementations of `Iterator`.
8447       * std: Many old internal vector and string iterators,
8448         incl. `any`, `all`. removed.
8449       * std: The `finalize` method of `Drop` renamed to `drop`.
8450       * std: The `drop` method now takes `&mut self` instead of `&self`.
8451       * std: The prelude no longer re-exports any modules, only types and traits.
8452       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8453         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8454       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8455         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8456       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8457         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8458       * std: Many types implement `Clone`.
8459       * std: `path` type renamed to `Path`.
8460       * std: `mut` module and `Mut` type removed.
8461       * std: Many standalone functions removed in favor of methods and iterators
8462         in `vec`, `str`. In the future methods will also work as functions.
8463       * std: `reinterpret_cast` removed. Use `transmute`.
8464       * std: ascii string handling in `std::ascii`.
8465       * std: `Rand` is implemented for ~/@.
8466       * std: `run` module for spawning processes overhauled.
8467       * std: Various atomic types added to `unstable::atomic`.
8468       * std: Various types implement `Zero`.
8469       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8470       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8471       * std: Added `os::mkdir_recursive`.
8472       * std: Added `os::glob` function performs filesystems globs.
8473       * std: `FuzzyEq` renamed to `ApproxEq`.
8474       * std: `Map` now defines `pop` and `swap` methods.
8475       * std: `Cell` constructors converted to static methods.
8476       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8477       * extra: `flate` module moved from `std` to `extra`.
8478       * extra: `fileinput` module for iterating over a series of files.
8479       * extra: `Complex` number type and `complex` module.
8480       * extra: `Rational` number type and `rational` module.
8481       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8482       * extra: `term` uses terminfo now, is more correct.
8483       * extra: `arc` functions converted to methods.
8484       * extra: Implementation of fixed output size variations of SHA-2.
8485
8486    * Tooling
8487       * `unused_variables` lint mode for unused variables (default: warn).
8488       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8489         (default: warn).
8490       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8491         (default: warn).
8492       * `dead_assignment` lint mode for unread variables (default: warn).
8493       * `unnecessary_allocation` lint mode detects some heap allocations that are
8494         immediately borrowed so could be written without allocating (default: warn).
8495       * `missing_doc` lint mode (default: allow).
8496       * `unreachable_code` lint mode (default: warn).
8497       * The `rusti` command has been rewritten and a number of bugs addressed.
8498       * rustc outputs in color on more terminals.
8499       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8500       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8501       * Compiling with `-g` will make the binary record information about
8502         dynamic borrowcheck failures for debugging.
8503       * rustdoc has a nicer stylesheet.
8504       * Various improvements to rustdoc.
8505       * Improvements to rustpkg (see the detailed release notes).
8506
8507
8508 Version 0.6 (2013-04-03)
8509 ========================
8510
8511    * ~2100 changes, numerous bugfixes
8512
8513    * Syntax changes
8514       * The self type parameter in traits is now spelled `Self`
8515       * The `self` parameter in trait and impl methods must now be explicitly
8516         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8517       * Static methods no longer require the `static` keyword and instead
8518         are distinguished by the lack of a `self` parameter
8519       * Replaced the `Durable` trait with the `'static` lifetime
8520       * The old closure type syntax with the trailing sigil has been
8521         removed in favor of the more consistent leading sigil
8522       * `super` is a keyword, and may be prefixed to paths
8523       * Trait bounds are separated with `+` instead of whitespace
8524       * Traits are implemented with `impl Trait for Type`
8525         instead of `impl Type: Trait`
8526       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8527       * The `export` keyword has finally been removed
8528       * The `move` keyword has been removed (see "Semantic changes")
8529       * The interior mutability qualifier on vectors, `[mut T]`, has been
8530         removed. Use `&mut [T]`, etc.
8531       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8532       * `fail` is no longer a keyword. Use `fail!()`
8533       * `assert` is no longer a keyword. Use `assert!()`
8534       * `log` is no longer a keyword. use `debug!`, etc.
8535       * 1-tuples may be represented as `(T,)`
8536       * Struct fields may no longer be `mut`. Use inherited mutability,
8537         `@mut T`, `core::mut` or `core::cell`
8538       * `extern mod { ... }` is no longer valid syntax for foreign
8539         function modules. Use extern blocks: `extern { ... }`
8540       * Newtype enums removed. Use tuple-structs.
8541       * Trait implementations no longer support visibility modifiers
8542       * Pattern matching over vectors improved and expanded
8543       * `const` renamed to `static` to correspond to lifetime name,
8544         and make room for future `static mut` unsafe mutable globals.
8545       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8546       * `Clone` implementations can be automatically generated with
8547         `#[deriving(Clone)]`
8548       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8549         instead of `foo as Bar`.
8550       * Fixed length vector types are now written as `[int, .. 3]`
8551         instead of `[int * 3]`.
8552       * Fixed length vector types can express the length as a constant
8553         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8554
8555    * Semantic changes
8556       * Types with owned pointers or custom destructors move by default,
8557         eliminating the `move` keyword
8558       * All foreign functions are considered unsafe
8559       * &mut is now unaliasable
8560       * Writes to borrowed @mut pointers are prevented dynamically
8561       * () has size 0
8562       * The name of the main function can be customized using #[main]
8563       * The default type of an inferred closure is &fn instead of @fn
8564       * `use` statements may no longer be "chained" - they cannot import
8565         identifiers imported by previous `use` statements
8566       * `use` statements are crate relative, importing from the "top"
8567         of the crate by default. Paths may be prefixed with `super::`
8568         or `self::` to change the search behavior.
8569       * Method visibility is inherited from the implementation declaration
8570       * Structural records have been removed
8571       * Many more types can be used in static items, including enums
8572         'static-lifetime pointers and vectors
8573       * Pattern matching over vectors improved and expanded
8574       * Typechecking of closure types has been overhauled to
8575         improve inference and eliminate unsoundness
8576       * Macros leave scope at the end of modules, unless that module is
8577         tagged with #[macro_escape]
8578
8579    * Libraries
8580       * Added big integers to `std::bigint`
8581       * Removed `core::oldcomm` module
8582       * Added pipe-based `core::comm` module
8583       * Numeric traits have been reorganized under `core::num`
8584       * `vec::slice` finally returns a slice
8585       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8586       * Containers reorganized around traits in `core::container`
8587       * `core::dvec` removed, `~[T]` is a drop-in replacement
8588       * `core::send_map` renamed to `core::hashmap`
8589       * `std::map` removed; replaced with `core::hashmap`
8590       * `std::treemap` reimplemented as an owned balanced tree
8591       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8592       * `core::trie` added as a fast ordered map for integer keys
8593       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8594       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8595         overload the comparison operators, whereas `TotalOrd` is used
8596         by certain container types
8597
8598    * Other
8599       * Replaced the 'cargo' package manager with 'rustpkg'
8600       * Added all-purpose 'rust' tool
8601       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8602       * rustc now *attempts* to offer spelling suggestions
8603       * Improved support for ARM and Android
8604       * Preliminary MIPS backend
8605       * Improved foreign function ABI implementation for x86, x86_64
8606       * Various memory usage improvements
8607       * Rust code may be embedded in foreign code under limited circumstances
8608       * Inline assembler supported by new asm!() syntax extension.
8609
8610
8611 Version 0.5 (2012-12-21)
8612 ===========================
8613
8614    * ~900 changes, numerous bugfixes
8615
8616    * Syntax changes
8617       * Removed `<-` move operator
8618       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8619       * Removed old fixed length vector syntax - `[T]/N`
8620       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8621       * Macros may now expand to items and statements
8622       * `a.b()` is always parsed as a method call, never as a field projection
8623       * `Eq` and `IterBytes` implementations can be automatically generated
8624         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8625       * Removed the special crate language for `.rc` files
8626       * Function arguments may consist of any irrefutable pattern
8627
8628    * Semantic changes
8629       * `&` and `~` pointers may point to objects
8630       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8631       * Enum variants may be structs
8632       * Destructors can be added to all nominal types with the Drop trait
8633       * Structs and nullary enum variants may be constants
8634       * Values that cannot be implicitly copied are now automatically moved
8635         without writing `move` explicitly
8636       * `&T` may now be coerced to `*T`
8637       * Coercions happen in `let` statements as well as function calls
8638       * `use` statements now take crate-relative paths
8639       * The module and type namespaces have been merged so that static
8640         method names can be resolved under the trait in which they are
8641         declared
8642
8643    * Improved support for language features
8644       * Trait inheritance works in many scenarios
8645       * More support for explicit self arguments in methods - `self`, `&self`
8646         `@self`, and `~self` all generally work as expected
8647       * Static methods work in more situations
8648       * Experimental: Traits may declare default methods for the implementations
8649         to use
8650
8651    * Libraries
8652       * New condition handling system in `core::condition`
8653       * Timsort added to `std::sort`
8654       * New priority queue, `std::priority_queue`
8655       * Pipes for serializable types, `std::flatpipes'
8656       * Serialization overhauled to be trait-based
8657       * Expanded `getopts` definitions
8658       * Moved futures to `std`
8659       * More functions are pure now
8660       * `core::comm` renamed to `oldcomm`. Still deprecated
8661       * `rustdoc` and `cargo` are libraries now
8662
8663    * Misc
8664       * Added a preliminary REPL, `rusti`
8665       * License changed from MIT to dual MIT/APL2
8666
8667
8668 Version 0.4 (2012-10-15)
8669 ==========================
8670
8671    * ~2000 changes, numerous bugfixes
8672
8673    * Syntax
8674       * All keywords are now strict and may not be used as identifiers anywhere
8675       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8676         'of', 'with', 'to', 'class'.
8677       * Classes are replaced with simpler structs
8678       * Explicit method self types
8679       * `ret` became `return` and `alt` became `match`
8680       * `import` is now `use`; `use is now `extern mod`
8681       * `extern mod { ... }` is now `extern { ... }`
8682       * `use mod` is the recommended way to import modules
8683       * `pub` and `priv` replace deprecated export lists
8684       * The syntax of `match` pattern arms now uses fat arrow (=>)
8685       * `main` no longer accepts an args vector; use `os::args` instead
8686
8687    * Semantics
8688       * Trait implementations are now coherent, ala Haskell typeclasses
8689       * Trait methods may be static
8690       * Argument modes are deprecated
8691       * Borrowed pointers are much more mature and recommended for use
8692       * Strings and vectors in the static region are stored in constant memory
8693       * Typestate was removed
8694       * Resolution rewritten to be more reliable
8695       * Support for 'dual-mode' data structures (freezing and thawing)
8696
8697    * Libraries
8698       * Most binary operators can now be overloaded via the traits in
8699         `core::ops'
8700       * `std::net::url` for representing URLs
8701       * Sendable hash maps in `core::send_map`
8702       * `core::task' gained a (currently unsafe) task-local storage API
8703
8704    * Concurrency
8705       * An efficient new intertask communication primitive called the pipe,
8706         along with a number of higher-level channel types, in `core::pipes`
8707       * `std::arc`, an atomically reference counted, immutable, shared memory
8708         type
8709       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8710       * Futures are now based on pipes and sendable
8711       * More robust linked task failure
8712       * Improved task builder API
8713
8714    * Other
8715       * Improved error reporting
8716       * Preliminary JIT support
8717       * Preliminary work on precise GC
8718       * Extensive architectural improvements to rustc
8719       * Begun a transition away from buggy C++-based reflection (shape) code to
8720         Rust-based (visitor) code
8721       * All hash functions and tables converted to secure, randomized SipHash
8722
8723
8724 Version 0.3  (2012-07-12)
8725 ========================
8726
8727    * ~1900 changes, numerous bugfixes
8728
8729    * New coding conveniences
8730       * Integer-literal suffix inference
8731       * Per-item control over warnings, errors
8732       * #[cfg(windows)] and #[cfg(unix)] attributes
8733       * Documentation comments
8734       * More compact closure syntax
8735       * 'do' expressions for treating higher-order functions as
8736         control structures
8737       * *-patterns (wildcard extended to all constructor fields)
8738
8739    * Semantic cleanup
8740       * Name resolution pass and exhaustiveness checker rewritten
8741       * Region pointers and borrow checking supersede alias
8742         analysis
8743       * Init-ness checking is now provided by a region-based liveness
8744         pass instead of the typestate pass; same for last-use analysis
8745       * Extensive work on region pointers
8746
8747    * Experimental new language features
8748       * Slices and fixed-size, interior-allocated vectors
8749       * #!-comments for lang versioning, shell execution
8750       * Destructors and iface implementation for classes;
8751         type-parameterized classes and class methods
8752       * 'const' type kind for types that can be used to implement
8753         shared-memory concurrency patterns
8754
8755    * Type reflection
8756
8757    * Removal of various obsolete features
8758       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8759                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8760
8761       * Constructs: do-while loops ('do' repurposed), fn binding,
8762                     resources (replaced by destructors)
8763
8764    * Compiler reorganization
8765       * Syntax-layer of compiler split into separate crate
8766       * Clang (from LLVM project) integrated into build
8767       * Typechecker split into sub-modules
8768
8769    * New library code
8770       * New time functions
8771       * Extension methods for many built-in types
8772       * Arc: atomic-refcount read-only / exclusive-use shared cells
8773       * Par: parallel map and search routines
8774       * Extensive work on libuv interface
8775       * Much vector code moved to libraries
8776       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8777         #include, #include_str, #include_bin
8778
8779    * Tool improvements
8780       * Cargo automatically resolves dependencies
8781
8782
8783 Version 0.2  (2012-03-29)
8784 =========================
8785
8786    * >1500 changes, numerous bugfixes
8787
8788    * New docs and doc tooling
8789
8790    * New port: FreeBSD x86_64
8791
8792    * Compilation model enhancements
8793       * Generics now specialized, multiply instantiated
8794       * Functions now inlined across separate crates
8795
8796    * Scheduling, stack and threading fixes
8797       * Noticeably improved message-passing performance
8798       * Explicit schedulers
8799       * Callbacks from C
8800       * Helgrind clean
8801
8802    * Experimental new language features
8803       * Operator overloading
8804       * Region pointers
8805       * Classes
8806
8807    * Various language extensions
8808       * C-callback function types: 'crust fn ...'
8809       * Infinite-loop construct: 'loop { ... }'
8810       * Shorten 'mutable' to 'mut'
8811       * Required mutable-local qualifier: 'let mut ...'
8812       * Basic glob-exporting: 'export foo::*;'
8813       * Alt now exhaustive, 'alt check' for runtime-checked
8814       * Block-function form of 'for' loop, with 'break' and 'ret'.
8815
8816    * New library code
8817       * AST quasi-quote syntax extension
8818       * Revived libuv interface
8819       * New modules: core::{future, iter}, std::arena
8820       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8821       * Extensive cleanup, regularization in libstd, libcore
8822
8823
8824 Version 0.1  (2012-01-20)
8825 ===============================
8826
8827    * Most language features work, including:
8828       * Unique pointers, unique closures, move semantics
8829       * Interface-constrained generics
8830       * Static interface dispatch
8831       * Stack growth
8832       * Multithread task scheduling
8833       * Typestate predicates
8834       * Failure unwinding, destructors
8835       * Pattern matching and destructuring assignment
8836       * Lightweight block-lambda syntax
8837       * Preliminary macro-by-example
8838
8839    * Compiler works with the following configurations:
8840       * Linux: x86 and x86_64 hosts and targets
8841       * macOS: x86 and x86_64 hosts and targets
8842       * Windows: x86 hosts and targets
8843
8844    * Cross compilation / multi-target configuration supported.
8845
8846    * Preliminary API-documentation and package-management tools included.
8847
8848 Known issues:
8849
8850    * Documentation is incomplete.
8851
8852    * Performance is below intended target.
8853
8854    * Standard library APIs are subject to extensive change, reorganization.
8855
8856    * Language-level versioning is not yet operational - future code will
8857      break unexpectedly.