]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Auto merge of #51555 - ccesare:remove_unused_variables_redox_os, r=kennytm
[rust.git] / RELEASES.md
1 Version 1.27.0 (2018-06-21)
2 ==========================
3
4 Language
5 --------
6 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
7   be used as an identifer.
8 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
9   bare `Trait` syntax, and should make it clearer when being used in tandem with
10   `impl Trait`. Since it is equivalent to the following syntax:
11   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
12   `Box<Trait> == Box<dyn Trait>`.
13 - [Attributes on generic parameters such as types and lifetimes are
14   now stable.][48851] e.g.
15   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
16 - [The `#[must_use]` attribute can now also be used on functions as well as
17   types.][48925] It provides a lint that by default warns users when the
18   value returned by a function has not been used.
19
20 Compiler
21 --------
22 - [Added the `armv5te-unknown-linux-musl` target.][50423]
23
24 Libraries
25 ---------
26 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
27   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
28   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
29   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
30   the `cfg` attribute.
31 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
32   std are now available in core.][49896]
33 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
34   to `Self`.][49630]
35 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
36   that the operation isn't done in place.
37 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
38   the `#[must_use]` attribute][49533] to warn about unused potentially
39   expensive allocations.
40
41 Stabilized APIs
42 ---------------
43 - [`DoubleEndedIterator::rfind`]
44 - [`DoubleEndedIterator::rfold`]
45 - [`DoubleEndedIterator::try_rfold`]
46 - [`Duration::from_micros`]
47 - [`Duration::from_nanos`]
48 - [`Duration::subsec_micros`]
49 - [`Duration::subsec_millis`]
50 - [`HashMap::remove_entry`]
51 - [`Iterator::try_fold`]
52 - [`Iterator::try_for_each`]
53 - [`NonNull::cast`]
54 - [`Option::filter`]
55 - [`String::replace_range`]
56 - [`Take::set_limit`]
57 - [`hint::unreachable_unchecked`]
58 - [`os::unix::process::parent_id`]
59 - [`process::id`]
60 - [`ptr::swap_nonoverlapping`]
61 - [`slice::rsplit_mut`]
62 - [`slice::rsplit`]
63 - [`slice::swap_with_slice`]
64
65 Cargo
66 -----
67 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
68   `readme`, and `repository` fields.][cargo/5386]
69 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
70   a different directory than `target` for placing compilation artifacts.
71 - [Cargo will be adding automatic target inference for binaries, benchmarks,
72   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
73   specific targets e.g. using `[[bin]]` and have other binaries in locations
74   where cargo would infer a binary, Cargo will produce a warning. You can
75   disable this feature ahead of time by setting any of the following `autobins`,
76   `autobenches`, `autoexamples`, `autotests` to false.
77 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
78   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
79
80 Misc
81 ----
82 - [Added “The Rustc book” into the official documentation.][49707]
83   [“The Rustc book”] documents and teaches how to use the rustc compiler.
84 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
85
86 Compatibility Notes
87 -------------------
88 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
89   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
90   compile, `"".is_empty()` will still compile.
91 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
92   will only print the inner type.][48553] e.g.
93   `print!("{:?}", AtomicBool::new(true))` will print `true`
94   not `AtomicBool(true)`.
95 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
96   could enter higher numbers but they were not supported by LLVM. Up to 512MB
97   alignment should cover all use cases.
98
99 [48553]: https://github.com/rust-lang/rust/pull/48553/
100 [48851]: https://github.com/rust-lang/rust/pull/48851/
101 [48925]: https://github.com/rust-lang/rust/pull/48925/
102 [49533]: https://github.com/rust-lang/rust/pull/49533/
103 [49623]: https://github.com/rust-lang/rust/pull/49623/
104 [49630]: https://github.com/rust-lang/rust/pull/49630/
105 [49664]: https://github.com/rust-lang/rust/pull/49664/
106 [49699]: https://github.com/rust-lang/rust/pull/49699/
107 [49707]: https://github.com/rust-lang/rust/pull/49707/
108 [49719]: https://github.com/rust-lang/rust/pull/49719/
109 [49896]: https://github.com/rust-lang/rust/pull/49896/
110 [49968]: https://github.com/rust-lang/rust/pull/49968/
111 [50177]: https://github.com/rust-lang/rust/pull/50177/
112 [50378]: https://github.com/rust-lang/rust/pull/50378/
113 [50398]: https://github.com/rust-lang/rust/pull/50398/
114 [50423]: https://github.com/rust-lang/rust/pull/50423/
115 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
116 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
117 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
118 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
119 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
120 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
121 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
122 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
123 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
124 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
125 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
126 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
127 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
128 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
129 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
130 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
131 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
132 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
133 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
134 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
135 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
136 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
137 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
138 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
139 [`fs::read`]:
140 [`fs::write`]:
141 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
142 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
143 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
144 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
145 [“The Rustc book”]: https://doc.rust-lang.org/rustc
146
147
148 Version 1.26.2 (2018-06-05)
149 ==========================
150
151 Compatibility Notes
152 -------------------
153
154 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics][51117]
155
156 [51117]: https://github.com/rust-lang/rust/issues/51117
157
158
159 Version 1.26.1 (2018-05-29)
160 ==========================
161
162 Tools
163 -----
164
165 - [RLS now works on Windows][50646]
166 - [Rustfmt stopped badly formatting text in some cases][rustfmt/2695]
167
168
169 Compatibility Notes
170 --------
171
172 - [`fn main() -> impl Trait` no longer works for non-Termination
173   trait][50656]
174   This reverts an accidental stabilization.
175 - [`NaN > NaN` no longer returns true in const-fn contexts][50812]
176 - [Prohibit using turbofish for `impl Trait` in method arguments][50950]
177
178 [50646]: https://github.com/rust-lang/rust/issues/50646
179 [50656]: https://github.com/rust-lang/rust/pull/50656
180 [50812]: https://github.com/rust-lang/rust/pull/50812
181 [50950]: https://github.com/rust-lang/rust/issues/50950
182 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
183
184 Version 1.26.0 (2018-05-10)
185 ==========================
186
187 Language
188 --------
189 - [Closures now implement `Copy` and/or `Clone` if all captured variables
190   implement either or both traits.][49299]
191 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
192 - [Stablise `'_`. The underscore lifetime can be used anywhere where a
193   lifetime can be elided.][49458]
194 - [`impl Trait` is now stable allowing you to have abstract types in returns
195    or in function parameters.][49255] e.g. `fn foo() -> impl Iterator<Item=u8>` or
196   `fn open(path: impl AsRef<Path>)`.
197 - [Pattern matching will now automatically apply dereferences.][49394]
198 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
199 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
200 - [A lot of operations are now available in a const context.][46882] E.g. You
201   can now index into constant arrays, reference and dereference into constants,
202   and use Tuple struct constructors.
203 - [Fixed entry slice patterns are now stable.][48516] e.g.
204   ```rust
205   let points = [1, 2, 3, 4];
206   match points {
207       [1, 2, 3, 4] => println!("All points were sequential."),
208       _ => println!("Not all points were sequential."),
209   }
210   ```
211
212
213 Compiler
214 --------
215 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
216 - [Fixed exponential projection complexity on nested types.][48296]
217   This can provide up to a ~12% reduction in compile times for certain crates.
218 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
219   to remap path prefixes outputted by the compiler.
220 - [Added `powerpc-unknown-netbsd` target.][48281]
221
222 Libraries
223 ---------
224 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
225 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
226   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
227 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
228 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
229 - [`ascii::escape_default` is now available in libcore.][48735]
230 - [Trailing commas are now supported in std and core macros.][48056]
231 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
232 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
233
234 Stabilized APIs
235 ---------------
236 - [`*const T::add`]
237 - [`*const T::copy_to_nonoverlapping`]
238 - [`*const T::copy_to`]
239 - [`*const T::read_unaligned`]
240 - [`*const T::read_volatile`]
241 - [`*const T::read`]
242 - [`*const T::sub`]
243 - [`*const T::wrapping_add`]
244 - [`*const T::wrapping_sub`]
245 - [`*mut T::add`]
246 - [`*mut T::copy_to_nonoverlapping`]
247 - [`*mut T::copy_to`]
248 - [`*mut T::read_unaligned`]
249 - [`*mut T::read_volatile`]
250 - [`*mut T::read`]
251 - [`*mut T::replace`]
252 - [`*mut T::sub`]
253 - [`*mut T::swap`]
254 - [`*mut T::wrapping_add`]
255 - [`*mut T::wrapping_sub`]
256 - [`*mut T::write_bytes`]
257 - [`*mut T::write_unaligned`]
258 - [`*mut T::write_volatile`]
259 - [`*mut T::write`]
260 - [`Box::leak`]
261 - [`FromUtf8Error::as_bytes`]
262 - [`LocalKey::try_with`]
263 - [`Option::cloned`]
264 - [`btree_map::Entry::and_modify`]
265 - [`fs::read_to_string`]
266 - [`fs::read`]
267 - [`fs::write`]
268 - [`hash_map::Entry::and_modify`]
269 - [`iter::FusedIterator`]
270 - [`ops::RangeInclusive`]
271 - [`ops::RangeToInclusive`]
272 - [`process::id`]
273 - [`slice::rotate_left`]
274 - [`slice::rotate_right`]
275 - [`String::retain`]
276
277
278 Cargo
279 -----
280 - [Cargo will now output path to custom commands when `-v` is
281   passed with `--list`][cargo/5041]
282 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
283
284 Misc
285 ----
286 - [The second edition of "The Rust Programming Language" book is now recommended
287   over the first.][48404]
288
289 Compatibility Notes
290 -------------------
291
292 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
293   syntax is now invalid.
294   ```
295   use std::ops::Fn as dyn;
296   fn g(_: Box<dyn(std::fmt::Debug)>) {}
297   ```
298 - [The result of dereferences are no longer promoted to `'static`.][47408]
299   e.g.
300   ```rust
301   fn main() {
302       const PAIR: &(i32, i32) = &(0, 1);
303       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
304   }
305   ```
306 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
307 - [`".e0"` will now no longer parse as `0.0` and will instead cause
308   an error.][48235]
309 - [Removed hoedown from rustdoc.][48274]
310 - [Bounds on higher-kinded lifetimes a hard error.][48326]
311
312 [46882]: https://github.com/rust-lang/rust/pull/46882
313 [47379]: https://github.com/rust-lang/rust/pull/47379
314 [47408]: https://github.com/rust-lang/rust/pull/47408
315 [47813]: https://github.com/rust-lang/rust/pull/47813
316 [48056]: https://github.com/rust-lang/rust/pull/48056
317 [48125]: https://github.com/rust-lang/rust/pull/48125
318 [48166]: https://github.com/rust-lang/rust/pull/48166
319 [48235]: https://github.com/rust-lang/rust/pull/48235
320 [48274]: https://github.com/rust-lang/rust/pull/48274
321 [48281]: https://github.com/rust-lang/rust/pull/48281
322 [48296]: https://github.com/rust-lang/rust/pull/48296
323 [48326]: https://github.com/rust-lang/rust/pull/48326
324 [48359]: https://github.com/rust-lang/rust/pull/48359
325 [48404]: https://github.com/rust-lang/rust/pull/48404
326 [48481]: https://github.com/rust-lang/rust/pull/48481
327 [48516]: https://github.com/rust-lang/rust/pull/48516
328 [48628]: https://github.com/rust-lang/rust/pull/48628
329 [48629]: https://github.com/rust-lang/rust/pull/48629
330 [48657]: https://github.com/rust-lang/rust/pull/48657
331 [48735]: https://github.com/rust-lang/rust/pull/48735
332 [48978]: https://github.com/rust-lang/rust/pull/48978
333 [49101]: https://github.com/rust-lang/rust/pull/49101
334 [49109]: https://github.com/rust-lang/rust/pull/49109
335 [49121]: https://github.com/rust-lang/rust/pull/49121
336 [49162]: https://github.com/rust-lang/rust/pull/49162
337 [49184]: https://github.com/rust-lang/rust/pull/49184
338 [49234]: https://github.com/rust-lang/rust/pull/49234
339 [49255]: https://github.com/rust-lang/rust/pull/49255
340 [49299]: https://github.com/rust-lang/rust/pull/49299
341 [49305]: https://github.com/rust-lang/rust/pull/49305
342 [49394]: https://github.com/rust-lang/rust/pull/49394
343 [49458]: https://github.com/rust-lang/rust/pull/49458
344 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
345 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
346 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
347 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
348 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
349 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
350 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
351 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
352 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
353 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
354 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
355 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
356 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
357 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
358 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
359 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
360 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
361 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
362 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
363 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
364 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
365 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
366 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
367 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
368 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
369 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
370 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
371 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
372 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
373 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
374 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
375 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
376 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
377 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
378 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
379 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
380 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
381 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
382 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
383 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
384 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
385 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
386
387
388 Version 1.25.0 (2018-03-29)
389 ==========================
390
391 Language
392 --------
393 - [Stabilised `#[repr(align(x))]`.][47006] [RFC 1358]
394 - [You can now use nested groups of imports.][47948]
395   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
396 - [You can now have `|` at the start of a match arm.][47947] e.g.
397 ```rust
398 enum Foo { A, B, C }
399
400 fn main() {
401     let x = Foo::A;
402     match x {
403         | Foo::A
404         | Foo::B => println!("AB"),
405         | Foo::C => println!("C"),
406     }
407 }
408 ```
409
410 Compiler
411 --------
412 - [Upgraded to LLVM 6.][47828]
413 - [Added `-C lto=val` option.][47521]
414 - [Added `i586-unknown-linux-musl` target][47282]
415
416 Libraries
417 ---------
418 - [Impl Send for `process::Command` on Unix.][47760]
419 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
420 - [`UnsafeCell::into_inner` is now safe.][47204]
421 - [Implement libstd for CloudABI.][47268]
422 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
423 - [Implement `AsRef<Path>` for Component][46985]
424 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
425 - [Moved `Duration` to libcore.][46666]
426
427 Stabilized APIs
428 ---------------
429 - [`Location::column`]
430 - [`ptr::NonNull`]
431
432 The following functions can now be used in a constant expression.
433 eg. `static MINUTE: Duration = Duration::from_secs(60);`
434 - [`Duration::new`][47300]
435 - [`Duration::from_secs`][47300]
436 - [`Duration::from_millis`][47300]
437
438 Cargo
439 -----
440 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
441 - [`cargo new` now defaults to creating a binary crate, instead of a
442   library crate.][cargo/5029]
443
444 Misc
445 ----
446 - [Rust by example is now shipped with new releases][46196]
447
448 Compatibility Notes
449 -------------------
450 - [Deprecated `net::lookup_host`.][47510]
451 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
452 - The borrow checker was sometimes incorrectly permitting overlapping borrows
453   around indexing operations (see [#47349][47349]). This has been fixed (which also
454   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
455 - [Removed deprecated unstable attribute `#[simd]`.][47251]
456
457 [33903]: https://github.com/rust-lang/rust/pull/33903
458 [47947]: https://github.com/rust-lang/rust/pull/47947
459 [47948]: https://github.com/rust-lang/rust/pull/47948
460 [47760]: https://github.com/rust-lang/rust/pull/47760
461 [47790]: https://github.com/rust-lang/rust/pull/47790
462 [47828]: https://github.com/rust-lang/rust/pull/47828
463 [47398]: https://github.com/rust-lang/rust/pull/47398
464 [47510]: https://github.com/rust-lang/rust/pull/47510
465 [47521]: https://github.com/rust-lang/rust/pull/47521
466 [47204]: https://github.com/rust-lang/rust/pull/47204
467 [47251]: https://github.com/rust-lang/rust/pull/47251
468 [47268]: https://github.com/rust-lang/rust/pull/47268
469 [47282]: https://github.com/rust-lang/rust/pull/47282
470 [47300]: https://github.com/rust-lang/rust/pull/47300
471 [47349]: https://github.com/rust-lang/rust/pull/47349
472 [46931]: https://github.com/rust-lang/rust/pull/46931
473 [46985]: https://github.com/rust-lang/rust/pull/46985
474 [47006]: https://github.com/rust-lang/rust/pull/47006
475 [46830]: https://github.com/rust-lang/rust/pull/46830
476 [46095]: https://github.com/rust-lang/rust/pull/46095
477 [46666]: https://github.com/rust-lang/rust/pull/46666
478 [46196]: https://github.com/rust-lang/rust/pull/46196
479 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
480 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
481 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
482 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
483 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
484
485
486 Version 1.24.1 (2018-03-01)
487 ==========================
488
489  - [Do not abort when unwinding through FFI][48251]
490  - [Emit UTF-16 files for linker arguments on Windows][48318]
491  - [Make the error index generator work again][48308]
492  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
493
494 [48251]: https://github.com/rust-lang/rust/issues/48251
495 [48308]: https://github.com/rust-lang/rust/issues/48308
496 [48318]: https://github.com/rust-lang/rust/issues/48318
497 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
498
499
500 Version 1.24.0 (2018-02-15)
501 ==========================
502
503 Language
504 --------
505 - [External `sysv64` ffi is now available.][46528]
506   eg. `extern "sysv64" fn foo () {}`
507
508 Compiler
509 --------
510 - [rustc now uses 16 codegen units by default for release builds.][46910]
511   For the fastest builds, utilize `codegen-units=1`.
512 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
513 - [Add `aarch64-unknown-openbsd` support][46760]
514
515 Libraries
516 ---------
517 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
518   improvement in performance in the majority of cases.
519 - [`OsStr`'s `Debug` implementation is now lossless and consistent
520   with Windows.][46798]
521 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
522 - [impl `From<bool>` for `AtomicBool`][46293]
523 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
524 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
525 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
526 - [float::from_bits now just uses transmute.][46012] This provides
527   some optimisations from LLVM.
528 - [Copied `AsciiExt` methods onto `char`][46077]
529 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
530 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
531 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
532 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
533
534 Stabilized APIs
535 ---------------
536 - [`RefCell::replace`]
537 - [`RefCell::swap`]
538 - [`atomic::spin_loop_hint`]
539
540 The following functions can now be used in a constant expression.
541 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
542
543 - [`AtomicBool::new`][46287]
544 - [`AtomicUsize::new`][46287]
545 - [`AtomicIsize::new`][46287]
546 - [`AtomicPtr::new`][46287]
547 - [`Cell::new`][46287]
548 - [`{integer}::min_value`][46287]
549 - [`{integer}::max_value`][46287]
550 - [`mem::size_of`][46287]
551 - [`mem::align_of`][46287]
552 - [`ptr::null`][46287]
553 - [`ptr::null_mut`][46287]
554 - [`RefCell::new`][46287]
555 - [`UnsafeCell::new`][46287]
556
557 Cargo
558 -----
559 - [Added a `workspace.default-members` config that
560   overrides implied `--all` in virtual workspaces.][cargo/4743]
561 - [Enable incremental by default on development builds.][cargo/4817] Also added
562   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
563   per-project or global basis respectively.
564
565 Misc
566 ----
567
568 Compatibility Notes
569 -------------------
570 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
571 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
572   in accordance with IETF RFC 4291 §2.2.
573 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
574 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
575   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
576 - [Leading zeros in tuple struct members is now an error][47084]
577 - [`column!()` macro is one-based instead of zero-based][46977]
578 - [`fmt::Arguments` can no longer be shared across threads][45198]
579 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
580 - [Cargo sets a different working directory for the compiler][cargo/4788]
581
582 [44884]: https://github.com/rust-lang/rust/pull/44884
583 [45198]: https://github.com/rust-lang/rust/pull/45198
584 [45506]: https://github.com/rust-lang/rust/pull/45506
585 [45904]: https://github.com/rust-lang/rust/pull/45904
586 [45990]: https://github.com/rust-lang/rust/pull/45990
587 [46012]: https://github.com/rust-lang/rust/pull/46012
588 [46077]: https://github.com/rust-lang/rust/pull/46077
589 [46094]: https://github.com/rust-lang/rust/pull/46094
590 [46284]: https://github.com/rust-lang/rust/pull/46284
591 [46287]: https://github.com/rust-lang/rust/pull/46287
592 [46293]: https://github.com/rust-lang/rust/pull/46293
593 [46528]: https://github.com/rust-lang/rust/pull/46528
594 [46671]: https://github.com/rust-lang/rust/pull/46671
595 [46713]: https://github.com/rust-lang/rust/pull/46713
596 [46735]: https://github.com/rust-lang/rust/pull/46735
597 [46749]: https://github.com/rust-lang/rust/pull/46749
598 [46760]: https://github.com/rust-lang/rust/pull/46760
599 [46798]: https://github.com/rust-lang/rust/pull/46798
600 [46828]: https://github.com/rust-lang/rust/pull/46828
601 [46831]: https://github.com/rust-lang/rust/pull/46831
602 [46833]: https://github.com/rust-lang/rust/pull/46833
603 [46910]: https://github.com/rust-lang/rust/pull/46910
604 [46977]: https://github.com/rust-lang/rust/pull/46977
605 [47018]: https://github.com/rust-lang/rust/pull/47018
606 [47080]: https://github.com/rust-lang/rust/pull/47080
607 [47084]: https://github.com/rust-lang/rust/pull/47084
608 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
609 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
610 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
611 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
612 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
613 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
614
615
616 Version 1.23.0 (2018-01-04)
617 ==========================
618
619 Language
620 --------
621 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
622 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
623   Which should fix some confusing errors in some operations.
624
625 Compiler
626 --------
627 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
628   undefined behaviour.][45920]
629 - [rustc now suggests renaming import if names clash.][45660]
630 - [Display errors/warnings correctly when there are zero-width or
631   wide characters.][45711]
632 - [rustc now avoids unnecessary copies of arguments that are
633   simple bindings][45380] This should improve memory usage on average by 5-10%.
634 - [Updated musl used to build musl rustc to 1.1.17][45393]
635
636 Libraries
637 ---------
638 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
639 - [Implement Hash for raw pointers to unsized types][45483]
640 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
641 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
642 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
643 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
644   and `<*mut T>::as_mut`][44932]
645 - [Optimized `Thread::{park, unpark}` implementation][45524]
646 - [Improved `SliceExt::binary_search` performance.][45333]
647 - [impl `FromIterator<()>` for `()`][45379]
648 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
649   is now deprecated.
650
651 Stabilized APIs
652 ---------------
653
654 Cargo
655 -----
656 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
657   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
658 - [Added unit test checking to `cargo check`][cargo/4592]
659 - [Cargo now lets you install a specific version
660   using `cargo install --version`][cargo/4637]
661
662 Misc
663 ----
664 - [Releases now ship with the Cargo book documentation.][45692]
665 - [rustdoc now prints rendering warnings on every run.][45324]
666
667 Compatibility Notes
668 -------------------
669 - [Changes have been made to type equality to make it more correct,
670   in rare cases this could break some code.][45853] [Tracking issue for
671   further information][45852]
672 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
673 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
674   Android 9, the minimum supported version is Android 14.
675 - [Bumped the minimum LLVM to 3.9][45326]
676
677 [44042]: https://github.com/rust-lang/rust/pull/44042
678 [44932]: https://github.com/rust-lang/rust/pull/44932
679 [45267]: https://github.com/rust-lang/rust/pull/45267
680 [45324]: https://github.com/rust-lang/rust/pull/45324
681 [45326]: https://github.com/rust-lang/rust/pull/45326
682 [45333]: https://github.com/rust-lang/rust/pull/45333
683 [45379]: https://github.com/rust-lang/rust/pull/45379
684 [45380]: https://github.com/rust-lang/rust/pull/45380
685 [45393]: https://github.com/rust-lang/rust/pull/45393
686 [45435]: https://github.com/rust-lang/rust/pull/45435
687 [45483]: https://github.com/rust-lang/rust/pull/45483
688 [45524]: https://github.com/rust-lang/rust/pull/45524
689 [45571]: https://github.com/rust-lang/rust/pull/45571
690 [45580]: https://github.com/rust-lang/rust/pull/45580
691 [45610]: https://github.com/rust-lang/rust/pull/45610
692 [45660]: https://github.com/rust-lang/rust/pull/45660
693 [45692]: https://github.com/rust-lang/rust/pull/45692
694 [45711]: https://github.com/rust-lang/rust/pull/45711
695 [45772]: https://github.com/rust-lang/rust/pull/45772
696 [45852]: https://github.com/rust-lang/rust/issues/45852
697 [45853]: https://github.com/rust-lang/rust/pull/45853
698 [45887]: https://github.com/rust-lang/rust/pull/45887
699 [45920]: https://github.com/rust-lang/rust/pull/45920
700 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
701 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
702 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
703
704
705 Version 1.22.1 (2017-11-22)
706 ==========================
707
708 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
709
710 [46183]: https://github.com/rust-lang/rust/pull/46183
711
712 Version 1.22.0 (2017-11-22)
713 ==========================
714
715 Language
716 --------
717 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
718 - [Now accepts underscores in unicode escapes][43716]
719 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
720 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
721
722 Compiler
723 --------
724 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
725 - [rustc will no longer inline in codegen units when compiling for debug][45075]
726   This should decrease compile times for debug builds.
727 - [strict memory alignment now enabled on ARMv6][45094]
728 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
729
730 Libraries
731 ---------
732 - [Allow atomic operations up to 32 bits
733   on `armv5te_unknown_linux_gnueabi`][44978]
734 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
735 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
736 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
737 - [Properly detect overflow in `Instant += Duration`.][44220]
738 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
739 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
740 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
741
742 Stabilized APIs
743 ---------------
744
745 Cargo
746 -----
747 - [Cargo will now build multi file examples in subdirectories of the `examples`
748   folder that have a `main.rs` file.][cargo/4496]
749 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
750   the old format will continue to work and can be updated with `cargo update`.
751 - [Now supports vendoring git repositories][cargo/3992]
752
753 Misc
754 ----
755 - [`libbacktrace` is now available on Apple platforms.][44251]
756 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
757   This now lets you specify that a given code example will fail to compile.
758
759 Compatibility Notes
760 -------------------
761 - [The minimum Android version that rustc can build for has been bumped
762   to `4.0` from `2.3`][45656]
763 - [Allowing `T op= &T` for numeric types has broken some type
764   inference cases][45480]
765
766
767 [42526]: https://github.com/rust-lang/rust/pull/42526
768 [43017]: https://github.com/rust-lang/rust/pull/43017
769 [43716]: https://github.com/rust-lang/rust/pull/43716
770 [43949]: https://github.com/rust-lang/rust/pull/43949
771 [44015]: https://github.com/rust-lang/rust/pull/44015
772 [44220]: https://github.com/rust-lang/rust/pull/44220
773 [44251]: https://github.com/rust-lang/rust/pull/44251
774 [44287]: https://github.com/rust-lang/rust/pull/44287
775 [44303]: https://github.com/rust-lang/rust/pull/44303
776 [44456]: https://github.com/rust-lang/rust/pull/44456
777 [44466]: https://github.com/rust-lang/rust/pull/44466
778 [44895]: https://github.com/rust-lang/rust/pull/44895
779 [44966]: https://github.com/rust-lang/rust/pull/44966
780 [44978]: https://github.com/rust-lang/rust/pull/44978
781 [45041]: https://github.com/rust-lang/rust/pull/45041
782 [45064]: https://github.com/rust-lang/rust/pull/45064
783 [45075]: https://github.com/rust-lang/rust/pull/45075
784 [45094]: https://github.com/rust-lang/rust/pull/45094
785 [45095]: https://github.com/rust-lang/rust/pull/45095
786 [45480]: https://github.com/rust-lang/rust/issues/45480
787 [45656]: https://github.com/rust-lang/rust/pull/45656
788 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
789 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
790 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
791
792
793
794
795
796
797 Version 1.21.0 (2017-10-12)
798 ==========================
799
800 Language
801 --------
802 - [You can now use static references for literals.][43838]
803   Example:
804   ```rust
805   fn main() {
806       let x: &'static u32 = &0;
807   }
808   ```
809 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
810   Example:
811   ```rust
812   my_macro!(Vec<i32>::new); // Always worked
813   my_macro!(Vec::<i32>::new); // Now works
814   ```
815
816 Compiler
817 --------
818 - [Upgraded jemalloc to 4.5.0][43911]
819 - [Enabled unwinding panics on Redox][43917]
820 - [Now runs LLVM in parallel during translation phase.][43506]
821   This should reduce peak memory usage.
822
823 Libraries
824 ---------
825 - [Generate builtin impls for `Clone` for all arrays and tuples that
826   are `T: Clone`][43690]
827 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
828 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
829   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
830
831 Stabilized APIs
832 ---------------
833
834 [`std::mem::discriminant`]
835
836 Cargo
837 -----
838 - [You can now call `cargo install` with multiple package names][cargo/4216]
839 - [Cargo commands inside a virtual workspace will now implicitly
840   pass `--all`][cargo/4335]
841 - [Added a `[patch]` section to `Cargo.toml` to handle
842   prepublication dependencies][cargo/4123] [RFC 1969]
843 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
844   like patterns][cargo/4270]
845 - [Added the `--all-targets` option][cargo/4400]
846 - [Using required dependencies as a feature is now deprecated and emits
847   a warning][cargo/4364]
848
849
850 Misc
851 ----
852 - [Cargo docs are moving][43916]
853   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
854 - [The rustdoc book is now available][43863]
855   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
856 - [Added a preview of RLS has been made available through rustup][44204]
857   Install with `rustup component add rls-preview`
858 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
859   Previously only showed `std::os::unix`.
860
861 Compatibility Notes
862 -------------------
863 - [Changes in method matching against higher-ranked types][43880] This may cause
864   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
865 - [rustc's JSON error output's byte position start at top of file.][42973]
866   Was previously relative to the rustc's internal `CodeMap` struct which
867   required the unstable library `libsyntax` to correctly use.
868 - [`unused_results` lint no longer ignores booleans][43728]
869
870 [42565]: https://github.com/rust-lang/rust/pull/42565
871 [42973]: https://github.com/rust-lang/rust/pull/42973
872 [43348]: https://github.com/rust-lang/rust/pull/43348
873 [43459]: https://github.com/rust-lang/rust/pull/43459
874 [43506]: https://github.com/rust-lang/rust/pull/43506
875 [43540]: https://github.com/rust-lang/rust/pull/43540
876 [43690]: https://github.com/rust-lang/rust/pull/43690
877 [43728]: https://github.com/rust-lang/rust/pull/43728
878 [43838]: https://github.com/rust-lang/rust/pull/43838
879 [43863]: https://github.com/rust-lang/rust/pull/43863
880 [43880]: https://github.com/rust-lang/rust/pull/43880
881 [43911]: https://github.com/rust-lang/rust/pull/43911
882 [43916]: https://github.com/rust-lang/rust/pull/43916
883 [43917]: https://github.com/rust-lang/rust/pull/43917
884 [44204]: https://github.com/rust-lang/rust/pull/44204
885 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
886 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
887 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
888 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
889 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
890 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
891 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
892 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
893 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
894
895 Version 1.20.0 (2017-08-31)
896 ===========================
897
898 Language
899 --------
900 - [Associated constants are now stabilised.][42809]
901 - [A lot of macro bugs are now fixed.][42913]
902
903 Compiler
904 --------
905
906 - [Struct fields are now properly coerced to the expected field type.][42807]
907 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
908   `wasm32-experimental-emscripten` target.
909 - [Changed some of the error messages to be more helpful.][42033]
910 - [Add support for RELRO(RELocation Read-Only) for platforms that support
911   it.][43170]
912 - [rustc now reports the total number of errors on compilation failure][43015]
913   previously this was only the number of errors in the pass that failed.
914 - [Expansion in rustc has been sped up 29x.][42533]
915 - [added `msp430-none-elf` target.][43099]
916 - [rustc will now suggest one-argument enum variant to fix type mismatch when
917   applicable][43178]
918 - [Fixes backtraces on Redox][43228]
919 - [rustc now identifies different versions of same crate when absolute paths of
920   different types match in an error message.][42826]
921
922 Libraries
923 ---------
924
925
926 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
927 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
928   tuples.][43011]
929 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
930   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
931 - [Impl `Clone` for `DefaultHasher`.][42799]
932 - [Impl `Sync` for `SyncSender`.][42397]
933 - [Impl `FromStr` for `char`][42271]
934 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
935   NaN.][42431]
936 - [allow messages in the `unimplemented!()` macro.][42155]
937   ie. `unimplemented!("Waiting for 1.21 to be stable")`
938 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
939 - [Upgrade to Unicode 10.0.0][42999]
940 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
941 - [Skip the main thread's manual stack guard on Linux][43072]
942 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
943 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
944   previously 2^15.
945 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
946
947 Stabilized APIs
948 ---------------
949
950 - [`CStr::into_c_string`]
951 - [`CString::as_c_str`]
952 - [`CString::into_boxed_c_str`]
953 - [`Chain::get_mut`]
954 - [`Chain::get_ref`]
955 - [`Chain::into_inner`]
956 - [`Option::get_or_insert_with`]
957 - [`Option::get_or_insert`]
958 - [`OsStr::into_os_string`]
959 - [`OsString::into_boxed_os_str`]
960 - [`Take::get_mut`]
961 - [`Take::get_ref`]
962 - [`Utf8Error::error_len`]
963 - [`char::EscapeDebug`]
964 - [`char::escape_debug`]
965 - [`compile_error!`]
966 - [`f32::from_bits`]
967 - [`f32::to_bits`]
968 - [`f64::from_bits`]
969 - [`f64::to_bits`]
970 - [`mem::ManuallyDrop`]
971 - [`slice::sort_unstable_by_key`]
972 - [`slice::sort_unstable_by`]
973 - [`slice::sort_unstable`]
974 - [`str::from_boxed_utf8_unchecked`]
975 - [`str::as_bytes_mut`]
976 - [`str::as_bytes_mut`]
977 - [`str::from_utf8_mut`]
978 - [`str::from_utf8_unchecked_mut`]
979 - [`str::get_mut`]
980 - [`str::get_unchecked_mut`]
981 - [`str::get_unchecked`]
982 - [`str::get`]
983 - [`str::into_boxed_bytes`]
984
985
986 Cargo
987 -----
988 - [Cargo API token location moved from `~/.cargo/config` to
989   `~/.cargo/credentials`.][cargo/3978]
990 - [Cargo will now build `main.rs` binaries that are in sub-directories of
991   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
992   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
993 - [You can now specify version of a binary when installed through
994   `cargo install` using `--vers`.][cargo/4229]
995 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
996   failure.][cargo/4248]
997 - [Changed the convention around which file is the crate root.][cargo/4259]
998 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
999   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1000
1001 Compatibility Notes
1002 -------------------
1003
1004 - [Functions with `'static` in their return types will now not be as usable as
1005   if they were using lifetime parameters instead.][42417]
1006 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1007   takes the sign of NaN into account where previously didn't.][42430]
1008
1009 [42033]: https://github.com/rust-lang/rust/pull/42033
1010 [42155]: https://github.com/rust-lang/rust/pull/42155
1011 [42271]: https://github.com/rust-lang/rust/pull/42271
1012 [42397]: https://github.com/rust-lang/rust/pull/42397
1013 [42417]: https://github.com/rust-lang/rust/pull/42417
1014 [42430]: https://github.com/rust-lang/rust/pull/42430
1015 [42431]: https://github.com/rust-lang/rust/pull/42431
1016 [42533]: https://github.com/rust-lang/rust/pull/42533
1017 [42571]: https://github.com/rust-lang/rust/pull/42571
1018 [42613]: https://github.com/rust-lang/rust/pull/42613
1019 [42799]: https://github.com/rust-lang/rust/pull/42799
1020 [42807]: https://github.com/rust-lang/rust/pull/42807
1021 [42809]: https://github.com/rust-lang/rust/pull/42809
1022 [42822]: https://github.com/rust-lang/rust/pull/42822
1023 [42826]: https://github.com/rust-lang/rust/pull/42826
1024 [42854]: https://github.com/rust-lang/rust/pull/42854
1025 [42913]: https://github.com/rust-lang/rust/pull/42913
1026 [42999]: https://github.com/rust-lang/rust/pull/42999
1027 [43011]: https://github.com/rust-lang/rust/pull/43011
1028 [43015]: https://github.com/rust-lang/rust/pull/43015
1029 [43072]: https://github.com/rust-lang/rust/pull/43072
1030 [43077]: https://github.com/rust-lang/rust/pull/43077
1031 [43097]: https://github.com/rust-lang/rust/pull/43097
1032 [43099]: https://github.com/rust-lang/rust/pull/43099
1033 [43170]: https://github.com/rust-lang/rust/pull/43170
1034 [43178]: https://github.com/rust-lang/rust/pull/43178
1035 [43185]: https://github.com/rust-lang/rust/pull/43185
1036 [43228]: https://github.com/rust-lang/rust/pull/43228
1037 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1038 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1039 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1040 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1041 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1042 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1043 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1044 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1045 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1046 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1047 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1048 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1049 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1050 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1051 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1052 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1053 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1054 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1055 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1056 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1057 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1058 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1059 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
1060 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
1061 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
1062 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
1063 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
1064 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
1065 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
1066 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
1067 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
1068 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
1069 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
1070 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
1071 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
1072 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
1073 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
1074 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
1075 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
1076
1077
1078 Version 1.19.0 (2017-07-20)
1079 ===========================
1080
1081 Language
1082 --------
1083
1084 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
1085   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
1086 - [Macro recursion limit increased to 1024 from 64.][41676]
1087 - [Added lint for detecting unused macros.][41907]
1088 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
1089   For example: `let x = loop { break 7; };`
1090 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
1091   contain `Copy` types and cannot have a `Drop` implementation.
1092   Example: `union Foo { bar: u8, baz: usize }`
1093 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
1094   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
1095
1096 Compiler
1097 --------
1098
1099 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
1100 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
1101   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
1102   you should use `--target armv7-linux-androideabi`.
1103 - [Fixed ICE when removing a source file between compilation sessions.][41873]
1104 - [Minor optimisation of string operations.][42037]
1105 - [Compiler error message is now `aborting due to previous error(s)` instead of
1106   `aborting due to N previous errors`][42150] This was previously inaccurate and
1107   would only count certain kinds of errors.
1108 - [The compiler now supports Visual Studio 2017][42225]
1109 - [The compiler is now built against LLVM 4.0.1 by default][42948]
1110 - [Added a lot][42264] of [new error codes][42302]
1111 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
1112   libraries with C Run-time Libraries(CRT) to be statically linked.
1113 - [Fixed various ARM codegen bugs][42740]
1114
1115 Libraries
1116 ---------
1117
1118 - [`String` now implements `FromIterator<Cow<'a, str>>` and
1119   `Extend<Cow<'a, str>>`][41449]
1120 - [`Vec` now implements `From<&mut [T]>`][41530]
1121 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
1122 - [`SplitWhitespace` now implements `Clone`][41659]
1123 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
1124   1.5x faster][41764]
1125 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
1126   macros, but for printing to stderr.
1127
1128 Stabilized APIs
1129 ---------------
1130
1131 - [`OsString::shrink_to_fit`]
1132 - [`cmp::Reverse`]
1133 - [`Command::envs`]
1134 - [`thread::ThreadId`]
1135
1136 Cargo
1137 -----
1138
1139 - [Build scripts can now add environment variables to the environment
1140   the crate is being compiled in.
1141   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
1142 - [Subcommands now replace the current process rather than spawning a new
1143   child process][cargo/3970]
1144 - [Workspace members can now accept glob file patterns][cargo/3979]
1145 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
1146   the members in a given workspace.][cargo/3988]
1147 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
1148 - [Target directory path is now in the cargo metadata][cargo/4022]
1149 - [Cargo no longer checks out a local working directory for the
1150   crates.io index][cargo/4026] This should provide smaller file size for the
1151   registry, and improve cloning times, especially on Windows machines.
1152 - [Added an `--exclude` option for excluding certain packages when using the
1153   `--all` option][cargo/4031]
1154 - [Cargo will now automatically retry when receiving a 5xx error
1155   from crates.io][cargo/4032]
1156 - [The `--features` option now accepts multiple comma or space
1157   delimited values.][cargo/4084]
1158 - [Added support for custom target specific runners][cargo/3954]
1159
1160 Misc
1161 ----
1162
1163 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
1164   Windows Debugger.
1165 - [Rust will now release XZ compressed packages][rust-installer/57]
1166 - [rustup will now prefer to download rust packages with
1167   XZ compression][rustup/1100] over GZip packages.
1168 - [Added the ability to escape `#` in rust documentation][41785] By adding
1169   additional `#`'s ie. `##` is now `#`
1170
1171 Compatibility Notes
1172 -------------------
1173
1174 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
1175 - [`-Z` flags are now no longer allowed to be used on the stable
1176   compiler.][41751] This has been a warning for a year previous to this.
1177 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
1178   longer works][42844]. Users should migrate to the built-in `check`
1179   command, which has been available since 1.16.
1180 - [Ending a float literal with `._` is now a hard error.
1181   Example: `42._` .][41946]
1182 - [Any use of a private `extern crate` outside of its module is now a
1183   hard error.][36886] This was previously a warning.
1184 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
1185   relative while the `::` prefix makes a path absolute, but was ignored and the
1186   path was relative regardless.
1187 - [Floating point constants in match patterns is now a hard error][36890]
1188   This was previously a warning.
1189 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
1190   match patterns is now a hard error][36891] This was previously a warning.
1191 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
1192   a warning.
1193 - [From the pound escape, lines consisting of multiple `#`s are
1194   now visible][41785]
1195 - [It is an error to re-export private enum variants][42460]. This is
1196   known to break a number of crates that depend on an older version of
1197   mustache.
1198 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
1199   to use it to find the linker, and the build will fail where it did
1200   not previously][42607]
1201
1202 [36886]: https://github.com/rust-lang/rust/issues/36886
1203 [36888]: https://github.com/rust-lang/rust/issues/36888
1204 [36890]: https://github.com/rust-lang/rust/issues/36890
1205 [36891]: https://github.com/rust-lang/rust/issues/36891
1206 [36892]: https://github.com/rust-lang/rust/issues/36892
1207 [37406]: https://github.com/rust-lang/rust/issues/37406
1208 [39983]: https://github.com/rust-lang/rust/pull/39983
1209 [41145]: https://github.com/rust-lang/rust/pull/41145
1210 [41192]: https://github.com/rust-lang/rust/pull/41192
1211 [41258]: https://github.com/rust-lang/rust/pull/41258
1212 [41370]: https://github.com/rust-lang/rust/pull/41370
1213 [41449]: https://github.com/rust-lang/rust/pull/41449
1214 [41530]: https://github.com/rust-lang/rust/pull/41530
1215 [41624]: https://github.com/rust-lang/rust/pull/41624
1216 [41656]: https://github.com/rust-lang/rust/pull/41656
1217 [41659]: https://github.com/rust-lang/rust/pull/41659
1218 [41676]: https://github.com/rust-lang/rust/pull/41676
1219 [41751]: https://github.com/rust-lang/rust/pull/41751
1220 [41764]: https://github.com/rust-lang/rust/pull/41764
1221 [41785]: https://github.com/rust-lang/rust/pull/41785
1222 [41873]: https://github.com/rust-lang/rust/pull/41873
1223 [41907]: https://github.com/rust-lang/rust/pull/41907
1224 [41946]: https://github.com/rust-lang/rust/pull/41946
1225 [42016]: https://github.com/rust-lang/rust/pull/42016
1226 [42037]: https://github.com/rust-lang/rust/pull/42037
1227 [42068]: https://github.com/rust-lang/rust/pull/42068
1228 [42150]: https://github.com/rust-lang/rust/pull/42150
1229 [42162]: https://github.com/rust-lang/rust/pull/42162
1230 [42225]: https://github.com/rust-lang/rust/pull/42225
1231 [42264]: https://github.com/rust-lang/rust/pull/42264
1232 [42302]: https://github.com/rust-lang/rust/pull/42302
1233 [42460]: https://github.com/rust-lang/rust/issues/42460
1234 [42607]: https://github.com/rust-lang/rust/issues/42607
1235 [42740]: https://github.com/rust-lang/rust/pull/42740
1236 [42844]: https://github.com/rust-lang/rust/issues/42844
1237 [42948]: https://github.com/rust-lang/rust/pull/42948
1238 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
1239 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
1240 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
1241 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
1242 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
1243 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
1244 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
1245 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
1246 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
1247 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
1248 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
1249 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
1250 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
1251 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
1252 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
1253 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
1254 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
1255 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
1256 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
1257 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
1258 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
1259 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
1260
1261
1262 Version 1.18.0 (2017-06-08)
1263 ===========================
1264
1265 Language
1266 --------
1267
1268 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
1269   make the item visible to just that module tree. Also accepts the keyword
1270   `crate` to make something public to the whole crate but not users of the
1271   library. Example: `pub(crate) mod utils;`. [RFC 1422].
1272 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
1273   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
1274 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
1275   types like `Write + Send`, trailing `+` are now supported in trait objects,
1276   and better error reporting for trait objects starting with `?Sized`.
1277 - [0e+10 is now a valid floating point literal][40589]
1278 - [Now warns if you bind a lifetime parameter to 'static][40734]
1279 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
1280   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
1281   representation in some cases.][40377]
1282
1283 Compiler
1284 --------
1285
1286 - [rustc can now emit mir with `--emit mir`][39891]
1287 - [Improved LLVM IR for trivial functions][40367]
1288 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
1289 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
1290   opportunities found through profiling
1291 - [Improved backtrace formatting when panicking][38165]
1292
1293 Libraries
1294 ---------
1295
1296 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
1297   iterator hasn't been advanced the original `Vec` is reassembled with no actual
1298   iteration or reallocation.
1299 - [Simplified HashMap Bucket interface][40561] provides performance
1300   improvements for iterating and cloning.
1301 - [Specialize Vec::from_elem to use calloc][40409]
1302 - [Fixed Race condition in fs::create_dir_all][39799]
1303 - [No longer caching stdio on Windows][40516]
1304 - [Optimized insertion sort in slice][40807] insertion sort in some cases
1305   2.50%~ faster and in one case now 12.50% faster.
1306 - [Optimized `AtomicBool::fetch_nand`][41143]
1307
1308 Stabilized APIs
1309 ---------------
1310
1311 - [`Child::try_wait`]
1312 - [`HashMap::retain`]
1313 - [`HashSet::retain`]
1314 - [`PeekMut::pop`]
1315 - [`TcpStream::peek`]
1316 - [`UdpSocket::peek`]
1317 - [`UdpSocket::peek_from`]
1318
1319 Cargo
1320 -----
1321
1322 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
1323   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
1324 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
1325 - [Added Android build support][cargo/3885]
1326 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
1327   of a certain type, for example `cargo build --bins` will build all
1328   binaries.
1329 - [Added support for haiku][cargo/3952]
1330
1331 Misc
1332 ----
1333
1334 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
1335 - [Added rust-windbg script for better debugging on Windows][39983]
1336 - [Rust now uses the official cross compiler for NetBSD][40612]
1337 - [rustdoc now accepts `#` at the start of files][40828]
1338 - [Fixed jemalloc support for musl][41168]
1339
1340 Compatibility Notes
1341 -------------------
1342
1343 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
1344   always placed after the sign if it exists and before the digits. With the `#`
1345   flag the zeroes are placed after the prefix and before the digits.
1346 - [Due to the struct field optimisation][40377], using `transmute` on structs
1347   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
1348   always been undefined behavior, but is now more likely to break in practice.
1349 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
1350   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
1351   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
1352 - [Overlapping inherent `impl`s are now a hard error][40728]
1353 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
1354 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
1355   `out.asm` and `out.ll` instead of only one of the filetypes.
1356 - [ calling a function that returns `Self` will no longer work][41805] when
1357   the size of `Self` cannot be statically determined.
1358 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
1359   this has caused a few regressions namely:
1360
1361   - Changed the link order of local static/dynamic libraries (respecting the
1362     order on given rather than having the compiler reorder).
1363   - Changed how MinGW is linked, native code linked to dynamic libraries
1364     may require manually linking to the gcc support library (for the native
1365     code itself)
1366
1367 [38165]: https://github.com/rust-lang/rust/pull/38165
1368 [39799]: https://github.com/rust-lang/rust/pull/39799
1369 [39891]: https://github.com/rust-lang/rust/pull/39891
1370 [39983]: https://github.com/rust-lang/rust/pull/39983
1371 [40043]: https://github.com/rust-lang/rust/pull/40043
1372 [40241]: https://github.com/rust-lang/rust/pull/40241
1373 [40338]: https://github.com/rust-lang/rust/pull/40338
1374 [40367]: https://github.com/rust-lang/rust/pull/40367
1375 [40377]: https://github.com/rust-lang/rust/pull/40377
1376 [40409]: https://github.com/rust-lang/rust/pull/40409
1377 [40516]: https://github.com/rust-lang/rust/pull/40516
1378 [40556]: https://github.com/rust-lang/rust/pull/40556
1379 [40561]: https://github.com/rust-lang/rust/pull/40561
1380 [40589]: https://github.com/rust-lang/rust/pull/40589
1381 [40612]: https://github.com/rust-lang/rust/pull/40612
1382 [40723]: https://github.com/rust-lang/rust/pull/40723
1383 [40728]: https://github.com/rust-lang/rust/pull/40728
1384 [40731]: https://github.com/rust-lang/rust/pull/40731
1385 [40734]: https://github.com/rust-lang/rust/pull/40734
1386 [40805]: https://github.com/rust-lang/rust/pull/40805
1387 [40807]: https://github.com/rust-lang/rust/pull/40807
1388 [40828]: https://github.com/rust-lang/rust/pull/40828
1389 [40870]: https://github.com/rust-lang/rust/pull/40870
1390 [41085]: https://github.com/rust-lang/rust/pull/41085
1391 [41143]: https://github.com/rust-lang/rust/pull/41143
1392 [41168]: https://github.com/rust-lang/rust/pull/41168
1393 [41270]: https://github.com/rust-lang/rust/issues/41270
1394 [41469]: https://github.com/rust-lang/rust/pull/41469
1395 [41805]: https://github.com/rust-lang/rust/issues/41805
1396 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
1397 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
1398 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
1399 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
1400 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
1401 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
1402 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
1403 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
1404 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
1405 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
1406 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
1407 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
1408 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
1409 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
1410
1411
1412 Version 1.17.0 (2017-04-27)
1413 ===========================
1414
1415 Language
1416 --------
1417
1418 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
1419 * [Fields of structs may be initialized without duplicating the field/variable
1420   names][39761]. [RFC 1682]
1421 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
1422 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1423   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
1424   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
1425   `'b`. Soundness fix.
1426 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
1427 * [Static variables may contain references to other statics][40027]
1428
1429 Compiler
1430 --------
1431
1432 * [Exit quickly on only `--emit dep-info`][40336]
1433 * [Make `-C relocation-model` more correctly determine whether the linker
1434   creates a position-independent executable][40245]
1435 * [Add `-C overflow-checks` to directly control whether integer overflow
1436   panics][40037]
1437 * [The rustc type checker now checks items on demand instead of in a single
1438   in-order pass][40008]. This is mostly an internal refactoring in support of
1439   future work, including incremental type checking, but also resolves [RFC
1440   1647], allowing `Self` to appear in `impl` `where` clauses.
1441 * [Optimize vtable loads][39995]
1442 * [Turn off vectorization for Emscripten targets][39990]
1443 * [Provide suggestions for unknown macros imported with `use`][39953]
1444 * [Fix ICEs in path resolution][39939]
1445 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
1446 * [Add clearer error message using `&str + &str`][39116]
1447
1448 Stabilized APIs
1449 ---------------
1450
1451 * [`Arc::into_raw`]
1452 * [`Arc::from_raw`]
1453 * [`Arc::ptr_eq`]
1454 * [`Rc::into_raw`]
1455 * [`Rc::from_raw`]
1456 * [`Rc::ptr_eq`]
1457 * [`Ordering::then`]
1458 * [`Ordering::then_with`]
1459 * [`BTreeMap::range`]
1460 * [`BTreeMap::range_mut`]
1461 * [`collections::Bound`]
1462 * [`process::abort`]
1463 * [`ptr::read_unaligned`]
1464 * [`ptr::write_unaligned`]
1465 * [`Result::expect_err`]
1466 * [`Cell::swap`]
1467 * [`Cell::replace`]
1468 * [`Cell::into_inner`]
1469 * [`Cell::take`]
1470
1471 Libraries
1472 ---------
1473
1474 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
1475 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
1476 * [`String` implements `FromIterator<&char>`][40028]
1477 * `Box` [implements][40009] a number of new conversions:
1478   `From<Box<str>> for String`,
1479   `From<Box<[T]>> for Vec<T>`,
1480   `From<Box<CStr>> for CString`,
1481   `From<Box<OsStr>> for OsString`,
1482   `From<Box<Path>> for PathBuf`,
1483   `Into<Box<str>> for String`,
1484   `Into<Box<[T]>> for Vec<T>`,
1485   `Into<Box<CStr>> for CString`,
1486   `Into<Box<OsStr>> for OsString`,
1487   `Into<Box<Path>> for PathBuf`,
1488   `Default for Box<str>`,
1489   `Default for Box<CStr>`,
1490   `Default for Box<OsStr>`,
1491   `From<&CStr> for Box<CStr>`,
1492   `From<&OsStr> for Box<OsStr>`,
1493   `From<&Path> for Box<Path>`
1494 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
1495 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
1496 * [Slightly optimize `slice::sort`][39538]
1497 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
1498 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
1499   `Box<str>` implements `From<&str>`][39438]
1500 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
1501   `From<(I, u16)> where I: Into<IpAddr>`][39372]
1502 * [`format!` estimates the needed capacity before writing a string][39356]
1503 * [Support unprivileged symlink creation in Windows][38921]
1504 * [`PathBuf` implements `Default`][38764]
1505 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
1506 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
1507   and poor hash functions.
1508
1509 Cargo
1510 -----
1511
1512 * [Add `cargo check --all`][cargo/3731]
1513 * [Add an option to ignore SSL revocation checking][cargo/3699]
1514 * [Add `cargo run --package`][cargo/3691]
1515 * [Add `required_features`][cargo/3667]
1516 * [Assume `build.rs` is a build script][cargo/3664]
1517 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
1518
1519 Misc
1520 ----
1521
1522 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
1523   `rustbook`][39633]
1524 * [The "Unstable Book" documents nightly-only features][ubook]
1525 * [Improve the style of the sidebar in rustdoc output][40265]
1526 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
1527 * [Fix MSP430 breakage due to `i128`][40257]
1528 * [Preliminary Solaris/SPARCv9 support][39903]
1529 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
1530   run without installing the MSVC runtime.
1531 * [`rustdoc --test` includes file names in test names][39788]
1532 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
1533   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
1534 * [Initial support for `aarch64-unknown-freebsd`][39491]
1535 * [Initial support for `i686-unknown-netbsd`][39426]
1536 * [This release no longer includes the old makefile build system][39431]. Rust
1537   is built with a custom build system, written in Rust, and with Cargo.
1538 * [Add Debug implementations for libcollection structs][39002]
1539 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
1540 * [`--test-threads=0` produces an error][38945]
1541 * [`rustup` installs documentation by default][40526]
1542 * [The Rust source includes NatVis visualizations][39843]. These can be used by
1543   WinDbg and Visual Studio to improve the debugging experience.
1544
1545 Compatibility Notes
1546 -------------------
1547
1548 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
1549   workaround, either use MSVC 2015 or run vcvars.bat.
1550 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1551   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
1552   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
1553   fix.
1554 * [`format!` and `Display::to_string` panic if an underlying formatting
1555   implementation returns an error][40117]. Previously the error was silently
1556   ignored. It is incorrect for `write_fmt` to return an error when writing
1557   to a string.
1558 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
1559   crates were marked stable and could be accessed from the stable toolchain.
1560 * [Rust git source no longer includes vendored crates][39728]. Those that need
1561   to build with vendored crates should build from release tarballs.
1562 * [Fix inert attributes from `proc_macro_derives`][39572]
1563 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
1564   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
1565   build system.
1566 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
1567   existing code generally ignores the type of dead-code unless a type-hint is
1568   provided; this can cause surprising inference interactions particularly around
1569   defaulting. The new code uniformly ignores the result type of dead-code.
1570 * [Tuple-struct constructors with private fields are no longer visible][38932]
1571 * [Lifetime parameters that do not appear in the arguments are now considered
1572   early-bound][38897], resolving a soundness bug (#[32330]). The
1573   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
1574   April of 2016.
1575 * [rustdoc: fix doctests with non-feature crate attributes][38161]
1576 * [Make transmuting from fn item types to pointer-sized types a hard
1577   error][34198]
1578
1579 [27787]: https://github.com/rust-lang/rust/issues/27787
1580 [32330]: https://github.com/rust-lang/rust/issues/32330
1581 [34198]: https://github.com/rust-lang/rust/pull/34198
1582 [38161]: https://github.com/rust-lang/rust/pull/38161
1583 [38368]: https://github.com/rust-lang/rust/pull/38368
1584 [38584]: https://github.com/rust-lang/rust/issues/38584
1585 [38661]: https://github.com/rust-lang/rust/pull/38661
1586 [38764]: https://github.com/rust-lang/rust/pull/38764
1587 [38864]: https://github.com/rust-lang/rust/issues/38864
1588 [38897]: https://github.com/rust-lang/rust/pull/38897
1589 [38921]: https://github.com/rust-lang/rust/pull/38921
1590 [38932]: https://github.com/rust-lang/rust/pull/38932
1591 [38945]: https://github.com/rust-lang/rust/pull/38945
1592 [38981]: https://github.com/rust-lang/rust/pull/38981
1593 [39002]: https://github.com/rust-lang/rust/pull/39002
1594 [39116]: https://github.com/rust-lang/rust/pull/39116
1595 [39193]: https://github.com/rust-lang/rust/pull/39193
1596 [39265]: https://github.com/rust-lang/rust/pull/39265
1597 [39356]: https://github.com/rust-lang/rust/pull/39356
1598 [39372]: https://github.com/rust-lang/rust/pull/39372
1599 [39426]: https://github.com/rust-lang/rust/pull/39426
1600 [39431]: https://github.com/rust-lang/rust/pull/39431
1601 [39438]: https://github.com/rust-lang/rust/pull/39438
1602 [39440]: https://github.com/rust-lang/rust/pull/39440
1603 [39485]: https://github.com/rust-lang/rust/pull/39485
1604 [39491]: https://github.com/rust-lang/rust/pull/39491
1605 [39518]: https://github.com/rust-lang/rust/pull/39518
1606 [39538]: https://github.com/rust-lang/rust/pull/39538
1607 [39572]: https://github.com/rust-lang/rust/pull/39572
1608 [39633]: https://github.com/rust-lang/rust/pull/39633
1609 [39642]: https://github.com/rust-lang/rust/pull/39642
1610 [39728]: https://github.com/rust-lang/rust/pull/39728
1611 [39761]: https://github.com/rust-lang/rust/pull/39761
1612 [39788]: https://github.com/rust-lang/rust/pull/39788
1613 [39793]: https://github.com/rust-lang/rust/pull/39793
1614 [39837]: https://github.com/rust-lang/rust/pull/39837
1615 [39843]: https://github.com/rust-lang/rust/pull/39843
1616 [39851]: https://github.com/rust-lang/rust/pull/39851
1617 [39903]: https://github.com/rust-lang/rust/pull/39903
1618 [39939]: https://github.com/rust-lang/rust/pull/39939
1619 [39953]: https://github.com/rust-lang/rust/pull/39953
1620 [39960]: https://github.com/rust-lang/rust/pull/39960
1621 [39990]: https://github.com/rust-lang/rust/pull/39990
1622 [39995]: https://github.com/rust-lang/rust/pull/39995
1623 [40008]: https://github.com/rust-lang/rust/pull/40008
1624 [40009]: https://github.com/rust-lang/rust/pull/40009
1625 [40027]: https://github.com/rust-lang/rust/pull/40027
1626 [40028]: https://github.com/rust-lang/rust/pull/40028
1627 [40037]: https://github.com/rust-lang/rust/pull/40037
1628 [40117]: https://github.com/rust-lang/rust/pull/40117
1629 [40166]: https://github.com/rust-lang/rust/pull/40166
1630 [40245]: https://github.com/rust-lang/rust/pull/40245
1631 [40257]: https://github.com/rust-lang/rust/pull/40257
1632 [40261]: https://github.com/rust-lang/rust/pull/40261
1633 [40265]: https://github.com/rust-lang/rust/pull/40265
1634 [40319]: https://github.com/rust-lang/rust/pull/40319
1635 [40336]: https://github.com/rust-lang/rust/pull/40336
1636 [40526]: https://github.com/rust-lang/rust/pull/40526
1637 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
1638 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
1639 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
1640 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
1641 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
1642 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
1643 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
1644 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
1645 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
1646 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
1647 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
1648 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
1649 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
1650 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
1651 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1652 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
1653 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
1654 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
1655 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
1656 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
1657 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
1658 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
1659 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
1660 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
1661 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
1662 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
1663 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
1664 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
1665 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
1666 [mdbook]: https://crates.io/crates/mdbook
1667 [ubook]: https://doc.rust-lang.org/unstable-book/
1668
1669
1670 Version 1.16.0 (2017-03-16)
1671 ===========================
1672
1673 Language
1674 --------
1675
1676 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
1677 * [Uninhabitable enums (those without any variants) no longer permit wildcard
1678   match patterns][38069]
1679 * [Clean up semantics of `self` in an import list][38313]
1680 * [`Self` may appear in `impl` headers][38920]
1681 * [`Self` may appear in struct expressions][39282]
1682
1683 Compiler
1684 --------
1685
1686 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
1687   a `.rmeta` file containing only crate metadata][38571]. This can be
1688   used by tools like the Rust Language Service to perform
1689   metadata-only builds.
1690 * [Levenshtein based typo suggestions now work in most places, while
1691   previously they worked only for fields and sometimes for local
1692   variables][38927]. Together with the overhaul of "no
1693   resolution"/"unexpected resolution" errors (#[38154]) they result in
1694   large and systematic improvement in resolution diagnostics.
1695 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
1696   `U`][38670]
1697 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
1698 * [`rustc` no longer attempts to provide "consider using an explicit
1699   lifetime" suggestions][37057]. They were inaccurate.
1700
1701 Stabilized APIs
1702 ---------------
1703
1704 * [`VecDeque::truncate`]
1705 * [`VecDeque::resize`]
1706 * [`String::insert_str`]
1707 * [`Duration::checked_add`]
1708 * [`Duration::checked_sub`]
1709 * [`Duration::checked_div`]
1710 * [`Duration::checked_mul`]
1711 * [`str::replacen`]
1712 * [`str::repeat`]
1713 * [`SocketAddr::is_ipv4`]
1714 * [`SocketAddr::is_ipv6`]
1715 * [`IpAddr::is_ipv4`]
1716 * [`IpAddr::is_ipv6`]
1717 * [`Vec::dedup_by`]
1718 * [`Vec::dedup_by_key`]
1719 * [`Result::unwrap_or_default`]
1720 * [`<*const T>::wrapping_offset`]
1721 * [`<*mut T>::wrapping_offset`]
1722 * `CommandExt::creation_flags`
1723 * [`File::set_permissions`]
1724 * [`String::split_off`]
1725
1726 Libraries
1727 ---------
1728
1729 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
1730   their argument by `Borrow` parameter][37761]
1731 * [All public types in std implement `Debug`][38006]
1732 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
1733 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
1734 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
1735   Windows][38274]
1736 * [std: Fix partial writes in `LineWriter`][38062]
1737 * [std: Clamp max read/write sizes on Unix][38062]
1738 * [Use more specific panic message for `&str` slicing errors][38066]
1739 * [`TcpListener::set_only_v6` is deprecated][38304]. This
1740   functionality cannot be achieved in std currently.
1741 * [`writeln!`, like `println!`, now accepts a form with no string
1742   or formatting arguments, to just print a newline][38469]
1743 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
1744 * [Reduce the size of static data in `std_unicode::tables`][38781]
1745 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
1746   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
1747   `Display`][38909]
1748 * [`Duration` implements `Sum`][38712]
1749 * [`String` implements `ToSocketAddrs`][39048]
1750
1751 Cargo
1752 -----
1753
1754 * [The `cargo check` command does a type check of a project without
1755   building it][cargo/3296]
1756 * [crates.io will display CI badges from Travis and AppVeyor, if
1757   specified in Cargo.toml][cargo/3546]
1758 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
1759 * [Compilation profiles accept integer values for `debug`, in addition
1760   to `true` and `false`. These are passed to `rustc` as the value to
1761   `-C debuginfo`][cargo/3534]
1762 * [Implement `cargo --version --verbose`][cargo/3604]
1763 * [All builds now output 'dep-info' build dependencies compatible with
1764   make and ninja][cargo/3557]
1765 * [Build all workspace members with `build --all`][cargo/3511]
1766 * [Document all workspace members with `doc --all`][cargo/3515]
1767 * [Path deps outside workspace are not members][cargo/3443]
1768
1769 Misc
1770 ----
1771
1772 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
1773   the path to the Rust implementation][38589]
1774 * [The `armv7-linux-androideabi` target no longer enables NEON
1775   extensions, per Google's ABI guide][38413]
1776 * [The stock standard library can be compiled for Redox OS][38401]
1777 * [Rust has initial SPARC support][38726]. Tier 3. No builds
1778   available.
1779 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
1780   builds available.
1781 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
1782
1783 Compatibility Notes
1784 -------------------
1785
1786 * [Uninhabitable enums (those without any variants) no longer permit wildcard
1787   match patterns][38069]
1788 * In this release, references to uninhabited types can not be
1789   pattern-matched. This was accidentally allowed in 1.15.
1790 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
1791 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
1792   Windows][38274]
1793 * [Clean up semantics of `self` in an import list][38313]
1794 * Reimplemented lifetime elision. This change was almost entirely compatible
1795   with existing code, but it did close a number of small bugs and loopholes,
1796   as well as being more accepting in some other [cases][41105].
1797
1798 [37057]: https://github.com/rust-lang/rust/pull/37057
1799 [37761]: https://github.com/rust-lang/rust/pull/37761
1800 [38006]: https://github.com/rust-lang/rust/pull/38006
1801 [38051]: https://github.com/rust-lang/rust/pull/38051
1802 [38062]: https://github.com/rust-lang/rust/pull/38062
1803 [38062]: https://github.com/rust-lang/rust/pull/38622
1804 [38066]: https://github.com/rust-lang/rust/pull/38066
1805 [38069]: https://github.com/rust-lang/rust/pull/38069
1806 [38131]: https://github.com/rust-lang/rust/pull/38131
1807 [38154]: https://github.com/rust-lang/rust/pull/38154
1808 [38274]: https://github.com/rust-lang/rust/pull/38274
1809 [38304]: https://github.com/rust-lang/rust/pull/38304
1810 [38313]: https://github.com/rust-lang/rust/pull/38313
1811 [38314]: https://github.com/rust-lang/rust/pull/38314
1812 [38327]: https://github.com/rust-lang/rust/pull/38327
1813 [38401]: https://github.com/rust-lang/rust/pull/38401
1814 [38413]: https://github.com/rust-lang/rust/pull/38413
1815 [38469]: https://github.com/rust-lang/rust/pull/38469
1816 [38559]: https://github.com/rust-lang/rust/pull/38559
1817 [38571]: https://github.com/rust-lang/rust/pull/38571
1818 [38580]: https://github.com/rust-lang/rust/pull/38580
1819 [38589]: https://github.com/rust-lang/rust/pull/38589
1820 [38670]: https://github.com/rust-lang/rust/pull/38670
1821 [38712]: https://github.com/rust-lang/rust/pull/38712
1822 [38726]: https://github.com/rust-lang/rust/pull/38726
1823 [38781]: https://github.com/rust-lang/rust/pull/38781
1824 [38798]: https://github.com/rust-lang/rust/pull/38798
1825 [38909]: https://github.com/rust-lang/rust/pull/38909
1826 [38920]: https://github.com/rust-lang/rust/pull/38920
1827 [38927]: https://github.com/rust-lang/rust/pull/38927
1828 [39048]: https://github.com/rust-lang/rust/pull/39048
1829 [39282]: https://github.com/rust-lang/rust/pull/39282
1830 [39379]: https://github.com/rust-lang/rust/pull/39379
1831 [41105]: https://github.com/rust-lang/rust/issues/41105
1832 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
1833 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
1834 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
1835 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
1836 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
1837 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
1838 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
1839 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
1840 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
1841 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
1842 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
1843 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
1844 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
1845 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
1846 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
1847 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
1848 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
1849 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
1850 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
1851 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
1852 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
1853 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
1854 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
1855 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
1856 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
1857 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
1858 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
1859 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
1860 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
1861 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
1862
1863
1864 Version 1.15.1 (2017-02-09)
1865 ===========================
1866
1867 * [Fix IntoIter::as_mut_slice's signature][39466]
1868 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
1869
1870 [39466]: https://github.com/rust-lang/rust/pull/39466
1871 [39523]: https://github.com/rust-lang/rust/pull/39523
1872
1873
1874 Version 1.15.0 (2017-02-02)
1875 ===========================
1876
1877 Language
1878 --------
1879
1880 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
1881   stable. This allows popular code-generating crates like Serde and Diesel to
1882   work ergonomically. [RFC 1681].
1883 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
1884   with curly braces][36868]. Part of [RFC 1506].
1885 * [A number of minor changes to name resolution have been activated][37127].
1886   They add up to more consistent semantics, allowing for future evolution of
1887   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
1888   details of what is different. The breaking changes here have been transitioned
1889   through the [`legacy_imports`] lint since 1.14, with no known regressions.
1890 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
1891   bounds][38279]
1892 * [`?Sized` can be used in `where` clauses][37791]
1893 * [There is now a limit on the size of monomorphized types and it can be
1894   modified with the `#![type_size_limit]` crate attribute, similarly to
1895   the `#![recursion_limit]` attribute][37789]
1896
1897 Compiler
1898 --------
1899
1900 * [On Windows, the compiler will apply dllimport attributes when linking to
1901   extern functions][37973]. Additional attributes and flags can control which
1902   library kind is linked and its name. [RFC 1717].
1903 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
1904 * [The `--test` flag works with procedural macro crates][38107]
1905 * [Fix `extern "aapcs" fn` ABI][37814]
1906 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
1907 * [The `format!` expander recognizes incorrect `printf` and shell-style
1908   formatting directives and suggests the correct format][37613].
1909 * [Only report one error for all unused imports in an import list][37456]
1910
1911 Compiler Performance
1912 --------------------
1913
1914 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
1915 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
1916 * [Don't clone in `UnificationTable::probe`][37848]
1917 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
1918 * [Use small vectors in type walker][37760]
1919 * [Macro expansion performance was improved][37701]
1920 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
1921 * [Replace FNV with a faster hash function][37229]
1922
1923 Stabilized APIs
1924 ---------------
1925
1926 * [`std::iter::Iterator::min_by`]
1927 * [`std::iter::Iterator::max_by`]
1928 * [`std::os::*::fs::FileExt`]
1929 * [`std::sync::atomic::Atomic*::get_mut`]
1930 * [`std::sync::atomic::Atomic*::into_inner`]
1931 * [`std::vec::IntoIter::as_slice`]
1932 * [`std::vec::IntoIter::as_mut_slice`]
1933 * [`std::sync::mpsc::Receiver::try_iter`]
1934 * [`std::os::unix::process::CommandExt::before_exec`]
1935 * [`std::rc::Rc::strong_count`]
1936 * [`std::rc::Rc::weak_count`]
1937 * [`std::sync::Arc::strong_count`]
1938 * [`std::sync::Arc::weak_count`]
1939 * [`std::char::encode_utf8`]
1940 * [`std::char::encode_utf16`]
1941 * [`std::cell::Ref::clone`]
1942 * [`std::io::Take::into_inner`]
1943
1944 Libraries
1945 ---------
1946
1947 * [The standard sorting algorithm has been rewritten for dramatic performance
1948   improvements][38192]. It is a hybrid merge sort, drawing influences from
1949   Timsort. Previously it was a naive merge sort.
1950 * [`Iterator::nth` no longer has a `Sized` bound][38134]
1951 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
1952   performance.
1953 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
1954   and `char_indices().last()`][37882]
1955 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
1956 * [Chinese characters display correctly in `fmt::Debug`][37855]
1957 * [Derive `Default` for `Duration`][37699]
1958 * [Support creation of anonymous pipes on WinXP/2k][37677]
1959 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
1960 * [Don't pass overlapped handles to processes][38835]
1961
1962 Cargo
1963 -----
1964
1965 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
1966   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
1967   should instead check the variable at runtime with `std::env`. That the value
1968   was set at build time was a bug, and incorrect when cross-compiling. This
1969   change is known to cause breakage.
1970 * [Add `--all` flag to `cargo test`][cargo/3221]
1971 * [Compile statically against the MSVC CRT][cargo/3363]
1972 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
1973 * [Link OpenSSL statically on OSX][cargo/3311]
1974 * [Apply new fingerprinting to build dir outputs][cargo/3310]
1975 * [Test for bad path overrides with summaries][cargo/3336]
1976 * [Require `cargo install --vers` to take a semver version][cargo/3338]
1977 * [Fix retrying crate downloads for network errors][cargo/3348]
1978 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
1979 * [Emit more info on --message-format=json][cargo/3319]
1980 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
1981 * [Don't ignore errors in workspace manifest][cargo/3409]
1982 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
1983
1984 Tooling
1985 -------
1986
1987 * [Test runners (binaries built with `--test`) now support a `--list` argument
1988   that lists the tests it contains][38185]
1989 * [Test runners now support a `--exact` argument that makes the test filter
1990   match exactly, instead of matching only a substring of the test name][38181]
1991 * [rustdoc supports a `--playground-url` flag][37763]
1992 * [rustdoc provides more details about `#[should_panic]` errors][37749]
1993
1994 Misc
1995 ----
1996
1997 * [The Rust build system is now written in Rust][37817]. The Makefiles may
1998   continue to be used in this release by passing `--disable-rustbuild` to the
1999   configure script, but they will be deleted soon. Note that the new build
2000   system uses a different on-disk layout that will likely affect any scripts
2001   building Rust.
2002 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2003   releases.
2004 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2005 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2006   releases.
2007
2008 Compatibility Notes
2009 -------------------
2010
2011 * [A number of minor changes to name resolution have been activated][37127].
2012   They add up to more consistent semantics, allowing for future evolution of
2013   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2014   details of what is different. The breaking changes here have been transitioned
2015   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2016 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2017   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2018   should instead check the variable at runtime with `std::env`. That the value
2019   was set at build time was a bug, and incorrect when cross-compiling. This
2020   change is known to cause breakage.
2021 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2022   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2023   1.10 and is now an error by default. It will become a hard error in the near
2024   future.
2025 * [The semantics relating modules to file system directories are changing in
2026   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2027   lint, which is a warning in this release, and will become a hard error in the
2028   future.
2029 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2030 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2031   the underlying iterator][37834]
2032
2033 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2034 [33685]: https://github.com/rust-lang/rust/issues/33685
2035 [36868]: https://github.com/rust-lang/rust/pull/36868
2036 [37127]: https://github.com/rust-lang/rust/pull/37127
2037 [37229]: https://github.com/rust-lang/rust/pull/37229
2038 [37456]: https://github.com/rust-lang/rust/pull/37456
2039 [37527]: https://github.com/rust-lang/rust/pull/37527
2040 [37602]: https://github.com/rust-lang/rust/pull/37602
2041 [37613]: https://github.com/rust-lang/rust/pull/37613
2042 [37615]: https://github.com/rust-lang/rust/pull/37615
2043 [37636]: https://github.com/rust-lang/rust/pull/37636
2044 [37627]: https://github.com/rust-lang/rust/pull/37627
2045 [37642]: https://github.com/rust-lang/rust/pull/37642
2046 [37677]: https://github.com/rust-lang/rust/pull/37677
2047 [37699]: https://github.com/rust-lang/rust/pull/37699
2048 [37701]: https://github.com/rust-lang/rust/pull/37701
2049 [37705]: https://github.com/rust-lang/rust/pull/37705
2050 [37749]: https://github.com/rust-lang/rust/pull/37749
2051 [37760]: https://github.com/rust-lang/rust/pull/37760
2052 [37763]: https://github.com/rust-lang/rust/pull/37763
2053 [37764]: https://github.com/rust-lang/rust/pull/37764
2054 [37789]: https://github.com/rust-lang/rust/pull/37789
2055 [37791]: https://github.com/rust-lang/rust/pull/37791
2056 [37814]: https://github.com/rust-lang/rust/pull/37814
2057 [37817]: https://github.com/rust-lang/rust/pull/37817
2058 [37834]: https://github.com/rust-lang/rust/pull/37834
2059 [37848]: https://github.com/rust-lang/rust/pull/37848
2060 [37855]: https://github.com/rust-lang/rust/pull/37855
2061 [37882]: https://github.com/rust-lang/rust/pull/37882
2062 [37888]: https://github.com/rust-lang/rust/pull/37888
2063 [37973]: https://github.com/rust-lang/rust/pull/37973
2064 [37979]: https://github.com/rust-lang/rust/pull/37979
2065 [38086]: https://github.com/rust-lang/rust/pull/38086
2066 [38107]: https://github.com/rust-lang/rust/pull/38107
2067 [38117]: https://github.com/rust-lang/rust/pull/38117
2068 [38134]: https://github.com/rust-lang/rust/pull/38134
2069 [38146]: https://github.com/rust-lang/rust/pull/38146
2070 [38181]: https://github.com/rust-lang/rust/pull/38181
2071 [38182]: https://github.com/rust-lang/rust/pull/38182
2072 [38185]: https://github.com/rust-lang/rust/pull/38185
2073 [38192]: https://github.com/rust-lang/rust/pull/38192
2074 [38279]: https://github.com/rust-lang/rust/pull/38279
2075 [38835]: https://github.com/rust-lang/rust/pull/38835
2076 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2077 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2078 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
2079 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
2080 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
2081 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
2082 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
2083 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
2084 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
2085 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
2086 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
2087 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
2088 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
2089 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
2090 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
2091 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
2092 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
2093 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
2094 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
2095 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
2096 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
2097 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
2098 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
2099 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
2100 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
2101 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
2102 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
2103 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
2104 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
2105 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
2106 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
2107 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
2108 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
2109 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
2110 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
2111 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
2112 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
2113 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
2114
2115
2116 Version 1.14.0 (2016-12-22)
2117 ===========================
2118
2119 Language
2120 --------
2121
2122 * [`..` matches multiple tuple fields in enum variants, structs
2123   and tuples][36843]. [RFC 1492].
2124 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
2125 * [`use *` and `use ::*` both glob-import from the crate root][37367]
2126 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
2127   dereferencing][36822]
2128
2129 Compiler
2130 --------
2131
2132 * [Mark enums with non-zero discriminant as non-zero][37224]
2133 * [Lower-case `static mut` names are linted like other
2134   statics and consts][37162]
2135 * [Fix ICE on some macros in const integer positions
2136    (e.g. `[u8; m!()]`)][36819]
2137 * [Improve error message and snippet for "did you mean `x`"][36798]
2138 * [Add a panic-strategy field to the target specification][36794]
2139 * [Include LLVM version in `--version --verbose`][37200]
2140
2141 Compile-time Optimizations
2142 --------------------------
2143
2144 * [Improve macro expansion performance][37569]
2145 * [Shrink `Expr_::ExprInlineAsm`][37445]
2146 * [Replace all uses of SHA-256 with BLAKE2b][37439]
2147 * [Reduce the number of bytes hashed by `IchHasher`][37427]
2148 * [Avoid more allocations when compiling html5ever][37373]
2149 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
2150 * [Avoid some allocations in the macro parser][37318]
2151 * [Use a faster deflate setting][37298]
2152 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
2153   during interning of slices][37270]
2154 * [Optimize `write_metadata`][37267]
2155 * [Don't process obligation forest cycles when stalled][37231]
2156 * [Avoid many `CrateConfig` clones][37161]
2157 * [Optimize `Substs::super_fold_with`][37108]
2158 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
2159 * [Speed up `plug_leaks`][36917]
2160
2161 Libraries
2162 ---------
2163
2164 * [`println!()`, with no arguments, prints newline][36825].
2165   Previously, an empty string was required to achieve the same.
2166 * [`Wrapping` impls standard binary and unary operators, as well as
2167    the `Sum` and `Product` iterators][37356]
2168 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
2169   Vec<T>`][37326]
2170 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
2171   `VecDeque` iterators][37315]
2172 * [Improve `SipHasher` performance on small values][37312]
2173 * [Add Iterator trait TrustedLen to enable better FromIterator /
2174   Extend][37306]
2175 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
2176 * [`ReadDir` implements `Debug`][37221]
2177 * [Implement `RefUnwindSafe` for atomic types][37178]
2178 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
2179 * [Avoid allocations in `Decoder::read_str`][37064]
2180 * [`io::Error` implements `From<io::ErrorKind>`][37037]
2181 * [Impl `Debug` for raw pointers to unsized data][36880]
2182 * [Don't reuse `HashMap` random seeds][37470]
2183 * [The internal memory layout of `HashMap` is more cache-friendly, for
2184   significant improvements in some operations][36692]
2185 * [`HashMap` uses less memory on 32-bit architectures][36595]
2186 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
2187
2188 Cargo
2189 -----
2190
2191 * [Expose rustc cfg values to build scripts][cargo/3243]
2192 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
2193 * [Fix passing --features when testing multiple packages][cargo/3280]
2194 * [Use a single profile set per workspace][cargo/3249]
2195 * [Load `replace` sections from lock files][cargo/3220]
2196 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
2197
2198 Tooling
2199 -------
2200
2201 * [rustup is the recommended Rust installation method][1.14rustup]
2202 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
2203   S390x. These are [tier 2] platforms and may have major defects. Follow the
2204   instructions on the website to install, or add the targets to an existing
2205   installation with `rustup target add`. The new target triples are:
2206   - `mips-unknown-linux-gnu`
2207   - `mipsel-unknown-linux-gnu`
2208   - `mips64-unknown-linux-gnuabi64`
2209   - `mips64el-unknown-linux-gnuabi64 `
2210   - `powerpc-unknown-linux-gnu`
2211   - `powerpc64-unknown-linux-gnu`
2212   - `powerpc64le-unknown-linux-gnu`
2213   - `s390x-unknown-linux-gnu `
2214 * This release includes target (std) builds for ARM Linux running MUSL
2215   libc. These are [tier 2] platforms and may have major defects. Add the
2216   following triples to an existing rustup installation with `rustup target add`:
2217   - `arm-unknown-linux-musleabi`
2218   - `arm-unknown-linux-musleabihf`
2219   - `armv7-unknown-linux-musleabihf`
2220 * This release includes [experimental support for WebAssembly][1.14wasm], via
2221   the `wasm32-unknown-emscripten` target. This target is known to have major
2222   defects. Please test, report, and fix.
2223 * rustup no longer installs documentation by default. Run `rustup
2224   component add rust-docs` to install.
2225 * [Fix line stepping in debugger][37310]
2226 * [Enable line number debuginfo in releases][37280]
2227
2228 Misc
2229 ----
2230
2231 * [Disable jemalloc on aarch64/powerpc/mips][37392]
2232 * [Add support for Fuchsia OS][37313]
2233 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
2234
2235 Compatibility Notes
2236 -------------------
2237
2238 * [A number of forward-compatibility lints used by the compiler
2239   to gradually introduce language changes have been converted
2240   to deny by default][36894]:
2241   - ["use of inaccessible extern crate erroneously allowed"][36886]
2242   - ["type parameter default erroneously allowed in invalid location"][36887]
2243   - ["detects super or self keywords at the beginning of global path"][36888]
2244   - ["two overlapping inherent impls define an item with the same name
2245     were erroneously allowed"][36889]
2246   - ["floating-point constants cannot be used in patterns"][36890]
2247   - ["constants of struct or enum type can only be used in a pattern if
2248      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
2249   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
2250 * [Prohibit patterns in trait methods without bodies][37378]
2251 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
2252 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
2253 * [The `$crate` macro variable is accepted in fewer locations][37213]
2254 * [Impls specifying extra region requirements beyond the trait
2255   they implement are rejected][37167]
2256 * [Enums may not be unsized][37111]. Unsized enums are intended to
2257   work but never have. For now they are forbidden.
2258 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
2259
2260 [tier 2]: https://forge.rust-lang.org/platform-support.html
2261 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
2262 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
2263 [36430]: https://github.com/rust-lang/rust/pull/36430
2264 [36595]: https://github.com/rust-lang/rust/pull/36595
2265 [36595]: https://github.com/rust-lang/rust/pull/36595
2266 [36692]: https://github.com/rust-lang/rust/pull/36692
2267 [36767]: https://github.com/rust-lang/rust/pull/36767
2268 [36794]: https://github.com/rust-lang/rust/pull/36794
2269 [36798]: https://github.com/rust-lang/rust/pull/36798
2270 [36819]: https://github.com/rust-lang/rust/pull/36819
2271 [36822]: https://github.com/rust-lang/rust/pull/36822
2272 [36825]: https://github.com/rust-lang/rust/pull/36825
2273 [36843]: https://github.com/rust-lang/rust/pull/36843
2274 [36880]: https://github.com/rust-lang/rust/pull/36880
2275 [36886]: https://github.com/rust-lang/rust/issues/36886
2276 [36887]: https://github.com/rust-lang/rust/issues/36887
2277 [36888]: https://github.com/rust-lang/rust/issues/36888
2278 [36889]: https://github.com/rust-lang/rust/issues/36889
2279 [36890]: https://github.com/rust-lang/rust/issues/36890
2280 [36891]: https://github.com/rust-lang/rust/issues/36891
2281 [36892]: https://github.com/rust-lang/rust/issues/36892
2282 [36894]: https://github.com/rust-lang/rust/pull/36894
2283 [36917]: https://github.com/rust-lang/rust/pull/36917
2284 [36993]: https://github.com/rust-lang/rust/pull/36993
2285 [37037]: https://github.com/rust-lang/rust/pull/37037
2286 [37064]: https://github.com/rust-lang/rust/pull/37064
2287 [37094]: https://github.com/rust-lang/rust/pull/37094
2288 [37108]: https://github.com/rust-lang/rust/pull/37108
2289 [37111]: https://github.com/rust-lang/rust/pull/37111
2290 [37161]: https://github.com/rust-lang/rust/pull/37161
2291 [37162]: https://github.com/rust-lang/rust/pull/37162
2292 [37167]: https://github.com/rust-lang/rust/pull/37167
2293 [37178]: https://github.com/rust-lang/rust/pull/37178
2294 [37200]: https://github.com/rust-lang/rust/pull/37200
2295 [37213]: https://github.com/rust-lang/rust/pull/37213
2296 [37221]: https://github.com/rust-lang/rust/pull/37221
2297 [37224]: https://github.com/rust-lang/rust/pull/37224
2298 [37230]: https://github.com/rust-lang/rust/pull/37230
2299 [37231]: https://github.com/rust-lang/rust/pull/37231
2300 [37247]: https://github.com/rust-lang/rust/pull/37247
2301 [37267]: https://github.com/rust-lang/rust/pull/37267
2302 [37270]: https://github.com/rust-lang/rust/pull/37270
2303 [37273]: https://github.com/rust-lang/rust/pull/37273
2304 [37280]: https://github.com/rust-lang/rust/pull/37280
2305 [37298]: https://github.com/rust-lang/rust/pull/37298
2306 [37306]: https://github.com/rust-lang/rust/pull/37306
2307 [37310]: https://github.com/rust-lang/rust/pull/37310
2308 [37312]: https://github.com/rust-lang/rust/pull/37312
2309 [37313]: https://github.com/rust-lang/rust/pull/37313
2310 [37315]: https://github.com/rust-lang/rust/pull/37315
2311 [37318]: https://github.com/rust-lang/rust/pull/37318
2312 [37322]: https://github.com/rust-lang/rust/pull/37322
2313 [37326]: https://github.com/rust-lang/rust/pull/37326
2314 [37351]: https://github.com/rust-lang/rust/pull/37351
2315 [37356]: https://github.com/rust-lang/rust/pull/37356
2316 [37367]: https://github.com/rust-lang/rust/pull/37367
2317 [37373]: https://github.com/rust-lang/rust/pull/37373
2318 [37378]: https://github.com/rust-lang/rust/pull/37378
2319 [37389]: https://github.com/rust-lang/rust/pull/37389
2320 [37392]: https://github.com/rust-lang/rust/pull/37392
2321 [37427]: https://github.com/rust-lang/rust/pull/37427
2322 [37439]: https://github.com/rust-lang/rust/pull/37439
2323 [37445]: https://github.com/rust-lang/rust/pull/37445
2324 [37470]: https://github.com/rust-lang/rust/pull/37470
2325 [37569]: https://github.com/rust-lang/rust/pull/37569
2326 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2327 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
2328 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
2329 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
2330 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
2331 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
2332 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
2333
2334
2335 Version 1.13.0 (2016-11-10)
2336 ===========================
2337
2338 Language
2339 --------
2340
2341 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
2342   errors, like the `try!` macro, described in [RFC 0243].
2343 * [Stabilize macros in type position][36014]. Described in [RFC 873].
2344 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
2345 * [Fix `#[derive]` for empty tuple structs/variants][35728]
2346 * [Fix lifetime rules for 'if' conditions][36029]
2347 * [Avoid loading and parsing unconfigured non-inline modules][36482]
2348
2349 Compiler
2350 --------
2351
2352 * [Add the `-C link-arg` argument][36574]
2353 * [Remove the old AST-based backend from rustc_trans][35764]
2354 * [Don't enable NEON by default on armv7 Linux][35814]
2355 * [Fix debug line number info for macro expansions][35238]
2356 * [Do not emit "class method" debuginfo for types that are not
2357   DICompositeType][36008]
2358 * [Warn about multiple conflicting #[repr] hints][34623]
2359 * [When sizing DST, don't double-count nested struct prefixes][36351]
2360 * [Default RUST_MIN_STACK to 16MiB for now][36505]
2361 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
2362 * [Reject macros with empty repetitions to avoid infinite loop][36721]
2363 * [Expand macros without recursing to avoid stack overflows][36214]
2364
2365 Diagnostics
2366 -----------
2367
2368 * [Replace macro backtraces with labeled local uses][35702]
2369 * [Improve error message for misplaced doc comments][33922]
2370 * [Buffer unix and lock windows to prevent message interleaving][35975]
2371 * [Update lifetime errors to specifically note temporaries][36171]
2372 * [Special case a few colors for Windows][36178]
2373 * [Suggest `use self` when such an import resolves][36289]
2374 * [Be more specific when type parameter shadows primitive type][36338]
2375 * Many minor improvements
2376
2377 Compile-time Optimizations
2378 --------------------------
2379
2380 * [Compute and cache HIR hashes at beginning][35854]
2381 * [Don't hash types in loan paths][36004]
2382 * [Cache projections in trans][35761]
2383 * [Optimize the parser's last token handling][36527]
2384 * [Only instantiate #[inline] functions in codegen units referencing
2385   them][36524]. This leads to big improvements in cases where crates export
2386   define many inline functions without using them directly.
2387 * [Lazily allocate TypedArena's first chunk][36592]
2388 * [Don't allocate during default HashSet creation][36734]
2389
2390 Stabilized APIs
2391 ---------------
2392
2393 * [`checked_abs`]
2394 * [`wrapping_abs`]
2395 * [`overflowing_abs`]
2396 * [`RefCell::try_borrow`]
2397 * [`RefCell::try_borrow_mut`]
2398
2399 Libraries
2400 ---------
2401
2402 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
2403 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
2404   covariant][35354]
2405 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
2406 * [Implement `Debug` for `std::vec::IntoIter`][35707]
2407 * [`CString`: avoid excessive growth just to 0-terminate][35871]
2408 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
2409 * [Use arc4rand on FreeBSD][35884]
2410 * [memrchr: Correct aligned offset computation][35969]
2411 * [Improve Demangling of Rust Symbols][36059]
2412 * [Use monotonic time in condition variables][35048]
2413 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
2414 * [Implement conversion traits for `char`][35755]
2415 * [Fix illegal instruction caused by overflow in channel cloning][36104]
2416 * [Zero first byte of CString on drop][36264]
2417 * [Inherit overflow checks for sum and product][36372]
2418 * [Add missing Eq implementations][36423]
2419 * [Implement `Debug` for `DirEntry`][36631]
2420 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
2421   `errno`][36754]
2422 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2423 * [Implement more traits for `std::io::ErrorKind`][35911]
2424 * [Optimize BinaryHeap bounds checking][36072]
2425 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
2426   `extend_with_element`][36355]
2427 * [Fix overflow checking in unsigned pow()][34942]
2428
2429 Cargo
2430 -----
2431
2432 * This release includes security fixes to both curl and OpenSSL.
2433 * [Fix transitive doctests when panic=abort][cargo/3021]
2434 * [Add --all-features flag to cargo][cargo/3038]
2435 * [Reject path-based dependencies in `cargo package`][cargo/3060]
2436 * [Don't parse the home directory more than once][cargo/3078]
2437 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
2438 * [Update OpenSSL to 1.0.2j][cargo/3121]
2439 * [Add license and license_file to cargo metadata output][cargo/3110]
2440 * [Make crates-io registry URL optional in config; ignore all changes to
2441   source.crates-io][cargo/3089]
2442 * [Don't download dependencies from other platforms][cargo/3123]
2443 * [Build transitive dev-dependencies when needed][cargo/3125]
2444 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
2445 * [Avoid updating registry when adding existing deps][cargo/3144]
2446 * [Warn about path overrides that won't work][cargo/3136]
2447 * [Use workspaces during `cargo install`][cargo/3146]
2448 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
2449 * [Add --message-format flag][cargo/3000]
2450 * [Pass target environment for rustdoc][cargo/3205]
2451 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
2452 * [Update curl and curl-sys][cargo/3241]
2453 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
2454
2455 Tooling
2456 -------
2457
2458 * [rustdoc: Add the `--sysroot` argument][36586]
2459 * [rustdoc: Fix a couple of issues with the search results][35655]
2460 * [rustdoc: remove the `!` from macro URLs and titles][35234]
2461 * [gdb: Fix pretty-printing special-cased Rust types][35585]
2462 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
2463
2464 Misc
2465 ----
2466
2467 * [Remove unmaintained style guide][35124]
2468 * [Add s390x support][36369]
2469 * [Initial work at Haiku OS support][36727]
2470 * [Add mips-uclibc targets][35734]
2471 * [Crate-ify compiler-rt into compiler-builtins][35021]
2472 * [Add rustc version info (git hash + date) to dist tarball][36213]
2473 * Many documentation improvements
2474
2475 Compatibility Notes
2476 -------------------
2477
2478 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2479 * [Deny (by default) transmuting from fn item types to pointer-sized
2480   types][34923]. Continuing the long transition to zero-sized fn items,
2481   per [RFC 401].
2482 * [Fix `#[derive]` for empty tuple structs/variants][35728].
2483   Part of [RFC 1506].
2484 * [Issue deprecation warnings for safe accesses to extern statics][36173]
2485 * [Fix lifetime rules for 'if' conditions][36029].
2486 * [Inherit overflow checks for sum and product][36372].
2487 * [Forbid user-defined macros named "macro_rules"][36730].
2488
2489 [33922]: https://github.com/rust-lang/rust/pull/33922
2490 [34623]: https://github.com/rust-lang/rust/pull/34623
2491 [34923]: https://github.com/rust-lang/rust/pull/34923
2492 [34942]: https://github.com/rust-lang/rust/pull/34942
2493 [34982]: https://github.com/rust-lang/rust/pull/34982
2494 [35021]: https://github.com/rust-lang/rust/pull/35021
2495 [35048]: https://github.com/rust-lang/rust/pull/35048
2496 [35074]: https://github.com/rust-lang/rust/pull/35074
2497 [35124]: https://github.com/rust-lang/rust/pull/35124
2498 [35234]: https://github.com/rust-lang/rust/pull/35234
2499 [35238]: https://github.com/rust-lang/rust/pull/35238
2500 [35354]: https://github.com/rust-lang/rust/pull/35354
2501 [35559]: https://github.com/rust-lang/rust/pull/35559
2502 [35585]: https://github.com/rust-lang/rust/pull/35585
2503 [35627]: https://github.com/rust-lang/rust/pull/35627
2504 [35655]: https://github.com/rust-lang/rust/pull/35655
2505 [35702]: https://github.com/rust-lang/rust/pull/35702
2506 [35707]: https://github.com/rust-lang/rust/pull/35707
2507 [35728]: https://github.com/rust-lang/rust/pull/35728
2508 [35734]: https://github.com/rust-lang/rust/pull/35734
2509 [35755]: https://github.com/rust-lang/rust/pull/35755
2510 [35761]: https://github.com/rust-lang/rust/pull/35761
2511 [35764]: https://github.com/rust-lang/rust/pull/35764
2512 [35814]: https://github.com/rust-lang/rust/pull/35814
2513 [35854]: https://github.com/rust-lang/rust/pull/35854
2514 [35871]: https://github.com/rust-lang/rust/pull/35871
2515 [35884]: https://github.com/rust-lang/rust/pull/35884
2516 [35911]: https://github.com/rust-lang/rust/pull/35911
2517 [35969]: https://github.com/rust-lang/rust/pull/35969
2518 [35975]: https://github.com/rust-lang/rust/pull/35975
2519 [36004]: https://github.com/rust-lang/rust/pull/36004
2520 [36008]: https://github.com/rust-lang/rust/pull/36008
2521 [36014]: https://github.com/rust-lang/rust/pull/36014
2522 [36029]: https://github.com/rust-lang/rust/pull/36029
2523 [36059]: https://github.com/rust-lang/rust/pull/36059
2524 [36072]: https://github.com/rust-lang/rust/pull/36072
2525 [36101]: https://github.com/rust-lang/rust/pull/36101
2526 [36104]: https://github.com/rust-lang/rust/pull/36104
2527 [36171]: https://github.com/rust-lang/rust/pull/36171
2528 [36173]: https://github.com/rust-lang/rust/pull/36173
2529 [36178]: https://github.com/rust-lang/rust/pull/36178
2530 [36213]: https://github.com/rust-lang/rust/pull/36213
2531 [36214]: https://github.com/rust-lang/rust/pull/36214
2532 [36264]: https://github.com/rust-lang/rust/pull/36264
2533 [36266]: https://github.com/rust-lang/rust/pull/36266
2534 [36289]: https://github.com/rust-lang/rust/pull/36289
2535 [36338]: https://github.com/rust-lang/rust/pull/36338
2536 [36351]: https://github.com/rust-lang/rust/pull/36351
2537 [36355]: https://github.com/rust-lang/rust/pull/36355
2538 [36369]: https://github.com/rust-lang/rust/pull/36369
2539 [36372]: https://github.com/rust-lang/rust/pull/36372
2540 [36423]: https://github.com/rust-lang/rust/pull/36423
2541 [36482]: https://github.com/rust-lang/rust/pull/36482
2542 [36505]: https://github.com/rust-lang/rust/pull/36505
2543 [36524]: https://github.com/rust-lang/rust/pull/36524
2544 [36527]: https://github.com/rust-lang/rust/pull/36527
2545 [36551]: https://github.com/rust-lang/rust/pull/36551
2546 [36574]: https://github.com/rust-lang/rust/pull/36574
2547 [36586]: https://github.com/rust-lang/rust/pull/36586
2548 [36592]: https://github.com/rust-lang/rust/pull/36592
2549 [36631]: https://github.com/rust-lang/rust/pull/36631
2550 [36639]: https://github.com/rust-lang/rust/pull/36639
2551 [36721]: https://github.com/rust-lang/rust/pull/36721
2552 [36727]: https://github.com/rust-lang/rust/pull/36727
2553 [36730]: https://github.com/rust-lang/rust/pull/36730
2554 [36734]: https://github.com/rust-lang/rust/pull/36734
2555 [36754]: https://github.com/rust-lang/rust/pull/36754
2556 [36995]: https://github.com/rust-lang/rust/pull/36995
2557 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
2558 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
2559 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2560 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
2561 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
2562 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
2563 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
2564 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
2565 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
2566 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
2567 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
2568 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
2569 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
2570 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
2571 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
2572 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
2573 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
2574 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
2575 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
2576 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
2577 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
2578 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
2579 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
2580 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
2581 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
2582 [rustup]: https://www.rustup.rs
2583 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
2584 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
2585 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
2586 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
2587 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
2588 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
2589 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
2590
2591
2592 Version 1.12.1 (2016-10-20)
2593 ===========================
2594
2595 Regression Fixes
2596 ----------------
2597
2598 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
2599 * [Confusion with double negation and booleans][36856]
2600 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
2601 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
2602 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
2603 * [Corrupted memory after updated to 1.12][36936]
2604 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
2605 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
2606 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
2607
2608 [36381]: https://github.com/rust-lang/rust/issues/36381
2609 [36856]: https://github.com/rust-lang/rust/issues/36856
2610 [36875]: https://github.com/rust-lang/rust/issues/36875
2611 [36924]: https://github.com/rust-lang/rust/issues/36924
2612 [36926]: https://github.com/rust-lang/rust/issues/36926
2613 [36936]: https://github.com/rust-lang/rust/issues/36936
2614 [37026]: https://github.com/rust-lang/rust/issues/37026
2615 [37112]: https://github.com/rust-lang/rust/issues/37112
2616 [37153]: https://github.com/rust-lang/rust/issues/37153
2617
2618
2619 Version 1.12.0 (2016-09-29)
2620 ===========================
2621
2622 Highlights
2623 ----------
2624
2625 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
2626   This translation pass is far simpler than the previous AST->LLVM pass, and
2627   creates opportunities to perform new optimizations directly on the MIR. It
2628   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
2629 * [`rustc` presents a new, more readable error format, along with
2630   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
2631   Most common editors supporting Rust have been updated to work with it. It was
2632   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
2633
2634 Compiler
2635 --------
2636
2637 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
2638   This translation pass is far simpler than the previous AST->LLVM pass, and
2639   creates opportunities to perform new optimizations directly on the MIR. It
2640   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
2641 * [Print the Rust target name, not the LLVM target name, with
2642   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
2643 * [The computation of `TypeId` is correct in some cases where it was previously
2644   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
2645 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
2646 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
2647   `--print relocation-models`, and `--print code-models` print the available
2648   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
2649   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
2650 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
2651   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
2652   These targets produce statically-linked binaries. There are no binary release
2653   builds yet though.
2654
2655 Diagnostics
2656 -----------
2657
2658 * [`rustc` presents a new, more readable error format, along with
2659   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
2660   Most common editors supporting Rust have been updated to work with it. It was
2661   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
2662 * [In error descriptions, references are now described in plain English,
2663   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
2664 * [In error type descriptions, unknown numeric types are named `{integer}` or
2665   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
2666 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
2667
2668 Language
2669 --------
2670
2671 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
2672 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
2673 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
2674   useful](https://github.com/rust-lang/rust/pull/34908)
2675 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
2676   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
2677 * [Semicolons are properly required as statement delimiters inside
2678   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
2679 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
2680
2681 Stabilized APIs
2682 ---------------
2683
2684 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
2685 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
2686 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
2687 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
2688 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
2689 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
2690 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
2691 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
2692 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
2693 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
2694   Both on Unix and Windows.
2695 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
2696 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
2697 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
2698 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
2699 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
2700 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
2701 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
2702 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
2703
2704 Libraries
2705 ---------
2706
2707 * [The `format!` macro and friends now allow a single argument to be formatted
2708   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
2709 * [The lifetime bounds on `[T]::binary_search_by` and
2710   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
2711 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
2712 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
2713 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
2714 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
2715 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
2716 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
2717 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
2718 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
2719   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
2720 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
2721   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
2722 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
2723 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
2724   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
2725 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
2726 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
2727 * [`mpsc::sync_channel` `Receiver`s return any available message before
2728   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
2729 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
2730 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
2731
2732 Cargo
2733 -----
2734
2735 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
2736 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
2737 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
2738 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
2739 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
2740 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
2741 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
2742 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
2743 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
2744 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
2745 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
2746 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
2747 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
2748 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
2749 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
2750 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
2751
2752 Performance
2753 -----------
2754
2755 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
2756 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
2757
2758 Tooling
2759 -------
2760
2761 * [Test binaries now support a `--test-threads` argument to specify the number
2762   of threads used to run tests, and which acts the same as the
2763   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
2764 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
2765 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
2766 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
2767 * [Rust releases now come with source packages that can be installed by rustup
2768   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
2769   The resulting source code can be used by tools and IDES, located in the
2770   sysroot under `lib/rustlib/src`.
2771
2772 Misc
2773 ----
2774
2775 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
2776 * Many minor improvements to the documentation.
2777 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
2778
2779 Compatibility Notes
2780 -------------------
2781
2782 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
2783   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
2784 * [When formatting strings, if "precision" is specified, the "fill",
2785   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
2786 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
2787
2788
2789 Version 1.11.0 (2016-08-18)
2790 ===========================
2791
2792 Language
2793 --------
2794
2795 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
2796 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
2797 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
2798 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
2799 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
2800
2801 Stabilized APIs
2802 ---------------
2803
2804 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
2805 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
2806 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
2807 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
2808 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
2809 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
2810   (in libcore - previously stabilized in libstd)
2811 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
2812   (in libcore - previously stabilized in libstd)
2813 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
2814   (in libcore - previously stabilized in libstd)
2815 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
2816   (in libcore - previously stabilized in libstd)
2817 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
2818 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
2819 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
2820 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
2821
2822 Libraries
2823 ---------
2824
2825 * [The `thread_local!` macro supports multiple definitions in a single
2826    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
2827 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
2828 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
2829   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
2830 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
2831 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
2832 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
2833 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
2834
2835 Cargo
2836 -----
2837
2838 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
2839 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
2840 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
2841 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
2842 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
2843   and `-vv` prints warnings for all crates.
2844 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
2845 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
2846   This provides room for expansion by arbitrary tools.
2847 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
2848 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
2849 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
2850 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
2851 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
2852 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
2853 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
2854
2855 Performance
2856 -----------
2857
2858 * [Caching projections speeds up type check dramatically for some
2859   workloads](https://github.com/rust-lang/rust/pull/33816)
2860 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
2861   This hasher is faster, but is believed to provide sufficient
2862   protection from collision attacks.
2863 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
2864
2865 Rustdoc
2866 -------
2867
2868 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
2869 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
2870 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
2871 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
2872 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
2873
2874 Tooling
2875 -------
2876
2877 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
2878 * [When emitting debug info, rustc emits frame pointers for closures,
2879   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
2880 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
2881 * Many more errors have been given error codes and extended
2882   explanations
2883 * API documentation continues to be improved, with many new examples
2884
2885 Misc
2886 ----
2887
2888 * [rustc no longer hangs when dependencies recursively re-export
2889   submodules](https://github.com/rust-lang/rust/pull/34542)
2890 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
2891 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
2892   rewritten](https://github.com/rust-lang/rust/pull/33895)
2893 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
2894   No targets use this yet, but it works toward AVR support.
2895
2896 Compatibility Notes
2897 -------------------
2898
2899 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
2900 * [The new follow-set rules that place restrictions on `macro_rules!`
2901   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
2902   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
2903   and has been a warning since 1.10.
2904 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
2905   This causes breakage in some corner cases.
2906
2907
2908 Version 1.10.0 (2016-07-07)
2909 ===========================
2910
2911 Language
2912 --------
2913
2914 * [Allow `concat_idents!` in type positions as well as in expression
2915   positions](https://github.com/rust-lang/rust/pull/33735).
2916 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
2917   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
2918 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
2919 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
2920 * [`panic!` can be converted to a runtime abort with the
2921   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
2922   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
2923 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
2924   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
2925   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-rdylib.md).
2926   Note that Cargo does not yet directly support cdylibs.
2927
2928 Stabilized APIs
2929 ---------------
2930
2931 * `os::windows::fs::OpenOptionsExt::access_mode`
2932 * `os::windows::fs::OpenOptionsExt::share_mode`
2933 * `os::windows::fs::OpenOptionsExt::custom_flags`
2934 * `os::windows::fs::OpenOptionsExt::attributes`
2935 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
2936 * `os::unix::fs::OpenOptionsExt::custom_flags`
2937 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
2938 * `Default for sync::Weak`
2939 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
2940 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
2941 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
2942 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
2943 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
2944 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
2945 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
2946 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
2947 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
2948 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
2949 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
2950 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
2951 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
2952 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
2953 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
2954 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
2955 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
2956 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
2957 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
2958 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
2959 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
2960 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
2961 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
2962 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
2963 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
2964 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
2965 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
2966 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
2967 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
2968 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
2969 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
2970 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
2971 * Read/Write/RawFd impls for `UnixStream`
2972 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
2973 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
2974 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
2975 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
2976 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
2977 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
2978 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
2979 * RawFd impls for `UnixListener`
2980 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
2981 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
2982 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
2983 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
2984 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
2985 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
2986 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
2987 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
2988 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
2989 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
2990 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
2991 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
2992 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
2993 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
2994 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
2995 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
2996 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
2997 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
2998 * RawFd impls for `UnixDatagram`
2999 * `{BTree,Hash}Map::values_mut`
3000 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/beta/std/primitive.slice.html#method.binary_search_by_key)
3001
3002 Libraries
3003 ---------
3004
3005 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3006   The semantics of this minor method are subtle and probably not what
3007   most people want.
3008 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3009 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3010   will fall back to `/dev/urandom` temporarily to avoid blocking
3011   during early boot](https://github.com/rust-lang/rust/pull/33086).
3012 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3013 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3014 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3015 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3016 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3017 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3018   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3019
3020 Cargo
3021 -----
3022 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3023   This controls the runtime behavior of the `panic!` macro
3024   and can be either "unwind" (the default), or "abort".
3025   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3026 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3027 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3028 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3029   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3030 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3031 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3032 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3033   By default they are retried twice, which can be customized with the
3034   `net.retry` value in `.cargo/config`.
3035 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3036 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3037 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3038 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3039   Makes it possible to install multiple crates in parallel.
3040 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3041 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3042 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3043 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3044 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3045 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3046
3047 Performance
3048 -----------
3049
3050 * [rustc memory usage was reduced by refactoring the context used for
3051   type checking](https://github.com/rust-lang/rust/pull/33425).
3052 * [Speed up creation of `HashMap`s by caching the random keys used
3053   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3054 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3055 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3056 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3057   10x faster than the previous lookup tables.
3058 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3059
3060 Usability
3061 ---------
3062
3063 * Many incremental improvements to documentation and rustdoc.
3064 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
3065 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
3066 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
3067 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
3068 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
3069 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
3070 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
3071
3072 Misc
3073 ----
3074
3075 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
3076 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
3077 * [`std` no longer prints backtraces on platforms where the running
3078   module must be loaded with `env::current_exe`, which can't be relied
3079   on](https://github.com/rust-lang/rust/pull/33554).
3080 * This release includes std binaries for the i586-unknown-linux-gnu,
3081   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
3082   i586 target is for old x86 hardware without SSE2, and the armv7
3083   target is for Android running on modern ARM architectures.
3084 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
3085   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
3086 * [On Unix the runtime aborts by calling `libc::abort` instead of
3087   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
3088 * [Rust is now bootstrapped from the previous release of Rust,
3089   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
3090
3091 Compatibility Notes
3092 -------------------
3093
3094 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
3095 * [`target_env` for Linux ARM targets is just `gnu`, not
3096   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
3097 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
3098 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
3099 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
3100   Affects how macros are parsed.
3101 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
3102 * [Feature-gated attributes on macro-generated macro invocations are
3103   now rejected](https://github.com/rust-lang/rust/pull/32791).
3104 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
3105   This caused some minor changes to type inference.
3106
3107
3108 Version 1.9.0 (2016-05-26)
3109 ==========================
3110
3111 Language
3112 --------
3113
3114 * The `#[deprecated]` attribute when applied to an API will generate
3115   warnings when used. The warnings may be suppressed with
3116   `#[allow(deprecated)]`. [RFC 1270].
3117 * [`fn` item types are zero sized, and each `fn` names a unique
3118   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3119   `transmute` on a `fn` type will generate a warning for a few cycles,
3120   then will be converted to an error.
3121 * [Field and method resolution understand visibility, so private
3122   fields and methods cannot prevent the proper use of public fields
3123   and methods][1.9fv].
3124 * [The parser considers unicode codepoints in the
3125   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
3126
3127 Stabilized APIs
3128 ---------------
3129
3130 * [`std::panic`]
3131 * [`std::panic::catch_unwind`][] (renamed from `recover`)
3132 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
3133 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
3134 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
3135 * [`str::is_char_boundary`]
3136 * [`<*const T>::as_ref`]
3137 * [`<*mut T>::as_ref`]
3138 * [`<*mut T>::as_mut`]
3139 * [`AsciiExt::make_ascii_uppercase`]
3140 * [`AsciiExt::make_ascii_lowercase`]
3141 * [`char::decode_utf16`]
3142 * [`char::DecodeUtf16`]
3143 * [`char::DecodeUtf16Error`]
3144 * [`char::DecodeUtf16Error::unpaired_surrogate`]
3145 * [`BTreeSet::take`]
3146 * [`BTreeSet::replace`]
3147 * [`BTreeSet::get`]
3148 * [`HashSet::take`]
3149 * [`HashSet::replace`]
3150 * [`HashSet::get`]
3151 * [`OsString::with_capacity`]
3152 * [`OsString::clear`]
3153 * [`OsString::capacity`]
3154 * [`OsString::reserve`]
3155 * [`OsString::reserve_exact`]
3156 * [`OsStr::is_empty`]
3157 * [`OsStr::len`]
3158 * [`std::os::unix::thread`]
3159 * [`RawPthread`]
3160 * [`JoinHandleExt`]
3161 * [`JoinHandleExt::as_pthread_t`]
3162 * [`JoinHandleExt::into_pthread_t`]
3163 * [`HashSet::hasher`]
3164 * [`HashMap::hasher`]
3165 * [`CommandExt::exec`]
3166 * [`File::try_clone`]
3167 * [`SocketAddr::set_ip`]
3168 * [`SocketAddr::set_port`]
3169 * [`SocketAddrV4::set_ip`]
3170 * [`SocketAddrV4::set_port`]
3171 * [`SocketAddrV6::set_ip`]
3172 * [`SocketAddrV6::set_port`]
3173 * [`SocketAddrV6::set_flowinfo`]
3174 * [`SocketAddrV6::set_scope_id`]
3175 * [`slice::copy_from_slice`]
3176 * [`ptr::read_volatile`]
3177 * [`ptr::write_volatile`]
3178 * [`OpenOptions::create_new`]
3179 * [`TcpStream::set_nodelay`]
3180 * [`TcpStream::nodelay`]
3181 * [`TcpStream::set_ttl`]
3182 * [`TcpStream::ttl`]
3183 * [`TcpStream::set_only_v6`]
3184 * [`TcpStream::only_v6`]
3185 * [`TcpStream::take_error`]
3186 * [`TcpStream::set_nonblocking`]
3187 * [`TcpListener::set_ttl`]
3188 * [`TcpListener::ttl`]
3189 * [`TcpListener::set_only_v6`]
3190 * [`TcpListener::only_v6`]
3191 * [`TcpListener::take_error`]
3192 * [`TcpListener::set_nonblocking`]
3193 * [`UdpSocket::set_broadcast`]
3194 * [`UdpSocket::broadcast`]
3195 * [`UdpSocket::set_multicast_loop_v4`]
3196 * [`UdpSocket::multicast_loop_v4`]
3197 * [`UdpSocket::set_multicast_ttl_v4`]
3198 * [`UdpSocket::multicast_ttl_v4`]
3199 * [`UdpSocket::set_multicast_loop_v6`]
3200 * [`UdpSocket::multicast_loop_v6`]
3201 * [`UdpSocket::set_multicast_ttl_v6`]
3202 * [`UdpSocket::multicast_ttl_v6`]
3203 * [`UdpSocket::set_ttl`]
3204 * [`UdpSocket::ttl`]
3205 * [`UdpSocket::set_only_v6`]
3206 * [`UdpSocket::only_v6`]
3207 * [`UdpSocket::join_multicast_v4`]
3208 * [`UdpSocket::join_multicast_v6`]
3209 * [`UdpSocket::leave_multicast_v4`]
3210 * [`UdpSocket::leave_multicast_v6`]
3211 * [`UdpSocket::take_error`]
3212 * [`UdpSocket::connect`]
3213 * [`UdpSocket::send`]
3214 * [`UdpSocket::recv`]
3215 * [`UdpSocket::set_nonblocking`]
3216
3217 Libraries
3218 ---------
3219
3220 * [`std::sync::Once` is poisoned if its initialization function
3221   fails][1.9o].
3222 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
3223 * [Most types implement `fmt::Debug`][1.9db].
3224 * [The default buffer size used by `BufReader` and `BufWriter` was
3225   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
3226   used by other languages.
3227 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
3228   `Duration` additionally implements `*=` and `/=`][1.9ta].
3229 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
3230 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
3231 * [`Chain` implements `BufRead`][1.9ch].
3232 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
3233
3234 Cargo
3235 -----
3236
3237 * [Cargo can now run concurrently][1.9cc].
3238 * [Top-level overrides allow specific revisions of crates to be
3239   overridden through the entire crate graph][1.9ct].  This is intended
3240   to make upgrades easier for large projects, by allowing crates to be
3241   forked temporarily until they've been upgraded and republished.
3242 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
3243 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
3244   on the commandline][1.9cf]. `rustc` arguments can also be specified
3245   in the `build.rustflags` configuration key.
3246
3247 Performance
3248 -----------
3249
3250 * [The time complexity of comparing variables for equivalence during type
3251   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
3252   to major compilation time improvement in some scenarios.
3253 * [`ToString` is specialized for `str`, giving it the same performance
3254   as `to_owned`][1.9ts].
3255 * [Spawning processes with `Command::output` no longer creates extra
3256   threads][1.9sp].
3257 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
3258   for C-like enums][1.9cl].
3259
3260 Misc
3261 ----
3262
3263 * [Passing the `--quiet` flag to a test runner will produce
3264   much-abbreviated output][1.9q].
3265 * The Rust Project now publishes std binaries for the
3266   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
3267   `i586-pc-windows-msvc` targets.
3268
3269 Compatibility Notes
3270 -------------------
3271
3272 * [`std::sync::Once` is poisoned if its initialization function
3273   fails][1.9o].
3274 * [It is illegal to define methods with the same name in overlapping
3275   inherent `impl` blocks][1.9sn].
3276 * [`fn` item types are zero sized, and each `fn` names a unique
3277   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3278   `transmute` on a `fn` type will generate a warning for a few cycles,
3279   then will be converted to an error.
3280 * [Improvements to const evaluation may trigger new errors when integer
3281   literals are out of range][1.9ce].
3282
3283
3284 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
3285 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
3286 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
3287 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
3288 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
3289 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
3290 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
3291 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
3292 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
3293 [1.9db]: https://github.com/rust-lang/rust/pull/32054
3294 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
3295 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
3296 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
3297 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
3298 [1.9o]: https://github.com/rust-lang/rust/pull/32325
3299 [1.9q]: https://github.com/rust-lang/rust/pull/31887
3300 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
3301 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
3302 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
3303 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
3304 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
3305 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
3306 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
3307 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
3308 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3309 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
3310 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3311 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
3312 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
3313 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
3314 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
3315 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
3316 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
3317 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
3318 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
3319 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
3320 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
3321 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
3322 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
3323 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
3324 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
3325 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
3326 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
3327 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
3328 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
3329 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
3330 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
3331 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
3332 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
3333 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
3334 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
3335 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
3336 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
3337 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
3338 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
3339 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
3340 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
3341 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
3342 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
3343 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
3344 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3345 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3346 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3347 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3348 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3349 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3350 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
3351 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3352 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
3353 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3354 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3355 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3356 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3357 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3358 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
3359 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
3360 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
3361 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
3362 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
3363 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
3364 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
3365 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
3366 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
3367 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
3368 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
3369 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
3370 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
3371 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
3372 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
3373 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
3374 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
3375 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
3376 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
3377 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
3378 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
3379 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
3380 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
3381 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
3382 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
3383 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
3384 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
3385 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
3386 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
3387 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
3388 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
3389 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
3390 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
3391 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
3392 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
3393 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
3394
3395
3396 Version 1.8.0 (2016-04-14)
3397 ==========================
3398
3399 Language
3400 --------
3401
3402 * Rust supports overloading of compound assignment statements like
3403   `+=` by implementing the [`AddAssign`], [`SubAssign`],
3404   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
3405   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
3406   traits. [RFC 953].
3407 * Empty structs can be defined with braces, as in `struct Foo { }`, in
3408   addition to the non-braced form, `struct Foo;`. [RFC 218].
3409
3410 Libraries
3411 ---------
3412
3413 * Stabilized APIs:
3414   * [`str::encode_utf16`][] (renamed from `utf16_units`)
3415   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
3416   * [`Ref::map`]
3417   * [`RefMut::map`]
3418   * [`ptr::drop_in_place`]
3419   * [`time::Instant`]
3420   * [`time::SystemTime`]
3421   * [`Instant::now`]
3422   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
3423   * [`Instant::elapsed`]
3424   * [`SystemTime::now`]
3425   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
3426   * [`SystemTime::elapsed`]
3427   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
3428   * [`SystemTimeError`]
3429   * [`SystemTimeError::duration`]
3430   * Various impls for `SystemTimeError`
3431   * [`UNIX_EPOCH`]
3432   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
3433     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
3434     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
3435 * [The `write!` and `writeln!` macros correctly emit errors if any of
3436   their arguments can't be formatted][1.8w].
3437 * [Various I/O functions support large files on 32-bit Linux][1.8l].
3438 * [The Unix-specific `raw` modules, which contain a number of
3439   redefined C types are deprecated][1.8r], including `os::raw::unix`,
3440   `os::raw::macos`, and `os::raw::linux`. These modules defined types
3441   such as `ino_t` and `dev_t`. The inconsistency of these definitions
3442   across platforms was making it difficult to implement `std`
3443   correctly. Those that need these definitions should use the `libc`
3444   crate. [RFC 1415].
3445 * The Unix-specific `MetadataExt` traits, including
3446   `os::unix::fs::MetadataExt`, which expose values such as inode
3447   numbers [no longer return platform-specific types][1.8r], but
3448   instead return widened integers. [RFC 1415].
3449 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
3450 * [Atomic loads and stores are not volatile][1.8a].
3451 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
3452
3453 Performance
3454 -----------
3455
3456 * [Inlining hash functions lead to a 3% compile-time improvement in
3457   some workloads][1.8h].
3458 * When using jemalloc, its symbols are [unprefixed so that it
3459   overrides the libc malloc implementation][1.8h]. This means that for
3460   rustc, LLVM is now using jemalloc, which results in a 6%
3461   compile-time improvement on a specific workload.
3462 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
3463
3464 Misc
3465 ----
3466
3467 * [32-bit MSVC builds finally implement unwinding][1.8ms].
3468   i686-pc-windows-msvc is now considered a tier-1 platform.
3469 * [The `--print targets` flag prints a list of supported targets][1.8t].
3470 * [The `--print cfg` flag prints the `cfg`s defined for the current
3471   target][1.8cf].
3472 * [`rustc` can be built with an new Cargo-based build system, written
3473   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
3474   build system. To enable it configure with `configure --rustbuild`.
3475 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
3476   variants while also indicating the total number of missing variants
3477   if more than 3][1.8m].
3478 * [Executable stacks are disabled on Linux and BSD][1.8nx].
3479 * The Rust Project now publishes binary releases of the standard
3480   library for a number of tier-2 targets:
3481   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
3482   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
3483   `x86_64-rumprun-netbsd`. These can be installed with
3484   tools such as [multirust][1.8mr].
3485
3486 Cargo
3487 -----
3488
3489 * [`cargo init` creates a new Cargo project in the current
3490   directory][1.8ci].  It is otherwise like `cargo new`.
3491 * [Cargo has configuration keys for `-v` and
3492   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
3493   `[term]` section of `.cargo/config`.
3494 * [Configuration keys that evaluate to strings or integers can be set
3495   via environment variables][1.8ce]. For example the `build.jobs` key
3496   can be set via `CARGO_BUILD_JOBS`. Environment variables take
3497   precedence over config files.
3498 * [Target-specific dependencies support Rust `cfg` syntax for
3499   describing targets][1.8cfg] so that dependencies for multiple
3500   targets can be specified together. [RFC 1361].
3501 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
3502   `RUSTDOC` take precedence over the `build.target-dir`,
3503   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
3504 * [The child process tree is killed on Windows when Cargo is
3505   killed][1.8ck].
3506 * [The `build.target` configuration value sets the target platform,
3507   like `--target`][1.8ct].
3508
3509 Compatibility Notes
3510 -------------------
3511
3512 * [Unstable compiler flags have been further restricted][1.8u]. Since
3513   1.0 `-Z` flags have been considered unstable, and other flags that
3514   were considered unstable additionally required passing `-Z
3515   unstable-options` to access. Unlike unstable language and library
3516   features though, these options have been accessible on the stable
3517   release channel. Going forward, *new unstable flags will not be
3518   available on the stable release channel*, and old unstable flags
3519   will warn about their usage. In the future, all unstable flags will
3520   be unavailable on the stable release channel.
3521 * [It is no longer possible to `match` on empty enum variants using
3522   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
3523 * The Unix-specific `MetadataExt` traits, including
3524   `os::unix::fs::MetadataExt`, which expose values such as inode
3525   numbers [no longer return platform-specific types][1.8r], but
3526   instead return widened integers. [RFC 1415].
3527 * [Modules sourced from the filesystem cannot appear within arbitrary
3528   blocks, but only within other modules][1.8mf].
3529 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
3530 * On Unix, [stack overflow triggers a runtime abort instead of a
3531   SIGSEGV][1.8so].
3532 * [`Command::spawn` and its equivalents return an error if any of
3533   its command-line arguments contain interior `NUL`s][1.8n].
3534 * [Tuple and unit enum variants from other crates are in the type
3535   namespace][1.8tn].
3536 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
3537   type instead of `.a` files][1.8st]. Additionally, for the MSVC
3538   toolchain, `rustc` emits import libraries named `foo.dll.lib`
3539   instead of `foo.lib`.
3540
3541
3542 [1.8a]: https://github.com/rust-lang/rust/pull/30962
3543 [1.8b]: https://github.com/rust-lang/rust/pull/31123
3544 [1.8c]: https://github.com/rust-lang/rust/pull/31530
3545 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
3546 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
3547 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
3548 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
3549 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
3550 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
3551 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
3552 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
3553 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
3554 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
3555 [1.8h]: https://github.com/rust-lang/rust/pull/31460
3556 [1.8l]: https://github.com/rust-lang/rust/pull/31668
3557 [1.8m]: https://github.com/rust-lang/rust/pull/31020
3558 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
3559 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
3560 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
3561 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
3562 [1.8n]: https://github.com/rust-lang/rust/pull/31056
3563 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
3564 [1.8r]: https://github.com/rust-lang/rust/pull/31551
3565 [1.8so]: https://github.com/rust-lang/rust/pull/31333
3566 [1.8st]: https://github.com/rust-lang/rust/pull/29520
3567 [1.8t]: https://github.com/rust-lang/rust/pull/31358
3568 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
3569 [1.8u]: https://github.com/rust-lang/rust/pull/31793
3570 [1.8v]: https://github.com/rust-lang/rust/pull/31757
3571 [1.8w]: https://github.com/rust-lang/rust/pull/31904
3572 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
3573 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
3574 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
3575 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
3576 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
3577 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
3578 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
3579 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
3580 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
3581 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
3582 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
3583 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
3584 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
3585 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
3586 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
3587 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
3588 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
3589 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
3590 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
3591 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
3592 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
3593 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
3594 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
3595 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
3596 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
3597 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
3598 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
3599 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
3600 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
3601 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
3602
3603
3604 Version 1.7.0 (2016-03-03)
3605 ==========================
3606
3607 Libraries
3608 ---------
3609
3610 * Stabilized APIs
3611   * `Path`
3612     * [`Path::strip_prefix`][] (renamed from relative_from)
3613     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
3614   * `Ipv4Addr`
3615     * [`Ipv4Addr::is_loopback`]
3616     * [`Ipv4Addr::is_private`]
3617     * [`Ipv4Addr::is_link_local`]
3618     * [`Ipv4Addr::is_multicast`]
3619     * [`Ipv4Addr::is_broadcast`]
3620     * [`Ipv4Addr::is_documentation`]
3621   * `Ipv6Addr`
3622     * [`Ipv6Addr::is_unspecified`]
3623     * [`Ipv6Addr::is_loopback`]
3624     * [`Ipv6Addr::is_multicast`]
3625   * `Vec`
3626     * [`Vec::as_slice`]
3627     * [`Vec::as_mut_slice`]
3628   * `String`
3629     * [`String::as_str`]
3630     * [`String::as_mut_str`]
3631   * Slices
3632     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
3633     be the same length
3634     * `<[T]>::`[`sort_by_key`]
3635   * checked, saturated, and overflowing operations
3636     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
3637     * [`i32::saturating_mul`]
3638     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
3639     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
3640     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
3641     * [`u32::saturating_mul`]
3642     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
3643     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
3644     * and checked, saturated, and overflowing operations for other primitive types
3645   * FFI
3646     * [`ffi::IntoStringError`]
3647     * [`CString::into_string`]
3648     * [`CString::into_bytes`]
3649     * [`CString::into_bytes_with_nul`]
3650     * `From<CString> for Vec<u8>`
3651   * `IntoStringError`
3652     * [`IntoStringError::into_cstring`]
3653     * [`IntoStringError::utf8_error`]
3654     * `Error for IntoStringError`
3655   * Hashing
3656     * [`std::hash::BuildHasher`]
3657     * [`BuildHasher::Hasher`]
3658     * [`BuildHasher::build_hasher`]
3659     * [`std::hash::BuildHasherDefault`]
3660     * [`HashMap::with_hasher`]
3661     * [`HashMap::with_capacity_and_hasher`]
3662     * [`HashSet::with_hasher`]
3663     * [`HashSet::with_capacity_and_hasher`]
3664     * [`std::collections::hash_map::RandomState`]
3665     * [`RandomState::new`]
3666 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
3667   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
3668   from bytes is faster.
3669 * [The performance of `LineWriter` (and thus `io::stdout`) was
3670   improved by using `memchr` to search for newlines][1.7m].
3671 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
3672   `f64` variants were stabilized previously.
3673 * [`BTreeMap` was rewritten to use less memory and improve the performance
3674   of insertion and iteration, the latter by as much as 5x][1.7bm].
3675 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
3676   covariant over their contained type][1.7bt].
3677 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
3678   over their contained type][1.7ll].
3679 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
3680   searching methods.
3681 * [`Any` is implemented for unsized types][1.7a].
3682 * [`Hash` is implemented for `Duration`][1.7h].
3683
3684 Misc
3685 ----
3686
3687 * [When running tests with `--test`, rustdoc will pass `--cfg`
3688   arguments to the compiler][1.7dt].
3689 * [The compiler is built with RPATH information by default][1.7rpa].
3690   This means that it will be possible to run `rustc` when installed in
3691   unusual configurations without configuring the dynamic linker search
3692   path explicitly.
3693 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
3694   any RPATH entries (emitted with `-C rpath`) *not* take precedence
3695   over `LD_LIBRARY_PATH`.
3696
3697 Cargo
3698 -----
3699
3700 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
3701   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
3702 * [The `rerun-if-changed` build script directive no longer causes the
3703   build script to incorrectly run twice in certain scenarios][1.7rr].
3704
3705 Compatibility Notes
3706 -------------------
3707
3708 * Soundness fixes to the interactions between associated types and
3709   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
3710   code that violates the new rules. This is a significant change that
3711   is known to break existing code, so it has emitted warnings for the
3712   new error cases since 1.4 to give crate authors time to adapt. The
3713   details of what is changing are subtle; read the RFC for more.
3714 * [Several bugs in the compiler's visibility calculations were
3715   fixed][1.7v]. Since this was found to break significant amounts of
3716   code, the new errors will be emitted as warnings for several release
3717   cycles, under the `private_in_public` lint.
3718 * Defaulted type parameters were accidentally accepted in positions
3719   that were not intended. In this release, [defaulted type parameters
3720   appearing outside of type definitions will generate a
3721   warning][1.7d], which will become an error in future releases.
3722 * [Parsing "." as a float results in an error instead of 0][1.7p].
3723   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
3724 * [Borrows of closure parameters may not outlive the closure][1.7bc].
3725
3726 [1.7a]: https://github.com/rust-lang/rust/pull/30928
3727 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
3728 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
3729 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
3730 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
3731 [1.7d]: https://github.com/rust-lang/rust/pull/30724
3732 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
3733 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
3734 [1.7f]: https://github.com/rust-lang/rust/pull/30672
3735 [1.7h]: https://github.com/rust-lang/rust/pull/30818
3736 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
3737 [1.7m]: https://github.com/rust-lang/rust/pull/30381
3738 [1.7p]: https://github.com/rust-lang/rust/pull/30681
3739 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
3740 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
3741 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
3742 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
3743 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
3744 [1.7v]: https://github.com/rust-lang/rust/pull/29973
3745 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
3746 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
3747 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
3748 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
3749 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
3750 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
3751 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
3752 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
3753 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
3754 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
3755 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
3756 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
3757 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
3758 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
3759 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
3760 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
3761 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
3762 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
3763 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
3764 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
3765 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
3766 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
3767 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
3768 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
3769 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
3770 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
3771 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
3772 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
3773 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
3774 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
3775 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
3776 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
3777 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
3778 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
3779 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
3780 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
3781 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
3782 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
3783 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
3784 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
3785 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
3786 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
3787 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
3788 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
3789 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
3790 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
3791 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
3792 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
3793 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
3794 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
3795 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
3796 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
3797 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
3798 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
3799 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
3800 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
3801 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
3802 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
3803 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
3804 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
3805
3806
3807 Version 1.6.0 (2016-01-21)
3808 ==========================
3809
3810 Language
3811 --------
3812
3813 * The `#![no_std]` attribute causes a crate to not be linked to the
3814   standard library, but only the [core library][1.6co], as described
3815   in [RFC 1184]. The core library defines common types and traits but
3816   has no platform dependencies whatsoever, and is the basis for Rust
3817   software in environments that cannot support a full port of the
3818   standard library, such as operating systems. Most of the core
3819   library is now stable.
3820
3821 Libraries
3822 ---------
3823
3824 * Stabilized APIs:
3825   [`Read::read_exact`],
3826   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
3827   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
3828   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
3829   [`os::unix::fs::DirBuilderExt`],
3830   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
3831   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
3832   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
3833   [`collections::hash_map::Drain`],
3834   [`collections::hash_map::HashMap::drain`],
3835   [`collections::hash_set::Drain`],
3836   [`collections::hash_set::HashSet::drain`],
3837   [`collections::binary_heap::Drain`],
3838   [`collections::binary_heap::BinaryHeap::drain`],
3839   [`Vec::extend_from_slice`][] (renamed from `push_all`),
3840   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
3841   [`RwLock::into_inner`],
3842   [`Iterator::min_by_key`][] (renamed from `min_by`),
3843   [`Iterator::max_by_key`][] (renamed from `max_by`).
3844 * The [core library][1.6co] is stable, as are most of its APIs.
3845 * [The `assert_eq!` macro supports arguments that don't implement
3846   `Sized`][1.6ae], such as arrays. In this way it behaves more like
3847   `assert!`.
3848 * Several timer functions that take duration in milliseconds [are
3849   deprecated in favor of those that take `Duration`][1.6ms]. These
3850   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
3851   `thread::park_timeout_ms`.
3852 * The algorithm by which `Vec` reserves additional elements was
3853   [tweaked to not allocate excessive space][1.6a] while still growing
3854   exponentially.
3855 * `From` conversions are [implemented from integers to floats][1.6f]
3856   in cases where the conversion is lossless. Thus they are not
3857   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
3858   or `f64`. They are also not implemented for `isize` and `usize`
3859   because the implementations would be platform-specific. `From` is
3860   also implemented from `f32` to `f64`.
3861 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
3862 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
3863 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
3864 * [`BinaryHeap` was refactored][1.6bh] for modest performance
3865   improvements.
3866 * Sorting slices that are already sorted [is 50% faster in some
3867   cases][1.6s].
3868
3869 Cargo
3870 -----
3871
3872 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
3873 * Cargo build scripts can specify their dependencies by emitting the
3874   [`rerun-if-changed`][1.6rr] key.
3875 * crates.io will reject publication of crates with dependencies that
3876   have a wildcard version constraint. Crates with wildcard
3877   dependencies were seen to cause a variety of problems, as described
3878   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
3879   warning.
3880 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
3881   release folder.  A variety of artifacts that Cargo failed to clean
3882   are now correctly deleted.
3883
3884 Misc
3885 ----
3886
3887 * The `unreachable_code` lint [warns when a function call's argument
3888   diverges][1.6dv].
3889 * The parser indicates [failures that may be caused by
3890   confusingly-similar Unicode characters][1.6uc]
3891 * Certain macro errors [are reported at definition time][1.6m], not
3892   expansion.
3893
3894 Compatibility Notes
3895 -------------------
3896
3897 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
3898   environment variable when locating crates. This was a pre-cargo
3899   feature for integrating with the package manager that was
3900   accidentally never removed.
3901 * [A number of bugs were fixed in the privacy checker][1.6p] that
3902   could cause previously-accepted code to break.
3903 * [Modules and unit/tuple structs may not share the same name][1.6ts].
3904 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
3905   struct pattern syntax (`Foo(..)`) can no longer be used to match
3906   unit structs. This is a warning now, but will become an error in
3907   future releases. Patterns that share the same name as a const are
3908   now an error.
3909 * A bug was fixed that causes [rustc not to apply default type
3910   parameters][1.6xc] when resolving certain method implementations of
3911   traits defined in other crates.
3912
3913 [1.6a]: https://github.com/rust-lang/rust/pull/29454
3914 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
3915 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
3916 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
3917 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
3918 [1.6co]: http://doc.rust-lang.org/beta/core/index.html
3919 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
3920 [1.6f]: https://github.com/rust-lang/rust/pull/29129
3921 [1.6m]: https://github.com/rust-lang/rust/pull/29828
3922 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
3923 [1.6p]: https://github.com/rust-lang/rust/pull/29726
3924 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
3925 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
3926 [1.6s]: https://github.com/rust-lang/rust/pull/29675
3927 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
3928 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
3929 [1.6us]: https://github.com/rust-lang/rust/pull/29383
3930 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
3931 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
3932 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
3933 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
3934 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
3935 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
3936 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
3937 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
3938 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
3939 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
3940 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
3941 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
3942 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
3943 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
3944 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
3945 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
3946 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
3947 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
3948 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
3949 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
3950 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
3951 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
3952 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
3953 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
3954 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
3955 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
3956 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
3957 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
3958 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
3959 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
3960
3961
3962 Version 1.5.0 (2015-12-10)
3963 ==========================
3964
3965 * ~700 changes, numerous bugfixes
3966
3967 Highlights
3968 ----------
3969
3970 * Stabilized APIs:
3971   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
3972   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
3973   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
3974   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
3975   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
3976   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
3977   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
3978   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
3979   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
3980   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
3981   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
3982   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
3983   [`Path::read_link`], [`Path::symlink_metadata`],
3984   [`Utf8Error::valid_up_to`], [`Vec::resize`],
3985   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
3986   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
3987   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
3988   [`slice::split_first_mut`], [`slice::split_first`],
3989   [`slice::split_last_mut`], [`slice::split_last`],
3990   [`char::from_u32_unchecked`], [`fs::canonicalize`],
3991   [`str::MatchIndices`], [`str::RMatchIndices`],
3992   [`str::match_indices`], [`str::rmatch_indices`],
3993   [`str::slice_mut_unchecked`], [`string::ParseError`].
3994 * Rust applications hosted on crates.io can be installed locally to
3995   `~/.cargo/bin` with the [`cargo install`] command. Among other
3996   things this makes it easier to augment Cargo with new subcommands:
3997   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
3998   invoked as `cargo foo`.
3999 * Crates with wildcard (`*`) dependencies will [emit warnings when
4000   published][1.5w]. In 1.6 it will no longer be possible to publish
4001   crates with wildcard dependencies.
4002
4003 Breaking Changes
4004 ----------------
4005
4006 * The rules determining when a particular lifetime must outlive
4007   a particular value (known as '[dropck]') have been [modified
4008   to not rely on parametricity][1.5p].
4009 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4010   and `Arc`][1.5a]. Because these smart pointer types implement
4011   `Deref`, this causes breakage in cases where the interior type
4012   contains methods of the same name.
4013 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4014   that they could drop their content. Soundness fix.
4015 * All method invocations are [properly checked][1.5wf1] for
4016   [well-formedness][1.5wf2]. Soundness fix.
4017 * Traits whose supertraits contain `Self` are [not object
4018   safe][1.5o]. Soundness fix.
4019 * Target specifications support a [`no_default_libraries`][1.5nd]
4020   setting that controls whether `-nodefaultlibs` is passed to the
4021   linker, and in turn the `is_like_windows` setting no longer affects
4022   the `-nodefaultlibs` flag.
4023 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4024 * The `#[inline]` and `#[repr]` attributes [can only appear
4025   in valid locations][1.5at].
4026 * Native libraries linked from the local crate are [passed to
4027   the linker before native libraries from upstream crates][1.5nl].
4028 * Two rarely-used attributes, `#[no_debug]` and
4029   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4030 * Negation of unsigned integers, which has been a warning for
4031   several releases, [is now behind a feature gate and will
4032   generate errors][1.5nu].
4033 * The parser accidentally accepted visibility modifiers on
4034   enum variants, a bug [which has been fixed][1.5ev].
4035 * [A bug was fixed that allowed `use` statements to import unstable
4036   features][1.5use].
4037
4038 Language
4039 --------
4040
4041 * When evaluating expressions at compile-time that are not
4042   compile-time constants (const-evaluating expressions in non-const
4043   contexts), incorrect code such as overlong bitshifts and arithmetic
4044   overflow will [generate a warning instead of an error][1.5ce],
4045   delaying the error until runtime. This will allow the
4046   const-evaluator to be expanded in the future backwards-compatibly.
4047 * The `improper_ctypes` lint [no longer warns about using `isize` and
4048   `usize` in FFI][1.5ict].
4049
4050 Libraries
4051 ---------
4052
4053 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4054   invariant][1.5c].
4055 * `Default` is [implemented for mutable slices][1.5d].
4056 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4057 * There are now `From` conversions [between floating point
4058   types][1.5f] where the conversions are lossless.
4059 * There are now `From` conversions [between integer types][1.5i] where
4060   the conversions are lossless.
4061 * [`fs::Metadata` implements `Clone`][1.5fs].
4062 * The `parse` method [accepts a leading "+" when parsing
4063   integers][1.5pi].
4064 * [`AsMut` is implemented for `Vec`][1.5am].
4065 * The `clone_from` implementations for `String` and `BinaryHeap` [have
4066   been optimized][1.5cf] and no longer rely on the default impl.
4067 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
4068   `unsafe extern "C"` function types now [implement `Clone`,
4069   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
4070   `fmt::Debug` for up to 12 arguments][1.5fp].
4071 * [Dropping `Vec`s is much faster in unoptimized builds when the
4072   element types don't implement `Drop`][1.5dv].
4073 * A bug that caused in incorrect behavior when [combining `VecDeque`
4074   with zero-sized types][1.5vdz] was resolved.
4075 * [`PartialOrd` for slices is faster][1.5po].
4076
4077 Miscellaneous
4078 -------------
4079
4080 * [Crate metadata size was reduced by 20%][1.5md].
4081 * [Improvements to code generation reduced the size of libcore by 3.3
4082   MB and rustc's memory usage by 18MB][1.5m].
4083 * [Improvements to deref translation increased performance in
4084   unoptimized builds][1.5dr].
4085 * Various errors in trait resolution [are deduplicated to only be
4086   reported once][1.5te].
4087 * Rust has preliminary [support for rumprun kernels][1.5rr].
4088 * Rust has preliminary [support for NetBSD on amd64][1.5na].
4089
4090 [1.5use]: https://github.com/rust-lang/rust/pull/28364
4091 [1.5po]: https://github.com/rust-lang/rust/pull/28436
4092 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
4093 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
4094 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
4095 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
4096 [1.5md]: https://github.com/rust-lang/rust/pull/28521
4097 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
4098 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
4099 [1.5na]: https://github.com/rust-lang/rust/pull/28543
4100 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
4101 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
4102 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
4103 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
4104 [1.5te]: https://github.com/rust-lang/rust/pull/28645
4105 [1.5at]: https://github.com/rust-lang/rust/pull/28650
4106 [1.5am]: https://github.com/rust-lang/rust/pull/28663
4107 [1.5m]: https://github.com/rust-lang/rust/pull/28778
4108 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
4109 [1.5a]: https://github.com/rust-lang/rust/pull/28811
4110 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
4111 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
4112 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
4113 [1.5i]: https://github.com/rust-lang/rust/pull/28921
4114 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
4115 [1.5f]: https://github.com/rust-lang/rust/pull/29129
4116 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
4117 [1.5s]: https://github.com/rust-lang/rust/pull/29190
4118 [1.5d]: https://github.com/rust-lang/rust/pull/29245
4119 [1.5o]: https://github.com/rust-lang/rust/pull/29259
4120 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
4121 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4122 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
4123 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
4124 [1.5c]: https://github.com/rust-lang/rust/pull/29110
4125 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4126 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
4127 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
4128 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
4129 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
4130 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
4131 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
4132 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
4133 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
4134 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
4135 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
4136 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
4137 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
4138 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
4139 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
4140 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
4141 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
4142 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
4143 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
4144 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
4145 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
4146 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
4147 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
4148 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
4149 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
4150 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
4151 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
4152 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
4153 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
4154 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
4155 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
4156 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
4157 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
4158 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
4159 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
4160 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
4161 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
4162 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
4163 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
4164 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
4165 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
4166 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
4167 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
4168 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
4169 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
4170 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
4171 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
4172 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
4173 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
4174 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
4175 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
4176 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
4177 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
4178 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
4179
4180 Version 1.4.0 (2015-10-29)
4181 ==========================
4182
4183 * ~1200 changes, numerous bugfixes
4184
4185 Highlights
4186 ----------
4187
4188 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
4189   GNU) are now supported and recommended for use.
4190
4191 Breaking Changes
4192 ----------------
4193
4194 * [Several changes have been made to fix type soundness and improve
4195   the behavior of associated types][sound]. See [RFC 1214]. Although
4196   we have mostly introduced these changes as warnings this release, to
4197   become errors next release, there are still some scenarios that will
4198   see immediate breakage.
4199 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
4200   line breaks in addition to `\n`][crlf].
4201 * [Loans of `'static` lifetime extend to the end of a function][stat].
4202 * [`str::parse` no longer introduces avoidable rounding error when
4203   parsing floating point numbers. Together with earlier changes to
4204   float formatting/output, "round trips" like f.to_string().parse()
4205   now preserve the value of f exactly. Additionally, leading plus
4206   signs are now accepted][fp3].
4207
4208
4209 Language
4210 --------
4211
4212 * `use` statements that import multiple items [can now rename
4213   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
4214 * [Binops work correctly on fat pointers][binfat].
4215 * `pub extern crate`, which does not behave as expected, [issues a
4216   warning][pec] until a better solution is found.
4217
4218 Libraries
4219 ---------
4220
4221 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
4222   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
4223   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
4224   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
4225   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
4226   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
4227   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
4228   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
4229   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
4230   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
4231   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
4232   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
4233   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
4234   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
4235   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
4236   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
4237   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
4238   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
4239   [`thread::sleep`].
4240 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
4241   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
4242   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
4243   `f64::from_str_radix`.
4244 * [Reverse-searching strings is faster with the 'two-way'
4245   algorithm][s].
4246 * [`std::io::copy` allows `?Sized` arguments][cc].
4247 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
4248   [override `count`, `nth` and `last` with an O(1)
4249   implementation][it].
4250 * [`Default` is implemented for arrays up to `[T; 32]`][d].
4251 * [`IntoRawFd` has been added to the Unix-specific prelude,
4252   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
4253   prelude][pr].
4254 * [`Extend<String>` and `FromIterator<String` are both implemented for
4255   `String`][es].
4256 * [`IntoIterator` is implemented for references to `Option` and
4257   `Result`][into2].
4258 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
4259   Copy`][ext] as part of [RFC 839]. This will cause type inference
4260   breakage in rare situations.
4261 * [`BinaryHeap` implements `Debug`][bh2].
4262 * [`Borrow` and `BorrowMut` are implemented for fixed-size
4263   arrays][bm].
4264 * [`extern fn`s with the "Rust" and "C" ABIs implement common
4265   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
4266 * [String comparison is faster][faststr].
4267 * `&mut T` where `T: std::fmt::Write` [also implements
4268   `std::fmt::Write`][mutw].
4269 * [A stable regression in `VecDeque::push_back` and other
4270   capacity-altering methods that caused panics for zero-sized types
4271   was fixed][vd].
4272 * [Function pointers implement traits for up to 12 parameters][fp2].
4273
4274 Miscellaneous
4275 -------------
4276
4277 * The compiler [no longer uses the 'morestack' feature to prevent
4278   stack overflow][mm]. Instead it uses guard pages and stack
4279   probes (though stack probes are not yet implemented on any platform
4280   but Windows).
4281 * [The compiler matches traits faster when projections are involved][p].
4282 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
4283   `usize`][ffi].
4284 * [Cargo now displays useful information about what its doing during
4285   `cargo update`][cu].
4286
4287 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
4288 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
4289 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
4290 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
4291 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
4292 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
4293 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
4294 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
4295 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
4296 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
4297 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
4298 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
4299 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
4300 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
4301 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
4302 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
4303 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
4304 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
4305 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4306 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4307 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4308 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4309 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4310 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4311 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4312 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4313 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
4314 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
4315 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
4316 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
4317 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
4318 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
4319 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
4320 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
4321 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
4322 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
4323 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
4324 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
4325 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
4326 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
4327 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
4328 [bh2]: https://github.com/rust-lang/rust/pull/28156
4329 [binfat]: https://github.com/rust-lang/rust/pull/28270
4330 [bm]: https://github.com/rust-lang/rust/pull/28197
4331 [cc]: https://github.com/rust-lang/rust/pull/27531
4332 [crlf]: https://github.com/rust-lang/rust/pull/28034
4333 [cu]: https://github.com/rust-lang/cargo/pull/1931
4334 [d]: https://github.com/rust-lang/rust/pull/27825
4335 [dep]: https://github.com/rust-lang/rust/pull/28339
4336 [es]: https://github.com/rust-lang/rust/pull/27956
4337 [ext]: https://github.com/rust-lang/rust/pull/28094
4338 [faststr]: https://github.com/rust-lang/rust/pull/28338
4339 [ffi]: https://github.com/rust-lang/rust/pull/28779
4340 [fp]: https://github.com/rust-lang/rust/pull/28268
4341 [fp2]: https://github.com/rust-lang/rust/pull/28560
4342 [fp3]: https://github.com/rust-lang/rust/pull/27307
4343 [i]: https://github.com/rust-lang/rust/pull/27451
4344 [into2]: https://github.com/rust-lang/rust/pull/28039
4345 [it]: https://github.com/rust-lang/rust/pull/27652
4346 [mm]: https://github.com/rust-lang/rust/pull/27338
4347 [mutw]: https://github.com/rust-lang/rust/pull/28368
4348 [sound]: https://github.com/rust-lang/rust/pull/27641
4349 [p]: https://github.com/rust-lang/rust/pull/27866
4350 [pec]: https://github.com/rust-lang/rust/pull/28486
4351 [pr]: https://github.com/rust-lang/rust/pull/27896
4352 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4353 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4354 [s]: https://github.com/rust-lang/rust/pull/27474
4355 [stab]: https://github.com/rust-lang/rust/pull/28339
4356 [stat]: https://github.com/rust-lang/rust/pull/28321
4357 [vd]: https://github.com/rust-lang/rust/pull/28494
4358
4359 Version 1.3.0 (2015-09-17)
4360 ==============================
4361
4362 * ~900 changes, numerous bugfixes
4363
4364 Highlights
4365 ----------
4366
4367 * The [new object lifetime defaults][nold] have been [turned
4368   on][nold2] after a cycle of warnings about the change. Now types
4369   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
4370   being interpreted as `&'a Box<Trait+'a>` to `&'a
4371   Box<Trait+'static>`.
4372 * [The Rustonomicon][nom] is a new book in the official documentation
4373   that dives into writing unsafe Rust.
4374 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
4375   timekeeping is employed by other std APIs, as well as out-of-tree
4376   time crates.
4377
4378 Breaking Changes
4379 ----------------
4380
4381 * The [new object lifetime defaults][nold] have been [turned
4382   on][nold2] after a cycle of warnings about the change.
4383 * There is a known [regression][lr] in how object lifetime elision is
4384   interpreted, the proper solution for which is undetermined.
4385 * The `#[prelude_import]` attribute, an internal implementation
4386   detail, was accidentally stabilized previously. [It has been put
4387   behind the `prelude_import` feature gate][pi]. This change is
4388   believed to break no existing code.
4389 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4390   [more sane for dynamically sized types][dst3]. Code that relied on
4391   the previous behavior is thought to be broken.
4392 * The `dropck` rules, which checks that destructors can't access
4393   destroyed values, [have been updated][dropck] to match the
4394   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
4395   cause some previously-compiling code to no longer build.
4396
4397 Language
4398 --------
4399
4400 * The [new object lifetime defaults][nold] have been [turned
4401   on][nold2] after a cycle of warnings about the change.
4402 * Semicolons may [now follow types and paths in
4403   macros](https://github.com/rust-lang/rust/pull/27000).
4404 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4405   [more sane for dynamically sized types][dst3]. Code that relied on
4406   the previous behavior is not known to exist, and suspected to be
4407   broken.
4408 * `'static` variables [may now be recursive][st].
4409 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
4410   implementations correctly.
4411 * The `dropck` rules, which checks that destructors can't access
4412   destroyed values, [have been updated][dropck] to match the
4413   [RFC][dropckrfc].
4414
4415 Libraries
4416 ---------
4417
4418 * The [`Duration`] API, [has been stabilized][ds], as well as the
4419   `std::time` module, which presently contains only `Duration`.
4420 * `Box<str>` and `Box<[T]>` both implement `Clone`.
4421 * The owned C string, [`CString`], implements [`Borrow`] and the
4422   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
4423   these allow C strings to be borrowed and cloned in generic code.
4424 * [`CStr`] implements [`Debug`].
4425 * [`AtomicPtr`] implements [`Debug`].
4426 * [`Error`] trait objects [can be downcast to their concrete types][e]
4427   in many common configurations, using the [`is`], [`downcast`],
4428   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
4429   [`Any`] trait.
4430 * Searching for substrings now [employs the two-way algorithm][search]
4431   instead of doing a naive search. This gives major speedups to a
4432   number of methods, including [`contains`][sc], [`find`][sf],
4433   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
4434   [`ends_with`][sew] are also faster.
4435 * The performance of `PartialEq` for slices is [much faster][ps].
4436 * The [`Hash`] trait offers the default method, [`hash_slice`], which
4437   is overridden and optimized by the implementations for scalars.
4438 * The [`Hasher`] trait now has a number of specialized `write_*`
4439   methods for primitive types, for efficiency.
4440 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
4441   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
4442   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
4443   of [`std::error::Error::cause`][iec] also delegates to the inner
4444   error.
4445 * [`process::Child`][pc] gained the [`id`] method, which returns a
4446   `u32` representing the platform-specific process identifier.
4447 * The [`connect`] method on slices is deprecated, replaced by the new
4448   [`join`] method (note that both of these are on the *unstable*
4449   [`SliceConcatExt`] trait, but through the magic of the prelude are
4450   available to stable code anyway).
4451 * The [`Div`] operator is implemented for [`Wrapping`] types.
4452 * [`DerefMut` is implemented for `String`][dms].
4453 * Performance of SipHash (the default hasher for `HashMap`) is
4454   [better for long data][sh].
4455 * [`AtomicPtr`] implements [`Send`].
4456 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
4457   are now [specialized to use uninitialized buffers for increased
4458   performance][rte].
4459 * Lifetime parameters of foreign functions [are now resolved
4460   properly][f].
4461
4462 Misc
4463 ----
4464
4465 * Rust can now, with some coercion, [produce programs that run on
4466   Windows XP][xp], though XP is not considered a supported platform.
4467 * Porting Rust on Windows from the GNU toolchain to MSVC continues
4468   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
4469   recommended for use in 1.3, though should be fully-functional
4470   in the [64-bit 1.4 beta][b14].
4471 * On Fedora-based systems installation will [properly configure the
4472   dynamic linker][fl].
4473 * The compiler gained many new extended error descriptions, which can
4474   be accessed with the `--explain` flag.
4475 * The `dropck` pass, which checks that destructors can't access
4476   destroyed values, [has been rewritten][dropck]. This fixes some
4477   soundness holes, and as such will cause some previously-compiling
4478   code to no longer build.
4479 * `rustc` now uses [LLVM to write archive files where possible][ar].
4480   Eventually this will eliminate the compiler's dependency on the ar
4481   utility.
4482 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
4483   supported FreeBSD on x86_64).
4484 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
4485   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
4486   more strict.
4487 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
4488   will kill the process instead of leaking][nlp].
4489
4490 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
4491 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
4492 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
4493 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
4494 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
4495 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
4496 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
4497 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
4498 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
4499 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
4500 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
4501 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
4502 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
4503 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4504 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
4505 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
4506 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
4507 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
4508 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
4509 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
4510 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
4511 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
4512 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
4513 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
4514 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
4515 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
4516 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
4517 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
4518 [ar]: https://github.com/rust-lang/rust/pull/26926
4519 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
4520 [dms]: https://github.com/rust-lang/rust/pull/26241
4521 [dropck]: https://github.com/rust-lang/rust/pull/27261
4522 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
4523 [ds]: https://github.com/rust-lang/rust/pull/26818
4524 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
4525 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
4526 [dst3]: https://github.com/rust-lang/rust/pull/27351
4527 [e]: https://github.com/rust-lang/rust/pull/24793
4528 [f]: https://github.com/rust-lang/rust/pull/26588
4529 [fb]: https://github.com/rust-lang/rust/pull/26959
4530 [fl]: https://github.com/rust-lang/rust-installer/pull/41
4531 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
4532 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
4533 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
4534 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
4535 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
4536 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
4537 [lic]: https://github.com/rust-lang/rust/pull/26583
4538 [lnu]: https://github.com/rust-lang/rust/pull/27026
4539 [lr]: https://github.com/rust-lang/rust/issues/27248
4540 [lum]: https://github.com/rust-lang/rust/pull/26378
4541 [lur]: https://github.com/rust-lang/rust/pull/26783
4542 [nlp]: https://github.com/rust-lang/rust/pull/27176
4543 [nold2]: https://github.com/rust-lang/rust/pull/27045
4544 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
4545 [nom]: http://doc.rust-lang.org/nightly/nomicon/
4546 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
4547 [pi]: https://github.com/rust-lang/rust/pull/26699
4548 [ps]: https://github.com/rust-lang/rust/pull/26884
4549 [rte]: https://github.com/rust-lang/rust/pull/26950
4550 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
4551 [search]: https://github.com/rust-lang/rust/pull/26327
4552 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
4553 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
4554 [sh]: https://github.com/rust-lang/rust/pull/27280
4555 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
4556 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
4557 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
4558 [st]: https://github.com/rust-lang/rust/pull/26630
4559 [win1]: https://github.com/rust-lang/rust/pull/26569
4560 [win2]: https://github.com/rust-lang/rust/pull/26741
4561 [win3]: https://github.com/rust-lang/rust/pull/26741
4562 [win4]: https://github.com/rust-lang/rust/pull/27210
4563 [xp]: https://github.com/rust-lang/rust/pull/26569
4564
4565 Version 1.2.0 (2015-08-07)
4566 ==========================
4567
4568 * ~1200 changes, numerous bugfixes
4569
4570 Highlights
4571 ----------
4572
4573 * [Dynamically-sized-type coercions][dst] allow smart pointer types
4574   like `Rc` to contain types without a fixed size, arrays and trait
4575   objects, finally enabling use of `Rc<[T]>` and completing the
4576   implementation of DST.
4577 * [Parallel codegen][parcodegen] is now working again, which can
4578   substantially speed up large builds in debug mode; It also gets
4579   another ~33% speedup when bootstrapping on a 4 core machine (using 8
4580   jobs). It's not enabled by default, but will be "in the near
4581   future". It can be activated with the `-C codegen-units=N` flag to
4582   `rustc`.
4583 * This is the first release with [experimental support for linking
4584   with the MSVC linker and lib C on Windows (instead of using the GNU
4585   variants via MinGW)][win]. It is yet recommended only for the most
4586   intrepid Rustaceans.
4587 * Benchmark compilations are showing a 30% improvement in
4588   bootstrapping over 1.1.
4589
4590 Breaking Changes
4591 ----------------
4592
4593 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
4594   unicode case mapping, which is a previously-planned change in
4595   behavior and considered a bugfix.
4596 * [`mem::align_of`] now specifies [the *minimum alignment* for
4597   T][align], which is usually the alignment programs are interested
4598   in, and the same value reported by clang's
4599   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
4600   break real code.
4601 * [The `#[packed]` attribute is no longer silently accepted by the
4602   compiler][packed]. This attribute did nothing and code that
4603   mentioned it likely did not work as intended.
4604 * Associated type defaults are [now behind the
4605   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
4606   defaults *did not work*, but could be mentioned syntactically. As
4607   such this breakage has minimal impact.
4608
4609 Language
4610 --------
4611
4612 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
4613   matching against dereferencable values.
4614
4615 Libraries
4616 ---------
4617
4618 * The [`Extend`] trait, which grows a collection from an iterator, is
4619   implemented over iterators of references, for `String`, `Vec`,
4620   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
4621   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
4622 * The [`iter::once`] function returns an iterator that yields a single
4623   element, and [`iter::empty`] returns an iterator that yields no
4624   elements.
4625 * The [`matches`] and [`rmatches`] methods on `str` return iterators
4626   over substring matches.
4627 * [`Cell`] and [`RefCell`] both implement `Eq`.
4628 * A number of methods for wrapping arithmetic are added to the
4629   integral types, [`wrapping_div`], [`wrapping_rem`],
4630   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
4631   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
4632   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
4633   type.. It is illegal for the default arithmetic operations in Rust
4634   to overflow; the desire to wrap must be explicit.
4635 * The `{:#?}` formatting specifier [displays the alternate,
4636   pretty-printed][debugfmt] form of the `Debug` formatter. This
4637   feature was actually introduced prior to 1.0 with little
4638   fanfare.
4639 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
4640   for writing data to formatted strings, similar to [`io::Write`].
4641 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
4642   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
4643   are used by code generators to emit implementations of [`Debug`].
4644 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
4645   methods that convert case, following Unicode case mapping.
4646 * It is now easier to handle poisoned locks. The [`PoisonError`]
4647   type, returned by failing lock operations, exposes `into_inner`,
4648   `get_ref`, and `get_mut`, which all give access to the inner lock
4649   guard, and allow the poisoned lock to continue to operate. The
4650   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
4651   poisoned lock without attempting to take the lock.
4652 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
4653   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
4654   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
4655   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
4656   `ChildStderr`.
4657 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
4658   malformed input.
4659
4660 Misc
4661 ----
4662
4663 * `rustc` employs smarter heuristics for guessing at [typos].
4664 * `rustc` emits more efficient code for [no-op conversions between
4665   unsafe pointers][nop].
4666 * Fat pointers are now [passed in pairs of immediate arguments][fat],
4667   resulting in faster compile times and smaller code.
4668
4669 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
4670 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4671 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
4672 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
4673 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
4674 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
4675 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
4676 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
4677 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
4678 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
4679 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
4680 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
4681 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
4682 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
4683 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
4684 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
4685 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
4686 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
4687 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
4688 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
4689 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
4690 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
4691 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
4692 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
4693 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
4694 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
4695 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
4696 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
4697 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
4698 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
4699 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
4700 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
4701 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
4702 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
4703 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
4704 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
4705 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
4706 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
4707 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
4708 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
4709 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
4710 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
4711 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
4712 [align]: https://github.com/rust-lang/rust/pull/25646
4713 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
4714 [typos]: https://github.com/rust-lang/rust/pull/26087
4715 [nop]: https://github.com/rust-lang/rust/pull/26336
4716 [fat]: https://github.com/rust-lang/rust/pull/26411
4717 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
4718 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
4719 [packed]: https://github.com/rust-lang/rust/pull/25541
4720 [ad]: https://github.com/rust-lang/rust/pull/27382
4721 [win]: https://github.com/rust-lang/rust/pull/25350
4722
4723 Version 1.1.0 (2015-06-25)
4724 =========================
4725
4726 * ~850 changes, numerous bugfixes
4727
4728 Highlights
4729 ----------
4730
4731 * The [`std::fs` module has been expanded][fs] to expand the set of
4732   functionality exposed:
4733   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
4734     don't incur a syscall on some platforms.
4735   * A `symlink_metadata` function has been added.
4736   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
4737     access to all underlying information.
4738 * The compiler now contains extended explanations of many errors. When an error
4739   with an explanation occurs the compiler suggests using the `--explain` flag
4740   to read the explanation. Error explanations are also [available online][err-index].
4741 * Thanks to multiple [improvements][sk] to [type checking][pre], as
4742   well as other work, the time to bootstrap the compiler decreased by
4743   32%.
4744
4745 Libraries
4746 ---------
4747
4748 * The [`str::split_whitespace`] method splits a string on unicode
4749   whitespace boundaries.
4750 * On both Windows and Unix, new extension traits provide conversion of
4751   I/O types to and from the underlying system handles. On Unix, these
4752   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
4753   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
4754   `TcpListener`, and `UpdSocket`. Further implementations for
4755   `std::process` will be stabilized later.
4756 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
4757   Windows, symlinks can be created with
4758   `std::os::windows::symlink_dir` and
4759   `std::os::windows::symlink_file`.
4760 * The `mpsc::Receiver` type can now be converted into an iterator with
4761   `into_iter` on the [`IntoIterator`] trait.
4762 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
4763   implementation of the [`From`] trait.
4764 * The `Debug` implementation for `RangeFull` [creates output that is
4765   more consistent with other implementations][rf].
4766 * [`Debug` is implemented for `File`][file].
4767 * The `Default` implementation for `Arc` [no longer requires `Sync +
4768   Send`][arc].
4769 * [The `Iterator` methods `count`, `nth`, and `last` have been
4770   overridden for slices to have O(1) performance instead of O(n)][si].
4771 * Incorrect handling of paths on Windows has been improved in both the
4772   compiler and the standard library.
4773 * [`AtomicPtr` gained a `Default` implementation][ap].
4774 * In accordance with Rust's policy on arithmetic overflow `abs` now
4775   [panics on overflow when debug assertions are enabled][abs].
4776 * The [`Cloned`] iterator, which was accidentally left unstable for
4777   1.0 [has been stabilized][c].
4778 * The [`Incoming`] iterator, which iterates over incoming TCP
4779   connections, and which was accidentally unnamable in 1.0, [is now
4780   properly exported][inc].
4781 * [`BinaryHeap`] no longer corrupts itself [when functions called by
4782   `sift_up` or `sift_down` panic][bh].
4783 * The [`split_off`] method of `LinkedList` [no longer corrupts
4784   the list in certain scenarios][ll].
4785
4786 Misc
4787 ----
4788
4789 * Type checking performance [has improved notably][sk] with
4790   [multiple improvements][pre].
4791 * The compiler [suggests code changes][ch] for more errors.
4792 * rustc and it's build system have experimental support for [building
4793   toolchains against MUSL][m] instead of glibc on Linux.
4794 * The compiler defines the `target_env` cfg value, which is used for
4795   distinguishing toolchains that are otherwise for the same
4796   platform. Presently this is set to `gnu` for common GNU Linux
4797   targets and for MinGW targets, and `musl` for MUSL Linux targets.
4798 * The [`cargo rustc`][crc] command invokes a build with custom flags
4799   to rustc.
4800 * [Android executables are always position independent][pie].
4801 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
4802   with `Drop`][drop].
4803
4804 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
4805 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
4806 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
4807 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
4808 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
4809 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
4810 [rf]: https://github.com/rust-lang/rust/pull/24491
4811 [err-index]: https://doc.rust-lang.org/error-index.html
4812 [sk]: https://github.com/rust-lang/rust/pull/24615
4813 [pre]: https://github.com/rust-lang/rust/pull/25323
4814 [file]: https://github.com/rust-lang/rust/pull/24598
4815 [ch]: https://github.com/rust-lang/rust/pull/24683
4816 [arc]: https://github.com/rust-lang/rust/pull/24695
4817 [si]: https://github.com/rust-lang/rust/pull/24701
4818 [ap]: https://github.com/rust-lang/rust/pull/24834
4819 [m]: https://github.com/rust-lang/rust/pull/24777
4820 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
4821 [crc]: https://github.com/rust-lang/cargo/pull/1568
4822 [pie]: https://github.com/rust-lang/rust/pull/24953
4823 [abs]: https://github.com/rust-lang/rust/pull/25441
4824 [c]: https://github.com/rust-lang/rust/pull/25496
4825 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
4826 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
4827 [inc]: https://github.com/rust-lang/rust/pull/25522
4828 [bh]: https://github.com/rust-lang/rust/pull/25856
4829 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
4830 [ll]: https://github.com/rust-lang/rust/pull/26022
4831 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
4832 [drop]: https://github.com/rust-lang/rust/pull/24935
4833
4834 Version 1.0.0 (2015-05-15)
4835 ========================
4836
4837 * ~1500 changes, numerous bugfixes
4838
4839 Highlights
4840 ----------
4841
4842 * The vast majority of the standard library is now `#[stable]`. It is
4843   no longer possible to use unstable features with a stable build of
4844   the compiler.
4845 * Many popular crates on [crates.io] now work on the stable release
4846   channel.
4847 * Arithmetic on basic integer types now [checks for overflow in debug
4848   builds][overflow].
4849
4850 Language
4851 --------
4852
4853 * Several [restrictions have been added to trait coherence][coh] in
4854   order to make it easier for upstream authors to change traits
4855   without breaking downstream code.
4856 * Digits of binary and octal literals are [lexed more eagerly][lex] to
4857   improve error messages and macro behavior. For example, `0b1234` is
4858   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
4859 * Trait bounds [are always invariant][inv], eliminating the need for
4860   the `PhantomFn` and `MarkerTrait` lang items, which have been
4861   removed.
4862 * ["-" is no longer a valid character in crate names][cr], the `extern crate
4863   "foo" as bar` syntax has been replaced with `extern crate foo as
4864   bar`, and Cargo now automatically translates "-" in *package* names
4865   to underscore for the crate name.
4866 * [Lifetime shadowing is an error][lt].
4867 * [`Send` no longer implies `'static`][send-rfc].
4868 * [UFCS now supports trait-less associated paths][moar-ufcs] like
4869   `MyType::default()`.
4870 * Primitive types [now have inherent methods][prim-inherent],
4871   obviating the need for extension traits like `SliceExt`.
4872 * Methods with `Self: Sized` in their `where` clause are [considered
4873   object-safe][self-sized], allowing many extension traits like
4874   `IteratorExt` to be merged into the traits they extended.
4875 * You can now [refer to associated types][assoc-where] whose
4876   corresponding trait bounds appear only in a `where` clause.
4877 * The final bits of [OIBIT landed][oibit-final], meaning that traits
4878   like `Send` and `Sync` are now library-defined.
4879 * A [Reflect trait][reflect] was introduced, which means that
4880   downcasting via the `Any` trait is effectively limited to concrete
4881   types. This helps retain the potentially-important "parametricity"
4882   property: generic code cannot behave differently for different type
4883   arguments except in minor ways.
4884 * The `unsafe_destructor` feature is now deprecated in favor of the
4885   [new `dropck`][dropck]. This change is a major reduction in unsafe
4886   code.
4887
4888 Libraries
4889 ---------
4890
4891 * The `thread_local` module [has been renamed to `std::thread`][th].
4892 * The methods of `IteratorExt` [have been moved to the `Iterator`
4893   trait itself][ie].
4894 * Several traits that implement Rust's conventions for type
4895   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
4896   [centralized in the `std::convert` module][con].
4897 * The `FromError` trait [was removed in favor of `From`][fe].
4898 * The basic sleep function [has moved to
4899   `std::thread::sleep_ms`][slp].
4900 * The `splitn` function now takes an `n` parameter that represents the
4901   number of items yielded by the returned iterator [instead of the
4902   number of 'splits'][spl].
4903 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
4904 * [Derived implementations of `PartialOrd` now order enums according
4905   to their explicitly-assigned discriminants][po].
4906 * [Methods for searching strings are generic over `Pattern`s][pat],
4907   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
4908   some others.
4909 * [In method resolution, object methods are resolved before inherent
4910   methods][meth].
4911 * [`String::from_str` has been deprecated in favor of the `From` impl,
4912   `String::from`][sf].
4913 * [`io::Error` implements `Sync`][ios].
4914 * [The `words` method on `&str` has been replaced with
4915   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
4916   a word?'
4917 * The new path and IO modules are complete and `#[stable]`. This
4918   was the major library focus for this cycle.
4919 * The path API was [revised][path-normalize] to normalize `.`,
4920   adjusting the tradeoffs in favor of the most common usage.
4921 * A large number of remaining APIs in `std` were also stabilized
4922   during this cycle; about 75% of the non-deprecated API surface
4923   is now stable.
4924 * The new [string pattern API][string-pattern] landed, which makes
4925   the string slice API much more internally consistent and flexible.
4926 * A new set of [generic conversion traits][conversion] replaced
4927   many existing ad hoc traits.
4928 * Generic numeric traits were [completely removed][num-traits]. This
4929   was made possible thanks to inherent methods for primitive types,
4930   and the removal gives maximal flexibility for designing a numeric
4931   hierarchy in the future.
4932 * The `Fn` traits are now related via [inheritance][fn-inherit]
4933   and provide ergonomic [blanket implementations][fn-blanket].
4934 * The `Index` and `IndexMut` traits were changed to
4935   [take the index by value][index-value], enabling code like
4936   `hash_map["string"]` to work.
4937 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
4938   `Copy` data is known to be `Clone` as well.
4939
4940 Misc
4941 ----
4942
4943 * Many errors now have extended explanations that can be accessed with
4944   the `--explain` flag to `rustc`.
4945 * Many new examples have been added to the standard library
4946   documentation.
4947 * rustdoc has received a number of improvements focused on completion
4948   and polish.
4949 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
4950 * Much headway was made on ecosystem-wide CI, making it possible
4951   to [compare builds for breakage][ci-compare].
4952
4953
4954 [crates.io]: http://crates.io
4955 [clo]: https://github.com/rust-lang/rust/pull/24034
4956 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
4957 [con]: https://github.com/rust-lang/rust/pull/23875
4958 [cr]: https://github.com/rust-lang/rust/pull/23419
4959 [fe]: https://github.com/rust-lang/rust/pull/23879
4960 [ie]: https://github.com/rust-lang/rust/pull/23300
4961 [inv]: https://github.com/rust-lang/rust/pull/23938
4962 [ios]: https://github.com/rust-lang/rust/pull/24133
4963 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
4964 [lt]: https://github.com/rust-lang/rust/pull/24057
4965 [meth]: https://github.com/rust-lang/rust/pull/24056
4966 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
4967 [po]: https://github.com/rust-lang/rust/pull/24270
4968 [sf]: https://github.com/rust-lang/rust/pull/24517
4969 [slp]: https://github.com/rust-lang/rust/pull/23949
4970 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
4971 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
4972 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
4973 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
4974 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
4975 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
4976 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
4977 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
4978 [self-sized]: https://github.com/rust-lang/rust/pull/22301
4979 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
4980 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
4981 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
4982 [reflect]: https://github.com/rust-lang/rust/pull/23712
4983 [conversion]: https://github.com/rust-lang/rfcs/pull/529
4984 [num-traits]: https://github.com/rust-lang/rust/pull/23549
4985 [index-value]: https://github.com/rust-lang/rust/pull/23601
4986 [dropck]: https://github.com/rust-lang/rfcs/pull/769
4987 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
4988 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
4989 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
4990 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
4991 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
4992
4993
4994 Version 1.0.0-alpha.2 (2015-02-20)
4995 =====================================
4996
4997 * ~1300 changes, numerous bugfixes
4998
4999 * Highlights
5000
5001     * The various I/O modules were [overhauled][io-rfc] to reduce
5002       unnecessary abstractions and provide better interoperation with
5003       the underlying platform. The old `io` module remains temporarily
5004       at `std::old_io`.
5005     * The standard library now [participates in feature gating][feat],
5006       so use of unstable libraries now requires a `#![feature(...)]`
5007       attribute. The impact of this change is [described on the
5008       forum][feat-forum]. [RFC][feat-rfc].
5009
5010 * Language
5011
5012     * `for` loops [now operate on the `IntoIterator` trait][into],
5013       which eliminates the need to call `.iter()`, etc. to iterate
5014       over collections. There are some new subtleties to remember
5015       though regarding what sort of iterators various types yield, in
5016       particular that `for foo in bar { }` yields values from a move
5017       iterator, destroying the original collection. [RFC][into-rfc].
5018     * Objects now have [default lifetime bounds][obj], so you don't
5019       have to write `Box<Trait+'static>` when you don't care about
5020       storing references. [RFC][obj-rfc].
5021     * In types that implement `Drop`, [lifetimes must outlive the
5022       value][drop]. This will soon make it possible to safely
5023       implement `Drop` for types where `#[unsafe_destructor]` is now
5024       required. Read the [gorgeous RFC][drop-rfc] for details.
5025     * The fully qualified <T as Trait>::X syntax lets you set the Self
5026       type for a trait method or associated type. [RFC][ufcs-rfc].
5027     * References to types that implement `Deref<U>` now [automatically
5028       coerce to references][deref] to the dereferenced type `U`,
5029       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5030       should eliminate many unsightly uses of `&*`, as when converting
5031       from references to vectors into references to
5032       slices. [RFC][deref-rfc].
5033     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5034       `|:|`) is obsolete and closure kind is inferred from context.
5035     * [`Self` is a keyword][Self].
5036
5037 * Libraries
5038
5039     * The `Show` and `String` formatting traits [have been
5040       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5041       their related purposes. Automatically getting a string
5042       conversion to use with `format!("{:?}", something_to_debug)` is
5043       now written `#[derive(Debug)]`.
5044     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5045       OsStr}`, provide strings in platform-specific encodings for easier
5046       interop with system APIs. [RFC][osstr-rfc].
5047     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5048       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5049       creating raw pointers.
5050
5051 * Tooling
5052
5053     * Certain long error messages of the form 'expected foo found bar'
5054       are now [split neatly across multiple
5055       lines][multiline]. Examples in the PR.
5056     * On Unix Rust can be [uninstalled][un] by running
5057       `/usr/local/lib/rustlib/uninstall.sh`.
5058     * The `#[rustc_on_unimplemented]` attribute, requiring the
5059       'on_unimplemented' feature, lets rustc [display custom error
5060       messages when a trait is expected to be implemented for a type
5061       but is not][onun].
5062
5063 * Misc
5064
5065     * Rust is tested against a [LALR grammar][lalr], which parses
5066       almost all the Rust files that rustc does.
5067
5068 [boxraw]: https://github.com/rust-lang/rust/pull/21318
5069 [close]: https://github.com/rust-lang/rust/pull/21843
5070 [deref]: https://github.com/rust-lang/rust/pull/21351
5071 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
5072 [drop]: https://github.com/rust-lang/rust/pull/21972
5073 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5074 [feat]: https://github.com/rust-lang/rust/pull/21248
5075 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
5076 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
5077 [fmt]: https://github.com/rust-lang/rust/pull/21457
5078 [into]: https://github.com/rust-lang/rust/pull/20790
5079 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
5080 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5081 [lalr]: https://github.com/rust-lang/rust/pull/21452
5082 [multiline]: https://github.com/rust-lang/rust/pull/19870
5083 [obj]: https://github.com/rust-lang/rust/pull/22230
5084 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
5085 [onun]: https://github.com/rust-lang/rust/pull/20889
5086 [osstr]: https://github.com/rust-lang/rust/pull/21488
5087 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5088 [Self]: https://github.com/rust-lang/rust/pull/22158
5089 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
5090 [un]: https://github.com/rust-lang/rust/pull/22256
5091
5092
5093 Version 1.0.0-alpha (2015-01-09)
5094 ==================================
5095
5096   * ~2400 changes, numerous bugfixes
5097
5098   * Highlights
5099
5100     * The language itself is considered feature complete for 1.0,
5101       though there will be many usability improvements and bugfixes
5102       before the final release.
5103     * Nearly 50% of the public API surface of the standard library has
5104       been declared 'stable'. Those interfaces are unlikely to change
5105       before 1.0.
5106     * The long-running debate over integer types has been
5107       [settled][ints]: Rust will ship with types named `isize` and
5108       `usize`, rather than `int` and `uint`, for pointer-sized
5109       integers. Guidelines will be rolled out during the alpha cycle.
5110     * Most crates that are not `std` have been moved out of the Rust
5111       distribution into the Cargo ecosystem so they can evolve
5112       separately and don't need to be stabilized as quickly, including
5113       'time', 'getopts', 'num', 'regex', and 'term'.
5114     * Documentation continues to be expanded with more API coverage, more
5115       examples, and more in-depth explanations. The guides have been
5116       consolidated into [The Rust Programming Language][trpl].
5117     * "[Rust By Example][rbe]" is now maintained by the Rust team.
5118     * All official Rust binary installers now come with [Cargo], the
5119       Rust package manager.
5120
5121 * Language
5122
5123     * Closures have been [completely redesigned][unboxed] to be
5124       implemented in terms of traits, can now be used as generic type
5125       bounds and thus monomorphized and inlined, or via an opaque
5126       pointer (boxed) as in the old system. The new system is often
5127       referred to as 'unboxed' closures.
5128     * Traits now support [associated types][assoc], allowing families
5129       of related types to be defined together and used generically in
5130       powerful ways.
5131     * Enum variants are [namespaced by their type names][enum].
5132     * [`where` clauses][where] provide a more versatile and attractive
5133       syntax for specifying generic bounds, though the previous syntax
5134       remains valid.
5135     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
5136       numeric types.
5137     * Rust [no longer has a runtime][rt] of any description, and only
5138       supports OS threads, not green threads.
5139     * At long last, Rust has been overhauled for 'dynamically-sized
5140       types' ([DST]), which integrates 'fat pointers' (object types,
5141       arrays, and `str`) more deeply into the type system, making it
5142       more consistent.
5143     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
5144       `..j` that produce range types and which, when combined with the
5145       `Index` operator and multidispatch, leads to a convenient slice
5146       notation, `[i..j]`.
5147     * The new range syntax revealed an ambiguity in the fixed-length
5148       array syntax, so now fixed length arrays [are written `[T;
5149       N]`][arrays].
5150     * The `Copy` trait is no longer implemented automatically. Unsafe
5151       pointers no longer implement `Sync` and `Send` so types
5152       containing them don't automatically either. `Sync` and `Send`
5153       are now 'unsafe traits' so one can "forcibly" implement them via
5154       `unsafe impl` if a type confirms to the requirements for them
5155       even though the internals do not (e.g. structs containing unsafe
5156       pointers like `Arc`). These changes are intended to prevent some
5157       footguns and are collectively known as [opt-in built-in
5158       traits][oibit] (though `Sync` and `Send` will soon become pure
5159       library types unknown to the compiler).
5160     * Operator traits now take their operands [by value][ops], and
5161       comparison traits can use multidispatch to compare one type
5162       against multiple other types, allowing e.g. `String` to be
5163       compared with `&str`.
5164     * `if let` and `while let` are no longer feature-gated.
5165     * Rust has adopted a more [uniform syntax for escaping unicode
5166       characters][unicode].
5167     * `macro_rules!` [has been declared stable][mac]. Though it is a
5168       flawed system it is sufficiently popular that it must be usable
5169       for 1.0. Effort has gone into [future-proofing][mac-future] it
5170       in ways that will allow other macro systems to be developed in
5171       parallel, and won't otherwise impact the evolution of the
5172       language.
5173     * The prelude has been [pared back significantly][prelude] such
5174       that it is the minimum necessary to support the most pervasive
5175       code patterns, and through [generalized where clauses][where]
5176       many of the prelude extension traits have been consolidated.
5177     * Rust's rudimentary reflection [has been removed][refl], as it
5178       incurred too much code generation for little benefit.
5179     * [Struct variants][structvars] are no longer feature-gated.
5180     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
5181       known as 'higher-ranked trait bounds', this crucially allows
5182       unboxed closures to work.
5183     * Macros invocations surrounded by parens or square brackets and
5184       not terminated by a semicolon are [parsed as
5185       expressions][macros], which makes expressions like `vec![1i32,
5186       2, 3].len()` work as expected.
5187     * Trait objects now implement their traits automatically, and
5188       traits that can be coerced to objects now must be [object
5189       safe][objsafe].
5190     * Automatically deriving traits is now done with `#[derive(...)]`
5191       not `#[deriving(...)]` for [consistency with other naming
5192       conventions][derive].
5193     * Importing the containing module or enum at the same time as
5194       items or variants they contain is [now done with `self` instead
5195       of `mod`][self], as in use `foo::{self, bar}`
5196     * Glob imports are no longer feature-gated.
5197     * The `box` operator and `box` patterns have been feature-gated
5198       pending a redesign. For now unique boxes should be allocated
5199       like other containers, with `Box::new`.
5200
5201 * Libraries
5202
5203     * A [series][coll1] of [efforts][coll2] to establish
5204       [conventions][coll3] for collections types has resulted in API
5205       improvements throughout the standard library.
5206     * New [APIs for error handling][err] provide ergonomic interop
5207       between error types, and [new conventions][err-conv] describe
5208       more clearly the recommended error handling strategies in Rust.
5209     * The `fail!` macro has been renamed to [`panic!`][panic] so that
5210       it is easier to discuss failure in the context of error handling
5211       without making clarifications as to whether you are referring to
5212       the 'fail' macro or failure more generally.
5213     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
5214       syscall when available.
5215     * The 'serialize' crate has been renamed 'rustc-serialize' and
5216       moved out of the distribution to Cargo. Although it is widely
5217       used now, it is expected to be superseded in the near future.
5218     * The `Show` formatter, typically implemented with
5219       `#[derive(Show)]` is [now requested with the `{:?}`
5220       specifier][show] and is intended for use by all types, for uses
5221       such as `println!` debugging. The new `String` formatter must be
5222       implemented by hand, uses the `{}` specifier, and is intended
5223       for full-fidelity conversions of things that can logically be
5224       represented as strings.
5225
5226 * Tooling
5227
5228     * [Flexible target specification][flex] allows rustc's code
5229       generation to be configured to support otherwise-unsupported
5230       platforms.
5231     * Rust comes with rust-gdb and rust-lldb scripts that launch their
5232       respective debuggers with Rust-appropriate pretty-printing.
5233     * The Windows installation of Rust is distributed with the
5234       MinGW components currently required to link binaries on that
5235       platform.
5236
5237 * Misc
5238
5239     * Nullable enum optimizations have been extended to more types so
5240       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
5241       space than the inner types themselves.
5242     * Work has begun on supporting AArch64.
5243
5244 [Cargo]: https://crates.io
5245 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
5246 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
5247 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
5248 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
5249 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
5250 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
5251 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
5252 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
5253 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
5254 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
5255 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
5256 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
5257 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
5258 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
5259 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
5260 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
5261 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
5262 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
5263 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
5264 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
5265 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
5266 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
5267 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
5268 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
5269 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
5270 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
5271 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
5272 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
5273 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
5274 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
5275 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
5276 [trpl]: https://doc.rust-lang.org/book/index.html
5277 [rbe]: http://rustbyexample.com/
5278
5279
5280 Version 0.12.0 (2014-10-09)
5281 =============================
5282
5283   * ~1900 changes, numerous bugfixes
5284
5285   * Highlights
5286
5287     * The introductory documentation (now called The Rust Guide) has
5288       been completely rewritten, as have a number of supplementary
5289       guides.
5290     * Rust's package manager, Cargo, continues to improve and is
5291       sometimes considered to be quite awesome.
5292     * Many API's in `std` have been reviewed and updated for
5293       consistency with the in-development Rust coding
5294       guidelines. The standard library documentation tracks
5295       stabilization progress.
5296     * Minor libraries have been moved out-of-tree to the rust-lang org
5297       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
5298       be installed with Cargo.
5299     * Lifetime elision allows lifetime annotations to be left off of
5300       function declarations in many common scenarios.
5301     * Rust now works on 64-bit Windows.
5302
5303   * Language
5304     * Indexing can be overloaded with the `Index` and `IndexMut`
5305       traits.
5306     * The `if let` construct takes a branch only if the `let` pattern
5307       matches, currently behind the 'if_let' feature gate.
5308     * 'where clauses', a more flexible syntax for specifying trait
5309       bounds that is more aesthetic, have been added for traits and
5310       free functions. Where clauses will in the future make it
5311       possible to constrain associated types, which would be
5312       impossible with the existing syntax.
5313     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
5314       the 'slicing_syntax' feature gate, and can be overloaded with
5315       the `Slice` or `SliceMut` traits.
5316     * The syntax for matching of sub-slices has been changed to use a
5317       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
5318       consistency with other uses of `..` and to future-proof
5319       potential additional uses of the syntax.
5320     * The syntax for matching inclusive ranges in patterns has changed
5321       from `0..3` to `0...4` to be consistent with the exclusive range
5322       syntax for slicing.
5323     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
5324       c]`) has been put behind the 'advanced_slice_patterns' feature
5325       gate and may be removed in the future.
5326     * Components of tuples and tuple structs can be extracted using
5327       the `value.0` syntax, currently behind the `tuple_indexing`
5328       feature gate.
5329     * The `#[crate_id]` attribute is no longer supported; versioning
5330       is handled by the package manager.
5331     * Renaming crate imports are now written `extern crate foo as bar`
5332       instead of `extern crate bar = foo`.
5333     * Renaming use statements are now written `use foo as bar` instead
5334       of `use bar = foo`.
5335     * `let` and `match` bindings and argument names in macros are now
5336       hygienic.
5337     * The new, more efficient, closure types ('unboxed closures') have
5338       been added under a feature gate, 'unboxed_closures'. These will
5339       soon replace the existing closure types, once higher-ranked
5340       trait lifetimes are added to the language.
5341     * `move` has been added as a keyword, for indicating closures
5342       that capture by value.
5343     * Mutation and assignment is no longer allowed in pattern guards.
5344     * Generic structs and enums can now have trait bounds.
5345     * The `Share` trait is now called `Sync` to free up the term
5346       'shared' to refer to 'shared reference' (the default reference
5347       type.
5348     * Dynamically-sized types have been mostly implemented,
5349       unifying the behavior of fat-pointer types with the rest of the
5350       type system.
5351     * As part of dynamically-sized types, the `Sized` trait has been
5352       introduced, which qualifying types implement by default, and
5353       which type parameters expect by default. To specify that a type
5354       parameter does not need to be sized, write `<Sized? T>`. Most
5355       types are `Sized`, notable exceptions being unsized arrays
5356       (`[T]`) and trait types.
5357     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
5358     * Lifetime bounds can now be applied to type parameters and object
5359       types.
5360     * The old, reference counted GC type, `Gc<T>` which was once
5361       denoted by the `@` sigil, has finally been removed. GC will be
5362       revisited in the future.
5363
5364   * Libraries
5365     * Library documentation has been improved for a number of modules.
5366     * Bit-vectors, collections::bitv has been modernized.
5367     * The url crate is deprecated in favor of
5368       http://github.com/servo/rust-url, which can be installed with
5369       Cargo.
5370     * Most I/O stream types can be cloned and subsequently closed from
5371       a different thread.
5372     * A `std::time::Duration` type has been added for use in I/O
5373       methods that rely on timers, as well as in the 'time' crate's
5374       `Timespec` arithmetic.
5375     * The runtime I/O abstraction layer that enabled the green thread
5376       scheduler to do non-thread-blocking I/O has been removed, along
5377       with the libuv-based implementation employed by the green thread
5378       scheduler. This will greatly simplify the future I/O work.
5379     * `collections::btree` has been rewritten to have a more
5380       idiomatic and efficient design.
5381
5382   * Tooling
5383     * rustdoc output now indicates the stability levels of API's.
5384     * The `--crate-name` flag can specify the name of the crate
5385       being compiled, like `#[crate_name]`.
5386     * The `-C metadata` specifies additional metadata to hash into
5387       symbol names, and `-C extra-filename` specifies additional
5388       information to put into the output filename, for use by the
5389       package manager for versioning.
5390     * debug info generation has continued to improve and should be
5391       more reliable under both gdb and lldb.
5392     * rustc has experimental support for compiling in parallel
5393       using the `-C codegen-units` flag.
5394     * rustc no longer encodes rpath information into binaries by
5395       default.
5396
5397   * Misc
5398     * Stack usage has been optimized with LLVM lifetime annotations.
5399     * Official Rust binaries on Linux are more compatible with older
5400       kernels and distributions, built on CentOS 5.10.
5401
5402
5403 Version 0.11.0 (2014-07-02)
5404 ==========================
5405
5406   * ~1700 changes, numerous bugfixes
5407
5408   * Language
5409     * ~[T] has been removed from the language. This type is superseded by
5410       the Vec<T> type.
5411     * ~str has been removed from the language. This type is superseded by
5412       the String type.
5413     * ~T has been removed from the language. This type is superseded by the
5414       Box<T> type.
5415     * @T has been removed from the language. This type is superseded by the
5416       standard library's std::gc::Gc<T> type.
5417     * Struct fields are now all private by default.
5418     * Vector indices and shift amounts are both required to be a `uint`
5419       instead of any integral type.
5420     * Byte character, byte string, and raw byte string literals are now all
5421       supported by prefixing the normal literal with a `b`.
5422     * Multiple ABIs are no longer allowed in an ABI string
5423     * The syntax for lifetimes on closures/procedures has been tweaked
5424       slightly: `<'a>|A, B|: 'b + K -> T`
5425     * Floating point modulus has been removed from the language; however it
5426       is still provided by a library implementation.
5427     * Private enum variants are now disallowed.
5428     * The `priv` keyword has been removed from the language.
5429     * A closure can no longer be invoked through a &-pointer.
5430     * The `use foo, bar, baz;` syntax has been removed from the language.
5431     * The transmute intrinsic no longer works on type parameters.
5432     * Statics now allow blocks/items in their definition.
5433     * Trait bounds are separated from objects with + instead of : now.
5434     * Objects can no longer be read while they are mutably borrowed.
5435     * The address of a static is now marked as insignificant unless the
5436       #[inline(never)] attribute is placed it.
5437     * The #[unsafe_destructor] attribute is now behind a feature gate.
5438     * Struct literals are no longer allowed in ambiguous positions such as
5439       if, while, match, and for..in.
5440     * Declaration of lang items and intrinsics are now feature-gated by
5441       default.
5442     * Integral literals no longer default to `int`, and floating point
5443       literals no longer default to `f64`. Literals must be suffixed with an
5444       appropriate type if inference cannot determine the type of the
5445       literal.
5446     * The Box<T> type is no longer implicitly borrowed to &mut T.
5447     * Procedures are now required to not capture borrowed references.
5448
5449   * Libraries
5450     * The standard library is now a "facade" over a number of underlying
5451       libraries. This means that development on the standard library should
5452       be speedier due to smaller crates, as well as a clearer line between
5453       all dependencies.
5454     * A new library, libcore, lives under the standard library's facade
5455       which is Rust's "0-assumption" library, suitable for embedded and
5456       kernel development for example.
5457     * A regex crate has been added to the standard distribution. This crate
5458       includes statically compiled regular expressions.
5459     * The unwrap/unwrap_err methods on Result require a Show bound for
5460       better error messages.
5461     * The return types of the std::comm primitives have been centralized
5462       around the Result type.
5463     * A number of I/O primitives have gained the ability to time out their
5464       operations.
5465     * A number of I/O primitives have gained the ability to close their
5466       reading/writing halves to cancel pending operations.
5467     * Reverse iterator methods have been removed in favor of `rev()` on
5468       their forward-iteration counterparts.
5469     * A bitflags! macro has been added to enable easy interop with C and
5470       management of bit flags.
5471     * A debug_assert! macro is now provided which is disabled when
5472       `--cfg ndebug` is passed to the compiler.
5473     * A graphviz crate has been added for creating .dot files.
5474     * The std::cast module has been migrated into std::mem.
5475     * The std::local_data api has been migrated from freestanding functions
5476       to being based on methods.
5477     * The Pod trait has been renamed to Copy.
5478     * jemalloc has been added as the default allocator for types.
5479     * The API for allocating memory has been changed to use proper alignment
5480       and sized deallocation
5481     * Connecting a TcpStream or binding a TcpListener is now based on a
5482       string address and a u16 port. This allows connecting to a hostname as
5483       opposed to an IP.
5484     * The Reader trait now contains a core method, read_at_least(), which
5485       correctly handles many repeated 0-length reads.
5486     * The process-spawning API is now centered around a builder-style
5487       Command struct.
5488     * The :? printing qualifier has been moved from the standard library to
5489       an external libdebug crate.
5490     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
5491       have been renamed to Eq/Ord.
5492     * The select/plural methods have been removed from format!. The escapes
5493       for { and } have also changed from \{ and \} to {{ and }},
5494       respectively.
5495     * The TaskBuilder API has been re-worked to be a true builder, and
5496       extension traits for spawning native/green tasks have been added.
5497
5498   * Tooling
5499     * All breaking changes to the language or libraries now have their
5500       commit message annotated with `[breaking-change]` to allow for easy
5501       discovery of breaking changes.
5502     * The compiler will now try to suggest how to annotate lifetimes if a
5503       lifetime-related error occurs.
5504     * Debug info continues to be improved greatly with general bug fixes and
5505       better support for situations like link time optimization (LTO).
5506     * Usage of syntax extensions when cross-compiling has been fixed.
5507     * Functionality equivalent to GCC & Clang's -ffunction-sections,
5508       -fdata-sections and --gc-sections has been enabled by default
5509     * The compiler is now stricter about where it will load module files
5510       from when a module is declared via `mod foo;`.
5511     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
5512       Syntax extensions are now discovered via a "plugin registrar" type
5513       which will be extended in the future to other various plugins.
5514     * Lints have been restructured to allow for dynamically loadable lints.
5515     * A number of rustdoc improvements:
5516       * The HTML output has been visually redesigned.
5517       * Markdown is now powered by hoedown instead of sundown.
5518       * Searching heuristics have been greatly improved.
5519       * The search index has been reduced in size by a great amount.
5520       * Cross-crate documentation via `pub use` has been greatly improved.
5521       * Primitive types are now hyperlinked and documented.
5522     * Documentation has been moved from static.rust-lang.org/doc to
5523       doc.rust-lang.org
5524     * A new sandbox, play.rust-lang.org, is available for running and
5525       sharing rust code examples on-line.
5526     * Unused attributes are now more robustly warned about.
5527     * The dead_code lint now warns about unused struct fields.
5528     * Cross-compiling to iOS is now supported.
5529     * Cross-compiling to mipsel is now supported.
5530     * Stability attributes are now inherited by default and no longer apply
5531       to intra-crate usage, only inter-crate usage.
5532     * Error message related to non-exhaustive match expressions have been
5533       greatly improved.
5534
5535
5536 Version 0.10 (2014-04-03)
5537 =========================
5538
5539   * ~1500 changes, numerous bugfixes
5540
5541   * Language
5542     * A new RFC process is now in place for modifying the language.
5543     * Patterns with `@`-pointers have been removed from the language.
5544     * Patterns with unique vectors (`~[T]`) have been removed from the
5545       language.
5546     * Patterns with unique strings (`~str`) have been removed from the
5547       language.
5548     * `@str` has been removed from the language.
5549     * `@[T]` has been removed from the language.
5550     * `@self` has been removed from the language.
5551     * `@Trait` has been removed from the language.
5552     * Headers on `~` allocations which contain `@` boxes inside the type for
5553       reference counting have been removed.
5554     * The semantics around the lifetimes of temporary expressions have changed,
5555       see #3511 and #11585 for more information.
5556     * Cross-crate syntax extensions are now possible, but feature gated. See
5557       #11151 for more information. This includes both `macro_rules!` macros as
5558       well as syntax extensions such as `format!`.
5559     * New lint modes have been added, and older ones have been turned on to be
5560       warn-by-default.
5561       * Unnecessary parentheses
5562       * Uppercase statics
5563       * Camel Case types
5564       * Uppercase variables
5565       * Publicly visible private types
5566       * `#[deriving]` with raw pointers
5567     * Unsafe functions can no longer be coerced to closures.
5568     * Various obscure macros such as `log_syntax!` are now behind feature gates.
5569     * The `#[simd]` attribute is now behind a feature gate.
5570     * Visibility is no longer allowed on `extern crate` statements, and
5571       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
5572     * Trailing commas are now allowed in argument lists and tuple patterns.
5573     * The `do` keyword has been removed, it is now a reserved keyword.
5574     * Default type parameters have been implemented, but are feature gated.
5575     * Borrowed variables through captures in closures are now considered soundly.
5576     * `extern mod` is now `extern crate`
5577     * The `Freeze` trait has been removed.
5578     * The `Share` trait has been added for types that can be shared among
5579       threads.
5580     * Labels in macros are now hygienic.
5581     * Expression/statement macro invocations can be delimited with `{}` now.
5582     * Treatment of types allowed in `static mut` locations has been tweaked.
5583     * The `*` and `.` operators are now overloadable through the `Deref` and
5584       `DerefMut` traits.
5585     * `~Trait` and `proc` no longer have `Send` bounds by default.
5586     * Partial type hints are now supported with the `_` type marker.
5587     * An `Unsafe` type was introduced for interior mutability. It is now
5588       considered undefined to transmute from `&T` to `&mut T` without using the
5589       `Unsafe` type.
5590     * The #[linkage] attribute was implemented for extern statics/functions.
5591     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
5592     * `Pod` was renamed to `Copy`.
5593
5594   * Libraries
5595     * The `libextra` library has been removed. It has now been decomposed into
5596       component libraries with smaller and more focused nuggets of
5597       functionality. The full list of libraries can be found on the
5598       documentation index page.
5599     * std: `std::condition` has been removed. All I/O errors are now propagated
5600       through the `Result` type. In order to assist with error handling, a
5601       `try!` macro for unwrapping errors with an early return and a lint for
5602       unused results has been added. See #12039 for more information.
5603     * std: The `vec` module has been renamed to `slice`.
5604     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
5605       This will become the only growable vector in the future.
5606     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
5607       are now found at `std::io::BufferedReader` instead of
5608       `std::io::buffered::BufferedReader`.
5609     * std: `print` and `println` are no longer in the prelude, the `print!` and
5610       `println!` macros are intended to be used instead.
5611     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
5612       attempts to statically prevent cycles.
5613     * std: The standard distribution is adopting the policy of pushing failure
5614       to the user rather than failing in libraries. Many functions (such as
5615       `slice::last()`) now return `Option<T>` instead of `T` + failing.
5616     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
5617       deriving mode: `#[deriving(Show)]`.
5618     * std: `ToStr` is now implemented for all types implementing `Show`.
5619     * std: The formatting trait methods now take `&self` instead of `&T`
5620     * std: The `invert()` method on iterators has been renamed to `rev()`
5621     * std: `std::num` has seen a reduction in the genericity of its traits,
5622       consolidating functionality into a few core traits.
5623     * std: Backtraces are now printed on task failure if the environment
5624       variable `RUST_BACKTRACE` is present.
5625     * std: Naming conventions for iterators have been standardized. More details
5626       can be found on the wiki's style guide.
5627     * std: `eof()` has been removed from the `Reader` trait. Specific types may
5628       still implement the function.
5629     * std: Networking types are now cloneable to allow simultaneous reads/writes.
5630     * std: `assert_approx_eq!` has been removed
5631     * std: The `e` and `E` formatting specifiers for floats have been added to
5632       print them in exponential notation.
5633     * std: The `Times` trait has been removed
5634     * std: Indications of variance and opting out of builtin bounds is done
5635       through marker types in `std::kinds::marker` now
5636     * std: `hash` has been rewritten, `IterBytes` has been removed, and
5637       `#[deriving(Hash)]` is now possible.
5638     * std: `SharedChan` has been removed, `Sender` is now cloneable.
5639     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
5640     * std: `Chan::new` is now `channel()`.
5641     * std: A new synchronous channel type has been implemented.
5642     * std: A `select!` macro is now provided for selecting over `Receiver`s.
5643     * std: `hashmap` and `trie` have been moved to `libcollections`
5644     * std: `run` has been rolled into `io::process`
5645     * std: `assert_eq!` now uses `{}` instead of `{:?}`
5646     * std: The equality and comparison traits have seen some reorganization.
5647     * std: `rand` has moved to `librand`.
5648     * std: `to_{lower,upper}case` has been implemented for `char`.
5649     * std: Logging has been moved to `liblog`.
5650     * collections: `HashMap` has been rewritten for higher performance and less
5651       memory usage.
5652     * native: The default runtime is now `libnative`. If `libgreen` is desired,
5653       it can be booted manually. The runtime guide has more information and
5654       examples.
5655     * native: All I/O functionality except signals has been implemented.
5656     * green: Task spawning with `libgreen` has been optimized with stack caching
5657       and various trimming of code.
5658     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
5659     * sync: The `extra::sync` module has been updated to modern rust (and moved
5660       to the `sync` library), tweaking and improving various interfaces while
5661       dropping redundant functionality.
5662     * sync: A new `Barrier` type has been added to the `sync` library.
5663     * sync: An efficient mutex for native and green tasks has been implemented.
5664     * serialize: The `base64` module has seen some improvement. It treats
5665       newlines better, has non-string error values, and has seen general
5666       cleanup.
5667     * fourcc: A `fourcc!` macro was introduced
5668     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
5669       hexadecimal literal.
5670
5671   * Tooling
5672     * `rustpkg` has been deprecated and removed from the main repository. Its
5673       replacement, `cargo`, is under development.
5674     * Nightly builds of rust are now available
5675     * The memory usage of rustc has been improved many times throughout this
5676       release cycle.
5677     * The build process supports disabling rpath support for the rustc binary
5678       itself.
5679     * Code generation has improved in some cases, giving more information to the
5680       LLVM optimization passes to enable more extensive optimizations.
5681     * Debuginfo compatibility with lldb on OSX has been restored.
5682     * The master branch is now gated on an android bot, making building for
5683       android much more reliable.
5684     * Output flags have been centralized into one `--emit` flag.
5685     * Crate type flags have been centralized into one `--crate-type` flag.
5686     * Codegen flags have been consolidated behind a `-C` flag.
5687     * Linking against outdated crates now has improved error messages.
5688     * Error messages with lifetimes will often suggest how to annotate the
5689       function to fix the error.
5690     * Many more types are documented in the standard library, and new guides
5691       were written.
5692     * Many `rustdoc` improvements:
5693       * code blocks are syntax highlighted.
5694       * render standalone markdown files.
5695       * the --test flag tests all code blocks by default.
5696       * exported macros are displayed.
5697       * re-exported types have their documentation inlined at the location of the
5698         first re-export.
5699       * search works across crates that have been rendered to the same output
5700         directory.
5701
5702
5703 Version 0.9 (2014-01-09)
5704 ==========================
5705
5706    * ~1800 changes, numerous bugfixes
5707
5708    * Language
5709       * The `float` type has been removed. Use `f32` or `f64` instead.
5710       * A new facility for enabling experimental features (feature gating) has
5711         been added, using the crate-level `#[feature(foo)]` attribute.
5712       * Managed boxes (@) are now behind a feature gate
5713         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
5714         standard library's `Gc` or `Rc` types instead.
5715       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
5716       * Jumping back to the top of a loop is now done with `continue` instead of
5717         `loop`.
5718       * Strings can no longer be mutated through index assignment.
5719       * Raw strings can be created via the basic `r"foo"` syntax or with matched
5720         hash delimiters, as in `r###"foo"###`.
5721       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
5722         called once.
5723       * The `&fn` type is now written `|args| -> ret` to match the literal form.
5724       * `@fn`s have been removed.
5725       * `do` only works with procs in order to make it obvious what the cost
5726         of `do` is.
5727       * Single-element tuple-like structs can no longer be dereferenced to
5728         obtain the inner value. A more comprehensive solution for overloading
5729         the dereference operator will be provided in the future.
5730       * The `#[link(...)]` attribute has been replaced with
5731         `#[crate_id = "name#vers"]`.
5732       * Empty `impl`s must be terminated with empty braces and may not be
5733         terminated with a semicolon.
5734       * Keywords are no longer allowed as lifetime names; the `self` lifetime
5735         no longer has any special meaning.
5736       * The old `fmt!` string formatting macro has been removed.
5737       * `printf!` and `printfln!` (old-style formatting) removed in favor of
5738         `print!` and `println!`.
5739       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
5740       * The `extern mod foo (name = "bar")` syntax has been removed. Use
5741         `extern mod foo = "bar"` instead.
5742       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
5743       * Macros can have attributes.
5744       * Macros can expand to items with attributes.
5745       * Macros can expand to multiple items.
5746       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
5747       * Comments may be nested.
5748       * Values automatically coerce to trait objects they implement, without
5749         an explicit `as`.
5750       * Enum discriminants are no longer an entire word but as small as needed to
5751         contain all the variants. The `repr` attribute can be used to override
5752         the discriminant size, as in `#[repr(int)]` for integer-sized, and
5753         `#[repr(C)]` to match C enums.
5754       * Non-string literals are not allowed in attributes (they never worked).
5755       * The FFI now supports variadic functions.
5756       * Octal numeric literals, as in `0o7777`.
5757       * The `concat!` syntax extension performs compile-time string concatenation.
5758       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
5759         removed as Rust no longer uses segmented stacks.
5760       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
5761       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
5762         not `*`; ignoring remaining fields of a struct is also done with `..`,
5763         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
5764       * `rustc` supports the "win64" calling convention via `extern "win64"`.
5765       * `rustc` supports the "system" calling convention, which defaults to the
5766         preferred convention for the target platform, "stdcall" on 32-bit Windows,
5767         "C" elsewhere.
5768       * The `type_overflow` lint (default: warn) checks literals for overflow.
5769       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
5770       * The `attribute_usage` lint (default: warn) warns about unknown
5771         attributes.
5772       * The `unknown_features` lint (default: warn) warns about unknown
5773         feature gates.
5774       * The `dead_code` lint (default: warn) checks for dead code.
5775       * Rust libraries can be linked statically to one another
5776       * `#[link_args]` is behind the `link_args` feature gate.
5777       * Native libraries are now linked with `#[link(name = "foo")]`
5778       * Native libraries can be statically linked to a rust crate
5779         (`#[link(name = "foo", kind = "static")]`).
5780       * Native OS X frameworks are now officially supported
5781         (`#[link(name = "foo", kind = "framework")]`).
5782       * The `#[thread_local]` attribute creates thread-local (not task-local)
5783         variables. Currently behind the `thread_local` feature gate.
5784       * The `return` keyword may be used in closures.
5785       * Types that can be copied via a memcpy implement the `Pod` kind.
5786       * The `cfg` attribute can now be used on struct fields and enum variants.
5787
5788    * Libraries
5789       * std: The `option` and `result` API's have been overhauled to make them
5790         simpler, more consistent, and more composable.
5791       * std: The entire `std::io` module has been replaced with one that is
5792         more comprehensive and that properly interfaces with the underlying
5793         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
5794         implemented.
5795       * std: `io::util` contains a number of useful implementations of
5796         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
5797         `ZeroReader`, `TeeReader`.
5798       * std: The reference counted pointer type `extra::rc` moved into std.
5799       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
5800         just a wrapper around it).
5801       * std: The `Either` type has been removed.
5802       * std: `fmt::Default` can be implemented for any type to provide default
5803         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
5804       * std: The `rand` API continues to be tweaked.
5805       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
5806         on failure in gdb, is now named `rust_fail`.
5807       * std: The `each_key` and `each_value` methods on `HashMap` have been
5808         replaced by the `keys` and `values` iterators.
5809       * std: Functions dealing with type size and alignment have moved from the
5810         `sys` module to the `mem` module.
5811       * std: The `path` module was written and API changed.
5812       * std: `str::from_utf8` has been changed to cast instead of allocate.
5813       * std: `starts_with` and `ends_with` methods added to vectors via the
5814         `ImmutableEqVector` trait, which is in the prelude.
5815       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
5816         if the index is out of bounds.
5817       * std: Task failure no longer propagates between tasks, as the model was
5818         complex, expensive, and incompatible with thread-based tasks.
5819       * std: The `Any` type can be used for dynamic typing.
5820       * std: `~Any` can be passed to the `fail!` macro and retrieved via
5821         `task::try`.
5822       * std: Methods that produce iterators generally do not have an `_iter`
5823         suffix now.
5824       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
5825         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
5826       * std: `util::ignore` renamed to `prelude::drop`.
5827       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
5828         trait.
5829       * std: `vec::raw` has seen a lot of cleanup and API changes.
5830       * std: The standard library no longer includes any C++ code, and very
5831         minimal C, eliminating the dependency on libstdc++.
5832       * std: Runtime scheduling and I/O functionality has been factored out into
5833         extensible interfaces and is now implemented by two different crates:
5834         libnative, for native threading and I/O; and libgreen, for green threading
5835         and I/O. This paves the way for using the standard library in more limited
5836         embedded environments.
5837       * std: The `comm` module has been rewritten to be much faster, have a
5838         simpler, more consistent API, and to work for both native and green
5839         threading.
5840       * std: All libuv dependencies have been moved into the rustuv crate.
5841       * native: New implementations of runtime scheduling on top of OS threads.
5842       * native: New native implementations of TCP, UDP, file I/O, process spawning,
5843         and other I/O.
5844       * green: The green thread scheduler and message passing types are almost
5845         entirely lock-free.
5846       * extra: The `flatpipes` module had bitrotted and was removed.
5847       * extra: All crypto functions have been removed and Rust now has a policy of
5848         not reimplementing crypto in the standard library. In the future crypto
5849         will be provided by external crates with bindings to established libraries.
5850       * extra: `c_vec` has been modernized.
5851       * extra: The `sort` module has been removed. Use the `sort` method on
5852         mutable slices.
5853
5854    * Tooling
5855       * The `rust` and `rusti` commands have been removed, due to lack of
5856         maintenance.
5857       * `rustdoc` was completely rewritten.
5858       * `rustdoc` can test code examples in documentation.
5859       * `rustpkg` can test packages with the argument, 'test'.
5860       * `rustpkg` supports arbitrary dependencies, including C libraries.
5861       * `rustc`'s support for generating debug info is improved again.
5862       * `rustc` has better error reporting for unbalanced delimiters.
5863       * `rustc`'s JIT support was removed due to bitrot.
5864       * Executables and static libraries can be built with LTO (-Z lto)
5865       * `rustc` adds a `--dep-info` flag for communicating dependencies to
5866         build tools.
5867
5868
5869 Version 0.8 (2013-09-26)
5870 ============================
5871
5872    * ~2200 changes, numerous bugfixes
5873
5874    * Language
5875       * The `for` loop syntax has changed to work with the `Iterator` trait.
5876       * At long last, unwinding works on Windows.
5877       * Default methods are ready for use.
5878       * Many trait inheritance bugs fixed.
5879       * Owned and borrowed trait objects work more reliably.
5880       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
5881       * rustc can omit emission of code for the `debug!` macro if it is passed
5882         `--cfg ndebug`
5883       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
5884         for foo.rs, then foo/mod.rs, and will generate an error when both are
5885         present.
5886       * Strings no longer contain trailing nulls. The new `std::c_str` module
5887         provides new mechanisms for converting to C strings.
5888       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
5889       * The FFI has been overhauled such that foreign functions are called directly,
5890         instead of through a stack-switching wrapper.
5891       * Calling a foreign function must be done through a Rust function with the
5892         `#[fixed_stack_segment]` attribute.
5893       * The `externfn!` macro can be used to declare both a foreign function and
5894         a `#[fixed_stack_segment]` wrapper at once.
5895       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
5896       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
5897       * `priv` is disallowed everywhere except for struct fields and enum variants.
5898       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
5899       * `ref` bindings in irrefutable patterns work correctly now.
5900       * `char` is now prevented from containing invalid code points.
5901       * Casting to `bool` is no longer allowed.
5902       * `\0` is now accepted as an escape in chars and strings.
5903       * `yield` is a reserved keyword.
5904       * `typeof` is a reserved keyword.
5905       * Crates may be imported by URL with `extern mod foo = "url";`.
5906       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
5907       * Static vectors can be initialized with repeating elements,
5908         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
5909       * Static structs can be initialized with functional record update,
5910         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
5911       * `cfg!` can be used to conditionally execute code based on the crate
5912         configuration, similarly to `#[cfg(...)]`.
5913       * The `unnecessary_qualification` lint detects unneeded module
5914         prefixes (default: allow).
5915       * Arithmetic operations have been implemented on the SIMD types in
5916         `std::unstable::simd`.
5917       * Exchange allocation headers were removed, reducing memory usage.
5918       * `format!` implements a completely new, extensible, and higher-performance
5919         string formatting system. It will replace `fmt!`.
5920       * `print!` and `println!` write formatted strings (using the `format!`
5921         extension) to stdout.
5922       * `write!` and `writeln!` write formatted strings (using the `format!`
5923         extension) to the new Writers in `std::rt::io`.
5924       * The library section in which a function or static is placed may
5925         be specified with `#[link_section = "..."]`.
5926       * The `proto!` syntax extension for defining bounded message protocols
5927         was removed.
5928       * `macro_rules!` is hygienic for `let` declarations.
5929       * The `#[export_name]` attribute specifies the name of a symbol.
5930       * `unreachable!` can be used to indicate unreachable code, and fails
5931         if executed.
5932
5933    * Libraries
5934       * std: Transitioned to the new runtime, written in Rust.
5935       * std: Added an experimental I/O library, `rt::io`, based on the new
5936         runtime.
5937       * std: A new generic `range` function was added to the prelude, replacing
5938         `uint::range` and friends.
5939       * std: `range_rev` no longer exists. Since range is an iterator it can be
5940         reversed with `range(lo, hi).invert()`.
5941       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
5942         renamed to `unwrap_or`.
5943       * std: The `iterator` module was renamed to `iter`.
5944       * std: Integral types now support the `checked_add`, `checked_sub`, and
5945         `checked_mul` operations for detecting overflow.
5946       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
5947         consistency.
5948       * std: Methods are standardizing on conventions for casting methods:
5949         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
5950         and cheap casts.
5951       * std: The `CString` type in `c_str` provides new ways to convert to and
5952         from C strings.
5953       * std: `DoubleEndedIterator` can yield elements in two directions.
5954       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
5955         two splices.
5956       * std: `str::from_bytes` renamed to `str::from_utf8`.
5957       * std: `pop_opt` and `shift_opt` methods added to vectors.
5958       * std: The task-local data interface no longer uses @, and keys are
5959         no longer function pointers.
5960       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
5961       * std: Added `SharedPort` to `comm`.
5962       * std: `Eq` has a default method for `ne`; only `eq` is required
5963         in implementations.
5964       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
5965         is required in implementations.
5966       * std: `is_utf8` performance is improved, impacting many string functions.
5967       * std: `os::MemoryMap` provides cross-platform mmap.
5968       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
5969         are not 'in-bounds' are considered undefined.
5970       * std: Many freestanding functions in `vec` removed in favor of methods.
5971       * std: Many freestanding functions on scalar types removed in favor of
5972         methods.
5973       * std: Many options to task builders were removed since they don't make
5974         sense in the new scheduler design.
5975       * std: More containers implement `FromIterator` so can be created by the
5976         `collect` method.
5977       * std: More complete atomic types in `unstable::atomics`.
5978       * std: `comm::PortSet` removed.
5979       * std: Mutating methods in the `Set` and `Map` traits have been moved into
5980         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
5981         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
5982         default implementations.
5983       * std: Various `from_str` functions were removed in favor of a generic
5984         `from_str` which is available in the prelude.
5985       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
5986       * extra: `dlist`, the doubly-linked list was modernized.
5987       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
5988       * extra: Added `glob` module, replacing `std::os::glob`.
5989       * extra: `rope` was removed.
5990       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
5991       * extra: `net`, and `timer` were removed. The experimental replacements
5992         are `std::rt::io::net` and `std::rt::io::timer`.
5993       * extra: Iterators implemented for `SmallIntMap`.
5994       * extra: Iterators implemented for `Bitv` and `BitvSet`.
5995       * extra: `SmallIntSet` removed. Use `BitvSet`.
5996       * extra: Performance of JSON parsing greatly improved.
5997       * extra: `semver` updated to SemVer 2.0.0.
5998       * extra: `term` handles more terminals correctly.
5999       * extra: `dbg` module removed.
6000       * extra: `par` module removed.
6001       * extra: `future` was cleaned up, with some method renames.
6002       * extra: Most free functions in `getopts` were converted to methods.
6003
6004    * Other
6005       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6006       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6007         similarly to gcc's `--march` flag.
6008       * rustc's performance compiling small crates is much better.
6009       * rustpkg has received many improvements.
6010       * rustpkg supports git tags as package IDs.
6011       * rustpkg builds into target-specific directories so it can be used for
6012         cross-compiling.
6013       * The number of concurrent test tasks is controlled by the environment
6014         variable RUST_TEST_TASKS.
6015       * The test harness can now report metrics for benchmarks.
6016       * All tools have man pages.
6017       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6018       * The runtime uses jemalloc for allocations.
6019       * Segmented stacks are temporarily disabled as part of the transition to
6020         the new runtime. Stack overflows are possible!
6021       * A new documentation backend, rustdoc_ng, is available for use. It is
6022         still invoked through the normal `rustdoc` command.
6023
6024
6025 Version 0.7 (2013-07-03)
6026 =======================
6027
6028    * ~2000 changes, numerous bugfixes
6029
6030    * Language
6031       * `impl`s no longer accept a visibility qualifier. Put them on methods
6032         instead.
6033       * The borrow checker has been rewritten with flow-sensitivity, fixing
6034         many bugs and inconveniences.
6035       * The `self` parameter no longer implicitly means `&'self self`,
6036         and can be explicitly marked with a lifetime.
6037       * Overloadable compound operators (`+=`, etc.) have been temporarily
6038         removed due to bugs.
6039       * The `for` loop protocol now requires `for`-iterators to return `bool`
6040         so they compose better.
6041       * The `Durable` trait is replaced with the `'static` bounds.
6042       * Trait default methods work more often.
6043       * Structs with the `#[packed]` attribute have byte alignment and
6044         no padding between fields.
6045       * Type parameters bound by `Copy` must now be copied explicitly with
6046         the `copy` keyword.
6047       * It is now illegal to move out of a dereferenced unsafe pointer.
6048       * `Option<~T>` is now represented as a nullable pointer.
6049       * `@mut` does dynamic borrow checks correctly.
6050       * The `main` function is only detected at the topmost level of the crate.
6051         The `#[main]` attribute is still valid anywhere.
6052       * Struct fields may no longer be mutable. Use inherited mutability.
6053       * The `#[no_send]` attribute makes a type that would otherwise be
6054         `Send`, not.
6055       * The `#[no_freeze]` attribute makes a type that would otherwise be
6056         `Freeze`, not.
6057       * Unbounded recursion will abort the process after reaching the limit
6058         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6059       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
6060         are never implicitly copyable.
6061       * `#[static_assert]` makes compile-time assertions about static bools.
6062       * At long last, 'argument modes' no longer exist.
6063       * The rarely used `use mod` statement no longer exists.
6064
6065    * Syntax extensions
6066       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
6067         argument list.
6068       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
6069         `Rand`, `Zero` and `ToStr` can all be automatically derived with
6070         `#[deriving(...)]`.
6071       * The `bytes!` macro returns a vector of bytes for string, u8, char,
6072         and unsuffixed integer literals.
6073
6074    * Libraries
6075       * The `core` crate was renamed to `std`.
6076       * The `std` crate was renamed to `extra`.
6077       * More and improved documentation.
6078       * std: `iterator` module for external iterator objects.
6079       * Many old-style (internal, higher-order function) iterators replaced by
6080         implementations of `Iterator`.
6081       * std: Many old internal vector and string iterators,
6082         incl. `any`, `all`. removed.
6083       * std: The `finalize` method of `Drop` renamed to `drop`.
6084       * std: The `drop` method now takes `&mut self` instead of `&self`.
6085       * std: The prelude no longer re-exports any modules, only types and traits.
6086       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
6087         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
6088       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
6089         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
6090       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
6091         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
6092       * std: Many types implement `Clone`.
6093       * std: `path` type renamed to `Path`.
6094       * std: `mut` module and `Mut` type removed.
6095       * std: Many standalone functions removed in favor of methods and iterators
6096         in `vec`, `str`. In the future methods will also work as functions.
6097       * std: `reinterpret_cast` removed. Use `transmute`.
6098       * std: ascii string handling in `std::ascii`.
6099       * std: `Rand` is implemented for ~/@.
6100       * std: `run` module for spawning processes overhauled.
6101       * std: Various atomic types added to `unstable::atomic`.
6102       * std: Various types implement `Zero`.
6103       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
6104       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
6105       * std: Added `os::mkdir_recursive`.
6106       * std: Added `os::glob` function performs filesystems globs.
6107       * std: `FuzzyEq` renamed to `ApproxEq`.
6108       * std: `Map` now defines `pop` and `swap` methods.
6109       * std: `Cell` constructors converted to static methods.
6110       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
6111       * extra: `flate` module moved from `std` to `extra`.
6112       * extra: `fileinput` module for iterating over a series of files.
6113       * extra: `Complex` number type and `complex` module.
6114       * extra: `Rational` number type and `rational` module.
6115       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
6116       * extra: `term` uses terminfo now, is more correct.
6117       * extra: `arc` functions converted to methods.
6118       * extra: Implementation of fixed output size variations of SHA-2.
6119
6120    * Tooling
6121       * `unused_variable`  lint mode for unused variables (default: warn).
6122       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
6123         (default: warn).
6124       * `unused_mut` lint mode for identifying unused `mut` qualifiers
6125         (default: warn).
6126       * `dead_assignment` lint mode for unread variables (default: warn).
6127       * `unnecessary_allocation` lint mode detects some heap allocations that are
6128         immediately borrowed so could be written without allocating (default: warn).
6129       * `missing_doc` lint mode (default: allow).
6130       * `unreachable_code` lint mode (default: warn).
6131       * The `rusti` command has been rewritten and a number of bugs addressed.
6132       * rustc outputs in color on more terminals.
6133       * rustc accepts a `--link-args` flag to pass arguments to the linker.
6134       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
6135       * Compiling with `-g` will make the binary record information about
6136         dynamic borrowcheck failures for debugging.
6137       * rustdoc has a nicer stylesheet.
6138       * Various improvements to rustdoc.
6139       * Improvements to rustpkg (see the detailed release notes).
6140
6141
6142 Version 0.6 (2013-04-03)
6143 ========================
6144
6145    * ~2100 changes, numerous bugfixes
6146
6147    * Syntax changes
6148       * The self type parameter in traits is now spelled `Self`
6149       * The `self` parameter in trait and impl methods must now be explicitly
6150         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
6151       * Static methods no longer require the `static` keyword and instead
6152         are distinguished by the lack of a `self` parameter
6153       * Replaced the `Durable` trait with the `'static` lifetime
6154       * The old closure type syntax with the trailing sigil has been
6155         removed in favor of the more consistent leading sigil
6156       * `super` is a keyword, and may be prefixed to paths
6157       * Trait bounds are separated with `+` instead of whitespace
6158       * Traits are implemented with `impl Trait for Type`
6159         instead of `impl Type: Trait`
6160       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
6161       * The `export` keyword has finally been removed
6162       * The `move` keyword has been removed (see "Semantic changes")
6163       * The interior mutability qualifier on vectors, `[mut T]`, has been
6164         removed. Use `&mut [T]`, etc.
6165       * `mut` is no longer valid in `~mut T`. Use inherited mutability
6166       * `fail` is no longer a keyword. Use `fail!()`
6167       * `assert` is no longer a keyword. Use `assert!()`
6168       * `log` is no longer a keyword. use `debug!`, etc.
6169       * 1-tuples may be represented as `(T,)`
6170       * Struct fields may no longer be `mut`. Use inherited mutability,
6171         `@mut T`, `core::mut` or `core::cell`
6172       * `extern mod { ... }` is no longer valid syntax for foreign
6173         function modules. Use extern blocks: `extern { ... }`
6174       * Newtype enums removed. Use tuple-structs.
6175       * Trait implementations no longer support visibility modifiers
6176       * Pattern matching over vectors improved and expanded
6177       * `const` renamed to `static` to correspond to lifetime name,
6178         and make room for future `static mut` unsafe mutable globals.
6179       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
6180       * `Clone` implementations can be automatically generated with
6181         `#[deriving(Clone)]`
6182       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
6183         instead of `foo as Bar`.
6184       * Fixed length vector types are now written as `[int, .. 3]`
6185         instead of `[int * 3]`.
6186       * Fixed length vector types can express the length as a constant
6187         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
6188
6189    * Semantic changes
6190       * Types with owned pointers or custom destructors move by default,
6191         eliminating the `move` keyword
6192       * All foreign functions are considered unsafe
6193       * &mut is now unaliasable
6194       * Writes to borrowed @mut pointers are prevented dynamically
6195       * () has size 0
6196       * The name of the main function can be customized using #[main]
6197       * The default type of an inferred closure is &fn instead of @fn
6198       * `use` statements may no longer be "chained" - they cannot import
6199         identifiers imported by previous `use` statements
6200       * `use` statements are crate relative, importing from the "top"
6201         of the crate by default. Paths may be prefixed with `super::`
6202         or `self::` to change the search behavior.
6203       * Method visibility is inherited from the implementation declaration
6204       * Structural records have been removed
6205       * Many more types can be used in static items, including enums
6206         'static-lifetime pointers and vectors
6207       * Pattern matching over vectors improved and expanded
6208       * Typechecking of closure types has been overhauled to
6209         improve inference and eliminate unsoundness
6210       * Macros leave scope at the end of modules, unless that module is
6211         tagged with #[macro_escape]
6212
6213    * Libraries
6214       * Added big integers to `std::bigint`
6215       * Removed `core::oldcomm` module
6216       * Added pipe-based `core::comm` module
6217       * Numeric traits have been reorganized under `core::num`
6218       * `vec::slice` finally returns a slice
6219       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
6220       * Containers reorganized around traits in `core::container`
6221       * `core::dvec` removed, `~[T]` is a drop-in replacement
6222       * `core::send_map` renamed to `core::hashmap`
6223       * `std::map` removed; replaced with `core::hashmap`
6224       * `std::treemap` reimplemented as an owned balanced tree
6225       * `std::deque` and `std::smallintmap` reimplemented as owned containers
6226       * `core::trie` added as a fast ordered map for integer keys
6227       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
6228       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
6229         overload the comparison operators, whereas `TotalOrd` is used
6230         by certain container types
6231
6232    * Other
6233       * Replaced the 'cargo' package manager with 'rustpkg'
6234       * Added all-purpose 'rust' tool
6235       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
6236       * rustc now *attempts* to offer spelling suggestions
6237       * Improved support for ARM and Android
6238       * Preliminary MIPS backend
6239       * Improved foreign function ABI implementation for x86, x86_64
6240       * Various memory usage improvements
6241       * Rust code may be embedded in foreign code under limited circumstances
6242       * Inline assembler supported by new asm!() syntax extension.
6243
6244
6245 Version 0.5 (2012-12-21)
6246 ===========================
6247
6248    * ~900 changes, numerous bugfixes
6249
6250    * Syntax changes
6251       * Removed `<-` move operator
6252       * Completed the transition from the `#fmt` extension syntax to `fmt!`
6253       * Removed old fixed length vector syntax - `[T]/N`
6254       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
6255       * Macros may now expand to items and statements
6256       * `a.b()` is always parsed as a method call, never as a field projection
6257       * `Eq` and `IterBytes` implementations can be automatically generated
6258         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
6259       * Removed the special crate language for `.rc` files
6260       * Function arguments may consist of any irrefutable pattern
6261
6262    * Semantic changes
6263       * `&` and `~` pointers may point to objects
6264       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
6265       * Enum variants may be structs
6266       * Destructors can be added to all nominal types with the Drop trait
6267       * Structs and nullary enum variants may be constants
6268       * Values that cannot be implicitly copied are now automatically moved
6269         without writing `move` explicitly
6270       * `&T` may now be coerced to `*T`
6271       * Coercions happen in `let` statements as well as function calls
6272       * `use` statements now take crate-relative paths
6273       * The module and type namespaces have been merged so that static
6274         method names can be resolved under the trait in which they are
6275         declared
6276
6277    * Improved support for language features
6278       * Trait inheritance works in many scenarios
6279       * More support for explicit self arguments in methods - `self`, `&self`
6280         `@self`, and `~self` all generally work as expected
6281       * Static methods work in more situations
6282       * Experimental: Traits may declare default methods for the implementations
6283         to use
6284
6285    * Libraries
6286       * New condition handling system in `core::condition`
6287       * Timsort added to `std::sort`
6288       * New priority queue, `std::priority_queue`
6289       * Pipes for serializable types, `std::flatpipes'
6290       * Serialization overhauled to be trait-based
6291       * Expanded `getopts` definitions
6292       * Moved futures to `std`
6293       * More functions are pure now
6294       * `core::comm` renamed to `oldcomm`. Still deprecated
6295       * `rustdoc` and `cargo` are libraries now
6296
6297    * Misc
6298       * Added a preliminary REPL, `rusti`
6299       * License changed from MIT to dual MIT/APL2
6300
6301
6302 Version 0.4 (2012-10-15)
6303 ==========================
6304
6305    * ~2000 changes, numerous bugfixes
6306
6307    * Syntax
6308       * All keywords are now strict and may not be used as identifiers anywhere
6309       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
6310         'of', 'with', 'to', 'class'.
6311       * Classes are replaced with simpler structs
6312       * Explicit method self types
6313       * `ret` became `return` and `alt` became `match`
6314       * `import` is now `use`; `use is now `extern mod`
6315       * `extern mod { ... }` is now `extern { ... }`
6316       * `use mod` is the recommended way to import modules
6317       * `pub` and `priv` replace deprecated export lists
6318       * The syntax of `match` pattern arms now uses fat arrow (=>)
6319       * `main` no longer accepts an args vector; use `os::args` instead
6320
6321    * Semantics
6322       * Trait implementations are now coherent, ala Haskell typeclasses
6323       * Trait methods may be static
6324       * Argument modes are deprecated
6325       * Borrowed pointers are much more mature and recommended for use
6326       * Strings and vectors in the static region are stored in constant memory
6327       * Typestate was removed
6328       * Resolution rewritten to be more reliable
6329       * Support for 'dual-mode' data structures (freezing and thawing)
6330
6331    * Libraries
6332       * Most binary operators can now be overloaded via the traits in
6333         `core::ops'
6334       * `std::net::url` for representing URLs
6335       * Sendable hash maps in `core::send_map`
6336       * `core::task' gained a (currently unsafe) task-local storage API
6337
6338    * Concurrency
6339       * An efficient new intertask communication primitive called the pipe,
6340         along with a number of higher-level channel types, in `core::pipes`
6341       * `std::arc`, an atomically reference counted, immutable, shared memory
6342         type
6343       * `std::sync`, various exotic synchronization tools based on arcs and pipes
6344       * Futures are now based on pipes and sendable
6345       * More robust linked task failure
6346       * Improved task builder API
6347
6348    * Other
6349       * Improved error reporting
6350       * Preliminary JIT support
6351       * Preliminary work on precise GC
6352       * Extensive architectural improvements to rustc
6353       * Begun a transition away from buggy C++-based reflection (shape) code to
6354         Rust-based (visitor) code
6355       * All hash functions and tables converted to secure, randomized SipHash
6356
6357
6358 Version 0.3  (2012-07-12)
6359 ========================
6360
6361    * ~1900 changes, numerous bugfixes
6362
6363    * New coding conveniences
6364       * Integer-literal suffix inference
6365       * Per-item control over warnings, errors
6366       * #[cfg(windows)] and #[cfg(unix)] attributes
6367       * Documentation comments
6368       * More compact closure syntax
6369       * 'do' expressions for treating higher-order functions as
6370         control structures
6371       * *-patterns (wildcard extended to all constructor fields)
6372
6373    * Semantic cleanup
6374       * Name resolution pass and exhaustiveness checker rewritten
6375       * Region pointers and borrow checking supersede alias
6376         analysis
6377       * Init-ness checking is now provided by a region-based liveness
6378         pass instead of the typestate pass; same for last-use analysis
6379       * Extensive work on region pointers
6380
6381    * Experimental new language features
6382       * Slices and fixed-size, interior-allocated vectors
6383       * #!-comments for lang versioning, shell execution
6384       * Destructors and iface implementation for classes;
6385         type-parameterized classes and class methods
6386       * 'const' type kind for types that can be used to implement
6387         shared-memory concurrency patterns
6388
6389    * Type reflection
6390
6391    * Removal of various obsolete features
6392       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
6393                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
6394
6395       * Constructs: do-while loops ('do' repurposed), fn binding,
6396                     resources (replaced by destructors)
6397
6398    * Compiler reorganization
6399       * Syntax-layer of compiler split into separate crate
6400       * Clang (from LLVM project) integrated into build
6401       * Typechecker split into sub-modules
6402
6403    * New library code
6404       * New time functions
6405       * Extension methods for many built-in types
6406       * Arc: atomic-refcount read-only / exclusive-use shared cells
6407       * Par: parallel map and search routines
6408       * Extensive work on libuv interface
6409       * Much vector code moved to libraries
6410       * Syntax extensions: #line, #col, #file, #mod, #stringify,
6411         #include, #include_str, #include_bin
6412
6413    * Tool improvements
6414       * Cargo automatically resolves dependencies
6415
6416
6417 Version 0.2  (2012-03-29)
6418 =========================
6419
6420    * >1500 changes, numerous bugfixes
6421
6422    * New docs and doc tooling
6423
6424    * New port: FreeBSD x86_64
6425
6426    * Compilation model enhancements
6427       * Generics now specialized, multiply instantiated
6428       * Functions now inlined across separate crates
6429
6430    * Scheduling, stack and threading fixes
6431       * Noticeably improved message-passing performance
6432       * Explicit schedulers
6433       * Callbacks from C
6434       * Helgrind clean
6435
6436    * Experimental new language features
6437       * Operator overloading
6438       * Region pointers
6439       * Classes
6440
6441    * Various language extensions
6442       * C-callback function types: 'crust fn ...'
6443       * Infinite-loop construct: 'loop { ... }'
6444       * Shorten 'mutable' to 'mut'
6445       * Required mutable-local qualifier: 'let mut ...'
6446       * Basic glob-exporting: 'export foo::*;'
6447       * Alt now exhaustive, 'alt check' for runtime-checked
6448       * Block-function form of 'for' loop, with 'break' and 'ret'.
6449
6450    * New library code
6451       * AST quasi-quote syntax extension
6452       * Revived libuv interface
6453       * New modules: core::{future, iter}, std::arena
6454       * Merged per-platform std::{os*, fs*} to core::{libc, os}
6455       * Extensive cleanup, regularization in libstd, libcore
6456
6457
6458 Version 0.1  (2012-01-20)
6459 ===============================
6460
6461    * Most language features work, including:
6462       * Unique pointers, unique closures, move semantics
6463       * Interface-constrained generics
6464       * Static interface dispatch
6465       * Stack growth
6466       * Multithread task scheduling
6467       * Typestate predicates
6468       * Failure unwinding, destructors
6469       * Pattern matching and destructuring assignment
6470       * Lightweight block-lambda syntax
6471       * Preliminary macro-by-example
6472
6473    * Compiler works with the following configurations:
6474       * Linux: x86 and x86_64 hosts and targets
6475       * macOS: x86 and x86_64 hosts and targets
6476       * Windows: x86 hosts and targets
6477
6478    * Cross compilation / multi-target configuration supported.
6479
6480    * Preliminary API-documentation and package-management tools included.
6481
6482 Known issues:
6483
6484    * Documentation is incomplete.
6485
6486    * Performance is below intended target.
6487
6488    * Standard library APIs are subject to extensive change, reorganization.
6489
6490    * Language-level versioning is not yet operational - future code will
6491      break unexpectedly.