]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Auto merge of #58077 - Nemo157:generator-state-debug-info, r=Zoxc
[rust.git] / RELEASES.md
1 Version 1.33.0 (2019-02-28)
2 ==========================
3
4 Language
5 --------
6 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
7   `#[cfg(target_vendor="linux")] fn main() { println!("Hello Linux!"); }`
8 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
9   E.g. You can have match statement on a `u8` that covers `0..=255` and
10   you would no longer be required to have a `_ => unreachable!()` case. 
11 - [You can now have multiple patterns in `if let` and `while let`
12   expressions.][57532] You can do this with the same syntax as a `match`
13   expression. E.g.
14   ```rust
15   enum Creature {
16       Crab(String),
17       Lobster(String),
18       Person(String),
19   }
20
21   fn main() {
22       let state = Creature::Crab("Ferris");
23
24       if let Creature::Crab(name) | Creature::Person(name) = state {
25           println!("This creature's name is: {}", name);
26       }
27   }
28   ```
29 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
30   this feature will by default produce a warning as this behaviour can be
31   unintuitive. E.g. `if let _ = 5 {}`
32 - [You can now use `let` bindings, assignments, expression statements,
33   and irrefutable pattern destructuring in const functions.][57175]
34 - [You can now call unsafe const functions.][57067] E.g.
35   ```rust
36   const unsafe fn foo() -> i32 { 5 }
37   const fn bar() -> i32 {
38       unsafe { foo() }
39   }
40   ```
41 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
42   E.g. `#[cfg_attr(all(), must_use, optimize)]`
43 - [You can now specify a specific alignment with the `#[repr(packed)]`
44   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
45   with an alignment of 2 bytes and a size of 6 bytes.
46 - [You can now import an item from a module as an `_`.][56303] This allows you to
47   import a trait's impls, and not have the name in the namespace. E.g.
48   ```rust
49   use std::io::Read as _;
50
51   // Allowed as there is only one `Read` in the module.
52   pub trait Read {}
53   ```
54 - [`extern` functions will now abort by default when panicking.][55982]
55   This was previously undefined behaviour.
56
57 Compiler
58 --------
59 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
60   command line argument.][56351]
61 - [The mininum required LLVM version has been bumped to 6.0.][56642]
62 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
63 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
64   tier 2 support.][57130] Visit the [platform support][platform-support] page for
65   information on Rust's platform support.
66 - [Added support for the `thumbv7neon-linux-androideabi` and
67   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
68 - [Added support for the `x86_64-unknown-uefi` target.][56769]
69
70 Libraries
71 ---------
72 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
73   functions for all numeric types.][57566]
74 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
75   are now `const` functions for all numeric types.][57105]
76 - [The methods `is_positive` and `is_negative` are now `const` functions for
77   all signed numeric types.][57105]
78 - [The `get` method for all `NonZero` types is now `const`.][57167]
79 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
80   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
81   numeric types.][57234]
82 - [`Ipv4Addr::new` is now a `const` function][57234]
83
84 Stabilized APIs
85 ---------------
86 - [`unix::FileExt::read_exact_at`]
87 - [`unix::FileExt::write_all_at`]
88 - [`Option::transpose`]
89 - [`Result::transpose`]
90 - [`convert::identity`]
91 - [`pin::Pin`]
92 - [`marker::Unpin`]
93 - [`marker::PhantomPinned`]
94 - [`Vec::resize_with`]
95 - [`VecDeque::resize_with`]
96 - [`Duration::as_millis`]
97 - [`Duration::as_micros`]
98 - [`Duration::as_nanos`]
99
100
101 Cargo
102 -----
103 - [Cargo should now rebuild a crate if a file was modified during the initial
104   build.][cargo/6484]
105
106 Compatibility Notes
107 -------------------
108 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
109   are now deprecated in the standard library, and their usage will now produce a warning.
110   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
111   methods instead.
112
113 [57615]: https://github.com/rust-lang/rust/pull/57615/
114 [57465]: https://github.com/rust-lang/rust/pull/57465/
115 [57532]: https://github.com/rust-lang/rust/pull/57532/
116 [57535]: https://github.com/rust-lang/rust/pull/57535/
117 [57566]: https://github.com/rust-lang/rust/pull/57566/
118 [57130]: https://github.com/rust-lang/rust/pull/57130/
119 [57167]: https://github.com/rust-lang/rust/pull/57167/
120 [57175]: https://github.com/rust-lang/rust/pull/57175/
121 [57234]: https://github.com/rust-lang/rust/pull/57234/
122 [57332]: https://github.com/rust-lang/rust/pull/57332/
123 [56947]: https://github.com/rust-lang/rust/pull/56947/
124 [57049]: https://github.com/rust-lang/rust/pull/57049/
125 [57067]: https://github.com/rust-lang/rust/pull/57067/
126 [56769]: https://github.com/rust-lang/rust/pull/56769/
127 [56642]: https://github.com/rust-lang/rust/pull/56642/
128 [56303]: https://github.com/rust-lang/rust/pull/56303/
129 [56351]: https://github.com/rust-lang/rust/pull/56351/
130 [55982]: https://github.com/rust-lang/rust/pull/55982/
131 [56362]: https://github.com/rust-lang/rust/pull/56362
132 [57105]: https://github.com/rust-lang/rust/pull/57105
133 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
134 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
135 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
136 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
137 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
138 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
139 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
140 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
141 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
142 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
143 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
144 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
145 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
146 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
147 [platform-support]: https://forge.rust-lang.org/platform-support.html
148
149 Version 1.32.0 (2019-01-17)
150 ==========================
151
152 Language
153 --------
154 #### 2018 edition
155 - [You can now use the `?` operator in macro definitions.][56245] The `?`
156   operator allows you to specify zero or one repetitions similar to the `*` and
157   `+` operators.
158 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
159   now always resolve to the item (`enum`, `struct`, etc.) available in the
160   module if present, before resolving to a external crate or an item the prelude.][56759]
161   E.g.
162   ```rust
163   enum Color { Red, Green, Blue }
164
165   use Color::*;
166   ```
167
168 #### All editions
169 - [You can now match against `PhantomData<T>` types.][55837]
170 - [You can now match against literals in macros with the `literal`
171   specifier.][56072] This will match against a literal of any type.
172   E.g. `1`, `'A'`, `"Hello World"`
173 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g. 
174   ```rust
175   struct Point(i32, i32);
176
177   impl Point {
178       pub fn new(x: i32, y: i32) -> Self {
179           Self(x, y)
180       }
181
182       pub fn is_origin(&self) -> bool {
183           match self {
184               Self(0, 0) => true,
185               _ => false,
186           }
187       }
188   }
189   ```
190 - [Self can also now be used in type definitions.][56366] E.g.
191   ```rust
192   enum List<T>
193   where
194       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
195   {
196       Nil,
197       Cons(T, Box<Self>) // likewise here
198   }
199   ```
200 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
201   a `impl Trait` or `dyn Trait` is returned and unused in the program.
202
203 Compiler
204 --------
205 - [The default allocator has changed from jemalloc to the default allocator on
206   your system.][55238] The compiler itself on Linux & macOS will still use
207   jemalloc, but programs compiled with it will use the system allocator.
208 - [Added the `aarch64-pc-windows-msvc` target.][55702]
209
210 Libraries
211 ---------
212 - [`PathBuf` now implements `FromStr`.][55148]
213 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
214 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
215   easily debug expressions in your rust program. E.g.
216   ```rust
217   let a = 2;
218   let b = dbg!(a * 2) + 1;
219   //      ^-- prints: [src/main.rs:4] a * 2 = 4
220   assert_eq!(b, 5);
221   ```
222
223 The following APIs are now `const` functions and can be used in a
224 `const` context.
225
226 - [`Cell::as_ptr`]
227 - [`UnsafeCell::get`]
228 - [`char::is_ascii`]
229 - [`iter::empty`]
230 - [`ManuallyDrop::new`]
231 - [`ManuallyDrop::into_inner`]
232 - [`RangeInclusive::start`]
233 - [`RangeInclusive::end`]
234 - [`NonNull::as_ptr`]
235 - [`slice::as_ptr`]
236 - [`str::as_ptr`]
237 - [`Duration::as_secs`]
238 - [`Duration::subsec_millis`]
239 - [`Duration::subsec_micros`]
240 - [`Duration::subsec_nanos`]
241 - [`CStr::as_ptr`]
242 - [`Ipv4Addr::is_unspecified`]
243 - [`Ipv6Addr::new`]
244 - [`Ipv6Addr::octets`]
245
246 Stabilized APIs
247 ---------------
248 - [`i8::to_be_bytes`]
249 - [`i8::to_le_bytes`]
250 - [`i8::to_ne_bytes`]
251 - [`i8::from_be_bytes`]
252 - [`i8::from_le_bytes`]
253 - [`i8::from_ne_bytes`]
254 - [`i16::to_be_bytes`]
255 - [`i16::to_le_bytes`]
256 - [`i16::to_ne_bytes`]
257 - [`i16::from_be_bytes`]
258 - [`i16::from_le_bytes`]
259 - [`i16::from_ne_bytes`]
260 - [`i32::to_be_bytes`]
261 - [`i32::to_le_bytes`]
262 - [`i32::to_ne_bytes`]
263 - [`i32::from_be_bytes`]
264 - [`i32::from_le_bytes`]
265 - [`i32::from_ne_bytes`]
266 - [`i64::to_be_bytes`]
267 - [`i64::to_le_bytes`]
268 - [`i64::to_ne_bytes`]
269 - [`i64::from_be_bytes`]
270 - [`i64::from_le_bytes`]
271 - [`i64::from_ne_bytes`]
272 - [`i128::to_be_bytes`]
273 - [`i128::to_le_bytes`]
274 - [`i128::to_ne_bytes`]
275 - [`i128::from_be_bytes`]
276 - [`i128::from_le_bytes`]
277 - [`i128::from_ne_bytes`]
278 - [`isize::to_be_bytes`]
279 - [`isize::to_le_bytes`]
280 - [`isize::to_ne_bytes`]
281 - [`isize::from_be_bytes`]
282 - [`isize::from_le_bytes`]
283 - [`isize::from_ne_bytes`]
284 - [`u8::to_be_bytes`]
285 - [`u8::to_le_bytes`]
286 - [`u8::to_ne_bytes`]
287 - [`u8::from_be_bytes`]
288 - [`u8::from_le_bytes`]
289 - [`u8::from_ne_bytes`]
290 - [`u16::to_be_bytes`]
291 - [`u16::to_le_bytes`]
292 - [`u16::to_ne_bytes`]
293 - [`u16::from_be_bytes`]
294 - [`u16::from_le_bytes`]
295 - [`u16::from_ne_bytes`]
296 - [`u32::to_be_bytes`]
297 - [`u32::to_le_bytes`]
298 - [`u32::to_ne_bytes`]
299 - [`u32::from_be_bytes`]
300 - [`u32::from_le_bytes`]
301 - [`u32::from_ne_bytes`]
302 - [`u64::to_be_bytes`]
303 - [`u64::to_le_bytes`]
304 - [`u64::to_ne_bytes`]
305 - [`u64::from_be_bytes`]
306 - [`u64::from_le_bytes`]
307 - [`u64::from_ne_bytes`]
308 - [`u128::to_be_bytes`]
309 - [`u128::to_le_bytes`]
310 - [`u128::to_ne_bytes`]
311 - [`u128::from_be_bytes`]
312 - [`u128::from_le_bytes`]
313 - [`u128::from_ne_bytes`]
314 - [`usize::to_be_bytes`]
315 - [`usize::to_le_bytes`]
316 - [`usize::to_ne_bytes`]
317 - [`usize::from_be_bytes`]
318 - [`usize::from_le_bytes`]
319 - [`usize::from_ne_bytes`]
320
321 Cargo
322 -----
323 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
324 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
325
326 Misc
327 ----
328 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
329
330 Compatibility Notes
331 -------------------
332 - [The argument types for AVX's
333   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
334   been changed from `*const` to `*mut` as the previous implementation
335   was unsound.
336
337
338 [55148]: https://github.com/rust-lang/rust/pull/55148/
339 [55238]: https://github.com/rust-lang/rust/pull/55238/
340 [55280]: https://github.com/rust-lang/rust/pull/55280/
341 [55610]: https://github.com/rust-lang/rust/pull/55610/
342 [55663]: https://github.com/rust-lang/rust/pull/55663/
343 [55702]: https://github.com/rust-lang/rust/pull/55702/
344 [55837]: https://github.com/rust-lang/rust/pull/55837/
345 [55843]: https://github.com/rust-lang/rust/pull/55843/
346 [56072]: https://github.com/rust-lang/rust/pull/56072/
347 [56245]: https://github.com/rust-lang/rust/pull/56245/
348 [56365]: https://github.com/rust-lang/rust/pull/56365/
349 [56366]: https://github.com/rust-lang/rust/pull/56366/
350 [56395]: https://github.com/rust-lang/rust/pull/56395/
351 [56759]: https://github.com/rust-lang/rust/pull/56759/
352 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
353 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
354 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
355 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
356 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
357 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
358 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
359 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
360 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
361 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
362 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
363 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
364 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
365 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
366 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
367 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
368 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
369 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
370 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
371 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
372 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
373 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
374 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
375 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
376 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
377 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
378 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
379 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
380 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
381 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
382 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
383 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
384 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
385 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
386 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
387 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
388 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
389 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
390 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
391 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
392 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
393 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
394 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
395 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
396 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
397 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
398 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
399 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
400 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
401 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
402 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
403 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
404 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
405 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
406 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
407 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
408 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
409 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
410 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
411 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
412 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
413 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
414 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
415 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
416 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
417 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
418 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
419 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
420 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
421 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
422 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
423 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
424 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
425 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
426 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
427 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
428 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
429 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
430 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
431 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
432 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
433 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
434 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
435 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
436 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
437 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
438 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
439 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
440 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
441 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
442 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
443 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
444 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
445
446
447 Version 1.31.1 (2018-12-20)
448 ===========================
449
450 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
451 - [Fix broken go-to-definition in RLS][rls/1171]
452 - [Fix infinite loop on hover in RLS][rls/1170]
453
454 [56562]: https://github.com/rust-lang/rust/pull/56562
455 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
456 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
457
458 Version 1.31.0 (2018-12-06)
459 ==========================
460
461 Language
462 --------
463 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉 
464 - [New lifetime elision rules now allow for eliding lifetimes in functions and
465   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
466   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
467   in structs.
468 - [You can now define and use `const` functions.][54835] These are currently
469   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
470   [language reference][const-reference] for what exactly is available.
471 - [You can now use tool lints, which allow you to scope lints from external
472   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
473 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
474   a crate, not just in exported functions.][54451]
475 - [You can now use parentheses in pattern matches.][54497]
476
477 Compiler
478 --------
479 - [Updated musl to 1.1.20][54430]
480
481 Libraries
482 ---------
483 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
484   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
485 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
486   into `Option<&mut T>` using the `From` trait.][53218]
487 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
488
489
490 Stabilized APIs
491 ---------------
492 - [`slice::align_to`]
493 - [`slice::align_to_mut`]
494 - [`slice::chunks_exact`]
495 - [`slice::chunks_exact_mut`]
496 - [`slice::rchunks`]
497 - [`slice::rchunks_mut`]
498 - [`slice::rchunks_exact`]
499 - [`slice::rchunks_exact_mut`]
500 - [`Option::replace`]
501
502 Cargo
503 -----
504 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
505 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
506   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
507
508 [52813]: https://github.com/rust-lang/rust/pull/52813/
509 [53218]: https://github.com/rust-lang/rust/pull/53218/
510 [53555]: https://github.com/rust-lang/rust/issues/53555/
511 [54057]: https://github.com/rust-lang/rust/pull/54057/
512 [54240]: https://github.com/rust-lang/rust/pull/54240/
513 [54430]: https://github.com/rust-lang/rust/pull/54430/
514 [54451]: https://github.com/rust-lang/rust/pull/54451/
515 [54497]: https://github.com/rust-lang/rust/pull/54497/
516 [54778]: https://github.com/rust-lang/rust/pull/54778/
517 [54835]: https://github.com/rust-lang/rust/pull/54835/
518 [54870]: https://github.com/rust-lang/rust/pull/54870/
519 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
520 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
521 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
522 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
523 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
524 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
525 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
526 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
527 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
528 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
529 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
530 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
531 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
532 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
533
534 Version 1.30.1 (2018-11-08)
535 ===========================
536
537 - [Fixed overflow ICE in rustdoc][54199]
538 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
539
540 [54199]: https://github.com/rust-lang/rust/pull/54199
541 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
542
543 Version 1.30.0 (2018-10-25)
544 ==========================
545
546 Language
547 --------
548 - [Procedural macros are now available.][52081] These kinds of macros allow for
549   more powerful code generation. There is a [new chapter available][proc-macros]
550   in the Rust Programming Language book that goes further in depth.
551 - [You can now use keywords as identifiers using the raw identifiers
552   syntax (`r#`),][53236] e.g. `let r#for = true;`
553 - [Using anonymous parameters in traits is now deprecated with a warning and
554   will be a hard error in the 2018 edition.][53272]
555 - [You can now use `crate` in paths.][54404] This allows you to refer to the
556   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
557 - [Using a external crate no longer requires being prefixed with `::`.][54404]
558   Previously, using a external crate in a module without a use statement
559   required `let json = ::serde_json::from_str(foo);` but can now be written
560   as `let json = serde_json::from_str(foo);`.
561 - [You can now apply the `#[used]` attribute to static items to prevent the
562   compiler from optimising them away, even if they appear to be unused,][51363]
563   e.g. `#[used] static FOO: u32 = 1;`
564 - [You can now import and reexport macros from other crates with the `use`
565   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
566   the root module of the crate. If your macro relies on calling other local
567   macros, it is recommended to export with the
568   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
569   those macros.
570 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
571   using the `vis` specifier.][53370]
572 - [Non-macro attributes now allow all forms of literals, not just
573   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
574   write `#[attr(true)]`.
575 - [You can now specify a function to handle a panic in the Rust runtime with the
576   `#[panic_handler]` attribute.][51366]
577
578 Compiler
579 --------
580 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
581 - [Added the `aarch64-unknown-netbsd` target][53165]
582
583 Libraries
584 ---------
585 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
586
587 Stabilized APIs
588 ---------------
589 - [`Ipv4Addr::BROADCAST`]
590 - [`Ipv4Addr::LOCALHOST`]
591 - [`Ipv4Addr::UNSPECIFIED`]
592 - [`Ipv6Addr::LOCALHOST`]
593 - [`Ipv6Addr::UNSPECIFIED`]
594 - [`Iterator::find_map`]
595
596   The following methods are replacement methods for `trim_left`, `trim_right`,
597   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
598   in 1.33.0:
599 - [`str::trim_end_matches`]
600 - [`str::trim_end`]
601 - [`str::trim_start_matches`]
602 - [`str::trim_start`]
603
604 Cargo
605 ----
606 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
607 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
608   equivalent to calling `rustdoc --error-format=json`.
609 - [Cargo will now provide a progress bar for builds.][cargo/5995]
610
611 Misc
612 ----
613 - [`rustdoc` allows you to specify what edition to treat your code as with the
614   `--edition` option.][54057]
615 - [`rustdoc` now has the `--color` (specify whether to output color) and
616   `--error-format` (specify error format, e.g. `json`) options.][53003]
617 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
618   debug symbols.][53774]
619 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
620   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
621
622 [50911]: https://github.com/rust-lang/rust/pull/50911/
623 [51363]: https://github.com/rust-lang/rust/pull/51363/
624 [51366]: https://github.com/rust-lang/rust/pull/51366/
625 [52081]: https://github.com/rust-lang/rust/pull/52081/
626 [53003]: https://github.com/rust-lang/rust/pull/53003/
627 [53033]: https://github.com/rust-lang/rust/pull/53033/
628 [53044]: https://github.com/rust-lang/rust/pull/53044/
629 [53165]: https://github.com/rust-lang/rust/pull/53165/
630 [53213]: https://github.com/rust-lang/rust/pull/53213/
631 [53236]: https://github.com/rust-lang/rust/pull/53236/
632 [53272]: https://github.com/rust-lang/rust/pull/53272/
633 [53370]: https://github.com/rust-lang/rust/pull/53370/
634 [53459]: https://github.com/rust-lang/rust/pull/53459/
635 [53774]: https://github.com/rust-lang/rust/pull/53774/
636 [53822]: https://github.com/rust-lang/rust/pull/53822/
637 [54057]: https://github.com/rust-lang/rust/pull/54057/
638 [54146]: https://github.com/rust-lang/rust/pull/54146/
639 [54404]: https://github.com/rust-lang/rust/pull/54404/
640 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
641 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
642 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
643 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
644
645 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
646 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
647 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
648 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
649 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
650 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
651 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
652 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
653 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
654 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
655
656
657 Version 1.29.2 (2018-10-11)
658 ===========================
659
660 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
661 - The `rls-preview` component on the windows-gnu targets has been restored.
662
663 [54639]: https://github.com/rust-lang/rust/pull/54639
664
665
666 Version 1.29.1 (2018-09-25)
667 ===========================
668
669 Security Notes
670 --------------
671
672 - The standard library's `str::repeat` function contained an out of bounds write
673   caused by an integer overflow. This has been fixed by deterministically
674   panicking when an overflow happens.
675
676   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
677   us.
678
679
680 Version 1.29.0 (2018-09-13)
681 ==========================
682
683 Compiler
684 --------
685 - [Bumped minimum LLVM version to 5.0.][51899]
686 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
687 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
688
689 Libraries
690 ---------
691 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
692 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
693 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
694 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
695   for `&str`.][51178]
696 - [`Cell<T>` now allows `T` to be unsized.][50494]
697 - [`SocketAddr` is now stable on Redox.][52656]
698
699 Stabilized APIs
700 ---------------
701 - [`Arc::downcast`]
702 - [`Iterator::flatten`]
703 - [`Rc::downcast`]
704
705 Cargo
706 -----
707 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
708   `--locked` to disable this behavior.
709 - [`cargo-install` will now allow you to cross compile an install
710   using `--target`.][cargo/5614]
711 - [Added the `cargo-fix` subcommand to automatically move project code from
712   2015 edition to 2018.][cargo/5723]
713 - [`cargo doc` can now optionally document private types using the
714   `--document-private-items` flag.][cargo/5543]
715
716 Misc
717 ----
718 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
719   the specified level to that level.][52354] For example `--cap-lints warn`
720   will demote `deny` and `forbid` lints to `warn`.
721 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
722   fails and `101` if there is a panic.][52197]
723 - [A preview of clippy has been made available through rustup.][51122]
724   You can install the preview with `rustup component add clippy-preview`.
725
726 Compatibility Notes
727 -------------------
728 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
729   Use `str::get_unchecked(begin..end)` instead.
730 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
731   Consider using the `home_dir` function from
732   https://crates.io/crates/dirs instead.
733 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
734 - [`cfg` attributes and `--cfg` command line flags are now more
735   strictly validated.][53893]
736
737 [53893]: https://github.com/rust-lang/rust/pull/53893/
738 [52861]: https://github.com/rust-lang/rust/pull/52861/
739 [52656]: https://github.com/rust-lang/rust/pull/52656/
740 [52239]: https://github.com/rust-lang/rust/pull/52239/
741 [52330]: https://github.com/rust-lang/rust/pull/52330/
742 [52354]: https://github.com/rust-lang/rust/pull/52354/
743 [52402]: https://github.com/rust-lang/rust/pull/52402/
744 [52103]: https://github.com/rust-lang/rust/pull/52103/
745 [52197]: https://github.com/rust-lang/rust/pull/52197/
746 [51807]: https://github.com/rust-lang/rust/pull/51807/
747 [51899]: https://github.com/rust-lang/rust/pull/51899/
748 [51912]: https://github.com/rust-lang/rust/pull/51912/
749 [51511]: https://github.com/rust-lang/rust/pull/51511/
750 [51619]: https://github.com/rust-lang/rust/pull/51619/
751 [51656]: https://github.com/rust-lang/rust/pull/51656/
752 [51178]: https://github.com/rust-lang/rust/pull/51178/
753 [51122]: https://github.com/rust-lang/rust/pull/51122
754 [50494]: https://github.com/rust-lang/rust/pull/50494/
755 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
756 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
757 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
758 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
759 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
760 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
761 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
762
763
764 Version 1.28.0 (2018-08-02)
765 ===========================
766
767 Language
768 --------
769 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
770   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
771   the inner type across Foreign Function Interface (FFI) boundaries.
772 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
773   and can now be used as identifiers.][51196]
774 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
775   stable.][51241] This will allow users to specify a global allocator for
776   their program.
777 - [Unit test functions marked with the `#[test]` attribute can now return
778   `Result<(), E: Debug>` in addition to `()`.][51298]
779 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
780   allows macros to easily target lifetimes.
781
782 Compiler
783 --------
784 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
785   prioritise making smaller binary sizes. `z` is the same as `s` with the
786   exception that it does not vectorise loops, which typically results in an even
787   smaller binary.
788 - [The short error format is now stable.][49546] Specified with
789   `--error-format=short` this option will provide a more compressed output of
790   rust error messages.
791 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
792 - [Reduced the number of allocations in the macro parser.][50855] This can
793   improve compile times of macro heavy crates on average by 5%.
794
795 Libraries
796 ---------
797 - [Implemented `Default` for `&mut str`.][51306]
798 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
799 - [Implemented `Extend` for `()`.][50234]
800 - [The `Debug` implementation of `time::Duration` should now be more easily
801   human readable.][50364] Previously a `Duration` of one second would printed as
802   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
803 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
804   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
805   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
806   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
807   for `PathBuf`.][50170]
808 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
809   and `Wrapping<i128>`.][50465]
810 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
811   possible.][51050] This can provide up to a 40% speed increase.
812 - [Improved error messages when using `format!`.][50610]
813
814 Stabilized APIs
815 ---------------
816 - [`Iterator::step_by`]
817 - [`Path::ancestors`]
818 - [`SystemTime::UNIX_EPOCH`]
819 - [`alloc::GlobalAlloc`]
820 - [`alloc::Layout`]
821 - [`alloc::LayoutErr`]
822 - [`alloc::System`]
823 - [`alloc::alloc`]
824 - [`alloc::alloc_zeroed`]
825 - [`alloc::dealloc`]
826 - [`alloc::realloc`]
827 - [`alloc::handle_alloc_error`]
828 - [`btree_map::Entry::or_default`]
829 - [`fmt::Alignment`]
830 - [`hash_map::Entry::or_default`]
831 - [`iter::repeat_with`]
832 - [`num::NonZeroUsize`]
833 - [`num::NonZeroU128`]
834 - [`num::NonZeroU16`]
835 - [`num::NonZeroU32`]
836 - [`num::NonZeroU64`]
837 - [`num::NonZeroU8`]
838 - [`ops::RangeBounds`]
839 - [`slice::SliceIndex`]
840 - [`slice::from_mut`]
841 - [`slice::from_ref`]
842 - [`{Any + Send + Sync}::downcast_mut`]
843 - [`{Any + Send + Sync}::downcast_ref`]
844 - [`{Any + Send + Sync}::is`]
845
846 Cargo
847 -----
848 - [Cargo will now no longer allow you to publish crates with build scripts that
849   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
850   considered to be immutable.
851
852 Misc
853 ----
854 - [The `suggestion_applicability` field in `rustc`'s json output is now
855   stable.][50486] This will allow dev tools to check whether a code suggestion
856   would apply to them.
857
858 Compatibility Notes
859 -------------------
860 - [Rust will consider trait objects with duplicated constraints to be the same
861   type as without the duplicated constraint.][51276] For example the below code will
862   now fail to compile.
863   ```rust
864   trait Trait {}
865
866   impl Trait + Send {
867       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
868   }
869
870   impl Trait + Send + Send {
871       fn test(&self) { println!("two"); }
872   }
873   ```
874
875 [49546]: https://github.com/rust-lang/rust/pull/49546/
876 [50143]: https://github.com/rust-lang/rust/pull/50143/
877 [50170]: https://github.com/rust-lang/rust/pull/50170/
878 [50234]: https://github.com/rust-lang/rust/pull/50234/
879 [50265]: https://github.com/rust-lang/rust/pull/50265/
880 [50364]: https://github.com/rust-lang/rust/pull/50364/
881 [50385]: https://github.com/rust-lang/rust/pull/50385/
882 [50465]: https://github.com/rust-lang/rust/pull/50465/
883 [50486]: https://github.com/rust-lang/rust/pull/50486/
884 [50554]: https://github.com/rust-lang/rust/pull/50554/
885 [50610]: https://github.com/rust-lang/rust/pull/50610/
886 [50855]: https://github.com/rust-lang/rust/pull/50855/
887 [51050]: https://github.com/rust-lang/rust/pull/51050/
888 [51196]: https://github.com/rust-lang/rust/pull/51196/
889 [51200]: https://github.com/rust-lang/rust/pull/51200/
890 [51241]: https://github.com/rust-lang/rust/pull/51241/
891 [51276]: https://github.com/rust-lang/rust/pull/51276/
892 [51298]: https://github.com/rust-lang/rust/pull/51298/
893 [51306]: https://github.com/rust-lang/rust/pull/51306/
894 [51562]: https://github.com/rust-lang/rust/pull/51562/
895 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
896 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
897 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
898 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
899 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
900 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
901 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
902 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
903 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
904 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
905 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
906 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
907 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
908 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
909 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
910 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
911 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
912 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
913 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
914 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
915 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
916 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
917 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
918 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
919 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
920 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
921 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
922 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
923 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
924 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
925
926 Version 1.27.2 (2018-07-20)
927 ===========================
928
929 Compatibility Notes
930 -------------------
931
932 - The borrow checker was fixed to avoid potential unsoundness when using
933   match ergonomics: [#52213][52213].
934
935 [52213]: https://github.com/rust-lang/rust/issues/52213
936
937 Version 1.27.1 (2018-07-10)
938 ===========================
939
940 Security Notes
941 --------------
942
943 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
944   when running, which enabled executing code as some other user on a
945   given machine. This release fixes that vulnerability; you can read
946   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
947
948   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
949
950 Compatibility Notes
951 -------------------
952
953 - The borrow checker was fixed to avoid an additional potential unsoundness when using
954   match ergonomics: [#51415][51415], [#49534][49534].
955
956 [51415]: https://github.com/rust-lang/rust/issues/51415
957 [49534]: https://github.com/rust-lang/rust/issues/49534
958 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
959 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
960
961 Version 1.27.0 (2018-06-21)
962 ==========================
963
964 Language
965 --------
966 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
967   be used as an identifier.
968 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
969   bare `Trait` syntax, and should make it clearer when being used in tandem with
970   `impl Trait` because it is equivalent to the following syntax:
971   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
972   `Box<Trait> == Box<dyn Trait>`.
973 - [Attributes on generic parameters such as types and lifetimes are
974   now stable.][48851] e.g.
975   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
976 - [The `#[must_use]` attribute can now also be used on functions as well as
977   types.][48925] It provides a lint that by default warns users when the
978   value returned by a function has not been used.
979
980 Compiler
981 --------
982 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
983
984 Libraries
985 ---------
986 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
987   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
988   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
989   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
990   the `cfg` attribute.
991 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
992   std are now available in core.][49896]
993 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
994   to `Self`.][49630]
995 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
996   that the operation isn't done in place.
997 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
998   the `#[must_use]` attribute][49533] to warn about unused potentially
999   expensive allocations.
1000
1001 Stabilized APIs
1002 ---------------
1003 - [`DoubleEndedIterator::rfind`]
1004 - [`DoubleEndedIterator::rfold`]
1005 - [`DoubleEndedIterator::try_rfold`]
1006 - [`Duration::from_micros`]
1007 - [`Duration::from_nanos`]
1008 - [`Duration::subsec_micros`]
1009 - [`Duration::subsec_millis`]
1010 - [`HashMap::remove_entry`]
1011 - [`Iterator::try_fold`]
1012 - [`Iterator::try_for_each`]
1013 - [`NonNull::cast`]
1014 - [`Option::filter`]
1015 - [`String::replace_range`]
1016 - [`Take::set_limit`]
1017 - [`hint::unreachable_unchecked`]
1018 - [`os::unix::process::parent_id`]
1019 - [`ptr::swap_nonoverlapping`]
1020 - [`slice::rsplit_mut`]
1021 - [`slice::rsplit`]
1022 - [`slice::swap_with_slice`]
1023
1024 Cargo
1025 -----
1026 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
1027   `readme`, and `repository` fields.][cargo/5386]
1028 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
1029 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
1030   a different directory than `target` for placing compilation artifacts.
1031 - [Cargo will be adding automatic target inference for binaries, benchmarks,
1032   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
1033   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
1034   where cargo would infer a binary, Cargo will produce a warning. You can
1035   disable this feature ahead of time by setting any of the following to false:
1036   `autobins`, `autobenches`, `autoexamples`, `autotests`.
1037 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
1038   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
1039
1040 Misc
1041 ----
1042 - [Added “The Rustc book” into the official documentation.][49707]
1043   [“The Rustc book”] documents and teaches how to use the rustc compiler.
1044 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
1045
1046 Compatibility Notes
1047 -------------------
1048 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
1049   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
1050   compile, `"".is_empty()` will still compile.
1051 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
1052   will only print the inner type.][48553] E.g.
1053   `print!("{:?}", AtomicBool::new(true))` will print `true`,
1054   not `AtomicBool(true)`.
1055 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
1056   could enter higher numbers but they were not supported by LLVM. Up to 512MB
1057   alignment should cover all use cases.
1058 - The `.description()` method on the `std::error::Error` trait
1059   [has been soft-deprecated][50163]. It is no longer required to implement it.
1060
1061 [48553]: https://github.com/rust-lang/rust/pull/48553/
1062 [48851]: https://github.com/rust-lang/rust/pull/48851/
1063 [48925]: https://github.com/rust-lang/rust/pull/48925/
1064 [49533]: https://github.com/rust-lang/rust/pull/49533/
1065 [49623]: https://github.com/rust-lang/rust/pull/49623/
1066 [49630]: https://github.com/rust-lang/rust/pull/49630/
1067 [49664]: https://github.com/rust-lang/rust/pull/49664/
1068 [49699]: https://github.com/rust-lang/rust/pull/49699/
1069 [49707]: https://github.com/rust-lang/rust/pull/49707/
1070 [49719]: https://github.com/rust-lang/rust/pull/49719/
1071 [49896]: https://github.com/rust-lang/rust/pull/49896/
1072 [49968]: https://github.com/rust-lang/rust/pull/49968/
1073 [50163]: https://github.com/rust-lang/rust/pull/50163
1074 [50177]: https://github.com/rust-lang/rust/pull/50177/
1075 [50378]: https://github.com/rust-lang/rust/pull/50378/
1076 [50398]: https://github.com/rust-lang/rust/pull/50398/
1077 [50423]: https://github.com/rust-lang/rust/pull/50423/
1078 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
1079 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
1080 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
1081 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
1082 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
1083 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
1084 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
1085 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
1086 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
1087 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
1088 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
1089 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1090 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1091 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
1092 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
1093 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
1094 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
1095 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
1096 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
1097 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
1098 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
1099 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
1100 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1101 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
1102 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
1103 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
1104 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
1105 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
1106 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
1107 [“The Rustc book”]: https://doc.rust-lang.org/rustc
1108
1109
1110 Version 1.26.2 (2018-06-05)
1111 ==========================
1112
1113 Compatibility Notes
1114 -------------------
1115
1116 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
1117
1118 [51117]: https://github.com/rust-lang/rust/issues/51117
1119
1120
1121 Version 1.26.1 (2018-05-29)
1122 ==========================
1123
1124 Tools
1125 -----
1126
1127 - [RLS now works on Windows.][50646]
1128 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
1129
1130
1131 Compatibility Notes
1132 --------
1133
1134 - [`fn main() -> impl Trait` no longer works for non-Termination
1135   trait.][50656]
1136   This reverts an accidental stabilization.
1137 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
1138 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
1139
1140 [50646]: https://github.com/rust-lang/rust/issues/50646
1141 [50656]: https://github.com/rust-lang/rust/pull/50656
1142 [50812]: https://github.com/rust-lang/rust/pull/50812
1143 [50950]: https://github.com/rust-lang/rust/issues/50950
1144 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
1145
1146 Version 1.26.0 (2018-05-10)
1147 ==========================
1148
1149 Language
1150 --------
1151 - [Closures now implement `Copy` and/or `Clone` if all captured variables
1152   implement either or both traits.][49299]
1153 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
1154 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
1155   lifetime can be elided.][49458]
1156 - [`impl Trait` is now stable allowing you to have abstract types in returns
1157    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
1158   `fn open(path: impl AsRef<Path>)`.
1159 - [Pattern matching will now automatically apply dereferences.][49394]
1160 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
1161 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
1162 - [A lot of operations are now available in a const context.][46882] E.g. You
1163   can now index into constant arrays, reference and dereference into constants,
1164   and use tuple struct constructors.
1165 - [Fixed entry slice patterns are now stable.][48516] E.g.
1166   ```rust
1167   let points = [1, 2, 3, 4];
1168   match points {
1169       [1, 2, 3, 4] => println!("All points were sequential."),
1170       _ => println!("Not all points were sequential."),
1171   }
1172   ```
1173
1174
1175 Compiler
1176 --------
1177 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
1178 - [Fixed exponential projection complexity on nested types.][48296]
1179   This can provide up to a ~12% reduction in compile times for certain crates.
1180 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
1181   to remap path prefixes outputted by the compiler.
1182 - [Added `powerpc-unknown-netbsd` target.][48281]
1183
1184 Libraries
1185 ---------
1186 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
1187 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
1188   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
1189 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
1190 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
1191 - [`ascii::escape_default` is now available in libcore.][48735]
1192 - [Trailing commas are now supported in std and core macros.][48056]
1193 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
1194 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
1195
1196 Stabilized APIs
1197 ---------------
1198 - [`*const T::add`]
1199 - [`*const T::copy_to_nonoverlapping`]
1200 - [`*const T::copy_to`]
1201 - [`*const T::read_unaligned`]
1202 - [`*const T::read_volatile`]
1203 - [`*const T::read`]
1204 - [`*const T::sub`]
1205 - [`*const T::wrapping_add`]
1206 - [`*const T::wrapping_sub`]
1207 - [`*mut T::add`]
1208 - [`*mut T::copy_to_nonoverlapping`]
1209 - [`*mut T::copy_to`]
1210 - [`*mut T::read_unaligned`]
1211 - [`*mut T::read_volatile`]
1212 - [`*mut T::read`]
1213 - [`*mut T::replace`]
1214 - [`*mut T::sub`]
1215 - [`*mut T::swap`]
1216 - [`*mut T::wrapping_add`]
1217 - [`*mut T::wrapping_sub`]
1218 - [`*mut T::write_bytes`]
1219 - [`*mut T::write_unaligned`]
1220 - [`*mut T::write_volatile`]
1221 - [`*mut T::write`]
1222 - [`Box::leak`]
1223 - [`FromUtf8Error::as_bytes`]
1224 - [`LocalKey::try_with`]
1225 - [`Option::cloned`]
1226 - [`btree_map::Entry::and_modify`]
1227 - [`fs::read_to_string`]
1228 - [`fs::read`]
1229 - [`fs::write`]
1230 - [`hash_map::Entry::and_modify`]
1231 - [`iter::FusedIterator`]
1232 - [`ops::RangeInclusive`]
1233 - [`ops::RangeToInclusive`]
1234 - [`process::id`]
1235 - [`slice::rotate_left`]
1236 - [`slice::rotate_right`]
1237 - [`String::retain`]
1238
1239
1240 Cargo
1241 -----
1242 - [Cargo will now output path to custom commands when `-v` is
1243   passed with `--list`][cargo/5041]
1244 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
1245
1246 Misc
1247 ----
1248 - [The second edition of "The Rust Programming Language" book is now recommended
1249   over the first.][48404]
1250
1251 Compatibility Notes
1252 -------------------
1253
1254 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
1255   syntax is now invalid.
1256   ```
1257   use std::ops::Fn as dyn;
1258   fn g(_: Box<dyn(std::fmt::Debug)>) {}
1259   ```
1260 - [The result of dereferences are no longer promoted to `'static`.][47408]
1261   e.g.
1262   ```rust
1263   fn main() {
1264       const PAIR: &(i32, i32) = &(0, 1);
1265       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
1266   }
1267   ```
1268 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
1269 - [`".e0"` will now no longer parse as `0.0` and will instead cause
1270   an error.][48235]
1271 - [Removed hoedown from rustdoc.][48274]
1272 - [Bounds on higher-kinded lifetimes a hard error.][48326]
1273
1274 [46882]: https://github.com/rust-lang/rust/pull/46882
1275 [47379]: https://github.com/rust-lang/rust/pull/47379
1276 [47408]: https://github.com/rust-lang/rust/pull/47408
1277 [47813]: https://github.com/rust-lang/rust/pull/47813
1278 [48056]: https://github.com/rust-lang/rust/pull/48056
1279 [48125]: https://github.com/rust-lang/rust/pull/48125
1280 [48166]: https://github.com/rust-lang/rust/pull/48166
1281 [48235]: https://github.com/rust-lang/rust/pull/48235
1282 [48274]: https://github.com/rust-lang/rust/pull/48274
1283 [48281]: https://github.com/rust-lang/rust/pull/48281
1284 [48296]: https://github.com/rust-lang/rust/pull/48296
1285 [48326]: https://github.com/rust-lang/rust/pull/48326
1286 [48359]: https://github.com/rust-lang/rust/pull/48359
1287 [48404]: https://github.com/rust-lang/rust/pull/48404
1288 [48481]: https://github.com/rust-lang/rust/pull/48481
1289 [48516]: https://github.com/rust-lang/rust/pull/48516
1290 [48628]: https://github.com/rust-lang/rust/pull/48628
1291 [48629]: https://github.com/rust-lang/rust/pull/48629
1292 [48657]: https://github.com/rust-lang/rust/pull/48657
1293 [48735]: https://github.com/rust-lang/rust/pull/48735
1294 [48978]: https://github.com/rust-lang/rust/pull/48978
1295 [49101]: https://github.com/rust-lang/rust/pull/49101
1296 [49109]: https://github.com/rust-lang/rust/pull/49109
1297 [49121]: https://github.com/rust-lang/rust/pull/49121
1298 [49162]: https://github.com/rust-lang/rust/pull/49162
1299 [49184]: https://github.com/rust-lang/rust/pull/49184
1300 [49234]: https://github.com/rust-lang/rust/pull/49234
1301 [49255]: https://github.com/rust-lang/rust/pull/49255
1302 [49299]: https://github.com/rust-lang/rust/pull/49299
1303 [49305]: https://github.com/rust-lang/rust/pull/49305
1304 [49394]: https://github.com/rust-lang/rust/pull/49394
1305 [49458]: https://github.com/rust-lang/rust/pull/49458
1306 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
1307 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
1308 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
1309 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
1310 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
1311 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
1312 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
1313 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
1314 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
1315 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
1316 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
1317 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
1318 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
1319 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
1320 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
1321 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
1322 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
1323 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
1324 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
1325 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
1326 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
1327 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
1328 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
1329 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
1330 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
1331 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
1332 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
1333 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
1334 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
1335 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
1336 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
1337 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
1338 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
1339 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
1340 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
1341 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
1342 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1343 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
1344 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
1345 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
1346 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
1347 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
1348
1349
1350 Version 1.25.0 (2018-03-29)
1351 ==========================
1352
1353 Language
1354 --------
1355 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
1356 - [You can now use nested groups of imports.][47948]
1357   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
1358 - [You can now have `|` at the start of a match arm.][47947] e.g.
1359 ```rust
1360 enum Foo { A, B, C }
1361
1362 fn main() {
1363     let x = Foo::A;
1364     match x {
1365         | Foo::A
1366         | Foo::B => println!("AB"),
1367         | Foo::C => println!("C"),
1368     }
1369 }
1370 ```
1371
1372 Compiler
1373 --------
1374 - [Upgraded to LLVM 6.][47828]
1375 - [Added `-C lto=val` option.][47521]
1376 - [Added `i586-unknown-linux-musl` target][47282]
1377
1378 Libraries
1379 ---------
1380 - [Impl Send for `process::Command` on Unix.][47760]
1381 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
1382 - [`UnsafeCell::into_inner` is now safe.][47204]
1383 - [Implement libstd for CloudABI.][47268]
1384 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
1385 - [Implement `AsRef<Path>` for Component][46985]
1386 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
1387 - [Moved `Duration` to libcore.][46666]
1388
1389 Stabilized APIs
1390 ---------------
1391 - [`Location::column`]
1392 - [`ptr::NonNull`]
1393
1394 The following functions can now be used in a constant expression.
1395 eg. `static MINUTE: Duration = Duration::from_secs(60);`
1396 - [`Duration::new`][47300]
1397 - [`Duration::from_secs`][47300]
1398 - [`Duration::from_millis`][47300]
1399
1400 Cargo
1401 -----
1402 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
1403 - [`cargo new` now defaults to creating a binary crate, instead of a
1404   library crate.][cargo/5029]
1405
1406 Misc
1407 ----
1408 - [Rust by example is now shipped with new releases][46196]
1409
1410 Compatibility Notes
1411 -------------------
1412 - [Deprecated `net::lookup_host`.][47510]
1413 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
1414 - The borrow checker was sometimes incorrectly permitting overlapping borrows
1415   around indexing operations (see [#47349][47349]). This has been fixed (which also
1416   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
1417 - [Removed deprecated unstable attribute `#[simd]`.][47251]
1418
1419 [33903]: https://github.com/rust-lang/rust/pull/33903
1420 [47947]: https://github.com/rust-lang/rust/pull/47947
1421 [47948]: https://github.com/rust-lang/rust/pull/47948
1422 [47760]: https://github.com/rust-lang/rust/pull/47760
1423 [47790]: https://github.com/rust-lang/rust/pull/47790
1424 [47828]: https://github.com/rust-lang/rust/pull/47828
1425 [47398]: https://github.com/rust-lang/rust/pull/47398
1426 [47510]: https://github.com/rust-lang/rust/pull/47510
1427 [47521]: https://github.com/rust-lang/rust/pull/47521
1428 [47204]: https://github.com/rust-lang/rust/pull/47204
1429 [47251]: https://github.com/rust-lang/rust/pull/47251
1430 [47268]: https://github.com/rust-lang/rust/pull/47268
1431 [47282]: https://github.com/rust-lang/rust/pull/47282
1432 [47300]: https://github.com/rust-lang/rust/pull/47300
1433 [47349]: https://github.com/rust-lang/rust/pull/47349
1434 [46931]: https://github.com/rust-lang/rust/pull/46931
1435 [46985]: https://github.com/rust-lang/rust/pull/46985
1436 [47006]: https://github.com/rust-lang/rust/pull/47006
1437 [46830]: https://github.com/rust-lang/rust/pull/46830
1438 [46095]: https://github.com/rust-lang/rust/pull/46095
1439 [46666]: https://github.com/rust-lang/rust/pull/46666
1440 [46196]: https://github.com/rust-lang/rust/pull/46196
1441 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
1442 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
1443 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
1444 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
1445 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
1446
1447
1448 Version 1.24.1 (2018-03-01)
1449 ==========================
1450
1451  - [Do not abort when unwinding through FFI][48251]
1452  - [Emit UTF-16 files for linker arguments on Windows][48318]
1453  - [Make the error index generator work again][48308]
1454  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
1455
1456 [48251]: https://github.com/rust-lang/rust/issues/48251
1457 [48308]: https://github.com/rust-lang/rust/issues/48308
1458 [48318]: https://github.com/rust-lang/rust/issues/48318
1459 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
1460
1461
1462 Version 1.24.0 (2018-02-15)
1463 ==========================
1464
1465 Language
1466 --------
1467 - [External `sysv64` ffi is now available.][46528]
1468   eg. `extern "sysv64" fn foo () {}`
1469
1470 Compiler
1471 --------
1472 - [rustc now uses 16 codegen units by default for release builds.][46910]
1473   For the fastest builds, utilize `codegen-units=1`.
1474 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1475 - [Add `aarch64-unknown-openbsd` support][46760]
1476
1477 Libraries
1478 ---------
1479 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1480   improvement in performance in the majority of cases.
1481 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1482   with Windows.][46798]
1483 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1484 - [impl `From<bool>` for `AtomicBool`][46293]
1485 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1486 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1487 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1488 - [float::from_bits now just uses transmute.][46012] This provides
1489   some optimisations from LLVM.
1490 - [Copied `AsciiExt` methods onto `char`][46077]
1491 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1492 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1493 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1494 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1495
1496 Stabilized APIs
1497 ---------------
1498 - [`RefCell::replace`]
1499 - [`RefCell::swap`]
1500 - [`atomic::spin_loop_hint`]
1501
1502 The following functions can now be used in a constant expression.
1503 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1504
1505 - [`AtomicBool::new`][46287]
1506 - [`AtomicUsize::new`][46287]
1507 - [`AtomicIsize::new`][46287]
1508 - [`AtomicPtr::new`][46287]
1509 - [`Cell::new`][46287]
1510 - [`{integer}::min_value`][46287]
1511 - [`{integer}::max_value`][46287]
1512 - [`mem::size_of`][46287]
1513 - [`mem::align_of`][46287]
1514 - [`ptr::null`][46287]
1515 - [`ptr::null_mut`][46287]
1516 - [`RefCell::new`][46287]
1517 - [`UnsafeCell::new`][46287]
1518
1519 Cargo
1520 -----
1521 - [Added a `workspace.default-members` config that
1522   overrides implied `--all` in virtual workspaces.][cargo/4743]
1523 - [Enable incremental by default on development builds.][cargo/4817] Also added
1524   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1525   per-project or global basis respectively.
1526
1527 Misc
1528 ----
1529
1530 Compatibility Notes
1531 -------------------
1532 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1533 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1534   in accordance with IETF RFC 4291 §2.2.
1535 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1536 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1537   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1538 - [Leading zeros in tuple struct members is now an error][47084]
1539 - [`column!()` macro is one-based instead of zero-based][46977]
1540 - [`fmt::Arguments` can no longer be shared across threads][45198]
1541 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1542 - [Cargo sets a different working directory for the compiler][cargo/4788]
1543
1544 [44884]: https://github.com/rust-lang/rust/pull/44884
1545 [45198]: https://github.com/rust-lang/rust/pull/45198
1546 [45506]: https://github.com/rust-lang/rust/pull/45506
1547 [45904]: https://github.com/rust-lang/rust/pull/45904
1548 [45990]: https://github.com/rust-lang/rust/pull/45990
1549 [46012]: https://github.com/rust-lang/rust/pull/46012
1550 [46077]: https://github.com/rust-lang/rust/pull/46077
1551 [46094]: https://github.com/rust-lang/rust/pull/46094
1552 [46284]: https://github.com/rust-lang/rust/pull/46284
1553 [46287]: https://github.com/rust-lang/rust/pull/46287
1554 [46293]: https://github.com/rust-lang/rust/pull/46293
1555 [46528]: https://github.com/rust-lang/rust/pull/46528
1556 [46671]: https://github.com/rust-lang/rust/pull/46671
1557 [46713]: https://github.com/rust-lang/rust/pull/46713
1558 [46735]: https://github.com/rust-lang/rust/pull/46735
1559 [46749]: https://github.com/rust-lang/rust/pull/46749
1560 [46760]: https://github.com/rust-lang/rust/pull/46760
1561 [46798]: https://github.com/rust-lang/rust/pull/46798
1562 [46828]: https://github.com/rust-lang/rust/pull/46828
1563 [46831]: https://github.com/rust-lang/rust/pull/46831
1564 [46833]: https://github.com/rust-lang/rust/pull/46833
1565 [46910]: https://github.com/rust-lang/rust/pull/46910
1566 [46977]: https://github.com/rust-lang/rust/pull/46977
1567 [47018]: https://github.com/rust-lang/rust/pull/47018
1568 [47080]: https://github.com/rust-lang/rust/pull/47080
1569 [47084]: https://github.com/rust-lang/rust/pull/47084
1570 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1571 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1572 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1573 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1574 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1575 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1576
1577
1578 Version 1.23.0 (2018-01-04)
1579 ==========================
1580
1581 Language
1582 --------
1583 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1584 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1585   Which should fix some confusing errors in some operations.
1586
1587 Compiler
1588 --------
1589 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1590   undefined behavior.][45920]
1591 - [rustc now suggests renaming import if names clash.][45660]
1592 - [Display errors/warnings correctly when there are zero-width or
1593   wide characters.][45711]
1594 - [rustc now avoids unnecessary copies of arguments that are
1595   simple bindings][45380] This should improve memory usage on average by 5-10%.
1596 - [Updated musl used to build musl rustc to 1.1.17][45393]
1597
1598 Libraries
1599 ---------
1600 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1601 - [Implement Hash for raw pointers to unsized types][45483]
1602 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1603 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1604 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1605 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1606   and `<*mut T>::as_mut`][44932]
1607 - [Optimized `Thread::{park, unpark}` implementation][45524]
1608 - [Improved `SliceExt::binary_search` performance.][45333]
1609 - [impl `FromIterator<()>` for `()`][45379]
1610 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1611   is now deprecated.
1612
1613 Stabilized APIs
1614 ---------------
1615
1616 Cargo
1617 -----
1618 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1619   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1620 - [Added unit test checking to `cargo check`][cargo/4592]
1621 - [Cargo now lets you install a specific version
1622   using `cargo install --version`][cargo/4637]
1623
1624 Misc
1625 ----
1626 - [Releases now ship with the Cargo book documentation.][45692]
1627 - [rustdoc now prints rendering warnings on every run.][45324]
1628
1629 Compatibility Notes
1630 -------------------
1631 - [Changes have been made to type equality to make it more correct,
1632   in rare cases this could break some code.][45853] [Tracking issue for
1633   further information][45852]
1634 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1635 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1636   Android 9, the minimum supported version is Android 14.
1637 - [Bumped the minimum LLVM to 3.9][45326]
1638
1639 [44042]: https://github.com/rust-lang/rust/pull/44042
1640 [44932]: https://github.com/rust-lang/rust/pull/44932
1641 [45267]: https://github.com/rust-lang/rust/pull/45267
1642 [45324]: https://github.com/rust-lang/rust/pull/45324
1643 [45326]: https://github.com/rust-lang/rust/pull/45326
1644 [45333]: https://github.com/rust-lang/rust/pull/45333
1645 [45379]: https://github.com/rust-lang/rust/pull/45379
1646 [45380]: https://github.com/rust-lang/rust/pull/45380
1647 [45393]: https://github.com/rust-lang/rust/pull/45393
1648 [45435]: https://github.com/rust-lang/rust/pull/45435
1649 [45483]: https://github.com/rust-lang/rust/pull/45483
1650 [45524]: https://github.com/rust-lang/rust/pull/45524
1651 [45571]: https://github.com/rust-lang/rust/pull/45571
1652 [45580]: https://github.com/rust-lang/rust/pull/45580
1653 [45610]: https://github.com/rust-lang/rust/pull/45610
1654 [45660]: https://github.com/rust-lang/rust/pull/45660
1655 [45692]: https://github.com/rust-lang/rust/pull/45692
1656 [45711]: https://github.com/rust-lang/rust/pull/45711
1657 [45772]: https://github.com/rust-lang/rust/pull/45772
1658 [45852]: https://github.com/rust-lang/rust/issues/45852
1659 [45853]: https://github.com/rust-lang/rust/pull/45853
1660 [45887]: https://github.com/rust-lang/rust/pull/45887
1661 [45920]: https://github.com/rust-lang/rust/pull/45920
1662 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1663 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1664 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1665
1666
1667 Version 1.22.1 (2017-11-22)
1668 ==========================
1669
1670 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1671
1672 [46183]: https://github.com/rust-lang/rust/pull/46183
1673
1674 Version 1.22.0 (2017-11-22)
1675 ==========================
1676
1677 Language
1678 --------
1679 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1680 - [Now accepts underscores in unicode escapes][43716]
1681 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1682 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1683
1684 Compiler
1685 --------
1686 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1687 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1688   This should decrease compile times for debug builds.
1689 - [strict memory alignment now enabled on ARMv6][45094]
1690 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1691
1692 Libraries
1693 ---------
1694 - [Allow atomic operations up to 32 bits
1695   on `armv5te_unknown_linux_gnueabi`][44978]
1696 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1697 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1698 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1699 - [Properly detect overflow in `Instant += Duration`.][44220]
1700 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1701 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1702 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1703
1704 Stabilized APIs
1705 ---------------
1706
1707 Cargo
1708 -----
1709 - [Cargo will now build multi file examples in subdirectories of the `examples`
1710   folder that have a `main.rs` file.][cargo/4496]
1711 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1712   the old format will continue to work and can be updated with `cargo update`.
1713 - [Now supports vendoring git repositories][cargo/3992]
1714
1715 Misc
1716 ----
1717 - [`libbacktrace` is now available on Apple platforms.][44251]
1718 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1719   This now lets you specify that a given code example will fail to compile.
1720
1721 Compatibility Notes
1722 -------------------
1723 - [The minimum Android version that rustc can build for has been bumped
1724   to `4.0` from `2.3`][45656]
1725 - [Allowing `T op= &T` for numeric types has broken some type
1726   inference cases][45480]
1727
1728
1729 [42526]: https://github.com/rust-lang/rust/pull/42526
1730 [43017]: https://github.com/rust-lang/rust/pull/43017
1731 [43716]: https://github.com/rust-lang/rust/pull/43716
1732 [43949]: https://github.com/rust-lang/rust/pull/43949
1733 [44015]: https://github.com/rust-lang/rust/pull/44015
1734 [44220]: https://github.com/rust-lang/rust/pull/44220
1735 [44251]: https://github.com/rust-lang/rust/pull/44251
1736 [44287]: https://github.com/rust-lang/rust/pull/44287
1737 [44303]: https://github.com/rust-lang/rust/pull/44303
1738 [44456]: https://github.com/rust-lang/rust/pull/44456
1739 [44466]: https://github.com/rust-lang/rust/pull/44466
1740 [44895]: https://github.com/rust-lang/rust/pull/44895
1741 [44966]: https://github.com/rust-lang/rust/pull/44966
1742 [44978]: https://github.com/rust-lang/rust/pull/44978
1743 [45041]: https://github.com/rust-lang/rust/pull/45041
1744 [45064]: https://github.com/rust-lang/rust/pull/45064
1745 [45075]: https://github.com/rust-lang/rust/pull/45075
1746 [45094]: https://github.com/rust-lang/rust/pull/45094
1747 [45095]: https://github.com/rust-lang/rust/pull/45095
1748 [45480]: https://github.com/rust-lang/rust/issues/45480
1749 [45656]: https://github.com/rust-lang/rust/pull/45656
1750 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1751 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1752 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1753
1754
1755
1756
1757
1758
1759 Version 1.21.0 (2017-10-12)
1760 ==========================
1761
1762 Language
1763 --------
1764 - [You can now use static references for literals.][43838]
1765   Example:
1766   ```rust
1767   fn main() {
1768       let x: &'static u32 = &0;
1769   }
1770   ```
1771 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1772   Example:
1773   ```rust
1774   my_macro!(Vec<i32>::new); // Always worked
1775   my_macro!(Vec::<i32>::new); // Now works
1776   ```
1777
1778 Compiler
1779 --------
1780 - [Upgraded jemalloc to 4.5.0][43911]
1781 - [Enabled unwinding panics on Redox][43917]
1782 - [Now runs LLVM in parallel during translation phase.][43506]
1783   This should reduce peak memory usage.
1784
1785 Libraries
1786 ---------
1787 - [Generate builtin impls for `Clone` for all arrays and tuples that
1788   are `T: Clone`][43690]
1789 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1790 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1791   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1792
1793 Stabilized APIs
1794 ---------------
1795
1796 [`std::mem::discriminant`]
1797
1798 Cargo
1799 -----
1800 - [You can now call `cargo install` with multiple package names][cargo/4216]
1801 - [Cargo commands inside a virtual workspace will now implicitly
1802   pass `--all`][cargo/4335]
1803 - [Added a `[patch]` section to `Cargo.toml` to handle
1804   prepublication dependencies][cargo/4123] [RFC 1969]
1805 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1806   like patterns][cargo/4270]
1807 - [Added the `--all-targets` option][cargo/4400]
1808 - [Using required dependencies as a feature is now deprecated and emits
1809   a warning][cargo/4364]
1810
1811
1812 Misc
1813 ----
1814 - [Cargo docs are moving][43916]
1815   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1816 - [The rustdoc book is now available][43863]
1817   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1818 - [Added a preview of RLS has been made available through rustup][44204]
1819   Install with `rustup component add rls-preview`
1820 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1821   Previously only showed `std::os::unix`.
1822
1823 Compatibility Notes
1824 -------------------
1825 - [Changes in method matching against higher-ranked types][43880] This may cause
1826   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1827 - [rustc's JSON error output's byte position start at top of file.][42973]
1828   Was previously relative to the rustc's internal `CodeMap` struct which
1829   required the unstable library `libsyntax` to correctly use.
1830 - [`unused_results` lint no longer ignores booleans][43728]
1831
1832 [42565]: https://github.com/rust-lang/rust/pull/42565
1833 [42973]: https://github.com/rust-lang/rust/pull/42973
1834 [43348]: https://github.com/rust-lang/rust/pull/43348
1835 [43459]: https://github.com/rust-lang/rust/pull/43459
1836 [43506]: https://github.com/rust-lang/rust/pull/43506
1837 [43540]: https://github.com/rust-lang/rust/pull/43540
1838 [43690]: https://github.com/rust-lang/rust/pull/43690
1839 [43728]: https://github.com/rust-lang/rust/pull/43728
1840 [43838]: https://github.com/rust-lang/rust/pull/43838
1841 [43863]: https://github.com/rust-lang/rust/pull/43863
1842 [43880]: https://github.com/rust-lang/rust/pull/43880
1843 [43911]: https://github.com/rust-lang/rust/pull/43911
1844 [43916]: https://github.com/rust-lang/rust/pull/43916
1845 [43917]: https://github.com/rust-lang/rust/pull/43917
1846 [44204]: https://github.com/rust-lang/rust/pull/44204
1847 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1848 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1849 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1850 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1851 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1852 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1853 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1854 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1855 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1856
1857 Version 1.20.0 (2017-08-31)
1858 ===========================
1859
1860 Language
1861 --------
1862 - [Associated constants are now stabilised.][42809]
1863 - [A lot of macro bugs are now fixed.][42913]
1864
1865 Compiler
1866 --------
1867
1868 - [Struct fields are now properly coerced to the expected field type.][42807]
1869 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1870   `wasm32-experimental-emscripten` target.
1871 - [Changed some of the error messages to be more helpful.][42033]
1872 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1873   it.][43170]
1874 - [rustc now reports the total number of errors on compilation failure][43015]
1875   previously this was only the number of errors in the pass that failed.
1876 - [Expansion in rustc has been sped up 29x.][42533]
1877 - [added `msp430-none-elf` target.][43099]
1878 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1879   applicable][43178]
1880 - [Fixes backtraces on Redox][43228]
1881 - [rustc now identifies different versions of same crate when absolute paths of
1882   different types match in an error message.][42826]
1883
1884 Libraries
1885 ---------
1886
1887
1888 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1889 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1890   tuples.][43011]
1891 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1892   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1893 - [Impl `Clone` for `DefaultHasher`.][42799]
1894 - [Impl `Sync` for `SyncSender`.][42397]
1895 - [Impl `FromStr` for `char`][42271]
1896 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1897   NaN.][42431]
1898 - [allow messages in the `unimplemented!()` macro.][42155]
1899   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1900 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1901 - [Upgrade to Unicode 10.0.0][42999]
1902 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1903 - [Skip the main thread's manual stack guard on Linux][43072]
1904 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1905 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1906   previously 2^15.
1907 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1908
1909 Stabilized APIs
1910 ---------------
1911
1912 - [`CStr::into_c_string`]
1913 - [`CString::as_c_str`]
1914 - [`CString::into_boxed_c_str`]
1915 - [`Chain::get_mut`]
1916 - [`Chain::get_ref`]
1917 - [`Chain::into_inner`]
1918 - [`Option::get_or_insert_with`]
1919 - [`Option::get_or_insert`]
1920 - [`OsStr::into_os_string`]
1921 - [`OsString::into_boxed_os_str`]
1922 - [`Take::get_mut`]
1923 - [`Take::get_ref`]
1924 - [`Utf8Error::error_len`]
1925 - [`char::EscapeDebug`]
1926 - [`char::escape_debug`]
1927 - [`compile_error!`]
1928 - [`f32::from_bits`]
1929 - [`f32::to_bits`]
1930 - [`f64::from_bits`]
1931 - [`f64::to_bits`]
1932 - [`mem::ManuallyDrop`]
1933 - [`slice::sort_unstable_by_key`]
1934 - [`slice::sort_unstable_by`]
1935 - [`slice::sort_unstable`]
1936 - [`str::from_boxed_utf8_unchecked`]
1937 - [`str::as_bytes_mut`]
1938 - [`str::as_bytes_mut`]
1939 - [`str::from_utf8_mut`]
1940 - [`str::from_utf8_unchecked_mut`]
1941 - [`str::get_mut`]
1942 - [`str::get_unchecked_mut`]
1943 - [`str::get_unchecked`]
1944 - [`str::get`]
1945 - [`str::into_boxed_bytes`]
1946
1947
1948 Cargo
1949 -----
1950 - [Cargo API token location moved from `~/.cargo/config` to
1951   `~/.cargo/credentials`.][cargo/3978]
1952 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1953   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1954   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1955 - [You can now specify version of a binary when installed through
1956   `cargo install` using `--vers`.][cargo/4229]
1957 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1958   failure.][cargo/4248]
1959 - [Changed the convention around which file is the crate root.][cargo/4259]
1960 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1961   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1962
1963 Compatibility Notes
1964 -------------------
1965
1966 - [Functions with `'static` in their return types will now not be as usable as
1967   if they were using lifetime parameters instead.][42417]
1968 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1969   takes the sign of NaN into account where previously didn't.][42430]
1970
1971 [42033]: https://github.com/rust-lang/rust/pull/42033
1972 [42155]: https://github.com/rust-lang/rust/pull/42155
1973 [42271]: https://github.com/rust-lang/rust/pull/42271
1974 [42397]: https://github.com/rust-lang/rust/pull/42397
1975 [42417]: https://github.com/rust-lang/rust/pull/42417
1976 [42430]: https://github.com/rust-lang/rust/pull/42430
1977 [42431]: https://github.com/rust-lang/rust/pull/42431
1978 [42533]: https://github.com/rust-lang/rust/pull/42533
1979 [42571]: https://github.com/rust-lang/rust/pull/42571
1980 [42613]: https://github.com/rust-lang/rust/pull/42613
1981 [42799]: https://github.com/rust-lang/rust/pull/42799
1982 [42807]: https://github.com/rust-lang/rust/pull/42807
1983 [42809]: https://github.com/rust-lang/rust/pull/42809
1984 [42822]: https://github.com/rust-lang/rust/pull/42822
1985 [42826]: https://github.com/rust-lang/rust/pull/42826
1986 [42854]: https://github.com/rust-lang/rust/pull/42854
1987 [42913]: https://github.com/rust-lang/rust/pull/42913
1988 [42999]: https://github.com/rust-lang/rust/pull/42999
1989 [43011]: https://github.com/rust-lang/rust/pull/43011
1990 [43015]: https://github.com/rust-lang/rust/pull/43015
1991 [43072]: https://github.com/rust-lang/rust/pull/43072
1992 [43077]: https://github.com/rust-lang/rust/pull/43077
1993 [43097]: https://github.com/rust-lang/rust/pull/43097
1994 [43099]: https://github.com/rust-lang/rust/pull/43099
1995 [43170]: https://github.com/rust-lang/rust/pull/43170
1996 [43178]: https://github.com/rust-lang/rust/pull/43178
1997 [43185]: https://github.com/rust-lang/rust/pull/43185
1998 [43228]: https://github.com/rust-lang/rust/pull/43228
1999 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
2000 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
2001 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
2002 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
2003 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
2004 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2005 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
2006 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
2007 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
2008 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
2009 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
2010 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
2011 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
2012 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
2013 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
2014 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
2015 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
2016 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
2017 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
2018 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
2019 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
2020 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
2021 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2022 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
2023 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
2024 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
2025 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
2026 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
2027 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
2028 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
2029 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
2030 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
2031 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
2032 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
2033 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
2034 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
2035 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
2036 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
2037 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
2038
2039
2040 Version 1.19.0 (2017-07-20)
2041 ===========================
2042
2043 Language
2044 --------
2045
2046 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
2047   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
2048 - [Macro recursion limit increased to 1024 from 64.][41676]
2049 - [Added lint for detecting unused macros.][41907]
2050 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
2051   For example: `let x = loop { break 7; };`
2052 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
2053   contain `Copy` types and cannot have a `Drop` implementation.
2054   Example: `union Foo { bar: u8, baz: usize }`
2055 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
2056   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
2057
2058 Compiler
2059 --------
2060
2061 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
2062 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
2063   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
2064   you should use `--target armv7-linux-androideabi`.
2065 - [Fixed ICE when removing a source file between compilation sessions.][41873]
2066 - [Minor optimisation of string operations.][42037]
2067 - [Compiler error message is now `aborting due to previous error(s)` instead of
2068   `aborting due to N previous errors`][42150] This was previously inaccurate and
2069   would only count certain kinds of errors.
2070 - [The compiler now supports Visual Studio 2017][42225]
2071 - [The compiler is now built against LLVM 4.0.1 by default][42948]
2072 - [Added a lot][42264] of [new error codes][42302]
2073 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
2074   libraries with C Run-time Libraries(CRT) to be statically linked.
2075 - [Fixed various ARM codegen bugs][42740]
2076
2077 Libraries
2078 ---------
2079
2080 - [`String` now implements `FromIterator<Cow<'a, str>>` and
2081   `Extend<Cow<'a, str>>`][41449]
2082 - [`Vec` now implements `From<&mut [T]>`][41530]
2083 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
2084 - [`SplitWhitespace` now implements `Clone`][41659]
2085 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
2086   1.5x faster][41764]
2087 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
2088   macros, but for printing to stderr.
2089
2090 Stabilized APIs
2091 ---------------
2092
2093 - [`OsString::shrink_to_fit`]
2094 - [`cmp::Reverse`]
2095 - [`Command::envs`]
2096 - [`thread::ThreadId`]
2097
2098 Cargo
2099 -----
2100
2101 - [Build scripts can now add environment variables to the environment
2102   the crate is being compiled in.
2103   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
2104 - [Subcommands now replace the current process rather than spawning a new
2105   child process][cargo/3970]
2106 - [Workspace members can now accept glob file patterns][cargo/3979]
2107 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
2108   the members in a given workspace.][cargo/3988]
2109 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
2110 - [Target directory path is now in the cargo metadata][cargo/4022]
2111 - [Cargo no longer checks out a local working directory for the
2112   crates.io index][cargo/4026] This should provide smaller file size for the
2113   registry, and improve cloning times, especially on Windows machines.
2114 - [Added an `--exclude` option for excluding certain packages when using the
2115   `--all` option][cargo/4031]
2116 - [Cargo will now automatically retry when receiving a 5xx error
2117   from crates.io][cargo/4032]
2118 - [The `--features` option now accepts multiple comma or space
2119   delimited values.][cargo/4084]
2120 - [Added support for custom target specific runners][cargo/3954]
2121
2122 Misc
2123 ----
2124
2125 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
2126   Windows Debugger.
2127 - [Rust will now release XZ compressed packages][rust-installer/57]
2128 - [rustup will now prefer to download rust packages with
2129   XZ compression][rustup/1100] over GZip packages.
2130 - [Added the ability to escape `#` in rust documentation][41785] By adding
2131   additional `#`'s ie. `##` is now `#`
2132
2133 Compatibility Notes
2134 -------------------
2135
2136 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
2137 - [`-Z` flags are now no longer allowed to be used on the stable
2138   compiler.][41751] This has been a warning for a year previous to this.
2139 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
2140   longer works][42844]. Users should migrate to the built-in `check`
2141   command, which has been available since 1.16.
2142 - [Ending a float literal with `._` is now a hard error.
2143   Example: `42._` .][41946]
2144 - [Any use of a private `extern crate` outside of its module is now a
2145   hard error.][36886] This was previously a warning.
2146 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
2147   relative while the `::` prefix makes a path absolute, but was ignored and the
2148   path was relative regardless.
2149 - [Floating point constants in match patterns is now a hard error][36890]
2150   This was previously a warning.
2151 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
2152   match patterns is now a hard error][36891] This was previously a warning.
2153 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
2154   a warning.
2155 - [From the pound escape, lines consisting of multiple `#`s are
2156   now visible][41785]
2157 - [It is an error to re-export private enum variants][42460]. This is
2158   known to break a number of crates that depend on an older version of
2159   mustache.
2160 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
2161   to use it to find the linker, and the build will fail where it did
2162   not previously][42607]
2163
2164 [36886]: https://github.com/rust-lang/rust/issues/36886
2165 [36888]: https://github.com/rust-lang/rust/issues/36888
2166 [36890]: https://github.com/rust-lang/rust/issues/36890
2167 [36891]: https://github.com/rust-lang/rust/issues/36891
2168 [36892]: https://github.com/rust-lang/rust/issues/36892
2169 [37406]: https://github.com/rust-lang/rust/issues/37406
2170 [39983]: https://github.com/rust-lang/rust/pull/39983
2171 [41145]: https://github.com/rust-lang/rust/pull/41145
2172 [41192]: https://github.com/rust-lang/rust/pull/41192
2173 [41258]: https://github.com/rust-lang/rust/pull/41258
2174 [41370]: https://github.com/rust-lang/rust/pull/41370
2175 [41449]: https://github.com/rust-lang/rust/pull/41449
2176 [41530]: https://github.com/rust-lang/rust/pull/41530
2177 [41624]: https://github.com/rust-lang/rust/pull/41624
2178 [41656]: https://github.com/rust-lang/rust/pull/41656
2179 [41659]: https://github.com/rust-lang/rust/pull/41659
2180 [41676]: https://github.com/rust-lang/rust/pull/41676
2181 [41751]: https://github.com/rust-lang/rust/pull/41751
2182 [41764]: https://github.com/rust-lang/rust/pull/41764
2183 [41785]: https://github.com/rust-lang/rust/pull/41785
2184 [41873]: https://github.com/rust-lang/rust/pull/41873
2185 [41907]: https://github.com/rust-lang/rust/pull/41907
2186 [41946]: https://github.com/rust-lang/rust/pull/41946
2187 [42016]: https://github.com/rust-lang/rust/pull/42016
2188 [42037]: https://github.com/rust-lang/rust/pull/42037
2189 [42068]: https://github.com/rust-lang/rust/pull/42068
2190 [42150]: https://github.com/rust-lang/rust/pull/42150
2191 [42162]: https://github.com/rust-lang/rust/pull/42162
2192 [42225]: https://github.com/rust-lang/rust/pull/42225
2193 [42264]: https://github.com/rust-lang/rust/pull/42264
2194 [42302]: https://github.com/rust-lang/rust/pull/42302
2195 [42460]: https://github.com/rust-lang/rust/issues/42460
2196 [42607]: https://github.com/rust-lang/rust/issues/42607
2197 [42740]: https://github.com/rust-lang/rust/pull/42740
2198 [42844]: https://github.com/rust-lang/rust/issues/42844
2199 [42948]: https://github.com/rust-lang/rust/pull/42948
2200 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
2201 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
2202 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
2203 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
2204 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
2205 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
2206 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
2207 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
2208 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
2209 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
2210 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
2211 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
2212 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
2213 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
2214 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
2215 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
2216 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
2217 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
2218 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
2219 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
2220 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
2221 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
2222
2223
2224 Version 1.18.0 (2017-06-08)
2225 ===========================
2226
2227 Language
2228 --------
2229
2230 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
2231   make the item visible to just that module tree. Also accepts the keyword
2232   `crate` to make something public to the whole crate but not users of the
2233   library. Example: `pub(crate) mod utils;`. [RFC 1422].
2234 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
2235   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
2236 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
2237   types like `Write + Send`, trailing `+` are now supported in trait objects,
2238   and better error reporting for trait objects starting with `?Sized`.
2239 - [0e+10 is now a valid floating point literal][40589]
2240 - [Now warns if you bind a lifetime parameter to 'static][40734]
2241 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
2242   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
2243   representation in some cases.][40377]
2244
2245 Compiler
2246 --------
2247
2248 - [rustc can now emit mir with `--emit mir`][39891]
2249 - [Improved LLVM IR for trivial functions][40367]
2250 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
2251 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
2252   opportunities found through profiling
2253 - [Improved backtrace formatting when panicking][38165]
2254
2255 Libraries
2256 ---------
2257
2258 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
2259   iterator hasn't been advanced the original `Vec` is reassembled with no actual
2260   iteration or reallocation.
2261 - [Simplified HashMap Bucket interface][40561] provides performance
2262   improvements for iterating and cloning.
2263 - [Specialize Vec::from_elem to use calloc][40409]
2264 - [Fixed Race condition in fs::create_dir_all][39799]
2265 - [No longer caching stdio on Windows][40516]
2266 - [Optimized insertion sort in slice][40807] insertion sort in some cases
2267   2.50%~ faster and in one case now 12.50% faster.
2268 - [Optimized `AtomicBool::fetch_nand`][41143]
2269
2270 Stabilized APIs
2271 ---------------
2272
2273 - [`Child::try_wait`]
2274 - [`HashMap::retain`]
2275 - [`HashSet::retain`]
2276 - [`PeekMut::pop`]
2277 - [`TcpStream::peek`]
2278 - [`UdpSocket::peek`]
2279 - [`UdpSocket::peek_from`]
2280
2281 Cargo
2282 -----
2283
2284 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
2285   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
2286 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
2287 - [Added Android build support][cargo/3885]
2288 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
2289   of a certain type, for example `cargo build --bins` will build all
2290   binaries.
2291 - [Added support for haiku][cargo/3952]
2292
2293 Misc
2294 ----
2295
2296 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
2297 - [Added rust-windbg script for better debugging on Windows][39983]
2298 - [Rust now uses the official cross compiler for NetBSD][40612]
2299 - [rustdoc now accepts `#` at the start of files][40828]
2300 - [Fixed jemalloc support for musl][41168]
2301
2302 Compatibility Notes
2303 -------------------
2304
2305 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
2306   always placed after the sign if it exists and before the digits. With the `#`
2307   flag the zeroes are placed after the prefix and before the digits.
2308 - [Due to the struct field optimisation][40377], using `transmute` on structs
2309   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
2310   always been undefined behavior, but is now more likely to break in practice.
2311 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
2312   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
2313   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
2314 - [Overlapping inherent `impl`s are now a hard error][40728]
2315 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
2316 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
2317   `out.asm` and `out.ll` instead of only one of the filetypes.
2318 - [ calling a function that returns `Self` will no longer work][41805] when
2319   the size of `Self` cannot be statically determined.
2320 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
2321   this has caused a few regressions namely:
2322
2323   - Changed the link order of local static/dynamic libraries (respecting the
2324     order on given rather than having the compiler reorder).
2325   - Changed how MinGW is linked, native code linked to dynamic libraries
2326     may require manually linking to the gcc support library (for the native
2327     code itself)
2328
2329 [38165]: https://github.com/rust-lang/rust/pull/38165
2330 [39799]: https://github.com/rust-lang/rust/pull/39799
2331 [39891]: https://github.com/rust-lang/rust/pull/39891
2332 [39983]: https://github.com/rust-lang/rust/pull/39983
2333 [40043]: https://github.com/rust-lang/rust/pull/40043
2334 [40241]: https://github.com/rust-lang/rust/pull/40241
2335 [40338]: https://github.com/rust-lang/rust/pull/40338
2336 [40367]: https://github.com/rust-lang/rust/pull/40367
2337 [40377]: https://github.com/rust-lang/rust/pull/40377
2338 [40409]: https://github.com/rust-lang/rust/pull/40409
2339 [40516]: https://github.com/rust-lang/rust/pull/40516
2340 [40556]: https://github.com/rust-lang/rust/pull/40556
2341 [40561]: https://github.com/rust-lang/rust/pull/40561
2342 [40589]: https://github.com/rust-lang/rust/pull/40589
2343 [40612]: https://github.com/rust-lang/rust/pull/40612
2344 [40723]: https://github.com/rust-lang/rust/pull/40723
2345 [40728]: https://github.com/rust-lang/rust/pull/40728
2346 [40731]: https://github.com/rust-lang/rust/pull/40731
2347 [40734]: https://github.com/rust-lang/rust/pull/40734
2348 [40805]: https://github.com/rust-lang/rust/pull/40805
2349 [40807]: https://github.com/rust-lang/rust/pull/40807
2350 [40828]: https://github.com/rust-lang/rust/pull/40828
2351 [40870]: https://github.com/rust-lang/rust/pull/40870
2352 [41085]: https://github.com/rust-lang/rust/pull/41085
2353 [41143]: https://github.com/rust-lang/rust/pull/41143
2354 [41168]: https://github.com/rust-lang/rust/pull/41168
2355 [41270]: https://github.com/rust-lang/rust/issues/41270
2356 [41469]: https://github.com/rust-lang/rust/pull/41469
2357 [41805]: https://github.com/rust-lang/rust/issues/41805
2358 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
2359 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
2360 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
2361 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
2362 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
2363 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
2364 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
2365 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
2366 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
2367 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
2368 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
2369 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
2370 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
2371 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
2372
2373
2374 Version 1.17.0 (2017-04-27)
2375 ===========================
2376
2377 Language
2378 --------
2379
2380 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
2381 * [Fields of structs may be initialized without duplicating the field/variable
2382   names][39761]. [RFC 1682]
2383 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
2384 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2385   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
2386   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
2387   `'b`. Soundness fix.
2388 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
2389 * [Static variables may contain references to other statics][40027]
2390
2391 Compiler
2392 --------
2393
2394 * [Exit quickly on only `--emit dep-info`][40336]
2395 * [Make `-C relocation-model` more correctly determine whether the linker
2396   creates a position-independent executable][40245]
2397 * [Add `-C overflow-checks` to directly control whether integer overflow
2398   panics][40037]
2399 * [The rustc type checker now checks items on demand instead of in a single
2400   in-order pass][40008]. This is mostly an internal refactoring in support of
2401   future work, including incremental type checking, but also resolves [RFC
2402   1647], allowing `Self` to appear in `impl` `where` clauses.
2403 * [Optimize vtable loads][39995]
2404 * [Turn off vectorization for Emscripten targets][39990]
2405 * [Provide suggestions for unknown macros imported with `use`][39953]
2406 * [Fix ICEs in path resolution][39939]
2407 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
2408 * [Add clearer error message using `&str + &str`][39116]
2409
2410 Stabilized APIs
2411 ---------------
2412
2413 * [`Arc::into_raw`]
2414 * [`Arc::from_raw`]
2415 * [`Arc::ptr_eq`]
2416 * [`Rc::into_raw`]
2417 * [`Rc::from_raw`]
2418 * [`Rc::ptr_eq`]
2419 * [`Ordering::then`]
2420 * [`Ordering::then_with`]
2421 * [`BTreeMap::range`]
2422 * [`BTreeMap::range_mut`]
2423 * [`collections::Bound`]
2424 * [`process::abort`]
2425 * [`ptr::read_unaligned`]
2426 * [`ptr::write_unaligned`]
2427 * [`Result::expect_err`]
2428 * [`Cell::swap`]
2429 * [`Cell::replace`]
2430 * [`Cell::into_inner`]
2431 * [`Cell::take`]
2432
2433 Libraries
2434 ---------
2435
2436 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
2437 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
2438 * [`String` implements `FromIterator<&char>`][40028]
2439 * `Box` [implements][40009] a number of new conversions:
2440   `From<Box<str>> for String`,
2441   `From<Box<[T]>> for Vec<T>`,
2442   `From<Box<CStr>> for CString`,
2443   `From<Box<OsStr>> for OsString`,
2444   `From<Box<Path>> for PathBuf`,
2445   `Into<Box<str>> for String`,
2446   `Into<Box<[T]>> for Vec<T>`,
2447   `Into<Box<CStr>> for CString`,
2448   `Into<Box<OsStr>> for OsString`,
2449   `Into<Box<Path>> for PathBuf`,
2450   `Default for Box<str>`,
2451   `Default for Box<CStr>`,
2452   `Default for Box<OsStr>`,
2453   `From<&CStr> for Box<CStr>`,
2454   `From<&OsStr> for Box<OsStr>`,
2455   `From<&Path> for Box<Path>`
2456 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
2457 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
2458 * [Slightly optimize `slice::sort`][39538]
2459 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
2460 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
2461   `Box<str>` implements `From<&str>`][39438]
2462 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
2463   `From<(I, u16)> where I: Into<IpAddr>`][39372]
2464 * [`format!` estimates the needed capacity before writing a string][39356]
2465 * [Support unprivileged symlink creation in Windows][38921]
2466 * [`PathBuf` implements `Default`][38764]
2467 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2468 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2469   and poor hash functions.
2470
2471 Cargo
2472 -----
2473
2474 * [Add `cargo check --all`][cargo/3731]
2475 * [Add an option to ignore SSL revocation checking][cargo/3699]
2476 * [Add `cargo run --package`][cargo/3691]
2477 * [Add `required_features`][cargo/3667]
2478 * [Assume `build.rs` is a build script][cargo/3664]
2479 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2480
2481 Misc
2482 ----
2483
2484 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2485   `rustbook`][39633]
2486 * [The "Unstable Book" documents nightly-only features][ubook]
2487 * [Improve the style of the sidebar in rustdoc output][40265]
2488 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2489 * [Fix MSP430 breakage due to `i128`][40257]
2490 * [Preliminary Solaris/SPARCv9 support][39903]
2491 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2492   run without installing the MSVC runtime.
2493 * [`rustdoc --test` includes file names in test names][39788]
2494 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2495   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2496 * [Initial support for `aarch64-unknown-freebsd`][39491]
2497 * [Initial support for `i686-unknown-netbsd`][39426]
2498 * [This release no longer includes the old makefile build system][39431]. Rust
2499   is built with a custom build system, written in Rust, and with Cargo.
2500 * [Add Debug implementations for libcollection structs][39002]
2501 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2502 * [`--test-threads=0` produces an error][38945]
2503 * [`rustup` installs documentation by default][40526]
2504 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2505   WinDbg and Visual Studio to improve the debugging experience.
2506
2507 Compatibility Notes
2508 -------------------
2509
2510 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2511   workaround, either use MSVC 2015 or run vcvars.bat.
2512 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2513   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2514   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2515   fix.
2516 * [`format!` and `Display::to_string` panic if an underlying formatting
2517   implementation returns an error][40117]. Previously the error was silently
2518   ignored. It is incorrect for `write_fmt` to return an error when writing
2519   to a string.
2520 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2521   crates were marked stable and could be accessed from the stable toolchain.
2522 * [Rust git source no longer includes vendored crates][39728]. Those that need
2523   to build with vendored crates should build from release tarballs.
2524 * [Fix inert attributes from `proc_macro_derives`][39572]
2525 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2526   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2527   build system.
2528 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2529   existing code generally ignores the type of dead-code unless a type-hint is
2530   provided; this can cause surprising inference interactions particularly around
2531   defaulting. The new code uniformly ignores the result type of dead-code.
2532 * [Tuple-struct constructors with private fields are no longer visible][38932]
2533 * [Lifetime parameters that do not appear in the arguments are now considered
2534   early-bound][38897], resolving a soundness bug (#[32330]). The
2535   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2536   April of 2016.
2537 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2538 * [Make transmuting from fn item types to pointer-sized types a hard
2539   error][34198]
2540
2541 [27787]: https://github.com/rust-lang/rust/issues/27787
2542 [32330]: https://github.com/rust-lang/rust/issues/32330
2543 [34198]: https://github.com/rust-lang/rust/pull/34198
2544 [38161]: https://github.com/rust-lang/rust/pull/38161
2545 [38368]: https://github.com/rust-lang/rust/pull/38368
2546 [38584]: https://github.com/rust-lang/rust/issues/38584
2547 [38661]: https://github.com/rust-lang/rust/pull/38661
2548 [38764]: https://github.com/rust-lang/rust/pull/38764
2549 [38864]: https://github.com/rust-lang/rust/issues/38864
2550 [38897]: https://github.com/rust-lang/rust/pull/38897
2551 [38921]: https://github.com/rust-lang/rust/pull/38921
2552 [38932]: https://github.com/rust-lang/rust/pull/38932
2553 [38945]: https://github.com/rust-lang/rust/pull/38945
2554 [38981]: https://github.com/rust-lang/rust/pull/38981
2555 [39002]: https://github.com/rust-lang/rust/pull/39002
2556 [39116]: https://github.com/rust-lang/rust/pull/39116
2557 [39193]: https://github.com/rust-lang/rust/pull/39193
2558 [39265]: https://github.com/rust-lang/rust/pull/39265
2559 [39356]: https://github.com/rust-lang/rust/pull/39356
2560 [39372]: https://github.com/rust-lang/rust/pull/39372
2561 [39426]: https://github.com/rust-lang/rust/pull/39426
2562 [39431]: https://github.com/rust-lang/rust/pull/39431
2563 [39438]: https://github.com/rust-lang/rust/pull/39438
2564 [39440]: https://github.com/rust-lang/rust/pull/39440
2565 [39485]: https://github.com/rust-lang/rust/pull/39485
2566 [39491]: https://github.com/rust-lang/rust/pull/39491
2567 [39518]: https://github.com/rust-lang/rust/pull/39518
2568 [39538]: https://github.com/rust-lang/rust/pull/39538
2569 [39572]: https://github.com/rust-lang/rust/pull/39572
2570 [39633]: https://github.com/rust-lang/rust/pull/39633
2571 [39642]: https://github.com/rust-lang/rust/pull/39642
2572 [39728]: https://github.com/rust-lang/rust/pull/39728
2573 [39761]: https://github.com/rust-lang/rust/pull/39761
2574 [39788]: https://github.com/rust-lang/rust/pull/39788
2575 [39793]: https://github.com/rust-lang/rust/pull/39793
2576 [39837]: https://github.com/rust-lang/rust/pull/39837
2577 [39843]: https://github.com/rust-lang/rust/pull/39843
2578 [39851]: https://github.com/rust-lang/rust/pull/39851
2579 [39903]: https://github.com/rust-lang/rust/pull/39903
2580 [39939]: https://github.com/rust-lang/rust/pull/39939
2581 [39953]: https://github.com/rust-lang/rust/pull/39953
2582 [39960]: https://github.com/rust-lang/rust/pull/39960
2583 [39990]: https://github.com/rust-lang/rust/pull/39990
2584 [39995]: https://github.com/rust-lang/rust/pull/39995
2585 [40008]: https://github.com/rust-lang/rust/pull/40008
2586 [40009]: https://github.com/rust-lang/rust/pull/40009
2587 [40027]: https://github.com/rust-lang/rust/pull/40027
2588 [40028]: https://github.com/rust-lang/rust/pull/40028
2589 [40037]: https://github.com/rust-lang/rust/pull/40037
2590 [40117]: https://github.com/rust-lang/rust/pull/40117
2591 [40166]: https://github.com/rust-lang/rust/pull/40166
2592 [40245]: https://github.com/rust-lang/rust/pull/40245
2593 [40257]: https://github.com/rust-lang/rust/pull/40257
2594 [40261]: https://github.com/rust-lang/rust/pull/40261
2595 [40265]: https://github.com/rust-lang/rust/pull/40265
2596 [40319]: https://github.com/rust-lang/rust/pull/40319
2597 [40336]: https://github.com/rust-lang/rust/pull/40336
2598 [40526]: https://github.com/rust-lang/rust/pull/40526
2599 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2600 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2601 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2602 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2603 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2604 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2605 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2606 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2607 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2608 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2609 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2610 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2611 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2612 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2613 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2614 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2615 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2616 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2617 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2618 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2619 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2620 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2621 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2622 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2623 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2624 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2625 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2626 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2627 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2628 [mdbook]: https://crates.io/crates/mdbook
2629 [ubook]: https://doc.rust-lang.org/unstable-book/
2630
2631
2632 Version 1.16.0 (2017-03-16)
2633 ===========================
2634
2635 Language
2636 --------
2637
2638 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2639 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2640   match patterns][38069]
2641 * [Clean up semantics of `self` in an import list][38313]
2642 * [`Self` may appear in `impl` headers][38920]
2643 * [`Self` may appear in struct expressions][39282]
2644
2645 Compiler
2646 --------
2647
2648 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2649   a `.rmeta` file containing only crate metadata][38571]. This can be
2650   used by tools like the Rust Language Service to perform
2651   metadata-only builds.
2652 * [Levenshtein based typo suggestions now work in most places, while
2653   previously they worked only for fields and sometimes for local
2654   variables][38927]. Together with the overhaul of "no
2655   resolution"/"unexpected resolution" errors (#[38154]) they result in
2656   large and systematic improvement in resolution diagnostics.
2657 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2658   `U`][38670]
2659 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2660 * [`rustc` no longer attempts to provide "consider using an explicit
2661   lifetime" suggestions][37057]. They were inaccurate.
2662
2663 Stabilized APIs
2664 ---------------
2665
2666 * [`VecDeque::truncate`]
2667 * [`VecDeque::resize`]
2668 * [`String::insert_str`]
2669 * [`Duration::checked_add`]
2670 * [`Duration::checked_sub`]
2671 * [`Duration::checked_div`]
2672 * [`Duration::checked_mul`]
2673 * [`str::replacen`]
2674 * [`str::repeat`]
2675 * [`SocketAddr::is_ipv4`]
2676 * [`SocketAddr::is_ipv6`]
2677 * [`IpAddr::is_ipv4`]
2678 * [`IpAddr::is_ipv6`]
2679 * [`Vec::dedup_by`]
2680 * [`Vec::dedup_by_key`]
2681 * [`Result::unwrap_or_default`]
2682 * [`<*const T>::wrapping_offset`]
2683 * [`<*mut T>::wrapping_offset`]
2684 * `CommandExt::creation_flags`
2685 * [`File::set_permissions`]
2686 * [`String::split_off`]
2687
2688 Libraries
2689 ---------
2690
2691 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2692   their argument by `Borrow` parameter][37761]
2693 * [All public types in std implement `Debug`][38006]
2694 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2695 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2696 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2697   Windows][38274]
2698 * [std: Fix partial writes in `LineWriter`][38062]
2699 * [std: Clamp max read/write sizes on Unix][38062]
2700 * [Use more specific panic message for `&str` slicing errors][38066]
2701 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2702   functionality cannot be achieved in std currently.
2703 * [`writeln!`, like `println!`, now accepts a form with no string
2704   or formatting arguments, to just print a newline][38469]
2705 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2706 * [Reduce the size of static data in `std_unicode::tables`][38781]
2707 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2708   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2709   `Display`][38909]
2710 * [`Duration` implements `Sum`][38712]
2711 * [`String` implements `ToSocketAddrs`][39048]
2712
2713 Cargo
2714 -----
2715
2716 * [The `cargo check` command does a type check of a project without
2717   building it][cargo/3296]
2718 * [crates.io will display CI badges from Travis and AppVeyor, if
2719   specified in Cargo.toml][cargo/3546]
2720 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2721 * [Compilation profiles accept integer values for `debug`, in addition
2722   to `true` and `false`. These are passed to `rustc` as the value to
2723   `-C debuginfo`][cargo/3534]
2724 * [Implement `cargo --version --verbose`][cargo/3604]
2725 * [All builds now output 'dep-info' build dependencies compatible with
2726   make and ninja][cargo/3557]
2727 * [Build all workspace members with `build --all`][cargo/3511]
2728 * [Document all workspace members with `doc --all`][cargo/3515]
2729 * [Path deps outside workspace are not members][cargo/3443]
2730
2731 Misc
2732 ----
2733
2734 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2735   the path to the Rust implementation][38589]
2736 * [The `armv7-linux-androideabi` target no longer enables NEON
2737   extensions, per Google's ABI guide][38413]
2738 * [The stock standard library can be compiled for Redox OS][38401]
2739 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2740   available.
2741 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2742   builds available.
2743 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2744
2745 Compatibility Notes
2746 -------------------
2747
2748 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2749   match patterns][38069]
2750 * In this release, references to uninhabited types can not be
2751   pattern-matched. This was accidentally allowed in 1.15.
2752 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2753 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2754   Windows][38274]
2755 * [Clean up semantics of `self` in an import list][38313]
2756 * Reimplemented lifetime elision. This change was almost entirely compatible
2757   with existing code, but it did close a number of small bugs and loopholes,
2758   as well as being more accepting in some other [cases][41105].
2759
2760 [37057]: https://github.com/rust-lang/rust/pull/37057
2761 [37761]: https://github.com/rust-lang/rust/pull/37761
2762 [38006]: https://github.com/rust-lang/rust/pull/38006
2763 [38051]: https://github.com/rust-lang/rust/pull/38051
2764 [38062]: https://github.com/rust-lang/rust/pull/38062
2765 [38062]: https://github.com/rust-lang/rust/pull/38622
2766 [38066]: https://github.com/rust-lang/rust/pull/38066
2767 [38069]: https://github.com/rust-lang/rust/pull/38069
2768 [38131]: https://github.com/rust-lang/rust/pull/38131
2769 [38154]: https://github.com/rust-lang/rust/pull/38154
2770 [38274]: https://github.com/rust-lang/rust/pull/38274
2771 [38304]: https://github.com/rust-lang/rust/pull/38304
2772 [38313]: https://github.com/rust-lang/rust/pull/38313
2773 [38314]: https://github.com/rust-lang/rust/pull/38314
2774 [38327]: https://github.com/rust-lang/rust/pull/38327
2775 [38401]: https://github.com/rust-lang/rust/pull/38401
2776 [38413]: https://github.com/rust-lang/rust/pull/38413
2777 [38469]: https://github.com/rust-lang/rust/pull/38469
2778 [38559]: https://github.com/rust-lang/rust/pull/38559
2779 [38571]: https://github.com/rust-lang/rust/pull/38571
2780 [38580]: https://github.com/rust-lang/rust/pull/38580
2781 [38589]: https://github.com/rust-lang/rust/pull/38589
2782 [38670]: https://github.com/rust-lang/rust/pull/38670
2783 [38712]: https://github.com/rust-lang/rust/pull/38712
2784 [38726]: https://github.com/rust-lang/rust/pull/38726
2785 [38781]: https://github.com/rust-lang/rust/pull/38781
2786 [38798]: https://github.com/rust-lang/rust/pull/38798
2787 [38909]: https://github.com/rust-lang/rust/pull/38909
2788 [38920]: https://github.com/rust-lang/rust/pull/38920
2789 [38927]: https://github.com/rust-lang/rust/pull/38927
2790 [39048]: https://github.com/rust-lang/rust/pull/39048
2791 [39282]: https://github.com/rust-lang/rust/pull/39282
2792 [39379]: https://github.com/rust-lang/rust/pull/39379
2793 [41105]: https://github.com/rust-lang/rust/issues/41105
2794 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2795 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2796 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2797 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2798 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2799 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2800 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2801 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2802 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2803 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2804 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2805 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2806 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2807 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2808 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2809 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2810 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2811 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2812 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2813 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2814 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2815 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2816 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2817 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2818 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2819 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2820 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2821 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2822 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2823 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2824
2825
2826 Version 1.15.1 (2017-02-09)
2827 ===========================
2828
2829 * [Fix IntoIter::as_mut_slice's signature][39466]
2830 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2831
2832 [39466]: https://github.com/rust-lang/rust/pull/39466
2833 [39523]: https://github.com/rust-lang/rust/pull/39523
2834
2835
2836 Version 1.15.0 (2017-02-02)
2837 ===========================
2838
2839 Language
2840 --------
2841
2842 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2843   stable. This allows popular code-generating crates like Serde and Diesel to
2844   work ergonomically. [RFC 1681].
2845 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2846   with curly braces][36868]. Part of [RFC 1506].
2847 * [A number of minor changes to name resolution have been activated][37127].
2848   They add up to more consistent semantics, allowing for future evolution of
2849   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2850   details of what is different. The breaking changes here have been transitioned
2851   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2852 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2853   bounds][38279]
2854 * [`?Sized` can be used in `where` clauses][37791]
2855 * [There is now a limit on the size of monomorphized types and it can be
2856   modified with the `#![type_size_limit]` crate attribute, similarly to
2857   the `#![recursion_limit]` attribute][37789]
2858
2859 Compiler
2860 --------
2861
2862 * [On Windows, the compiler will apply dllimport attributes when linking to
2863   extern functions][37973]. Additional attributes and flags can control which
2864   library kind is linked and its name. [RFC 1717].
2865 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2866 * [The `--test` flag works with procedural macro crates][38107]
2867 * [Fix `extern "aapcs" fn` ABI][37814]
2868 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2869 * [The `format!` expander recognizes incorrect `printf` and shell-style
2870   formatting directives and suggests the correct format][37613].
2871 * [Only report one error for all unused imports in an import list][37456]
2872
2873 Compiler Performance
2874 --------------------
2875
2876 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2877 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2878 * [Don't clone in `UnificationTable::probe`][37848]
2879 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2880 * [Use small vectors in type walker][37760]
2881 * [Macro expansion performance was improved][37701]
2882 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2883 * [Replace FNV with a faster hash function][37229]
2884
2885 Stabilized APIs
2886 ---------------
2887
2888 * [`std::iter::Iterator::min_by`]
2889 * [`std::iter::Iterator::max_by`]
2890 * [`std::os::*::fs::FileExt`]
2891 * [`std::sync::atomic::Atomic*::get_mut`]
2892 * [`std::sync::atomic::Atomic*::into_inner`]
2893 * [`std::vec::IntoIter::as_slice`]
2894 * [`std::vec::IntoIter::as_mut_slice`]
2895 * [`std::sync::mpsc::Receiver::try_iter`]
2896 * [`std::os::unix::process::CommandExt::before_exec`]
2897 * [`std::rc::Rc::strong_count`]
2898 * [`std::rc::Rc::weak_count`]
2899 * [`std::sync::Arc::strong_count`]
2900 * [`std::sync::Arc::weak_count`]
2901 * [`std::char::encode_utf8`]
2902 * [`std::char::encode_utf16`]
2903 * [`std::cell::Ref::clone`]
2904 * [`std::io::Take::into_inner`]
2905
2906 Libraries
2907 ---------
2908
2909 * [The standard sorting algorithm has been rewritten for dramatic performance
2910   improvements][38192]. It is a hybrid merge sort, drawing influences from
2911   Timsort. Previously it was a naive merge sort.
2912 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2913 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2914   performance.
2915 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2916   and `char_indices().last()`][37882]
2917 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2918 * [Chinese characters display correctly in `fmt::Debug`][37855]
2919 * [Derive `Default` for `Duration`][37699]
2920 * [Support creation of anonymous pipes on WinXP/2k][37677]
2921 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2922 * [Don't pass overlapped handles to processes][38835]
2923
2924 Cargo
2925 -----
2926
2927 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2928   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2929   should instead check the variable at runtime with `std::env`. That the value
2930   was set at build time was a bug, and incorrect when cross-compiling. This
2931   change is known to cause breakage.
2932 * [Add `--all` flag to `cargo test`][cargo/3221]
2933 * [Compile statically against the MSVC CRT][cargo/3363]
2934 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2935 * [Link OpenSSL statically on OSX][cargo/3311]
2936 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2937 * [Test for bad path overrides with summaries][cargo/3336]
2938 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2939 * [Fix retrying crate downloads for network errors][cargo/3348]
2940 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2941 * [Emit more info on --message-format=json][cargo/3319]
2942 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2943 * [Don't ignore errors in workspace manifest][cargo/3409]
2944 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2945
2946 Tooling
2947 -------
2948
2949 * [Test runners (binaries built with `--test`) now support a `--list` argument
2950   that lists the tests it contains][38185]
2951 * [Test runners now support a `--exact` argument that makes the test filter
2952   match exactly, instead of matching only a substring of the test name][38181]
2953 * [rustdoc supports a `--playground-url` flag][37763]
2954 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2955
2956 Misc
2957 ----
2958
2959 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2960   continue to be used in this release by passing `--disable-rustbuild` to the
2961   configure script, but they will be deleted soon. Note that the new build
2962   system uses a different on-disk layout that will likely affect any scripts
2963   building Rust.
2964 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2965   releases.
2966 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2967 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2968   releases.
2969
2970 Compatibility Notes
2971 -------------------
2972
2973 * [A number of minor changes to name resolution have been activated][37127].
2974   They add up to more consistent semantics, allowing for future evolution of
2975   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2976   details of what is different. The breaking changes here have been transitioned
2977   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2978 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2979   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2980   should instead check the variable at runtime with `std::env`. That the value
2981   was set at build time was a bug, and incorrect when cross-compiling. This
2982   change is known to cause breakage.
2983 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2984   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2985   1.10 and is now an error by default. It will become a hard error in the near
2986   future.
2987 * [The semantics relating modules to file system directories are changing in
2988   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2989   lint, which is a warning in this release, and will become a hard error in the
2990   future.
2991 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2992 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2993   the underlying iterator][37834]
2994
2995 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2996 [33685]: https://github.com/rust-lang/rust/issues/33685
2997 [36868]: https://github.com/rust-lang/rust/pull/36868
2998 [37127]: https://github.com/rust-lang/rust/pull/37127
2999 [37229]: https://github.com/rust-lang/rust/pull/37229
3000 [37456]: https://github.com/rust-lang/rust/pull/37456
3001 [37527]: https://github.com/rust-lang/rust/pull/37527
3002 [37602]: https://github.com/rust-lang/rust/pull/37602
3003 [37613]: https://github.com/rust-lang/rust/pull/37613
3004 [37615]: https://github.com/rust-lang/rust/pull/37615
3005 [37636]: https://github.com/rust-lang/rust/pull/37636
3006 [37627]: https://github.com/rust-lang/rust/pull/37627
3007 [37642]: https://github.com/rust-lang/rust/pull/37642
3008 [37677]: https://github.com/rust-lang/rust/pull/37677
3009 [37699]: https://github.com/rust-lang/rust/pull/37699
3010 [37701]: https://github.com/rust-lang/rust/pull/37701
3011 [37705]: https://github.com/rust-lang/rust/pull/37705
3012 [37749]: https://github.com/rust-lang/rust/pull/37749
3013 [37760]: https://github.com/rust-lang/rust/pull/37760
3014 [37763]: https://github.com/rust-lang/rust/pull/37763
3015 [37764]: https://github.com/rust-lang/rust/pull/37764
3016 [37789]: https://github.com/rust-lang/rust/pull/37789
3017 [37791]: https://github.com/rust-lang/rust/pull/37791
3018 [37814]: https://github.com/rust-lang/rust/pull/37814
3019 [37817]: https://github.com/rust-lang/rust/pull/37817
3020 [37834]: https://github.com/rust-lang/rust/pull/37834
3021 [37848]: https://github.com/rust-lang/rust/pull/37848
3022 [37855]: https://github.com/rust-lang/rust/pull/37855
3023 [37882]: https://github.com/rust-lang/rust/pull/37882
3024 [37888]: https://github.com/rust-lang/rust/pull/37888
3025 [37973]: https://github.com/rust-lang/rust/pull/37973
3026 [37979]: https://github.com/rust-lang/rust/pull/37979
3027 [38086]: https://github.com/rust-lang/rust/pull/38086
3028 [38107]: https://github.com/rust-lang/rust/pull/38107
3029 [38117]: https://github.com/rust-lang/rust/pull/38117
3030 [38134]: https://github.com/rust-lang/rust/pull/38134
3031 [38146]: https://github.com/rust-lang/rust/pull/38146
3032 [38181]: https://github.com/rust-lang/rust/pull/38181
3033 [38182]: https://github.com/rust-lang/rust/pull/38182
3034 [38185]: https://github.com/rust-lang/rust/pull/38185
3035 [38192]: https://github.com/rust-lang/rust/pull/38192
3036 [38279]: https://github.com/rust-lang/rust/pull/38279
3037 [38835]: https://github.com/rust-lang/rust/pull/38835
3038 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3039 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3040 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
3041 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
3042 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
3043 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
3044 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
3045 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
3046 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
3047 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
3048 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
3049 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
3050 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
3051 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
3052 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
3053 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
3054 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
3055 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
3056 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
3057 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
3058 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
3059 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
3060 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
3061 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
3062 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
3063 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
3064 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
3065 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
3066 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
3067 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
3068 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
3069 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
3070 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
3071 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
3072 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
3073 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
3074 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
3075 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
3076
3077
3078 Version 1.14.0 (2016-12-22)
3079 ===========================
3080
3081 Language
3082 --------
3083
3084 * [`..` matches multiple tuple fields in enum variants, structs
3085   and tuples][36843]. [RFC 1492].
3086 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
3087 * [`use *` and `use ::*` both glob-import from the crate root][37367]
3088 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
3089   dereferencing][36822]
3090
3091 Compiler
3092 --------
3093
3094 * [Mark enums with non-zero discriminant as non-zero][37224]
3095 * [Lower-case `static mut` names are linted like other
3096   statics and consts][37162]
3097 * [Fix ICE on some macros in const integer positions
3098    (e.g. `[u8; m!()]`)][36819]
3099 * [Improve error message and snippet for "did you mean `x`"][36798]
3100 * [Add a panic-strategy field to the target specification][36794]
3101 * [Include LLVM version in `--version --verbose`][37200]
3102
3103 Compile-time Optimizations
3104 --------------------------
3105
3106 * [Improve macro expansion performance][37569]
3107 * [Shrink `Expr_::ExprInlineAsm`][37445]
3108 * [Replace all uses of SHA-256 with BLAKE2b][37439]
3109 * [Reduce the number of bytes hashed by `IchHasher`][37427]
3110 * [Avoid more allocations when compiling html5ever][37373]
3111 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
3112 * [Avoid some allocations in the macro parser][37318]
3113 * [Use a faster deflate setting][37298]
3114 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
3115   during interning of slices][37270]
3116 * [Optimize `write_metadata`][37267]
3117 * [Don't process obligation forest cycles when stalled][37231]
3118 * [Avoid many `CrateConfig` clones][37161]
3119 * [Optimize `Substs::super_fold_with`][37108]
3120 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
3121 * [Speed up `plug_leaks`][36917]
3122
3123 Libraries
3124 ---------
3125
3126 * [`println!()`, with no arguments, prints newline][36825].
3127   Previously, an empty string was required to achieve the same.
3128 * [`Wrapping` impls standard binary and unary operators, as well as
3129    the `Sum` and `Product` iterators][37356]
3130 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
3131   Vec<T>`][37326]
3132 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
3133   `VecDeque` iterators][37315]
3134 * [Improve `SipHasher` performance on small values][37312]
3135 * [Add Iterator trait TrustedLen to enable better FromIterator /
3136   Extend][37306]
3137 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
3138 * [`ReadDir` implements `Debug`][37221]
3139 * [Implement `RefUnwindSafe` for atomic types][37178]
3140 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
3141 * [Avoid allocations in `Decoder::read_str`][37064]
3142 * [`io::Error` implements `From<io::ErrorKind>`][37037]
3143 * [Impl `Debug` for raw pointers to unsized data][36880]
3144 * [Don't reuse `HashMap` random seeds][37470]
3145 * [The internal memory layout of `HashMap` is more cache-friendly, for
3146   significant improvements in some operations][36692]
3147 * [`HashMap` uses less memory on 32-bit architectures][36595]
3148 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
3149
3150 Cargo
3151 -----
3152
3153 * [Expose rustc cfg values to build scripts][cargo/3243]
3154 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
3155 * [Fix passing --features when testing multiple packages][cargo/3280]
3156 * [Use a single profile set per workspace][cargo/3249]
3157 * [Load `replace` sections from lock files][cargo/3220]
3158 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
3159
3160 Tooling
3161 -------
3162
3163 * [rustup is the recommended Rust installation method][1.14rustup]
3164 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
3165   S390x. These are [tier 2] platforms and may have major defects. Follow the
3166   instructions on the website to install, or add the targets to an existing
3167   installation with `rustup target add`. The new target triples are:
3168   - `mips-unknown-linux-gnu`
3169   - `mipsel-unknown-linux-gnu`
3170   - `mips64-unknown-linux-gnuabi64`
3171   - `mips64el-unknown-linux-gnuabi64 `
3172   - `powerpc-unknown-linux-gnu`
3173   - `powerpc64-unknown-linux-gnu`
3174   - `powerpc64le-unknown-linux-gnu`
3175   - `s390x-unknown-linux-gnu `
3176 * This release includes target (std) builds for ARM Linux running MUSL
3177   libc. These are [tier 2] platforms and may have major defects. Add the
3178   following triples to an existing rustup installation with `rustup target add`:
3179   - `arm-unknown-linux-musleabi`
3180   - `arm-unknown-linux-musleabihf`
3181   - `armv7-unknown-linux-musleabihf`
3182 * This release includes [experimental support for WebAssembly][1.14wasm], via
3183   the `wasm32-unknown-emscripten` target. This target is known to have major
3184   defects. Please test, report, and fix.
3185 * rustup no longer installs documentation by default. Run `rustup
3186   component add rust-docs` to install.
3187 * [Fix line stepping in debugger][37310]
3188 * [Enable line number debuginfo in releases][37280]
3189
3190 Misc
3191 ----
3192
3193 * [Disable jemalloc on aarch64/powerpc/mips][37392]
3194 * [Add support for Fuchsia OS][37313]
3195 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
3196
3197 Compatibility Notes
3198 -------------------
3199
3200 * [A number of forward-compatibility lints used by the compiler
3201   to gradually introduce language changes have been converted
3202   to deny by default][36894]:
3203   - ["use of inaccessible extern crate erroneously allowed"][36886]
3204   - ["type parameter default erroneously allowed in invalid location"][36887]
3205   - ["detects super or self keywords at the beginning of global path"][36888]
3206   - ["two overlapping inherent impls define an item with the same name
3207     were erroneously allowed"][36889]
3208   - ["floating-point constants cannot be used in patterns"][36890]
3209   - ["constants of struct or enum type can only be used in a pattern if
3210      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
3211   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
3212 * [Prohibit patterns in trait methods without bodies][37378]
3213 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
3214 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
3215 * [The `$crate` macro variable is accepted in fewer locations][37213]
3216 * [Impls specifying extra region requirements beyond the trait
3217   they implement are rejected][37167]
3218 * [Enums may not be unsized][37111]. Unsized enums are intended to
3219   work but never have. For now they are forbidden.
3220 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
3221
3222 [tier 2]: https://forge.rust-lang.org/platform-support.html
3223 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
3224 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
3225 [36430]: https://github.com/rust-lang/rust/pull/36430
3226 [36595]: https://github.com/rust-lang/rust/pull/36595
3227 [36595]: https://github.com/rust-lang/rust/pull/36595
3228 [36692]: https://github.com/rust-lang/rust/pull/36692
3229 [36767]: https://github.com/rust-lang/rust/pull/36767
3230 [36794]: https://github.com/rust-lang/rust/pull/36794
3231 [36798]: https://github.com/rust-lang/rust/pull/36798
3232 [36819]: https://github.com/rust-lang/rust/pull/36819
3233 [36822]: https://github.com/rust-lang/rust/pull/36822
3234 [36825]: https://github.com/rust-lang/rust/pull/36825
3235 [36843]: https://github.com/rust-lang/rust/pull/36843
3236 [36880]: https://github.com/rust-lang/rust/pull/36880
3237 [36886]: https://github.com/rust-lang/rust/issues/36886
3238 [36887]: https://github.com/rust-lang/rust/issues/36887
3239 [36888]: https://github.com/rust-lang/rust/issues/36888
3240 [36889]: https://github.com/rust-lang/rust/issues/36889
3241 [36890]: https://github.com/rust-lang/rust/issues/36890
3242 [36891]: https://github.com/rust-lang/rust/issues/36891
3243 [36892]: https://github.com/rust-lang/rust/issues/36892
3244 [36894]: https://github.com/rust-lang/rust/pull/36894
3245 [36917]: https://github.com/rust-lang/rust/pull/36917
3246 [36993]: https://github.com/rust-lang/rust/pull/36993
3247 [37037]: https://github.com/rust-lang/rust/pull/37037
3248 [37064]: https://github.com/rust-lang/rust/pull/37064
3249 [37094]: https://github.com/rust-lang/rust/pull/37094
3250 [37108]: https://github.com/rust-lang/rust/pull/37108
3251 [37111]: https://github.com/rust-lang/rust/pull/37111
3252 [37161]: https://github.com/rust-lang/rust/pull/37161
3253 [37162]: https://github.com/rust-lang/rust/pull/37162
3254 [37167]: https://github.com/rust-lang/rust/pull/37167
3255 [37178]: https://github.com/rust-lang/rust/pull/37178
3256 [37200]: https://github.com/rust-lang/rust/pull/37200
3257 [37213]: https://github.com/rust-lang/rust/pull/37213
3258 [37221]: https://github.com/rust-lang/rust/pull/37221
3259 [37224]: https://github.com/rust-lang/rust/pull/37224
3260 [37230]: https://github.com/rust-lang/rust/pull/37230
3261 [37231]: https://github.com/rust-lang/rust/pull/37231
3262 [37247]: https://github.com/rust-lang/rust/pull/37247
3263 [37267]: https://github.com/rust-lang/rust/pull/37267
3264 [37270]: https://github.com/rust-lang/rust/pull/37270
3265 [37273]: https://github.com/rust-lang/rust/pull/37273
3266 [37280]: https://github.com/rust-lang/rust/pull/37280
3267 [37298]: https://github.com/rust-lang/rust/pull/37298
3268 [37306]: https://github.com/rust-lang/rust/pull/37306
3269 [37310]: https://github.com/rust-lang/rust/pull/37310
3270 [37312]: https://github.com/rust-lang/rust/pull/37312
3271 [37313]: https://github.com/rust-lang/rust/pull/37313
3272 [37315]: https://github.com/rust-lang/rust/pull/37315
3273 [37318]: https://github.com/rust-lang/rust/pull/37318
3274 [37322]: https://github.com/rust-lang/rust/pull/37322
3275 [37326]: https://github.com/rust-lang/rust/pull/37326
3276 [37351]: https://github.com/rust-lang/rust/pull/37351
3277 [37356]: https://github.com/rust-lang/rust/pull/37356
3278 [37367]: https://github.com/rust-lang/rust/pull/37367
3279 [37373]: https://github.com/rust-lang/rust/pull/37373
3280 [37378]: https://github.com/rust-lang/rust/pull/37378
3281 [37389]: https://github.com/rust-lang/rust/pull/37389
3282 [37392]: https://github.com/rust-lang/rust/pull/37392
3283 [37427]: https://github.com/rust-lang/rust/pull/37427
3284 [37439]: https://github.com/rust-lang/rust/pull/37439
3285 [37445]: https://github.com/rust-lang/rust/pull/37445
3286 [37470]: https://github.com/rust-lang/rust/pull/37470
3287 [37569]: https://github.com/rust-lang/rust/pull/37569
3288 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3289 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
3290 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
3291 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
3292 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
3293 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
3294 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
3295
3296
3297 Version 1.13.0 (2016-11-10)
3298 ===========================
3299
3300 Language
3301 --------
3302
3303 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
3304   errors, like the `try!` macro, described in [RFC 0243].
3305 * [Stabilize macros in type position][36014]. Described in [RFC 873].
3306 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
3307 * [Fix `#[derive]` for empty tuple structs/variants][35728]
3308 * [Fix lifetime rules for 'if' conditions][36029]
3309 * [Avoid loading and parsing unconfigured non-inline modules][36482]
3310
3311 Compiler
3312 --------
3313
3314 * [Add the `-C link-arg` argument][36574]
3315 * [Remove the old AST-based backend from rustc_trans][35764]
3316 * [Don't enable NEON by default on armv7 Linux][35814]
3317 * [Fix debug line number info for macro expansions][35238]
3318 * [Do not emit "class method" debuginfo for types that are not
3319   DICompositeType][36008]
3320 * [Warn about multiple conflicting #[repr] hints][34623]
3321 * [When sizing DST, don't double-count nested struct prefixes][36351]
3322 * [Default RUST_MIN_STACK to 16MiB for now][36505]
3323 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
3324 * [Reject macros with empty repetitions to avoid infinite loop][36721]
3325 * [Expand macros without recursing to avoid stack overflows][36214]
3326
3327 Diagnostics
3328 -----------
3329
3330 * [Replace macro backtraces with labeled local uses][35702]
3331 * [Improve error message for misplaced doc comments][33922]
3332 * [Buffer unix and lock windows to prevent message interleaving][35975]
3333 * [Update lifetime errors to specifically note temporaries][36171]
3334 * [Special case a few colors for Windows][36178]
3335 * [Suggest `use self` when such an import resolves][36289]
3336 * [Be more specific when type parameter shadows primitive type][36338]
3337 * Many minor improvements
3338
3339 Compile-time Optimizations
3340 --------------------------
3341
3342 * [Compute and cache HIR hashes at beginning][35854]
3343 * [Don't hash types in loan paths][36004]
3344 * [Cache projections in trans][35761]
3345 * [Optimize the parser's last token handling][36527]
3346 * [Only instantiate #[inline] functions in codegen units referencing
3347   them][36524]. This leads to big improvements in cases where crates export
3348   define many inline functions without using them directly.
3349 * [Lazily allocate TypedArena's first chunk][36592]
3350 * [Don't allocate during default HashSet creation][36734]
3351
3352 Stabilized APIs
3353 ---------------
3354
3355 * [`checked_abs`]
3356 * [`wrapping_abs`]
3357 * [`overflowing_abs`]
3358 * [`RefCell::try_borrow`]
3359 * [`RefCell::try_borrow_mut`]
3360
3361 Libraries
3362 ---------
3363
3364 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
3365 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
3366   covariant][35354]
3367 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
3368 * [Implement `Debug` for `std::vec::IntoIter`][35707]
3369 * [`CString`: avoid excessive growth just to 0-terminate][35871]
3370 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
3371 * [Use arc4rand on FreeBSD][35884]
3372 * [memrchr: Correct aligned offset computation][35969]
3373 * [Improve Demangling of Rust Symbols][36059]
3374 * [Use monotonic time in condition variables][35048]
3375 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
3376 * [Implement conversion traits for `char`][35755]
3377 * [Fix illegal instruction caused by overflow in channel cloning][36104]
3378 * [Zero first byte of CString on drop][36264]
3379 * [Inherit overflow checks for sum and product][36372]
3380 * [Add missing Eq implementations][36423]
3381 * [Implement `Debug` for `DirEntry`][36631]
3382 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
3383   `errno`][36754]
3384 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3385 * [Implement more traits for `std::io::ErrorKind`][35911]
3386 * [Optimize BinaryHeap bounds checking][36072]
3387 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
3388   `extend_with_element`][36355]
3389 * [Fix overflow checking in unsigned pow()][34942]
3390
3391 Cargo
3392 -----
3393
3394 * This release includes security fixes to both curl and OpenSSL.
3395 * [Fix transitive doctests when panic=abort][cargo/3021]
3396 * [Add --all-features flag to cargo][cargo/3038]
3397 * [Reject path-based dependencies in `cargo package`][cargo/3060]
3398 * [Don't parse the home directory more than once][cargo/3078]
3399 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
3400 * [Update OpenSSL to 1.0.2j][cargo/3121]
3401 * [Add license and license_file to cargo metadata output][cargo/3110]
3402 * [Make crates-io registry URL optional in config; ignore all changes to
3403   source.crates-io][cargo/3089]
3404 * [Don't download dependencies from other platforms][cargo/3123]
3405 * [Build transitive dev-dependencies when needed][cargo/3125]
3406 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
3407 * [Avoid updating registry when adding existing deps][cargo/3144]
3408 * [Warn about path overrides that won't work][cargo/3136]
3409 * [Use workspaces during `cargo install`][cargo/3146]
3410 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
3411 * [Add --message-format flag][cargo/3000]
3412 * [Pass target environment for rustdoc][cargo/3205]
3413 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
3414 * [Update curl and curl-sys][cargo/3241]
3415 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
3416
3417 Tooling
3418 -------
3419
3420 * [rustdoc: Add the `--sysroot` argument][36586]
3421 * [rustdoc: Fix a couple of issues with the search results][35655]
3422 * [rustdoc: remove the `!` from macro URLs and titles][35234]
3423 * [gdb: Fix pretty-printing special-cased Rust types][35585]
3424 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
3425
3426 Misc
3427 ----
3428
3429 * [Remove unmaintained style guide][35124]
3430 * [Add s390x support][36369]
3431 * [Initial work at Haiku OS support][36727]
3432 * [Add mips-uclibc targets][35734]
3433 * [Crate-ify compiler-rt into compiler-builtins][35021]
3434 * [Add rustc version info (git hash + date) to dist tarball][36213]
3435 * Many documentation improvements
3436
3437 Compatibility Notes
3438 -------------------
3439
3440 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3441 * [Deny (by default) transmuting from fn item types to pointer-sized
3442   types][34923]. Continuing the long transition to zero-sized fn items,
3443   per [RFC 401].
3444 * [Fix `#[derive]` for empty tuple structs/variants][35728].
3445   Part of [RFC 1506].
3446 * [Issue deprecation warnings for safe accesses to extern statics][36173]
3447 * [Fix lifetime rules for 'if' conditions][36029].
3448 * [Inherit overflow checks for sum and product][36372].
3449 * [Forbid user-defined macros named "macro_rules"][36730].
3450
3451 [33922]: https://github.com/rust-lang/rust/pull/33922
3452 [34623]: https://github.com/rust-lang/rust/pull/34623
3453 [34923]: https://github.com/rust-lang/rust/pull/34923
3454 [34942]: https://github.com/rust-lang/rust/pull/34942
3455 [34982]: https://github.com/rust-lang/rust/pull/34982
3456 [35021]: https://github.com/rust-lang/rust/pull/35021
3457 [35048]: https://github.com/rust-lang/rust/pull/35048
3458 [35074]: https://github.com/rust-lang/rust/pull/35074
3459 [35124]: https://github.com/rust-lang/rust/pull/35124
3460 [35234]: https://github.com/rust-lang/rust/pull/35234
3461 [35238]: https://github.com/rust-lang/rust/pull/35238
3462 [35354]: https://github.com/rust-lang/rust/pull/35354
3463 [35559]: https://github.com/rust-lang/rust/pull/35559
3464 [35585]: https://github.com/rust-lang/rust/pull/35585
3465 [35627]: https://github.com/rust-lang/rust/pull/35627
3466 [35655]: https://github.com/rust-lang/rust/pull/35655
3467 [35702]: https://github.com/rust-lang/rust/pull/35702
3468 [35707]: https://github.com/rust-lang/rust/pull/35707
3469 [35728]: https://github.com/rust-lang/rust/pull/35728
3470 [35734]: https://github.com/rust-lang/rust/pull/35734
3471 [35755]: https://github.com/rust-lang/rust/pull/35755
3472 [35761]: https://github.com/rust-lang/rust/pull/35761
3473 [35764]: https://github.com/rust-lang/rust/pull/35764
3474 [35814]: https://github.com/rust-lang/rust/pull/35814
3475 [35854]: https://github.com/rust-lang/rust/pull/35854
3476 [35871]: https://github.com/rust-lang/rust/pull/35871
3477 [35884]: https://github.com/rust-lang/rust/pull/35884
3478 [35911]: https://github.com/rust-lang/rust/pull/35911
3479 [35969]: https://github.com/rust-lang/rust/pull/35969
3480 [35975]: https://github.com/rust-lang/rust/pull/35975
3481 [36004]: https://github.com/rust-lang/rust/pull/36004
3482 [36008]: https://github.com/rust-lang/rust/pull/36008
3483 [36014]: https://github.com/rust-lang/rust/pull/36014
3484 [36029]: https://github.com/rust-lang/rust/pull/36029
3485 [36059]: https://github.com/rust-lang/rust/pull/36059
3486 [36072]: https://github.com/rust-lang/rust/pull/36072
3487 [36101]: https://github.com/rust-lang/rust/pull/36101
3488 [36104]: https://github.com/rust-lang/rust/pull/36104
3489 [36171]: https://github.com/rust-lang/rust/pull/36171
3490 [36173]: https://github.com/rust-lang/rust/pull/36173
3491 [36178]: https://github.com/rust-lang/rust/pull/36178
3492 [36213]: https://github.com/rust-lang/rust/pull/36213
3493 [36214]: https://github.com/rust-lang/rust/pull/36214
3494 [36264]: https://github.com/rust-lang/rust/pull/36264
3495 [36266]: https://github.com/rust-lang/rust/pull/36266
3496 [36289]: https://github.com/rust-lang/rust/pull/36289
3497 [36338]: https://github.com/rust-lang/rust/pull/36338
3498 [36351]: https://github.com/rust-lang/rust/pull/36351
3499 [36355]: https://github.com/rust-lang/rust/pull/36355
3500 [36369]: https://github.com/rust-lang/rust/pull/36369
3501 [36372]: https://github.com/rust-lang/rust/pull/36372
3502 [36423]: https://github.com/rust-lang/rust/pull/36423
3503 [36482]: https://github.com/rust-lang/rust/pull/36482
3504 [36505]: https://github.com/rust-lang/rust/pull/36505
3505 [36524]: https://github.com/rust-lang/rust/pull/36524
3506 [36527]: https://github.com/rust-lang/rust/pull/36527
3507 [36551]: https://github.com/rust-lang/rust/pull/36551
3508 [36574]: https://github.com/rust-lang/rust/pull/36574
3509 [36586]: https://github.com/rust-lang/rust/pull/36586
3510 [36592]: https://github.com/rust-lang/rust/pull/36592
3511 [36631]: https://github.com/rust-lang/rust/pull/36631
3512 [36639]: https://github.com/rust-lang/rust/pull/36639
3513 [36721]: https://github.com/rust-lang/rust/pull/36721
3514 [36727]: https://github.com/rust-lang/rust/pull/36727
3515 [36730]: https://github.com/rust-lang/rust/pull/36730
3516 [36734]: https://github.com/rust-lang/rust/pull/36734
3517 [36754]: https://github.com/rust-lang/rust/pull/36754
3518 [36995]: https://github.com/rust-lang/rust/pull/36995
3519 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3520 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3521 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3522 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3523 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3524 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3525 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3526 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3527 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3528 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3529 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3530 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3531 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3532 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3533 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3534 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3535 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3536 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3537 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3538 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3539 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3540 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3541 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3542 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3543 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3544 [rustup]: https://www.rustup.rs
3545 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3546 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3547 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3548 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3549 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3550 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3551 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3552
3553
3554 Version 1.12.1 (2016-10-20)
3555 ===========================
3556
3557 Regression Fixes
3558 ----------------
3559
3560 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3561 * [Confusion with double negation and booleans][36856]
3562 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3563 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3564 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3565 * [Corrupted memory after updated to 1.12][36936]
3566 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3567 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3568 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3569
3570 [36381]: https://github.com/rust-lang/rust/issues/36381
3571 [36856]: https://github.com/rust-lang/rust/issues/36856
3572 [36875]: https://github.com/rust-lang/rust/issues/36875
3573 [36924]: https://github.com/rust-lang/rust/issues/36924
3574 [36926]: https://github.com/rust-lang/rust/issues/36926
3575 [36936]: https://github.com/rust-lang/rust/issues/36936
3576 [37026]: https://github.com/rust-lang/rust/issues/37026
3577 [37112]: https://github.com/rust-lang/rust/issues/37112
3578 [37153]: https://github.com/rust-lang/rust/issues/37153
3579
3580
3581 Version 1.12.0 (2016-09-29)
3582 ===========================
3583
3584 Highlights
3585 ----------
3586
3587 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3588   This translation pass is far simpler than the previous AST->LLVM pass, and
3589   creates opportunities to perform new optimizations directly on the MIR. It
3590   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3591 * [`rustc` presents a new, more readable error format, along with
3592   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3593   Most common editors supporting Rust have been updated to work with it. It was
3594   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3595
3596 Compiler
3597 --------
3598
3599 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3600   This translation pass is far simpler than the previous AST->LLVM pass, and
3601   creates opportunities to perform new optimizations directly on the MIR. It
3602   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3603 * [Print the Rust target name, not the LLVM target name, with
3604   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3605 * [The computation of `TypeId` is correct in some cases where it was previously
3606   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3607 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3608 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3609   `--print relocation-models`, and `--print code-models` print the available
3610   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3611   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3612 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3613   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3614   These targets produce statically-linked binaries. There are no binary release
3615   builds yet though.
3616
3617 Diagnostics
3618 -----------
3619
3620 * [`rustc` presents a new, more readable error format, along with
3621   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3622   Most common editors supporting Rust have been updated to work with it. It was
3623   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3624 * [In error descriptions, references are now described in plain English,
3625   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3626 * [In error type descriptions, unknown numeric types are named `{integer}` or
3627   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3628 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3629
3630 Language
3631 --------
3632
3633 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3634 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3635 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3636   useful](https://github.com/rust-lang/rust/pull/34908)
3637 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3638   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3639 * [Semicolons are properly required as statement delimiters inside
3640   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3641 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3642
3643 Stabilized APIs
3644 ---------------
3645
3646 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3647 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3648 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3649 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3650 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3651 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3652 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3653 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3654 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3655 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3656   Both on Unix and Windows.
3657 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3658 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3659 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3660 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3661 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3662 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3663 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3664 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3665
3666 Libraries
3667 ---------
3668
3669 * [The `format!` macro and friends now allow a single argument to be formatted
3670   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3671 * [The lifetime bounds on `[T]::binary_search_by` and
3672   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3673 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3674 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3675 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3676 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3677 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3678 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3679 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3680 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3681   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3682 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3683   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3684 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3685 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3686   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3687 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3688 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3689 * [`mpsc::sync_channel` `Receiver`s return any available message before
3690   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3691 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3692 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3693
3694 Cargo
3695 -----
3696
3697 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3698 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3699 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3700 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3701 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3702 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3703 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3704 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3705 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3706 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3707 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3708 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3709 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3710 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3711 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3712 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3713
3714 Performance
3715 -----------
3716
3717 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3718 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3719
3720 Tooling
3721 -------
3722
3723 * [Test binaries now support a `--test-threads` argument to specify the number
3724   of threads used to run tests, and which acts the same as the
3725   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3726 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3727 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3728 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3729 * [Rust releases now come with source packages that can be installed by rustup
3730   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3731   The resulting source code can be used by tools and IDES, located in the
3732   sysroot under `lib/rustlib/src`.
3733
3734 Misc
3735 ----
3736
3737 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3738 * Many minor improvements to the documentation.
3739 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3740
3741 Compatibility Notes
3742 -------------------
3743
3744 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3745   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3746 * [When formatting strings, if "precision" is specified, the "fill",
3747   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3748 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3749
3750
3751 Version 1.11.0 (2016-08-18)
3752 ===========================
3753
3754 Language
3755 --------
3756
3757 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3758 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3759 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3760 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3761 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3762
3763 Stabilized APIs
3764 ---------------
3765
3766 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3767 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3768 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3769 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3770 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3771 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3772   (in libcore - previously stabilized in libstd)
3773 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3774   (in libcore - previously stabilized in libstd)
3775 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3776   (in libcore - previously stabilized in libstd)
3777 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3778   (in libcore - previously stabilized in libstd)
3779 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3780 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3781 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3782 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3783
3784 Libraries
3785 ---------
3786
3787 * [The `thread_local!` macro supports multiple definitions in a single
3788    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3789 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3790 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3791   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3792 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3793 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3794 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3795 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3796
3797 Cargo
3798 -----
3799
3800 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3801 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3802 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3803 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3804 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3805   and `-vv` prints warnings for all crates.
3806 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3807 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3808   This provides room for expansion by arbitrary tools.
3809 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3810 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3811 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3812 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3813 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3814 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3815 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3816
3817 Performance
3818 -----------
3819
3820 * [Caching projections speeds up type check dramatically for some
3821   workloads](https://github.com/rust-lang/rust/pull/33816)
3822 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3823   This hasher is faster, but is believed to provide sufficient
3824   protection from collision attacks.
3825 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3826
3827 Rustdoc
3828 -------
3829
3830 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3831 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3832 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3833 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3834 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3835
3836 Tooling
3837 -------
3838
3839 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3840 * [When emitting debug info, rustc emits frame pointers for closures,
3841   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3842 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3843 * Many more errors have been given error codes and extended
3844   explanations
3845 * API documentation continues to be improved, with many new examples
3846
3847 Misc
3848 ----
3849
3850 * [rustc no longer hangs when dependencies recursively re-export
3851   submodules](https://github.com/rust-lang/rust/pull/34542)
3852 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3853 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3854   rewritten](https://github.com/rust-lang/rust/pull/33895)
3855 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3856   No targets use this yet, but it works toward AVR support.
3857
3858 Compatibility Notes
3859 -------------------
3860
3861 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3862 * [The new follow-set rules that place restrictions on `macro_rules!`
3863   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3864   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3865   and has been a warning since 1.10.
3866 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3867   This causes breakage in some corner cases.
3868
3869
3870 Version 1.10.0 (2016-07-07)
3871 ===========================
3872
3873 Language
3874 --------
3875
3876 * [Allow `concat_idents!` in type positions as well as in expression
3877   positions](https://github.com/rust-lang/rust/pull/33735).
3878 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3879   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3880 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3881 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3882 * [`panic!` can be converted to a runtime abort with the
3883   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3884   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3885 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3886   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3887   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3888   Note that Cargo does not yet directly support cdylibs.
3889
3890 Stabilized APIs
3891 ---------------
3892
3893 * `os::windows::fs::OpenOptionsExt::access_mode`
3894 * `os::windows::fs::OpenOptionsExt::share_mode`
3895 * `os::windows::fs::OpenOptionsExt::custom_flags`
3896 * `os::windows::fs::OpenOptionsExt::attributes`
3897 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3898 * `os::unix::fs::OpenOptionsExt::custom_flags`
3899 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3900 * `Default for sync::Weak`
3901 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3902 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3903 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3904 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3905 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3906 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3907 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3908 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3909 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3910 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3911 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3912 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3913 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3914 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3915 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3916 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3917 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3918 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3919 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3920 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3921 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3922 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3923 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3924 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3925 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3926 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3927 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3928 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3929 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3930 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3931 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3932 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3933 * Read/Write/RawFd impls for `UnixStream`
3934 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3935 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3936 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3937 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3938 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3939 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3940 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3941 * RawFd impls for `UnixListener`
3942 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3943 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3944 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3945 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3946 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3947 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3948 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3949 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3950 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3951 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3952 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3953 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3954 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3955 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3956 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3957 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3958 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3959 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3960 * RawFd impls for `UnixDatagram`
3961 * `{BTree,Hash}Map::values_mut`
3962 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3963
3964 Libraries
3965 ---------
3966
3967 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3968   The semantics of this minor method are subtle and probably not what
3969   most people want.
3970 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3971 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3972   will fall back to `/dev/urandom` temporarily to avoid blocking
3973   during early boot](https://github.com/rust-lang/rust/pull/33086).
3974 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3975 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3976 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3977 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3978 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3979 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3980   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3981
3982 Cargo
3983 -----
3984 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3985   This controls the runtime behavior of the `panic!` macro
3986   and can be either "unwind" (the default), or "abort".
3987   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3988 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3989 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3990 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3991   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3992 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3993 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3994 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3995   By default they are retried twice, which can be customized with the
3996   `net.retry` value in `.cargo/config`.
3997 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3998 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3999 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
4000 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
4001   Makes it possible to install multiple crates in parallel.
4002 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
4003 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
4004 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
4005 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
4006 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
4007 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
4008
4009 Performance
4010 -----------
4011
4012 * [rustc memory usage was reduced by refactoring the context used for
4013   type checking](https://github.com/rust-lang/rust/pull/33425).
4014 * [Speed up creation of `HashMap`s by caching the random keys used
4015   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
4016 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
4017 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
4018 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
4019   10x faster than the previous lookup tables.
4020 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
4021
4022 Usability
4023 ---------
4024
4025 * Many incremental improvements to documentation and rustdoc.
4026 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
4027 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
4028 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
4029 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
4030 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
4031 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
4032 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
4033
4034 Misc
4035 ----
4036
4037 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
4038 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
4039 * [`std` no longer prints backtraces on platforms where the running
4040   module must be loaded with `env::current_exe`, which can't be relied
4041   on](https://github.com/rust-lang/rust/pull/33554).
4042 * This release includes std binaries for the i586-unknown-linux-gnu,
4043   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
4044   i586 target is for old x86 hardware without SSE2, and the armv7
4045   target is for Android running on modern ARM architectures.
4046 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
4047   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
4048 * [On Unix the runtime aborts by calling `libc::abort` instead of
4049   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
4050 * [Rust is now bootstrapped from the previous release of Rust,
4051   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
4052
4053 Compatibility Notes
4054 -------------------
4055
4056 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
4057 * [`target_env` for Linux ARM targets is just `gnu`, not
4058   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
4059 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
4060 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
4061 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
4062   Affects how macros are parsed.
4063 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
4064 * [Feature-gated attributes on macro-generated macro invocations are
4065   now rejected](https://github.com/rust-lang/rust/pull/32791).
4066 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
4067   This caused some minor changes to type inference.
4068
4069
4070 Version 1.9.0 (2016-05-26)
4071 ==========================
4072
4073 Language
4074 --------
4075
4076 * The `#[deprecated]` attribute when applied to an API will generate
4077   warnings when used. The warnings may be suppressed with
4078   `#[allow(deprecated)]`. [RFC 1270].
4079 * [`fn` item types are zero sized, and each `fn` names a unique
4080   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4081   `transmute` on a `fn` type will generate a warning for a few cycles,
4082   then will be converted to an error.
4083 * [Field and method resolution understand visibility, so private
4084   fields and methods cannot prevent the proper use of public fields
4085   and methods][1.9fv].
4086 * [The parser considers unicode codepoints in the
4087   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
4088
4089 Stabilized APIs
4090 ---------------
4091
4092 * [`std::panic`]
4093 * [`std::panic::catch_unwind`][] (renamed from `recover`)
4094 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
4095 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
4096 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
4097 * [`str::is_char_boundary`]
4098 * [`<*const T>::as_ref`]
4099 * [`<*mut T>::as_ref`]
4100 * [`<*mut T>::as_mut`]
4101 * [`AsciiExt::make_ascii_uppercase`]
4102 * [`AsciiExt::make_ascii_lowercase`]
4103 * [`char::decode_utf16`]
4104 * [`char::DecodeUtf16`]
4105 * [`char::DecodeUtf16Error`]
4106 * [`char::DecodeUtf16Error::unpaired_surrogate`]
4107 * [`BTreeSet::take`]
4108 * [`BTreeSet::replace`]
4109 * [`BTreeSet::get`]
4110 * [`HashSet::take`]
4111 * [`HashSet::replace`]
4112 * [`HashSet::get`]
4113 * [`OsString::with_capacity`]
4114 * [`OsString::clear`]
4115 * [`OsString::capacity`]
4116 * [`OsString::reserve`]
4117 * [`OsString::reserve_exact`]
4118 * [`OsStr::is_empty`]
4119 * [`OsStr::len`]
4120 * [`std::os::unix::thread`]
4121 * [`RawPthread`]
4122 * [`JoinHandleExt`]
4123 * [`JoinHandleExt::as_pthread_t`]
4124 * [`JoinHandleExt::into_pthread_t`]
4125 * [`HashSet::hasher`]
4126 * [`HashMap::hasher`]
4127 * [`CommandExt::exec`]
4128 * [`File::try_clone`]
4129 * [`SocketAddr::set_ip`]
4130 * [`SocketAddr::set_port`]
4131 * [`SocketAddrV4::set_ip`]
4132 * [`SocketAddrV4::set_port`]
4133 * [`SocketAddrV6::set_ip`]
4134 * [`SocketAddrV6::set_port`]
4135 * [`SocketAddrV6::set_flowinfo`]
4136 * [`SocketAddrV6::set_scope_id`]
4137 * [`slice::copy_from_slice`]
4138 * [`ptr::read_volatile`]
4139 * [`ptr::write_volatile`]
4140 * [`OpenOptions::create_new`]
4141 * [`TcpStream::set_nodelay`]
4142 * [`TcpStream::nodelay`]
4143 * [`TcpStream::set_ttl`]
4144 * [`TcpStream::ttl`]
4145 * [`TcpStream::set_only_v6`]
4146 * [`TcpStream::only_v6`]
4147 * [`TcpStream::take_error`]
4148 * [`TcpStream::set_nonblocking`]
4149 * [`TcpListener::set_ttl`]
4150 * [`TcpListener::ttl`]
4151 * [`TcpListener::set_only_v6`]
4152 * [`TcpListener::only_v6`]
4153 * [`TcpListener::take_error`]
4154 * [`TcpListener::set_nonblocking`]
4155 * [`UdpSocket::set_broadcast`]
4156 * [`UdpSocket::broadcast`]
4157 * [`UdpSocket::set_multicast_loop_v4`]
4158 * [`UdpSocket::multicast_loop_v4`]
4159 * [`UdpSocket::set_multicast_ttl_v4`]
4160 * [`UdpSocket::multicast_ttl_v4`]
4161 * [`UdpSocket::set_multicast_loop_v6`]
4162 * [`UdpSocket::multicast_loop_v6`]
4163 * [`UdpSocket::set_multicast_ttl_v6`]
4164 * [`UdpSocket::multicast_ttl_v6`]
4165 * [`UdpSocket::set_ttl`]
4166 * [`UdpSocket::ttl`]
4167 * [`UdpSocket::set_only_v6`]
4168 * [`UdpSocket::only_v6`]
4169 * [`UdpSocket::join_multicast_v4`]
4170 * [`UdpSocket::join_multicast_v6`]
4171 * [`UdpSocket::leave_multicast_v4`]
4172 * [`UdpSocket::leave_multicast_v6`]
4173 * [`UdpSocket::take_error`]
4174 * [`UdpSocket::connect`]
4175 * [`UdpSocket::send`]
4176 * [`UdpSocket::recv`]
4177 * [`UdpSocket::set_nonblocking`]
4178
4179 Libraries
4180 ---------
4181
4182 * [`std::sync::Once` is poisoned if its initialization function
4183   fails][1.9o].
4184 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
4185 * [Most types implement `fmt::Debug`][1.9db].
4186 * [The default buffer size used by `BufReader` and `BufWriter` was
4187   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
4188   used by other languages.
4189 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
4190   `Duration` additionally implements `*=` and `/=`][1.9ta].
4191 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
4192 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
4193 * [`Chain` implements `BufRead`][1.9ch].
4194 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
4195
4196 Cargo
4197 -----
4198
4199 * [Cargo can now run concurrently][1.9cc].
4200 * [Top-level overrides allow specific revisions of crates to be
4201   overridden through the entire crate graph][1.9ct].  This is intended
4202   to make upgrades easier for large projects, by allowing crates to be
4203   forked temporarily until they've been upgraded and republished.
4204 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
4205 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
4206   on the commandline][1.9cf]. `rustc` arguments can also be specified
4207   in the `build.rustflags` configuration key.
4208
4209 Performance
4210 -----------
4211
4212 * [The time complexity of comparing variables for equivalence during type
4213   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
4214   to major compilation time improvement in some scenarios.
4215 * [`ToString` is specialized for `str`, giving it the same performance
4216   as `to_owned`][1.9ts].
4217 * [Spawning processes with `Command::output` no longer creates extra
4218   threads][1.9sp].
4219 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
4220   for C-like enums][1.9cl].
4221
4222 Misc
4223 ----
4224
4225 * [Passing the `--quiet` flag to a test runner will produce
4226   much-abbreviated output][1.9q].
4227 * The Rust Project now publishes std binaries for the
4228   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
4229   `i586-pc-windows-msvc` targets.
4230
4231 Compatibility Notes
4232 -------------------
4233
4234 * [`std::sync::Once` is poisoned if its initialization function
4235   fails][1.9o].
4236 * [It is illegal to define methods with the same name in overlapping
4237   inherent `impl` blocks][1.9sn].
4238 * [`fn` item types are zero sized, and each `fn` names a unique
4239   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4240   `transmute` on a `fn` type will generate a warning for a few cycles,
4241   then will be converted to an error.
4242 * [Improvements to const evaluation may trigger new errors when integer
4243   literals are out of range][1.9ce].
4244
4245
4246 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
4247 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
4248 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
4249 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
4250 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
4251 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
4252 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
4253 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
4254 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
4255 [1.9db]: https://github.com/rust-lang/rust/pull/32054
4256 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
4257 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
4258 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
4259 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
4260 [1.9o]: https://github.com/rust-lang/rust/pull/32325
4261 [1.9q]: https://github.com/rust-lang/rust/pull/31887
4262 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
4263 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
4264 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
4265 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
4266 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
4267 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
4268 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
4269 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
4270 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4271 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
4272 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4273 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
4274 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
4275 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
4276 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
4277 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
4278 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
4279 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
4280 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
4281 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
4282 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
4283 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
4284 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
4285 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
4286 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
4287 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
4288 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
4289 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
4290 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
4291 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
4292 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
4293 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
4294 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
4295 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
4296 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
4297 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
4298 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
4299 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
4300 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
4301 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
4302 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
4303 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
4304 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
4305 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
4306 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4307 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4308 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4309 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4310 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4311 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4312 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
4313 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4314 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
4315 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4316 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4317 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4318 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4319 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4320 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
4321 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
4322 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
4323 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
4324 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
4325 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
4326 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
4327 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
4328 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
4329 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
4330 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
4331 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
4332 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
4333 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
4334 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
4335 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
4336 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
4337 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
4338 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
4339 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
4340 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
4341 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
4342 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
4343 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
4344 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
4345 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
4346 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
4347 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
4348 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
4349 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
4350 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
4351 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
4352 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
4353 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
4354 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
4355 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
4356
4357
4358 Version 1.8.0 (2016-04-14)
4359 ==========================
4360
4361 Language
4362 --------
4363
4364 * Rust supports overloading of compound assignment statements like
4365   `+=` by implementing the [`AddAssign`], [`SubAssign`],
4366   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
4367   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
4368   traits. [RFC 953].
4369 * Empty structs can be defined with braces, as in `struct Foo { }`, in
4370   addition to the non-braced form, `struct Foo;`. [RFC 218].
4371
4372 Libraries
4373 ---------
4374
4375 * Stabilized APIs:
4376   * [`str::encode_utf16`][] (renamed from `utf16_units`)
4377   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
4378   * [`Ref::map`]
4379   * [`RefMut::map`]
4380   * [`ptr::drop_in_place`]
4381   * [`time::Instant`]
4382   * [`time::SystemTime`]
4383   * [`Instant::now`]
4384   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
4385   * [`Instant::elapsed`]
4386   * [`SystemTime::now`]
4387   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
4388   * [`SystemTime::elapsed`]
4389   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
4390   * [`SystemTimeError`]
4391   * [`SystemTimeError::duration`]
4392   * Various impls for `SystemTimeError`
4393   * [`UNIX_EPOCH`]
4394   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
4395     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
4396     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
4397 * [The `write!` and `writeln!` macros correctly emit errors if any of
4398   their arguments can't be formatted][1.8w].
4399 * [Various I/O functions support large files on 32-bit Linux][1.8l].
4400 * [The Unix-specific `raw` modules, which contain a number of
4401   redefined C types are deprecated][1.8r], including `os::raw::unix`,
4402   `os::raw::macos`, and `os::raw::linux`. These modules defined types
4403   such as `ino_t` and `dev_t`. The inconsistency of these definitions
4404   across platforms was making it difficult to implement `std`
4405   correctly. Those that need these definitions should use the `libc`
4406   crate. [RFC 1415].
4407 * The Unix-specific `MetadataExt` traits, including
4408   `os::unix::fs::MetadataExt`, which expose values such as inode
4409   numbers [no longer return platform-specific types][1.8r], but
4410   instead return widened integers. [RFC 1415].
4411 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
4412 * [Atomic loads and stores are not volatile][1.8a].
4413 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
4414
4415 Performance
4416 -----------
4417
4418 * [Inlining hash functions lead to a 3% compile-time improvement in
4419   some workloads][1.8h].
4420 * When using jemalloc, its symbols are [unprefixed so that it
4421   overrides the libc malloc implementation][1.8h]. This means that for
4422   rustc, LLVM is now using jemalloc, which results in a 6%
4423   compile-time improvement on a specific workload.
4424 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
4425
4426 Misc
4427 ----
4428
4429 * [32-bit MSVC builds finally implement unwinding][1.8ms].
4430   i686-pc-windows-msvc is now considered a tier-1 platform.
4431 * [The `--print targets` flag prints a list of supported targets][1.8t].
4432 * [The `--print cfg` flag prints the `cfg`s defined for the current
4433   target][1.8cf].
4434 * [`rustc` can be built with an new Cargo-based build system, written
4435   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
4436   build system. To enable it configure with `configure --rustbuild`.
4437 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
4438   variants while also indicating the total number of missing variants
4439   if more than 3][1.8m].
4440 * [Executable stacks are disabled on Linux and BSD][1.8nx].
4441 * The Rust Project now publishes binary releases of the standard
4442   library for a number of tier-2 targets:
4443   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
4444   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
4445   `x86_64-rumprun-netbsd`. These can be installed with
4446   tools such as [multirust][1.8mr].
4447
4448 Cargo
4449 -----
4450
4451 * [`cargo init` creates a new Cargo project in the current
4452   directory][1.8ci].  It is otherwise like `cargo new`.
4453 * [Cargo has configuration keys for `-v` and
4454   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
4455   `[term]` section of `.cargo/config`.
4456 * [Configuration keys that evaluate to strings or integers can be set
4457   via environment variables][1.8ce]. For example the `build.jobs` key
4458   can be set via `CARGO_BUILD_JOBS`. Environment variables take
4459   precedence over config files.
4460 * [Target-specific dependencies support Rust `cfg` syntax for
4461   describing targets][1.8cfg] so that dependencies for multiple
4462   targets can be specified together. [RFC 1361].
4463 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
4464   `RUSTDOC` take precedence over the `build.target-dir`,
4465   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4466 * [The child process tree is killed on Windows when Cargo is
4467   killed][1.8ck].
4468 * [The `build.target` configuration value sets the target platform,
4469   like `--target`][1.8ct].
4470
4471 Compatibility Notes
4472 -------------------
4473
4474 * [Unstable compiler flags have been further restricted][1.8u]. Since
4475   1.0 `-Z` flags have been considered unstable, and other flags that
4476   were considered unstable additionally required passing `-Z
4477   unstable-options` to access. Unlike unstable language and library
4478   features though, these options have been accessible on the stable
4479   release channel. Going forward, *new unstable flags will not be
4480   available on the stable release channel*, and old unstable flags
4481   will warn about their usage. In the future, all unstable flags will
4482   be unavailable on the stable release channel.
4483 * [It is no longer possible to `match` on empty enum variants using
4484   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4485 * The Unix-specific `MetadataExt` traits, including
4486   `os::unix::fs::MetadataExt`, which expose values such as inode
4487   numbers [no longer return platform-specific types][1.8r], but
4488   instead return widened integers. [RFC 1415].
4489 * [Modules sourced from the filesystem cannot appear within arbitrary
4490   blocks, but only within other modules][1.8mf].
4491 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4492 * On Unix, [stack overflow triggers a runtime abort instead of a
4493   SIGSEGV][1.8so].
4494 * [`Command::spawn` and its equivalents return an error if any of
4495   its command-line arguments contain interior `NUL`s][1.8n].
4496 * [Tuple and unit enum variants from other crates are in the type
4497   namespace][1.8tn].
4498 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4499   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4500   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4501   instead of `foo.lib`.
4502
4503
4504 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4505 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4506 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4507 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4508 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4509 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4510 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4511 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4512 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4513 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4514 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4515 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4516 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4517 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4518 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4519 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4520 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4521 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4522 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4523 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4524 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4525 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4526 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4527 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4528 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4529 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4530 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4531 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4532 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4533 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4534 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4535 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4536 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4537 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4538 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4539 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4540 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4541 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4542 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4543 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4544 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4545 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4546 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4547 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4548 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4549 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4550 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4551 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4552 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4553 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4554 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4555 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4556 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4557 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4558 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4559 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4560 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4561 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4562 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4563 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4564
4565
4566 Version 1.7.0 (2016-03-03)
4567 ==========================
4568
4569 Libraries
4570 ---------
4571
4572 * Stabilized APIs
4573   * `Path`
4574     * [`Path::strip_prefix`][] (renamed from relative_from)
4575     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4576   * `Ipv4Addr`
4577     * [`Ipv4Addr::is_loopback`]
4578     * [`Ipv4Addr::is_private`]
4579     * [`Ipv4Addr::is_link_local`]
4580     * [`Ipv4Addr::is_multicast`]
4581     * [`Ipv4Addr::is_broadcast`]
4582     * [`Ipv4Addr::is_documentation`]
4583   * `Ipv6Addr`
4584     * [`Ipv6Addr::is_unspecified`]
4585     * [`Ipv6Addr::is_loopback`]
4586     * [`Ipv6Addr::is_multicast`]
4587   * `Vec`
4588     * [`Vec::as_slice`]
4589     * [`Vec::as_mut_slice`]
4590   * `String`
4591     * [`String::as_str`]
4592     * [`String::as_mut_str`]
4593   * Slices
4594     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4595     be the same length
4596     * `<[T]>::`[`sort_by_key`]
4597   * checked, saturated, and overflowing operations
4598     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4599     * [`i32::saturating_mul`]
4600     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4601     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4602     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4603     * [`u32::saturating_mul`]
4604     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4605     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4606     * and checked, saturated, and overflowing operations for other primitive types
4607   * FFI
4608     * [`ffi::IntoStringError`]
4609     * [`CString::into_string`]
4610     * [`CString::into_bytes`]
4611     * [`CString::into_bytes_with_nul`]
4612     * `From<CString> for Vec<u8>`
4613   * `IntoStringError`
4614     * [`IntoStringError::into_cstring`]
4615     * [`IntoStringError::utf8_error`]
4616     * `Error for IntoStringError`
4617   * Hashing
4618     * [`std::hash::BuildHasher`]
4619     * [`BuildHasher::Hasher`]
4620     * [`BuildHasher::build_hasher`]
4621     * [`std::hash::BuildHasherDefault`]
4622     * [`HashMap::with_hasher`]
4623     * [`HashMap::with_capacity_and_hasher`]
4624     * [`HashSet::with_hasher`]
4625     * [`HashSet::with_capacity_and_hasher`]
4626     * [`std::collections::hash_map::RandomState`]
4627     * [`RandomState::new`]
4628 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4629   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4630   from bytes is faster.
4631 * [The performance of `LineWriter` (and thus `io::stdout`) was
4632   improved by using `memchr` to search for newlines][1.7m].
4633 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4634   `f64` variants were stabilized previously.
4635 * [`BTreeMap` was rewritten to use less memory and improve the performance
4636   of insertion and iteration, the latter by as much as 5x][1.7bm].
4637 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4638   covariant over their contained type][1.7bt].
4639 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4640   over their contained type][1.7ll].
4641 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4642   searching methods.
4643 * [`Any` is implemented for unsized types][1.7a].
4644 * [`Hash` is implemented for `Duration`][1.7h].
4645
4646 Misc
4647 ----
4648
4649 * [When running tests with `--test`, rustdoc will pass `--cfg`
4650   arguments to the compiler][1.7dt].
4651 * [The compiler is built with RPATH information by default][1.7rpa].
4652   This means that it will be possible to run `rustc` when installed in
4653   unusual configurations without configuring the dynamic linker search
4654   path explicitly.
4655 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4656   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4657   over `LD_LIBRARY_PATH`.
4658
4659 Cargo
4660 -----
4661
4662 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4663   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4664 * [The `rerun-if-changed` build script directive no longer causes the
4665   build script to incorrectly run twice in certain scenarios][1.7rr].
4666
4667 Compatibility Notes
4668 -------------------
4669
4670 * Soundness fixes to the interactions between associated types and
4671   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4672   code that violates the new rules. This is a significant change that
4673   is known to break existing code, so it has emitted warnings for the
4674   new error cases since 1.4 to give crate authors time to adapt. The
4675   details of what is changing are subtle; read the RFC for more.
4676 * [Several bugs in the compiler's visibility calculations were
4677   fixed][1.7v]. Since this was found to break significant amounts of
4678   code, the new errors will be emitted as warnings for several release
4679   cycles, under the `private_in_public` lint.
4680 * Defaulted type parameters were accidentally accepted in positions
4681   that were not intended. In this release, [defaulted type parameters
4682   appearing outside of type definitions will generate a
4683   warning][1.7d], which will become an error in future releases.
4684 * [Parsing "." as a float results in an error instead of 0][1.7p].
4685   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4686 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4687
4688 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4689 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4690 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4691 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4692 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4693 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4694 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4695 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4696 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4697 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4698 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4699 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4700 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4701 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4702 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4703 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4704 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4705 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4706 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4707 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4708 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4709 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4710 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4711 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4712 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4713 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4714 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4715 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4716 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4717 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4718 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4719 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4720 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4721 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4722 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4723 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4724 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4725 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4726 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4727 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4728 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4729 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4730 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4731 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4732 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4733 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4734 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4735 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4736 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4737 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4738 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4739 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4740 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4741 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4742 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4743 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4744 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4745 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4746 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4747 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4748 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4749 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4750 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4751 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4752 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4753 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4754 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4755 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4756 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4757 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4758 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4759 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4760 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4761 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4762 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4763 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4764 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4765 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4766 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4767
4768
4769 Version 1.6.0 (2016-01-21)
4770 ==========================
4771
4772 Language
4773 --------
4774
4775 * The `#![no_std]` attribute causes a crate to not be linked to the
4776   standard library, but only the [core library][1.6co], as described
4777   in [RFC 1184]. The core library defines common types and traits but
4778   has no platform dependencies whatsoever, and is the basis for Rust
4779   software in environments that cannot support a full port of the
4780   standard library, such as operating systems. Most of the core
4781   library is now stable.
4782
4783 Libraries
4784 ---------
4785
4786 * Stabilized APIs:
4787   [`Read::read_exact`],
4788   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4789   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4790   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4791   [`os::unix::fs::DirBuilderExt`],
4792   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4793   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4794   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4795   [`collections::hash_map::Drain`],
4796   [`collections::hash_map::HashMap::drain`],
4797   [`collections::hash_set::Drain`],
4798   [`collections::hash_set::HashSet::drain`],
4799   [`collections::binary_heap::Drain`],
4800   [`collections::binary_heap::BinaryHeap::drain`],
4801   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4802   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4803   [`RwLock::into_inner`],
4804   [`Iterator::min_by_key`][] (renamed from `min_by`),
4805   [`Iterator::max_by_key`][] (renamed from `max_by`).
4806 * The [core library][1.6co] is stable, as are most of its APIs.
4807 * [The `assert_eq!` macro supports arguments that don't implement
4808   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4809   `assert!`.
4810 * Several timer functions that take duration in milliseconds [are
4811   deprecated in favor of those that take `Duration`][1.6ms]. These
4812   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4813   `thread::park_timeout_ms`.
4814 * The algorithm by which `Vec` reserves additional elements was
4815   [tweaked to not allocate excessive space][1.6a] while still growing
4816   exponentially.
4817 * `From` conversions are [implemented from integers to floats][1.6f]
4818   in cases where the conversion is lossless. Thus they are not
4819   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4820   or `f64`. They are also not implemented for `isize` and `usize`
4821   because the implementations would be platform-specific. `From` is
4822   also implemented from `f32` to `f64`.
4823 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4824 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4825 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4826 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4827   improvements.
4828 * Sorting slices that are already sorted [is 50% faster in some
4829   cases][1.6s].
4830
4831 Cargo
4832 -----
4833
4834 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4835 * Cargo build scripts can specify their dependencies by emitting the
4836   [`rerun-if-changed`][1.6rr] key.
4837 * crates.io will reject publication of crates with dependencies that
4838   have a wildcard version constraint. Crates with wildcard
4839   dependencies were seen to cause a variety of problems, as described
4840   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4841   warning.
4842 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4843   release folder.  A variety of artifacts that Cargo failed to clean
4844   are now correctly deleted.
4845
4846 Misc
4847 ----
4848
4849 * The `unreachable_code` lint [warns when a function call's argument
4850   diverges][1.6dv].
4851 * The parser indicates [failures that may be caused by
4852   confusingly-similar Unicode characters][1.6uc]
4853 * Certain macro errors [are reported at definition time][1.6m], not
4854   expansion.
4855
4856 Compatibility Notes
4857 -------------------
4858
4859 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4860   environment variable when locating crates. This was a pre-cargo
4861   feature for integrating with the package manager that was
4862   accidentally never removed.
4863 * [A number of bugs were fixed in the privacy checker][1.6p] that
4864   could cause previously-accepted code to break.
4865 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4866 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4867   struct pattern syntax (`Foo(..)`) can no longer be used to match
4868   unit structs. This is a warning now, but will become an error in
4869   future releases. Patterns that share the same name as a const are
4870   now an error.
4871 * A bug was fixed that causes [rustc not to apply default type
4872   parameters][1.6xc] when resolving certain method implementations of
4873   traits defined in other crates.
4874
4875 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4876 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4877 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4878 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4879 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4880 [1.6co]: http://doc.rust-lang.org/core/index.html
4881 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4882 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4883 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4884 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4885 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4886 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4887 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4888 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4889 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4890 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4891 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4892 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4893 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4894 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4895 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4896 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4897 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4898 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4899 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4900 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4901 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4902 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4903 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4904 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4905 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4906 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4907 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4908 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4909 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4910 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4911 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4912 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4913 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4914 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4915 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4916 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4917 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4918 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4919 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4920 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4921 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4922
4923
4924 Version 1.5.0 (2015-12-10)
4925 ==========================
4926
4927 * ~700 changes, numerous bugfixes
4928
4929 Highlights
4930 ----------
4931
4932 * Stabilized APIs:
4933   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4934   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4935   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4936   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4937   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4938   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4939   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4940   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4941   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4942   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4943   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4944   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4945   [`Path::read_link`], [`Path::symlink_metadata`],
4946   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4947   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4948   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4949   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4950   [`slice::split_first_mut`], [`slice::split_first`],
4951   [`slice::split_last_mut`], [`slice::split_last`],
4952   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4953   [`str::MatchIndices`], [`str::RMatchIndices`],
4954   [`str::match_indices`], [`str::rmatch_indices`],
4955   [`str::slice_mut_unchecked`], [`string::ParseError`].
4956 * Rust applications hosted on crates.io can be installed locally to
4957   `~/.cargo/bin` with the [`cargo install`] command. Among other
4958   things this makes it easier to augment Cargo with new subcommands:
4959   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4960   invoked as `cargo foo`.
4961 * Crates with wildcard (`*`) dependencies will [emit warnings when
4962   published][1.5w]. In 1.6 it will no longer be possible to publish
4963   crates with wildcard dependencies.
4964
4965 Breaking Changes
4966 ----------------
4967
4968 * The rules determining when a particular lifetime must outlive
4969   a particular value (known as '[dropck]') have been [modified
4970   to not rely on parametricity][1.5p].
4971 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4972   and `Arc`][1.5a]. Because these smart pointer types implement
4973   `Deref`, this causes breakage in cases where the interior type
4974   contains methods of the same name.
4975 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4976   that they could drop their content. Soundness fix.
4977 * All method invocations are [properly checked][1.5wf1] for
4978   [well-formedness][1.5wf2]. Soundness fix.
4979 * Traits whose supertraits contain `Self` are [not object
4980   safe][1.5o]. Soundness fix.
4981 * Target specifications support a [`no_default_libraries`][1.5nd]
4982   setting that controls whether `-nodefaultlibs` is passed to the
4983   linker, and in turn the `is_like_windows` setting no longer affects
4984   the `-nodefaultlibs` flag.
4985 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4986 * The `#[inline]` and `#[repr]` attributes [can only appear
4987   in valid locations][1.5at].
4988 * Native libraries linked from the local crate are [passed to
4989   the linker before native libraries from upstream crates][1.5nl].
4990 * Two rarely-used attributes, `#[no_debug]` and
4991   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4992 * Negation of unsigned integers, which has been a warning for
4993   several releases, [is now behind a feature gate and will
4994   generate errors][1.5nu].
4995 * The parser accidentally accepted visibility modifiers on
4996   enum variants, a bug [which has been fixed][1.5ev].
4997 * [A bug was fixed that allowed `use` statements to import unstable
4998   features][1.5use].
4999
5000 Language
5001 --------
5002
5003 * When evaluating expressions at compile-time that are not
5004   compile-time constants (const-evaluating expressions in non-const
5005   contexts), incorrect code such as overlong bitshifts and arithmetic
5006   overflow will [generate a warning instead of an error][1.5ce],
5007   delaying the error until runtime. This will allow the
5008   const-evaluator to be expanded in the future backwards-compatibly.
5009 * The `improper_ctypes` lint [no longer warns about using `isize` and
5010   `usize` in FFI][1.5ict].
5011
5012 Libraries
5013 ---------
5014
5015 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
5016   invariant][1.5c].
5017 * `Default` is [implemented for mutable slices][1.5d].
5018 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
5019 * There are now `From` conversions [between floating point
5020   types][1.5f] where the conversions are lossless.
5021 * There are now `From` conversions [between integer types][1.5i] where
5022   the conversions are lossless.
5023 * [`fs::Metadata` implements `Clone`][1.5fs].
5024 * The `parse` method [accepts a leading "+" when parsing
5025   integers][1.5pi].
5026 * [`AsMut` is implemented for `Vec`][1.5am].
5027 * The `clone_from` implementations for `String` and `BinaryHeap` [have
5028   been optimized][1.5cf] and no longer rely on the default impl.
5029 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
5030   `unsafe extern "C"` function types now [implement `Clone`,
5031   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
5032   `fmt::Debug` for up to 12 arguments][1.5fp].
5033 * [Dropping `Vec`s is much faster in unoptimized builds when the
5034   element types don't implement `Drop`][1.5dv].
5035 * A bug that caused in incorrect behavior when [combining `VecDeque`
5036   with zero-sized types][1.5vdz] was resolved.
5037 * [`PartialOrd` for slices is faster][1.5po].
5038
5039 Miscellaneous
5040 -------------
5041
5042 * [Crate metadata size was reduced by 20%][1.5md].
5043 * [Improvements to code generation reduced the size of libcore by 3.3
5044   MB and rustc's memory usage by 18MB][1.5m].
5045 * [Improvements to deref translation increased performance in
5046   unoptimized builds][1.5dr].
5047 * Various errors in trait resolution [are deduplicated to only be
5048   reported once][1.5te].
5049 * Rust has preliminary [support for rumprun kernels][1.5rr].
5050 * Rust has preliminary [support for NetBSD on amd64][1.5na].
5051
5052 [1.5use]: https://github.com/rust-lang/rust/pull/28364
5053 [1.5po]: https://github.com/rust-lang/rust/pull/28436
5054 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
5055 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
5056 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
5057 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
5058 [1.5md]: https://github.com/rust-lang/rust/pull/28521
5059 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
5060 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
5061 [1.5na]: https://github.com/rust-lang/rust/pull/28543
5062 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
5063 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
5064 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
5065 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
5066 [1.5te]: https://github.com/rust-lang/rust/pull/28645
5067 [1.5at]: https://github.com/rust-lang/rust/pull/28650
5068 [1.5am]: https://github.com/rust-lang/rust/pull/28663
5069 [1.5m]: https://github.com/rust-lang/rust/pull/28778
5070 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
5071 [1.5a]: https://github.com/rust-lang/rust/pull/28811
5072 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
5073 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
5074 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
5075 [1.5i]: https://github.com/rust-lang/rust/pull/28921
5076 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
5077 [1.5f]: https://github.com/rust-lang/rust/pull/29129
5078 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
5079 [1.5s]: https://github.com/rust-lang/rust/pull/29190
5080 [1.5d]: https://github.com/rust-lang/rust/pull/29245
5081 [1.5o]: https://github.com/rust-lang/rust/pull/29259
5082 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
5083 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5084 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
5085 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
5086 [1.5c]: https://github.com/rust-lang/rust/pull/29110
5087 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5088 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
5089 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
5090 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
5091 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
5092 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
5093 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
5094 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
5095 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
5096 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
5097 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
5098 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
5099 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
5100 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
5101 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
5102 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
5103 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
5104 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
5105 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
5106 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
5107 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
5108 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
5109 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
5110 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
5111 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
5112 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
5113 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
5114 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
5115 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
5116 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
5117 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
5118 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
5119 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
5120 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
5121 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
5122 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
5123 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
5124 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
5125 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
5126 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
5127 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
5128 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
5129 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
5130 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
5131 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
5132 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
5133 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
5134 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
5135 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
5136 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
5137 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
5138 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
5139 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
5140 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
5141
5142 Version 1.4.0 (2015-10-29)
5143 ==========================
5144
5145 * ~1200 changes, numerous bugfixes
5146
5147 Highlights
5148 ----------
5149
5150 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
5151   GNU) are now supported and recommended for use.
5152
5153 Breaking Changes
5154 ----------------
5155
5156 * [Several changes have been made to fix type soundness and improve
5157   the behavior of associated types][sound]. See [RFC 1214]. Although
5158   we have mostly introduced these changes as warnings this release, to
5159   become errors next release, there are still some scenarios that will
5160   see immediate breakage.
5161 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
5162   line breaks in addition to `\n`][crlf].
5163 * [Loans of `'static` lifetime extend to the end of a function][stat].
5164 * [`str::parse` no longer introduces avoidable rounding error when
5165   parsing floating point numbers. Together with earlier changes to
5166   float formatting/output, "round trips" like f.to_string().parse()
5167   now preserve the value of f exactly. Additionally, leading plus
5168   signs are now accepted][fp3].
5169
5170
5171 Language
5172 --------
5173
5174 * `use` statements that import multiple items [can now rename
5175   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
5176 * [Binops work correctly on fat pointers][binfat].
5177 * `pub extern crate`, which does not behave as expected, [issues a
5178   warning][pec] until a better solution is found.
5179
5180 Libraries
5181 ---------
5182
5183 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
5184   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
5185   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
5186   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
5187   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
5188   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
5189   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
5190   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
5191   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
5192   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
5193   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
5194   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
5195   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
5196   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
5197   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
5198   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
5199   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
5200   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
5201   [`thread::sleep`].
5202 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
5203   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
5204   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
5205   `f64::from_str_radix`.
5206 * [Reverse-searching strings is faster with the 'two-way'
5207   algorithm][s].
5208 * [`std::io::copy` allows `?Sized` arguments][cc].
5209 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
5210   [override `count`, `nth` and `last` with an O(1)
5211   implementation][it].
5212 * [`Default` is implemented for arrays up to `[T; 32]`][d].
5213 * [`IntoRawFd` has been added to the Unix-specific prelude,
5214   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
5215   prelude][pr].
5216 * [`Extend<String>` and `FromIterator<String` are both implemented for
5217   `String`][es].
5218 * [`IntoIterator` is implemented for references to `Option` and
5219   `Result`][into2].
5220 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
5221   Copy`][ext] as part of [RFC 839]. This will cause type inference
5222   breakage in rare situations.
5223 * [`BinaryHeap` implements `Debug`][bh2].
5224 * [`Borrow` and `BorrowMut` are implemented for fixed-size
5225   arrays][bm].
5226 * [`extern fn`s with the "Rust" and "C" ABIs implement common
5227   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
5228 * [String comparison is faster][faststr].
5229 * `&mut T` where `T: std::fmt::Write` [also implements
5230   `std::fmt::Write`][mutw].
5231 * [A stable regression in `VecDeque::push_back` and other
5232   capacity-altering methods that caused panics for zero-sized types
5233   was fixed][vd].
5234 * [Function pointers implement traits for up to 12 parameters][fp2].
5235
5236 Miscellaneous
5237 -------------
5238
5239 * The compiler [no longer uses the 'morestack' feature to prevent
5240   stack overflow][mm]. Instead it uses guard pages and stack
5241   probes (though stack probes are not yet implemented on any platform
5242   but Windows).
5243 * [The compiler matches traits faster when projections are involved][p].
5244 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
5245   `usize`][ffi].
5246 * [Cargo now displays useful information about what its doing during
5247   `cargo update`][cu].
5248
5249 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
5250 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
5251 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
5252 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
5253 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
5254 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
5255 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
5256 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
5257 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
5258 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
5259 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
5260 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
5261 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
5262 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
5263 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
5264 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
5265 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
5266 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
5267 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5268 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5269 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5270 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5271 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5272 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5273 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5274 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5275 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
5276 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
5277 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
5278 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
5279 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
5280 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
5281 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
5282 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
5283 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
5284 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
5285 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
5286 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
5287 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
5288 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
5289 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
5290 [bh2]: https://github.com/rust-lang/rust/pull/28156
5291 [binfat]: https://github.com/rust-lang/rust/pull/28270
5292 [bm]: https://github.com/rust-lang/rust/pull/28197
5293 [cc]: https://github.com/rust-lang/rust/pull/27531
5294 [crlf]: https://github.com/rust-lang/rust/pull/28034
5295 [cu]: https://github.com/rust-lang/cargo/pull/1931
5296 [d]: https://github.com/rust-lang/rust/pull/27825
5297 [dep]: https://github.com/rust-lang/rust/pull/28339
5298 [es]: https://github.com/rust-lang/rust/pull/27956
5299 [ext]: https://github.com/rust-lang/rust/pull/28094
5300 [faststr]: https://github.com/rust-lang/rust/pull/28338
5301 [ffi]: https://github.com/rust-lang/rust/pull/28779
5302 [fp]: https://github.com/rust-lang/rust/pull/28268
5303 [fp2]: https://github.com/rust-lang/rust/pull/28560
5304 [fp3]: https://github.com/rust-lang/rust/pull/27307
5305 [i]: https://github.com/rust-lang/rust/pull/27451
5306 [into2]: https://github.com/rust-lang/rust/pull/28039
5307 [it]: https://github.com/rust-lang/rust/pull/27652
5308 [mm]: https://github.com/rust-lang/rust/pull/27338
5309 [mutw]: https://github.com/rust-lang/rust/pull/28368
5310 [sound]: https://github.com/rust-lang/rust/pull/27641
5311 [p]: https://github.com/rust-lang/rust/pull/27866
5312 [pec]: https://github.com/rust-lang/rust/pull/28486
5313 [pr]: https://github.com/rust-lang/rust/pull/27896
5314 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5315 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5316 [s]: https://github.com/rust-lang/rust/pull/27474
5317 [stab]: https://github.com/rust-lang/rust/pull/28339
5318 [stat]: https://github.com/rust-lang/rust/pull/28321
5319 [vd]: https://github.com/rust-lang/rust/pull/28494
5320
5321 Version 1.3.0 (2015-09-17)
5322 ==============================
5323
5324 * ~900 changes, numerous bugfixes
5325
5326 Highlights
5327 ----------
5328
5329 * The [new object lifetime defaults][nold] have been [turned
5330   on][nold2] after a cycle of warnings about the change. Now types
5331   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
5332   being interpreted as `&'a Box<Trait+'a>` to `&'a
5333   Box<Trait+'static>`.
5334 * [The Rustonomicon][nom] is a new book in the official documentation
5335   that dives into writing unsafe Rust.
5336 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
5337   timekeeping is employed by other std APIs, as well as out-of-tree
5338   time crates.
5339
5340 Breaking Changes
5341 ----------------
5342
5343 * The [new object lifetime defaults][nold] have been [turned
5344   on][nold2] after a cycle of warnings about the change.
5345 * There is a known [regression][lr] in how object lifetime elision is
5346   interpreted, the proper solution for which is undetermined.
5347 * The `#[prelude_import]` attribute, an internal implementation
5348   detail, was accidentally stabilized previously. [It has been put
5349   behind the `prelude_import` feature gate][pi]. This change is
5350   believed to break no existing code.
5351 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5352   [more sane for dynamically sized types][dst3]. Code that relied on
5353   the previous behavior is thought to be broken.
5354 * The `dropck` rules, which checks that destructors can't access
5355   destroyed values, [have been updated][dropck] to match the
5356   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
5357   cause some previously-compiling code to no longer build.
5358
5359 Language
5360 --------
5361
5362 * The [new object lifetime defaults][nold] have been [turned
5363   on][nold2] after a cycle of warnings about the change.
5364 * Semicolons may [now follow types and paths in
5365   macros](https://github.com/rust-lang/rust/pull/27000).
5366 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5367   [more sane for dynamically sized types][dst3]. Code that relied on
5368   the previous behavior is not known to exist, and suspected to be
5369   broken.
5370 * `'static` variables [may now be recursive][st].
5371 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
5372   implementations correctly.
5373 * The `dropck` rules, which checks that destructors can't access
5374   destroyed values, [have been updated][dropck] to match the
5375   [RFC][dropckrfc].
5376
5377 Libraries
5378 ---------
5379
5380 * The [`Duration`] API, [has been stabilized][ds], as well as the
5381   `std::time` module, which presently contains only `Duration`.
5382 * `Box<str>` and `Box<[T]>` both implement `Clone`.
5383 * The owned C string, [`CString`], implements [`Borrow`] and the
5384   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
5385   these allow C strings to be borrowed and cloned in generic code.
5386 * [`CStr`] implements [`Debug`].
5387 * [`AtomicPtr`] implements [`Debug`].
5388 * [`Error`] trait objects [can be downcast to their concrete types][e]
5389   in many common configurations, using the [`is`], [`downcast`],
5390   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
5391   [`Any`] trait.
5392 * Searching for substrings now [employs the two-way algorithm][search]
5393   instead of doing a naive search. This gives major speedups to a
5394   number of methods, including [`contains`][sc], [`find`][sf],
5395   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
5396   [`ends_with`][sew] are also faster.
5397 * The performance of `PartialEq` for slices is [much faster][ps].
5398 * The [`Hash`] trait offers the default method, [`hash_slice`], which
5399   is overridden and optimized by the implementations for scalars.
5400 * The [`Hasher`] trait now has a number of specialized `write_*`
5401   methods for primitive types, for efficiency.
5402 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
5403   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
5404   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
5405   of [`std::error::Error::cause`][iec] also delegates to the inner
5406   error.
5407 * [`process::Child`][pc] gained the [`id`] method, which returns a
5408   `u32` representing the platform-specific process identifier.
5409 * The [`connect`] method on slices is deprecated, replaced by the new
5410   [`join`] method (note that both of these are on the *unstable*
5411   [`SliceConcatExt`] trait, but through the magic of the prelude are
5412   available to stable code anyway).
5413 * The [`Div`] operator is implemented for [`Wrapping`] types.
5414 * [`DerefMut` is implemented for `String`][dms].
5415 * Performance of SipHash (the default hasher for `HashMap`) is
5416   [better for long data][sh].
5417 * [`AtomicPtr`] implements [`Send`].
5418 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
5419   are now [specialized to use uninitialized buffers for increased
5420   performance][rte].
5421 * Lifetime parameters of foreign functions [are now resolved
5422   properly][f].
5423
5424 Misc
5425 ----
5426
5427 * Rust can now, with some coercion, [produce programs that run on
5428   Windows XP][xp], though XP is not considered a supported platform.
5429 * Porting Rust on Windows from the GNU toolchain to MSVC continues
5430   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
5431   recommended for use in 1.3, though should be fully-functional
5432   in the [64-bit 1.4 beta][b14].
5433 * On Fedora-based systems installation will [properly configure the
5434   dynamic linker][fl].
5435 * The compiler gained many new extended error descriptions, which can
5436   be accessed with the `--explain` flag.
5437 * The `dropck` pass, which checks that destructors can't access
5438   destroyed values, [has been rewritten][dropck]. This fixes some
5439   soundness holes, and as such will cause some previously-compiling
5440   code to no longer build.
5441 * `rustc` now uses [LLVM to write archive files where possible][ar].
5442   Eventually this will eliminate the compiler's dependency on the ar
5443   utility.
5444 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
5445   supported FreeBSD on x86_64).
5446 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
5447   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
5448   more strict.
5449 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
5450   will kill the process instead of leaking][nlp].
5451
5452 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
5453 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
5454 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
5455 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
5456 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
5457 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5458 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5459 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
5460 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
5461 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
5462 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
5463 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
5464 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5465 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5466 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5467 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5468 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5469 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5470 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5471 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5472 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5473 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5474 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5475 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5476 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5477 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5478 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5479 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5480 [ar]: https://github.com/rust-lang/rust/pull/26926
5481 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5482 [dms]: https://github.com/rust-lang/rust/pull/26241
5483 [dropck]: https://github.com/rust-lang/rust/pull/27261
5484 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5485 [ds]: https://github.com/rust-lang/rust/pull/26818
5486 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5487 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5488 [dst3]: https://github.com/rust-lang/rust/pull/27351
5489 [e]: https://github.com/rust-lang/rust/pull/24793
5490 [f]: https://github.com/rust-lang/rust/pull/26588
5491 [fb]: https://github.com/rust-lang/rust/pull/26959
5492 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5493 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5494 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5495 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5496 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5497 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5498 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5499 [lic]: https://github.com/rust-lang/rust/pull/26583
5500 [lnu]: https://github.com/rust-lang/rust/pull/27026
5501 [lr]: https://github.com/rust-lang/rust/issues/27248
5502 [lum]: https://github.com/rust-lang/rust/pull/26378
5503 [lur]: https://github.com/rust-lang/rust/pull/26783
5504 [nlp]: https://github.com/rust-lang/rust/pull/27176
5505 [nold2]: https://github.com/rust-lang/rust/pull/27045
5506 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5507 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5508 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5509 [pi]: https://github.com/rust-lang/rust/pull/26699
5510 [ps]: https://github.com/rust-lang/rust/pull/26884
5511 [rte]: https://github.com/rust-lang/rust/pull/26950
5512 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5513 [search]: https://github.com/rust-lang/rust/pull/26327
5514 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5515 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5516 [sh]: https://github.com/rust-lang/rust/pull/27280
5517 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5518 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5519 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5520 [st]: https://github.com/rust-lang/rust/pull/26630
5521 [win1]: https://github.com/rust-lang/rust/pull/26569
5522 [win2]: https://github.com/rust-lang/rust/pull/26741
5523 [win3]: https://github.com/rust-lang/rust/pull/26741
5524 [win4]: https://github.com/rust-lang/rust/pull/27210
5525 [xp]: https://github.com/rust-lang/rust/pull/26569
5526
5527 Version 1.2.0 (2015-08-07)
5528 ==========================
5529
5530 * ~1200 changes, numerous bugfixes
5531
5532 Highlights
5533 ----------
5534
5535 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5536   like `Rc` to contain types without a fixed size, arrays and trait
5537   objects, finally enabling use of `Rc<[T]>` and completing the
5538   implementation of DST.
5539 * [Parallel codegen][parcodegen] is now working again, which can
5540   substantially speed up large builds in debug mode; It also gets
5541   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5542   jobs). It's not enabled by default, but will be "in the near
5543   future". It can be activated with the `-C codegen-units=N` flag to
5544   `rustc`.
5545 * This is the first release with [experimental support for linking
5546   with the MSVC linker and lib C on Windows (instead of using the GNU
5547   variants via MinGW)][win]. It is yet recommended only for the most
5548   intrepid Rustaceans.
5549 * Benchmark compilations are showing a 30% improvement in
5550   bootstrapping over 1.1.
5551
5552 Breaking Changes
5553 ----------------
5554
5555 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5556   unicode case mapping, which is a previously-planned change in
5557   behavior and considered a bugfix.
5558 * [`mem::align_of`] now specifies [the *minimum alignment* for
5559   T][align], which is usually the alignment programs are interested
5560   in, and the same value reported by clang's
5561   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5562   break real code.
5563 * [The `#[packed]` attribute is no longer silently accepted by the
5564   compiler][packed]. This attribute did nothing and code that
5565   mentioned it likely did not work as intended.
5566 * Associated type defaults are [now behind the
5567   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5568   defaults *did not work*, but could be mentioned syntactically. As
5569   such this breakage has minimal impact.
5570
5571 Language
5572 --------
5573
5574 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5575   matching against dereferenceable values.
5576
5577 Libraries
5578 ---------
5579
5580 * The [`Extend`] trait, which grows a collection from an iterator, is
5581   implemented over iterators of references, for `String`, `Vec`,
5582   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5583   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5584 * The [`iter::once`] function returns an iterator that yields a single
5585   element, and [`iter::empty`] returns an iterator that yields no
5586   elements.
5587 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5588   over substring matches.
5589 * [`Cell`] and [`RefCell`] both implement `Eq`.
5590 * A number of methods for wrapping arithmetic are added to the
5591   integral types, [`wrapping_div`], [`wrapping_rem`],
5592   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5593   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5594   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5595   type.. It is illegal for the default arithmetic operations in Rust
5596   to overflow; the desire to wrap must be explicit.
5597 * The `{:#?}` formatting specifier [displays the alternate,
5598   pretty-printed][debugfmt] form of the `Debug` formatter. This
5599   feature was actually introduced prior to 1.0 with little
5600   fanfare.
5601 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5602   for writing data to formatted strings, similar to [`io::Write`].
5603 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5604   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5605   are used by code generators to emit implementations of [`Debug`].
5606 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5607   methods that convert case, following Unicode case mapping.
5608 * It is now easier to handle poisoned locks. The [`PoisonError`]
5609   type, returned by failing lock operations, exposes `into_inner`,
5610   `get_ref`, and `get_mut`, which all give access to the inner lock
5611   guard, and allow the poisoned lock to continue to operate. The
5612   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5613   poisoned lock without attempting to take the lock.
5614 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5615   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5616   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5617   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5618   `ChildStderr`.
5619 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5620   malformed input.
5621
5622 Misc
5623 ----
5624
5625 * `rustc` employs smarter heuristics for guessing at [typos].
5626 * `rustc` emits more efficient code for [no-op conversions between
5627   unsafe pointers][nop].
5628 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5629   resulting in faster compile times and smaller code.
5630
5631 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5632 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5633 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5634 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5635 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5636 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5637 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5638 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5639 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5640 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5641 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5642 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5643 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5644 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5645 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5646 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5647 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5648 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5649 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5650 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5651 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5652 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5653 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5654 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5655 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5656 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5657 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5658 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5659 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5660 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5661 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5662 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5663 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5664 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5665 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5666 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5667 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5668 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5669 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5670 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5671 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5672 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5673 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5674 [align]: https://github.com/rust-lang/rust/pull/25646
5675 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5676 [typos]: https://github.com/rust-lang/rust/pull/26087
5677 [nop]: https://github.com/rust-lang/rust/pull/26336
5678 [fat]: https://github.com/rust-lang/rust/pull/26411
5679 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5680 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5681 [packed]: https://github.com/rust-lang/rust/pull/25541
5682 [ad]: https://github.com/rust-lang/rust/pull/27382
5683 [win]: https://github.com/rust-lang/rust/pull/25350
5684
5685 Version 1.1.0 (2015-06-25)
5686 =========================
5687
5688 * ~850 changes, numerous bugfixes
5689
5690 Highlights
5691 ----------
5692
5693 * The [`std::fs` module has been expanded][fs] to expand the set of
5694   functionality exposed:
5695   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5696     don't incur a syscall on some platforms.
5697   * A `symlink_metadata` function has been added.
5698   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5699     access to all underlying information.
5700 * The compiler now contains extended explanations of many errors. When an error
5701   with an explanation occurs the compiler suggests using the `--explain` flag
5702   to read the explanation. Error explanations are also [available online][err-index].
5703 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5704   well as other work, the time to bootstrap the compiler decreased by
5705   32%.
5706
5707 Libraries
5708 ---------
5709
5710 * The [`str::split_whitespace`] method splits a string on unicode
5711   whitespace boundaries.
5712 * On both Windows and Unix, new extension traits provide conversion of
5713   I/O types to and from the underlying system handles. On Unix, these
5714   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5715   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5716   `TcpListener`, and `UpdSocket`. Further implementations for
5717   `std::process` will be stabilized later.
5718 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5719   Windows, symlinks can be created with
5720   `std::os::windows::symlink_dir` and
5721   `std::os::windows::symlink_file`.
5722 * The `mpsc::Receiver` type can now be converted into an iterator with
5723   `into_iter` on the [`IntoIterator`] trait.
5724 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5725   implementation of the [`From`] trait.
5726 * The `Debug` implementation for `RangeFull` [creates output that is
5727   more consistent with other implementations][rf].
5728 * [`Debug` is implemented for `File`][file].
5729 * The `Default` implementation for `Arc` [no longer requires `Sync +
5730   Send`][arc].
5731 * [The `Iterator` methods `count`, `nth`, and `last` have been
5732   overridden for slices to have O(1) performance instead of O(n)][si].
5733 * Incorrect handling of paths on Windows has been improved in both the
5734   compiler and the standard library.
5735 * [`AtomicPtr` gained a `Default` implementation][ap].
5736 * In accordance with Rust's policy on arithmetic overflow `abs` now
5737   [panics on overflow when debug assertions are enabled][abs].
5738 * The [`Cloned`] iterator, which was accidentally left unstable for
5739   1.0 [has been stabilized][c].
5740 * The [`Incoming`] iterator, which iterates over incoming TCP
5741   connections, and which was accidentally unnamable in 1.0, [is now
5742   properly exported][inc].
5743 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5744   `sift_up` or `sift_down` panic][bh].
5745 * The [`split_off`] method of `LinkedList` [no longer corrupts
5746   the list in certain scenarios][ll].
5747
5748 Misc
5749 ----
5750
5751 * Type checking performance [has improved notably][sk] with
5752   [multiple improvements][pre].
5753 * The compiler [suggests code changes][ch] for more errors.
5754 * rustc and it's build system have experimental support for [building
5755   toolchains against MUSL][m] instead of glibc on Linux.
5756 * The compiler defines the `target_env` cfg value, which is used for
5757   distinguishing toolchains that are otherwise for the same
5758   platform. Presently this is set to `gnu` for common GNU Linux
5759   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5760 * The [`cargo rustc`][crc] command invokes a build with custom flags
5761   to rustc.
5762 * [Android executables are always position independent][pie].
5763 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5764   with `Drop`][drop].
5765
5766 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5767 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5768 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5769 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5770 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5771 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5772 [rf]: https://github.com/rust-lang/rust/pull/24491
5773 [err-index]: https://doc.rust-lang.org/error-index.html
5774 [sk]: https://github.com/rust-lang/rust/pull/24615
5775 [pre]: https://github.com/rust-lang/rust/pull/25323
5776 [file]: https://github.com/rust-lang/rust/pull/24598
5777 [ch]: https://github.com/rust-lang/rust/pull/24683
5778 [arc]: https://github.com/rust-lang/rust/pull/24695
5779 [si]: https://github.com/rust-lang/rust/pull/24701
5780 [ap]: https://github.com/rust-lang/rust/pull/24834
5781 [m]: https://github.com/rust-lang/rust/pull/24777
5782 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5783 [crc]: https://github.com/rust-lang/cargo/pull/1568
5784 [pie]: https://github.com/rust-lang/rust/pull/24953
5785 [abs]: https://github.com/rust-lang/rust/pull/25441
5786 [c]: https://github.com/rust-lang/rust/pull/25496
5787 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5788 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5789 [inc]: https://github.com/rust-lang/rust/pull/25522
5790 [bh]: https://github.com/rust-lang/rust/pull/25856
5791 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5792 [ll]: https://github.com/rust-lang/rust/pull/26022
5793 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5794 [drop]: https://github.com/rust-lang/rust/pull/24935
5795
5796 Version 1.0.0 (2015-05-15)
5797 ========================
5798
5799 * ~1500 changes, numerous bugfixes
5800
5801 Highlights
5802 ----------
5803
5804 * The vast majority of the standard library is now `#[stable]`. It is
5805   no longer possible to use unstable features with a stable build of
5806   the compiler.
5807 * Many popular crates on [crates.io] now work on the stable release
5808   channel.
5809 * Arithmetic on basic integer types now [checks for overflow in debug
5810   builds][overflow].
5811
5812 Language
5813 --------
5814
5815 * Several [restrictions have been added to trait coherence][coh] in
5816   order to make it easier for upstream authors to change traits
5817   without breaking downstream code.
5818 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5819   improve error messages and macro behavior. For example, `0b1234` is
5820   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5821 * Trait bounds [are always invariant][inv], eliminating the need for
5822   the `PhantomFn` and `MarkerTrait` lang items, which have been
5823   removed.
5824 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5825   "foo" as bar` syntax has been replaced with `extern crate foo as
5826   bar`, and Cargo now automatically translates "-" in *package* names
5827   to underscore for the crate name.
5828 * [Lifetime shadowing is an error][lt].
5829 * [`Send` no longer implies `'static`][send-rfc].
5830 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5831   `MyType::default()`.
5832 * Primitive types [now have inherent methods][prim-inherent],
5833   obviating the need for extension traits like `SliceExt`.
5834 * Methods with `Self: Sized` in their `where` clause are [considered
5835   object-safe][self-sized], allowing many extension traits like
5836   `IteratorExt` to be merged into the traits they extended.
5837 * You can now [refer to associated types][assoc-where] whose
5838   corresponding trait bounds appear only in a `where` clause.
5839 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5840   like `Send` and `Sync` are now library-defined.
5841 * A [Reflect trait][reflect] was introduced, which means that
5842   downcasting via the `Any` trait is effectively limited to concrete
5843   types. This helps retain the potentially-important "parametricity"
5844   property: generic code cannot behave differently for different type
5845   arguments except in minor ways.
5846 * The `unsafe_destructor` feature is now deprecated in favor of the
5847   [new `dropck`][dropck]. This change is a major reduction in unsafe
5848   code.
5849
5850 Libraries
5851 ---------
5852
5853 * The `thread_local` module [has been renamed to `std::thread`][th].
5854 * The methods of `IteratorExt` [have been moved to the `Iterator`
5855   trait itself][ie].
5856 * Several traits that implement Rust's conventions for type
5857   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5858   [centralized in the `std::convert` module][con].
5859 * The `FromError` trait [was removed in favor of `From`][fe].
5860 * The basic sleep function [has moved to
5861   `std::thread::sleep_ms`][slp].
5862 * The `splitn` function now takes an `n` parameter that represents the
5863   number of items yielded by the returned iterator [instead of the
5864   number of 'splits'][spl].
5865 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5866 * [Derived implementations of `PartialOrd` now order enums according
5867   to their explicitly-assigned discriminants][po].
5868 * [Methods for searching strings are generic over `Pattern`s][pat],
5869   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5870   some others.
5871 * [In method resolution, object methods are resolved before inherent
5872   methods][meth].
5873 * [`String::from_str` has been deprecated in favor of the `From` impl,
5874   `String::from`][sf].
5875 * [`io::Error` implements `Sync`][ios].
5876 * [The `words` method on `&str` has been replaced with
5877   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5878   a word?'
5879 * The new path and IO modules are complete and `#[stable]`. This
5880   was the major library focus for this cycle.
5881 * The path API was [revised][path-normalize] to normalize `.`,
5882   adjusting the tradeoffs in favor of the most common usage.
5883 * A large number of remaining APIs in `std` were also stabilized
5884   during this cycle; about 75% of the non-deprecated API surface
5885   is now stable.
5886 * The new [string pattern API][string-pattern] landed, which makes
5887   the string slice API much more internally consistent and flexible.
5888 * A new set of [generic conversion traits][conversion] replaced
5889   many existing ad hoc traits.
5890 * Generic numeric traits were [completely removed][num-traits]. This
5891   was made possible thanks to inherent methods for primitive types,
5892   and the removal gives maximal flexibility for designing a numeric
5893   hierarchy in the future.
5894 * The `Fn` traits are now related via [inheritance][fn-inherit]
5895   and provide ergonomic [blanket implementations][fn-blanket].
5896 * The `Index` and `IndexMut` traits were changed to
5897   [take the index by value][index-value], enabling code like
5898   `hash_map["string"]` to work.
5899 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5900   `Copy` data is known to be `Clone` as well.
5901
5902 Misc
5903 ----
5904
5905 * Many errors now have extended explanations that can be accessed with
5906   the `--explain` flag to `rustc`.
5907 * Many new examples have been added to the standard library
5908   documentation.
5909 * rustdoc has received a number of improvements focused on completion
5910   and polish.
5911 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5912 * Much headway was made on ecosystem-wide CI, making it possible
5913   to [compare builds for breakage][ci-compare].
5914
5915
5916 [crates.io]: http://crates.io
5917 [clo]: https://github.com/rust-lang/rust/pull/24034
5918 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5919 [con]: https://github.com/rust-lang/rust/pull/23875
5920 [cr]: https://github.com/rust-lang/rust/pull/23419
5921 [fe]: https://github.com/rust-lang/rust/pull/23879
5922 [ie]: https://github.com/rust-lang/rust/pull/23300
5923 [inv]: https://github.com/rust-lang/rust/pull/23938
5924 [ios]: https://github.com/rust-lang/rust/pull/24133
5925 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5926 [lt]: https://github.com/rust-lang/rust/pull/24057
5927 [meth]: https://github.com/rust-lang/rust/pull/24056
5928 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5929 [po]: https://github.com/rust-lang/rust/pull/24270
5930 [sf]: https://github.com/rust-lang/rust/pull/24517
5931 [slp]: https://github.com/rust-lang/rust/pull/23949
5932 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5933 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5934 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5935 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5936 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5937 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5938 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5939 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5940 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5941 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5942 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5943 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5944 [reflect]: https://github.com/rust-lang/rust/pull/23712
5945 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5946 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5947 [index-value]: https://github.com/rust-lang/rust/pull/23601
5948 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5949 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5950 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5951 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5952 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5953 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5954
5955
5956 Version 1.0.0-alpha.2 (2015-02-20)
5957 =====================================
5958
5959 * ~1300 changes, numerous bugfixes
5960
5961 * Highlights
5962
5963     * The various I/O modules were [overhauled][io-rfc] to reduce
5964       unnecessary abstractions and provide better interoperation with
5965       the underlying platform. The old `io` module remains temporarily
5966       at `std::old_io`.
5967     * The standard library now [participates in feature gating][feat],
5968       so use of unstable libraries now requires a `#![feature(...)]`
5969       attribute. The impact of this change is [described on the
5970       forum][feat-forum]. [RFC][feat-rfc].
5971
5972 * Language
5973
5974     * `for` loops [now operate on the `IntoIterator` trait][into],
5975       which eliminates the need to call `.iter()`, etc. to iterate
5976       over collections. There are some new subtleties to remember
5977       though regarding what sort of iterators various types yield, in
5978       particular that `for foo in bar { }` yields values from a move
5979       iterator, destroying the original collection. [RFC][into-rfc].
5980     * Objects now have [default lifetime bounds][obj], so you don't
5981       have to write `Box<Trait+'static>` when you don't care about
5982       storing references. [RFC][obj-rfc].
5983     * In types that implement `Drop`, [lifetimes must outlive the
5984       value][drop]. This will soon make it possible to safely
5985       implement `Drop` for types where `#[unsafe_destructor]` is now
5986       required. Read the [gorgeous RFC][drop-rfc] for details.
5987     * The fully qualified <T as Trait>::X syntax lets you set the Self
5988       type for a trait method or associated type. [RFC][ufcs-rfc].
5989     * References to types that implement `Deref<U>` now [automatically
5990       coerce to references][deref] to the dereferenced type `U`,
5991       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5992       should eliminate many unsightly uses of `&*`, as when converting
5993       from references to vectors into references to
5994       slices. [RFC][deref-rfc].
5995     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5996       `|:|`) is obsolete and closure kind is inferred from context.
5997     * [`Self` is a keyword][Self].
5998
5999 * Libraries
6000
6001     * The `Show` and `String` formatting traits [have been
6002       renamed][fmt] to `Debug` and `Display` to more clearly reflect
6003       their related purposes. Automatically getting a string
6004       conversion to use with `format!("{:?}", something_to_debug)` is
6005       now written `#[derive(Debug)]`.
6006     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
6007       OsStr}`, provide strings in platform-specific encodings for easier
6008       interop with system APIs. [RFC][osstr-rfc].
6009     * The `boxed::into_raw` and `Box::from_raw` functions [convert
6010       between `Box<T>` and `*mut T`][boxraw], a common pattern for
6011       creating raw pointers.
6012
6013 * Tooling
6014
6015     * Certain long error messages of the form 'expected foo found bar'
6016       are now [split neatly across multiple
6017       lines][multiline]. Examples in the PR.
6018     * On Unix Rust can be [uninstalled][un] by running
6019       `/usr/local/lib/rustlib/uninstall.sh`.
6020     * The `#[rustc_on_unimplemented]` attribute, requiring the
6021       'on_unimplemented' feature, lets rustc [display custom error
6022       messages when a trait is expected to be implemented for a type
6023       but is not][onun].
6024
6025 * Misc
6026
6027     * Rust is tested against a [LALR grammar][lalr], which parses
6028       almost all the Rust files that rustc does.
6029
6030 [boxraw]: https://github.com/rust-lang/rust/pull/21318
6031 [close]: https://github.com/rust-lang/rust/pull/21843
6032 [deref]: https://github.com/rust-lang/rust/pull/21351
6033 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
6034 [drop]: https://github.com/rust-lang/rust/pull/21972
6035 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6036 [feat]: https://github.com/rust-lang/rust/pull/21248
6037 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
6038 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
6039 [fmt]: https://github.com/rust-lang/rust/pull/21457
6040 [into]: https://github.com/rust-lang/rust/pull/20790
6041 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
6042 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6043 [lalr]: https://github.com/rust-lang/rust/pull/21452
6044 [multiline]: https://github.com/rust-lang/rust/pull/19870
6045 [obj]: https://github.com/rust-lang/rust/pull/22230
6046 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
6047 [onun]: https://github.com/rust-lang/rust/pull/20889
6048 [osstr]: https://github.com/rust-lang/rust/pull/21488
6049 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6050 [Self]: https://github.com/rust-lang/rust/pull/22158
6051 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
6052 [un]: https://github.com/rust-lang/rust/pull/22256
6053
6054
6055 Version 1.0.0-alpha (2015-01-09)
6056 ==================================
6057
6058   * ~2400 changes, numerous bugfixes
6059
6060   * Highlights
6061
6062     * The language itself is considered feature complete for 1.0,
6063       though there will be many usability improvements and bugfixes
6064       before the final release.
6065     * Nearly 50% of the public API surface of the standard library has
6066       been declared 'stable'. Those interfaces are unlikely to change
6067       before 1.0.
6068     * The long-running debate over integer types has been
6069       [settled][ints]: Rust will ship with types named `isize` and
6070       `usize`, rather than `int` and `uint`, for pointer-sized
6071       integers. Guidelines will be rolled out during the alpha cycle.
6072     * Most crates that are not `std` have been moved out of the Rust
6073       distribution into the Cargo ecosystem so they can evolve
6074       separately and don't need to be stabilized as quickly, including
6075       'time', 'getopts', 'num', 'regex', and 'term'.
6076     * Documentation continues to be expanded with more API coverage, more
6077       examples, and more in-depth explanations. The guides have been
6078       consolidated into [The Rust Programming Language][trpl].
6079     * "[Rust By Example][rbe]" is now maintained by the Rust team.
6080     * All official Rust binary installers now come with [Cargo], the
6081       Rust package manager.
6082
6083 * Language
6084
6085     * Closures have been [completely redesigned][unboxed] to be
6086       implemented in terms of traits, can now be used as generic type
6087       bounds and thus monomorphized and inlined, or via an opaque
6088       pointer (boxed) as in the old system. The new system is often
6089       referred to as 'unboxed' closures.
6090     * Traits now support [associated types][assoc], allowing families
6091       of related types to be defined together and used generically in
6092       powerful ways.
6093     * Enum variants are [namespaced by their type names][enum].
6094     * [`where` clauses][where] provide a more versatile and attractive
6095       syntax for specifying generic bounds, though the previous syntax
6096       remains valid.
6097     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
6098       numeric types.
6099     * Rust [no longer has a runtime][rt] of any description, and only
6100       supports OS threads, not green threads.
6101     * At long last, Rust has been overhauled for 'dynamically-sized
6102       types' ([DST]), which integrates 'fat pointers' (object types,
6103       arrays, and `str`) more deeply into the type system, making it
6104       more consistent.
6105     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
6106       `..j` that produce range types and which, when combined with the
6107       `Index` operator and multidispatch, leads to a convenient slice
6108       notation, `[i..j]`.
6109     * The new range syntax revealed an ambiguity in the fixed-length
6110       array syntax, so now fixed length arrays [are written `[T;
6111       N]`][arrays].
6112     * The `Copy` trait is no longer implemented automatically. Unsafe
6113       pointers no longer implement `Sync` and `Send` so types
6114       containing them don't automatically either. `Sync` and `Send`
6115       are now 'unsafe traits' so one can "forcibly" implement them via
6116       `unsafe impl` if a type confirms to the requirements for them
6117       even though the internals do not (e.g. structs containing unsafe
6118       pointers like `Arc`). These changes are intended to prevent some
6119       footguns and are collectively known as [opt-in built-in
6120       traits][oibit] (though `Sync` and `Send` will soon become pure
6121       library types unknown to the compiler).
6122     * Operator traits now take their operands [by value][ops], and
6123       comparison traits can use multidispatch to compare one type
6124       against multiple other types, allowing e.g. `String` to be
6125       compared with `&str`.
6126     * `if let` and `while let` are no longer feature-gated.
6127     * Rust has adopted a more [uniform syntax for escaping unicode
6128       characters][unicode].
6129     * `macro_rules!` [has been declared stable][mac]. Though it is a
6130       flawed system it is sufficiently popular that it must be usable
6131       for 1.0. Effort has gone into [future-proofing][mac-future] it
6132       in ways that will allow other macro systems to be developed in
6133       parallel, and won't otherwise impact the evolution of the
6134       language.
6135     * The prelude has been [pared back significantly][prelude] such
6136       that it is the minimum necessary to support the most pervasive
6137       code patterns, and through [generalized where clauses][where]
6138       many of the prelude extension traits have been consolidated.
6139     * Rust's rudimentary reflection [has been removed][refl], as it
6140       incurred too much code generation for little benefit.
6141     * [Struct variants][structvars] are no longer feature-gated.
6142     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
6143       known as 'higher-ranked trait bounds', this crucially allows
6144       unboxed closures to work.
6145     * Macros invocations surrounded by parens or square brackets and
6146       not terminated by a semicolon are [parsed as
6147       expressions][macros], which makes expressions like `vec![1i32,
6148       2, 3].len()` work as expected.
6149     * Trait objects now implement their traits automatically, and
6150       traits that can be coerced to objects now must be [object
6151       safe][objsafe].
6152     * Automatically deriving traits is now done with `#[derive(...)]`
6153       not `#[deriving(...)]` for [consistency with other naming
6154       conventions][derive].
6155     * Importing the containing module or enum at the same time as
6156       items or variants they contain is [now done with `self` instead
6157       of `mod`][self], as in use `foo::{self, bar}`
6158     * Glob imports are no longer feature-gated.
6159     * The `box` operator and `box` patterns have been feature-gated
6160       pending a redesign. For now unique boxes should be allocated
6161       like other containers, with `Box::new`.
6162
6163 * Libraries
6164
6165     * A [series][coll1] of [efforts][coll2] to establish
6166       [conventions][coll3] for collections types has resulted in API
6167       improvements throughout the standard library.
6168     * New [APIs for error handling][err] provide ergonomic interop
6169       between error types, and [new conventions][err-conv] describe
6170       more clearly the recommended error handling strategies in Rust.
6171     * The `fail!` macro has been renamed to [`panic!`][panic] so that
6172       it is easier to discuss failure in the context of error handling
6173       without making clarifications as to whether you are referring to
6174       the 'fail' macro or failure more generally.
6175     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
6176       syscall when available.
6177     * The 'serialize' crate has been renamed 'rustc-serialize' and
6178       moved out of the distribution to Cargo. Although it is widely
6179       used now, it is expected to be superseded in the near future.
6180     * The `Show` formatter, typically implemented with
6181       `#[derive(Show)]` is [now requested with the `{:?}`
6182       specifier][show] and is intended for use by all types, for uses
6183       such as `println!` debugging. The new `String` formatter must be
6184       implemented by hand, uses the `{}` specifier, and is intended
6185       for full-fidelity conversions of things that can logically be
6186       represented as strings.
6187
6188 * Tooling
6189
6190     * [Flexible target specification][flex] allows rustc's code
6191       generation to be configured to support otherwise-unsupported
6192       platforms.
6193     * Rust comes with rust-gdb and rust-lldb scripts that launch their
6194       respective debuggers with Rust-appropriate pretty-printing.
6195     * The Windows installation of Rust is distributed with the
6196       MinGW components currently required to link binaries on that
6197       platform.
6198
6199 * Misc
6200
6201     * Nullable enum optimizations have been extended to more types so
6202       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
6203       space than the inner types themselves.
6204     * Work has begun on supporting AArch64.
6205
6206 [Cargo]: https://crates.io
6207 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
6208 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
6209 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
6210 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
6211 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
6212 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
6213 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
6214 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
6215 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
6216 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
6217 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
6218 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
6219 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
6220 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
6221 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
6222 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
6223 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
6224 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
6225 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
6226 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
6227 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
6228 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
6229 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
6230 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
6231 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
6232 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
6233 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
6234 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
6235 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
6236 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
6237 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
6238 [trpl]: https://doc.rust-lang.org/book/index.html
6239 [rbe]: http://rustbyexample.com/
6240
6241
6242 Version 0.12.0 (2014-10-09)
6243 =============================
6244
6245   * ~1900 changes, numerous bugfixes
6246
6247   * Highlights
6248
6249     * The introductory documentation (now called The Rust Guide) has
6250       been completely rewritten, as have a number of supplementary
6251       guides.
6252     * Rust's package manager, Cargo, continues to improve and is
6253       sometimes considered to be quite awesome.
6254     * Many API's in `std` have been reviewed and updated for
6255       consistency with the in-development Rust coding
6256       guidelines. The standard library documentation tracks
6257       stabilization progress.
6258     * Minor libraries have been moved out-of-tree to the rust-lang org
6259       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
6260       be installed with Cargo.
6261     * Lifetime elision allows lifetime annotations to be left off of
6262       function declarations in many common scenarios.
6263     * Rust now works on 64-bit Windows.
6264
6265   * Language
6266     * Indexing can be overloaded with the `Index` and `IndexMut`
6267       traits.
6268     * The `if let` construct takes a branch only if the `let` pattern
6269       matches, currently behind the 'if_let' feature gate.
6270     * 'where clauses', a more flexible syntax for specifying trait
6271       bounds that is more aesthetic, have been added for traits and
6272       free functions. Where clauses will in the future make it
6273       possible to constrain associated types, which would be
6274       impossible with the existing syntax.
6275     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
6276       the 'slicing_syntax' feature gate, and can be overloaded with
6277       the `Slice` or `SliceMut` traits.
6278     * The syntax for matching of sub-slices has been changed to use a
6279       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
6280       consistency with other uses of `..` and to future-proof
6281       potential additional uses of the syntax.
6282     * The syntax for matching inclusive ranges in patterns has changed
6283       from `0..3` to `0...4` to be consistent with the exclusive range
6284       syntax for slicing.
6285     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
6286       c]`) has been put behind the 'advanced_slice_patterns' feature
6287       gate and may be removed in the future.
6288     * Components of tuples and tuple structs can be extracted using
6289       the `value.0` syntax, currently behind the `tuple_indexing`
6290       feature gate.
6291     * The `#[crate_id]` attribute is no longer supported; versioning
6292       is handled by the package manager.
6293     * Renaming crate imports are now written `extern crate foo as bar`
6294       instead of `extern crate bar = foo`.
6295     * Renaming use statements are now written `use foo as bar` instead
6296       of `use bar = foo`.
6297     * `let` and `match` bindings and argument names in macros are now
6298       hygienic.
6299     * The new, more efficient, closure types ('unboxed closures') have
6300       been added under a feature gate, 'unboxed_closures'. These will
6301       soon replace the existing closure types, once higher-ranked
6302       trait lifetimes are added to the language.
6303     * `move` has been added as a keyword, for indicating closures
6304       that capture by value.
6305     * Mutation and assignment is no longer allowed in pattern guards.
6306     * Generic structs and enums can now have trait bounds.
6307     * The `Share` trait is now called `Sync` to free up the term
6308       'shared' to refer to 'shared reference' (the default reference
6309       type.
6310     * Dynamically-sized types have been mostly implemented,
6311       unifying the behavior of fat-pointer types with the rest of the
6312       type system.
6313     * As part of dynamically-sized types, the `Sized` trait has been
6314       introduced, which qualifying types implement by default, and
6315       which type parameters expect by default. To specify that a type
6316       parameter does not need to be sized, write `<Sized? T>`. Most
6317       types are `Sized`, notable exceptions being unsized arrays
6318       (`[T]`) and trait types.
6319     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
6320     * Lifetime bounds can now be applied to type parameters and object
6321       types.
6322     * The old, reference counted GC type, `Gc<T>` which was once
6323       denoted by the `@` sigil, has finally been removed. GC will be
6324       revisited in the future.
6325
6326   * Libraries
6327     * Library documentation has been improved for a number of modules.
6328     * Bit-vectors, collections::bitv has been modernized.
6329     * The url crate is deprecated in favor of
6330       http://github.com/servo/rust-url, which can be installed with
6331       Cargo.
6332     * Most I/O stream types can be cloned and subsequently closed from
6333       a different thread.
6334     * A `std::time::Duration` type has been added for use in I/O
6335       methods that rely on timers, as well as in the 'time' crate's
6336       `Timespec` arithmetic.
6337     * The runtime I/O abstraction layer that enabled the green thread
6338       scheduler to do non-thread-blocking I/O has been removed, along
6339       with the libuv-based implementation employed by the green thread
6340       scheduler. This will greatly simplify the future I/O work.
6341     * `collections::btree` has been rewritten to have a more
6342       idiomatic and efficient design.
6343
6344   * Tooling
6345     * rustdoc output now indicates the stability levels of API's.
6346     * The `--crate-name` flag can specify the name of the crate
6347       being compiled, like `#[crate_name]`.
6348     * The `-C metadata` specifies additional metadata to hash into
6349       symbol names, and `-C extra-filename` specifies additional
6350       information to put into the output filename, for use by the
6351       package manager for versioning.
6352     * debug info generation has continued to improve and should be
6353       more reliable under both gdb and lldb.
6354     * rustc has experimental support for compiling in parallel
6355       using the `-C codegen-units` flag.
6356     * rustc no longer encodes rpath information into binaries by
6357       default.
6358
6359   * Misc
6360     * Stack usage has been optimized with LLVM lifetime annotations.
6361     * Official Rust binaries on Linux are more compatible with older
6362       kernels and distributions, built on CentOS 5.10.
6363
6364
6365 Version 0.11.0 (2014-07-02)
6366 ==========================
6367
6368   * ~1700 changes, numerous bugfixes
6369
6370   * Language
6371     * ~[T] has been removed from the language. This type is superseded by
6372       the Vec<T> type.
6373     * ~str has been removed from the language. This type is superseded by
6374       the String type.
6375     * ~T has been removed from the language. This type is superseded by the
6376       Box<T> type.
6377     * @T has been removed from the language. This type is superseded by the
6378       standard library's std::gc::Gc<T> type.
6379     * Struct fields are now all private by default.
6380     * Vector indices and shift amounts are both required to be a `uint`
6381       instead of any integral type.
6382     * Byte character, byte string, and raw byte string literals are now all
6383       supported by prefixing the normal literal with a `b`.
6384     * Multiple ABIs are no longer allowed in an ABI string
6385     * The syntax for lifetimes on closures/procedures has been tweaked
6386       slightly: `<'a>|A, B|: 'b + K -> T`
6387     * Floating point modulus has been removed from the language; however it
6388       is still provided by a library implementation.
6389     * Private enum variants are now disallowed.
6390     * The `priv` keyword has been removed from the language.
6391     * A closure can no longer be invoked through a &-pointer.
6392     * The `use foo, bar, baz;` syntax has been removed from the language.
6393     * The transmute intrinsic no longer works on type parameters.
6394     * Statics now allow blocks/items in their definition.
6395     * Trait bounds are separated from objects with + instead of : now.
6396     * Objects can no longer be read while they are mutably borrowed.
6397     * The address of a static is now marked as insignificant unless the
6398       #[inline(never)] attribute is placed it.
6399     * The #[unsafe_destructor] attribute is now behind a feature gate.
6400     * Struct literals are no longer allowed in ambiguous positions such as
6401       if, while, match, and for..in.
6402     * Declaration of lang items and intrinsics are now feature-gated by
6403       default.
6404     * Integral literals no longer default to `int`, and floating point
6405       literals no longer default to `f64`. Literals must be suffixed with an
6406       appropriate type if inference cannot determine the type of the
6407       literal.
6408     * The Box<T> type is no longer implicitly borrowed to &mut T.
6409     * Procedures are now required to not capture borrowed references.
6410
6411   * Libraries
6412     * The standard library is now a "facade" over a number of underlying
6413       libraries. This means that development on the standard library should
6414       be speedier due to smaller crates, as well as a clearer line between
6415       all dependencies.
6416     * A new library, libcore, lives under the standard library's facade
6417       which is Rust's "0-assumption" library, suitable for embedded and
6418       kernel development for example.
6419     * A regex crate has been added to the standard distribution. This crate
6420       includes statically compiled regular expressions.
6421     * The unwrap/unwrap_err methods on Result require a Show bound for
6422       better error messages.
6423     * The return types of the std::comm primitives have been centralized
6424       around the Result type.
6425     * A number of I/O primitives have gained the ability to time out their
6426       operations.
6427     * A number of I/O primitives have gained the ability to close their
6428       reading/writing halves to cancel pending operations.
6429     * Reverse iterator methods have been removed in favor of `rev()` on
6430       their forward-iteration counterparts.
6431     * A bitflags! macro has been added to enable easy interop with C and
6432       management of bit flags.
6433     * A debug_assert! macro is now provided which is disabled when
6434       `--cfg ndebug` is passed to the compiler.
6435     * A graphviz crate has been added for creating .dot files.
6436     * The std::cast module has been migrated into std::mem.
6437     * The std::local_data api has been migrated from freestanding functions
6438       to being based on methods.
6439     * The Pod trait has been renamed to Copy.
6440     * jemalloc has been added as the default allocator for types.
6441     * The API for allocating memory has been changed to use proper alignment
6442       and sized deallocation
6443     * Connecting a TcpStream or binding a TcpListener is now based on a
6444       string address and a u16 port. This allows connecting to a hostname as
6445       opposed to an IP.
6446     * The Reader trait now contains a core method, read_at_least(), which
6447       correctly handles many repeated 0-length reads.
6448     * The process-spawning API is now centered around a builder-style
6449       Command struct.
6450     * The :? printing qualifier has been moved from the standard library to
6451       an external libdebug crate.
6452     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
6453       have been renamed to Eq/Ord.
6454     * The select/plural methods have been removed from format!. The escapes
6455       for { and } have also changed from \{ and \} to {{ and }},
6456       respectively.
6457     * The TaskBuilder API has been re-worked to be a true builder, and
6458       extension traits for spawning native/green tasks have been added.
6459
6460   * Tooling
6461     * All breaking changes to the language or libraries now have their
6462       commit message annotated with `[breaking-change]` to allow for easy
6463       discovery of breaking changes.
6464     * The compiler will now try to suggest how to annotate lifetimes if a
6465       lifetime-related error occurs.
6466     * Debug info continues to be improved greatly with general bug fixes and
6467       better support for situations like link time optimization (LTO).
6468     * Usage of syntax extensions when cross-compiling has been fixed.
6469     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6470       -fdata-sections and --gc-sections has been enabled by default
6471     * The compiler is now stricter about where it will load module files
6472       from when a module is declared via `mod foo;`.
6473     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6474       Syntax extensions are now discovered via a "plugin registrar" type
6475       which will be extended in the future to other various plugins.
6476     * Lints have been restructured to allow for dynamically loadable lints.
6477     * A number of rustdoc improvements:
6478       * The HTML output has been visually redesigned.
6479       * Markdown is now powered by hoedown instead of sundown.
6480       * Searching heuristics have been greatly improved.
6481       * The search index has been reduced in size by a great amount.
6482       * Cross-crate documentation via `pub use` has been greatly improved.
6483       * Primitive types are now hyperlinked and documented.
6484     * Documentation has been moved from static.rust-lang.org/doc to
6485       doc.rust-lang.org
6486     * A new sandbox, play.rust-lang.org, is available for running and
6487       sharing rust code examples on-line.
6488     * Unused attributes are now more robustly warned about.
6489     * The dead_code lint now warns about unused struct fields.
6490     * Cross-compiling to iOS is now supported.
6491     * Cross-compiling to mipsel is now supported.
6492     * Stability attributes are now inherited by default and no longer apply
6493       to intra-crate usage, only inter-crate usage.
6494     * Error message related to non-exhaustive match expressions have been
6495       greatly improved.
6496
6497
6498 Version 0.10 (2014-04-03)
6499 =========================
6500
6501   * ~1500 changes, numerous bugfixes
6502
6503   * Language
6504     * A new RFC process is now in place for modifying the language.
6505     * Patterns with `@`-pointers have been removed from the language.
6506     * Patterns with unique vectors (`~[T]`) have been removed from the
6507       language.
6508     * Patterns with unique strings (`~str`) have been removed from the
6509       language.
6510     * `@str` has been removed from the language.
6511     * `@[T]` has been removed from the language.
6512     * `@self` has been removed from the language.
6513     * `@Trait` has been removed from the language.
6514     * Headers on `~` allocations which contain `@` boxes inside the type for
6515       reference counting have been removed.
6516     * The semantics around the lifetimes of temporary expressions have changed,
6517       see #3511 and #11585 for more information.
6518     * Cross-crate syntax extensions are now possible, but feature gated. See
6519       #11151 for more information. This includes both `macro_rules!` macros as
6520       well as syntax extensions such as `format!`.
6521     * New lint modes have been added, and older ones have been turned on to be
6522       warn-by-default.
6523       * Unnecessary parentheses
6524       * Uppercase statics
6525       * Camel Case types
6526       * Uppercase variables
6527       * Publicly visible private types
6528       * `#[deriving]` with raw pointers
6529     * Unsafe functions can no longer be coerced to closures.
6530     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6531     * The `#[simd]` attribute is now behind a feature gate.
6532     * Visibility is no longer allowed on `extern crate` statements, and
6533       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6534     * Trailing commas are now allowed in argument lists and tuple patterns.
6535     * The `do` keyword has been removed, it is now a reserved keyword.
6536     * Default type parameters have been implemented, but are feature gated.
6537     * Borrowed variables through captures in closures are now considered soundly.
6538     * `extern mod` is now `extern crate`
6539     * The `Freeze` trait has been removed.
6540     * The `Share` trait has been added for types that can be shared among
6541       threads.
6542     * Labels in macros are now hygienic.
6543     * Expression/statement macro invocations can be delimited with `{}` now.
6544     * Treatment of types allowed in `static mut` locations has been tweaked.
6545     * The `*` and `.` operators are now overloadable through the `Deref` and
6546       `DerefMut` traits.
6547     * `~Trait` and `proc` no longer have `Send` bounds by default.
6548     * Partial type hints are now supported with the `_` type marker.
6549     * An `Unsafe` type was introduced for interior mutability. It is now
6550       considered undefined to transmute from `&T` to `&mut T` without using the
6551       `Unsafe` type.
6552     * The #[linkage] attribute was implemented for extern statics/functions.
6553     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6554     * `Pod` was renamed to `Copy`.
6555
6556   * Libraries
6557     * The `libextra` library has been removed. It has now been decomposed into
6558       component libraries with smaller and more focused nuggets of
6559       functionality. The full list of libraries can be found on the
6560       documentation index page.
6561     * std: `std::condition` has been removed. All I/O errors are now propagated
6562       through the `Result` type. In order to assist with error handling, a
6563       `try!` macro for unwrapping errors with an early return and a lint for
6564       unused results has been added. See #12039 for more information.
6565     * std: The `vec` module has been renamed to `slice`.
6566     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6567       This will become the only growable vector in the future.
6568     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6569       are now found at `std::io::BufferedReader` instead of
6570       `std::io::buffered::BufferedReader`.
6571     * std: `print` and `println` are no longer in the prelude, the `print!` and
6572       `println!` macros are intended to be used instead.
6573     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6574       attempts to statically prevent cycles.
6575     * std: The standard distribution is adopting the policy of pushing failure
6576       to the user rather than failing in libraries. Many functions (such as
6577       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6578     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6579       deriving mode: `#[deriving(Show)]`.
6580     * std: `ToStr` is now implemented for all types implementing `Show`.
6581     * std: The formatting trait methods now take `&self` instead of `&T`
6582     * std: The `invert()` method on iterators has been renamed to `rev()`
6583     * std: `std::num` has seen a reduction in the genericity of its traits,
6584       consolidating functionality into a few core traits.
6585     * std: Backtraces are now printed on task failure if the environment
6586       variable `RUST_BACKTRACE` is present.
6587     * std: Naming conventions for iterators have been standardized. More details
6588       can be found on the wiki's style guide.
6589     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6590       still implement the function.
6591     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6592     * std: `assert_approx_eq!` has been removed
6593     * std: The `e` and `E` formatting specifiers for floats have been added to
6594       print them in exponential notation.
6595     * std: The `Times` trait has been removed
6596     * std: Indications of variance and opting out of builtin bounds is done
6597       through marker types in `std::kinds::marker` now
6598     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6599       `#[deriving(Hash)]` is now possible.
6600     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6601     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6602     * std: `Chan::new` is now `channel()`.
6603     * std: A new synchronous channel type has been implemented.
6604     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6605     * std: `hashmap` and `trie` have been moved to `libcollections`
6606     * std: `run` has been rolled into `io::process`
6607     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6608     * std: The equality and comparison traits have seen some reorganization.
6609     * std: `rand` has moved to `librand`.
6610     * std: `to_{lower,upper}case` has been implemented for `char`.
6611     * std: Logging has been moved to `liblog`.
6612     * collections: `HashMap` has been rewritten for higher performance and less
6613       memory usage.
6614     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6615       it can be booted manually. The runtime guide has more information and
6616       examples.
6617     * native: All I/O functionality except signals has been implemented.
6618     * green: Task spawning with `libgreen` has been optimized with stack caching
6619       and various trimming of code.
6620     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6621     * sync: The `extra::sync` module has been updated to modern rust (and moved
6622       to the `sync` library), tweaking and improving various interfaces while
6623       dropping redundant functionality.
6624     * sync: A new `Barrier` type has been added to the `sync` library.
6625     * sync: An efficient mutex for native and green tasks has been implemented.
6626     * serialize: The `base64` module has seen some improvement. It treats
6627       newlines better, has non-string error values, and has seen general
6628       cleanup.
6629     * fourcc: A `fourcc!` macro was introduced
6630     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6631       hexadecimal literal.
6632
6633   * Tooling
6634     * `rustpkg` has been deprecated and removed from the main repository. Its
6635       replacement, `cargo`, is under development.
6636     * Nightly builds of rust are now available
6637     * The memory usage of rustc has been improved many times throughout this
6638       release cycle.
6639     * The build process supports disabling rpath support for the rustc binary
6640       itself.
6641     * Code generation has improved in some cases, giving more information to the
6642       LLVM optimization passes to enable more extensive optimizations.
6643     * Debuginfo compatibility with lldb on OSX has been restored.
6644     * The master branch is now gated on an android bot, making building for
6645       android much more reliable.
6646     * Output flags have been centralized into one `--emit` flag.
6647     * Crate type flags have been centralized into one `--crate-type` flag.
6648     * Codegen flags have been consolidated behind a `-C` flag.
6649     * Linking against outdated crates now has improved error messages.
6650     * Error messages with lifetimes will often suggest how to annotate the
6651       function to fix the error.
6652     * Many more types are documented in the standard library, and new guides
6653       were written.
6654     * Many `rustdoc` improvements:
6655       * code blocks are syntax highlighted.
6656       * render standalone markdown files.
6657       * the --test flag tests all code blocks by default.
6658       * exported macros are displayed.
6659       * re-exported types have their documentation inlined at the location of the
6660         first re-export.
6661       * search works across crates that have been rendered to the same output
6662         directory.
6663
6664
6665 Version 0.9 (2014-01-09)
6666 ==========================
6667
6668    * ~1800 changes, numerous bugfixes
6669
6670    * Language
6671       * The `float` type has been removed. Use `f32` or `f64` instead.
6672       * A new facility for enabling experimental features (feature gating) has
6673         been added, using the crate-level `#[feature(foo)]` attribute.
6674       * Managed boxes (@) are now behind a feature gate
6675         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6676         standard library's `Gc` or `Rc` types instead.
6677       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6678       * Jumping back to the top of a loop is now done with `continue` instead of
6679         `loop`.
6680       * Strings can no longer be mutated through index assignment.
6681       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6682         hash delimiters, as in `r###"foo"###`.
6683       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6684         called once.
6685       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6686       * `@fn`s have been removed.
6687       * `do` only works with procs in order to make it obvious what the cost
6688         of `do` is.
6689       * Single-element tuple-like structs can no longer be dereferenced to
6690         obtain the inner value. A more comprehensive solution for overloading
6691         the dereference operator will be provided in the future.
6692       * The `#[link(...)]` attribute has been replaced with
6693         `#[crate_id = "name#vers"]`.
6694       * Empty `impl`s must be terminated with empty braces and may not be
6695         terminated with a semicolon.
6696       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6697         no longer has any special meaning.
6698       * The old `fmt!` string formatting macro has been removed.
6699       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6700         `print!` and `println!`.
6701       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6702       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6703         `extern mod foo = "bar"` instead.
6704       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6705       * Macros can have attributes.
6706       * Macros can expand to items with attributes.
6707       * Macros can expand to multiple items.
6708       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6709       * Comments may be nested.
6710       * Values automatically coerce to trait objects they implement, without
6711         an explicit `as`.
6712       * Enum discriminants are no longer an entire word but as small as needed to
6713         contain all the variants. The `repr` attribute can be used to override
6714         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6715         `#[repr(C)]` to match C enums.
6716       * Non-string literals are not allowed in attributes (they never worked).
6717       * The FFI now supports variadic functions.
6718       * Octal numeric literals, as in `0o7777`.
6719       * The `concat!` syntax extension performs compile-time string concatenation.
6720       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6721         removed as Rust no longer uses segmented stacks.
6722       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6723       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6724         not `*`; ignoring remaining fields of a struct is also done with `..`,
6725         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6726       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6727       * `rustc` supports the "system" calling convention, which defaults to the
6728         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6729         "C" elsewhere.
6730       * The `type_overflow` lint (default: warn) checks literals for overflow.
6731       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6732       * The `attribute_usage` lint (default: warn) warns about unknown
6733         attributes.
6734       * The `unknown_features` lint (default: warn) warns about unknown
6735         feature gates.
6736       * The `dead_code` lint (default: warn) checks for dead code.
6737       * Rust libraries can be linked statically to one another
6738       * `#[link_args]` is behind the `link_args` feature gate.
6739       * Native libraries are now linked with `#[link(name = "foo")]`
6740       * Native libraries can be statically linked to a rust crate
6741         (`#[link(name = "foo", kind = "static")]`).
6742       * Native OS X frameworks are now officially supported
6743         (`#[link(name = "foo", kind = "framework")]`).
6744       * The `#[thread_local]` attribute creates thread-local (not task-local)
6745         variables. Currently behind the `thread_local` feature gate.
6746       * The `return` keyword may be used in closures.
6747       * Types that can be copied via a memcpy implement the `Pod` kind.
6748       * The `cfg` attribute can now be used on struct fields and enum variants.
6749
6750    * Libraries
6751       * std: The `option` and `result` API's have been overhauled to make them
6752         simpler, more consistent, and more composable.
6753       * std: The entire `std::io` module has been replaced with one that is
6754         more comprehensive and that properly interfaces with the underlying
6755         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6756         implemented.
6757       * std: `io::util` contains a number of useful implementations of
6758         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6759         `ZeroReader`, `TeeReader`.
6760       * std: The reference counted pointer type `extra::rc` moved into std.
6761       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6762         just a wrapper around it).
6763       * std: The `Either` type has been removed.
6764       * std: `fmt::Default` can be implemented for any type to provide default
6765         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6766       * std: The `rand` API continues to be tweaked.
6767       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6768         on failure in gdb, is now named `rust_fail`.
6769       * std: The `each_key` and `each_value` methods on `HashMap` have been
6770         replaced by the `keys` and `values` iterators.
6771       * std: Functions dealing with type size and alignment have moved from the
6772         `sys` module to the `mem` module.
6773       * std: The `path` module was written and API changed.
6774       * std: `str::from_utf8` has been changed to cast instead of allocate.
6775       * std: `starts_with` and `ends_with` methods added to vectors via the
6776         `ImmutableEqVector` trait, which is in the prelude.
6777       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6778         if the index is out of bounds.
6779       * std: Task failure no longer propagates between tasks, as the model was
6780         complex, expensive, and incompatible with thread-based tasks.
6781       * std: The `Any` type can be used for dynamic typing.
6782       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6783         `task::try`.
6784       * std: Methods that produce iterators generally do not have an `_iter`
6785         suffix now.
6786       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6787         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6788       * std: `util::ignore` renamed to `prelude::drop`.
6789       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6790         trait.
6791       * std: `vec::raw` has seen a lot of cleanup and API changes.
6792       * std: The standard library no longer includes any C++ code, and very
6793         minimal C, eliminating the dependency on libstdc++.
6794       * std: Runtime scheduling and I/O functionality has been factored out into
6795         extensible interfaces and is now implemented by two different crates:
6796         libnative, for native threading and I/O; and libgreen, for green threading
6797         and I/O. This paves the way for using the standard library in more limited
6798         embedded environments.
6799       * std: The `comm` module has been rewritten to be much faster, have a
6800         simpler, more consistent API, and to work for both native and green
6801         threading.
6802       * std: All libuv dependencies have been moved into the rustuv crate.
6803       * native: New implementations of runtime scheduling on top of OS threads.
6804       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6805         and other I/O.
6806       * green: The green thread scheduler and message passing types are almost
6807         entirely lock-free.
6808       * extra: The `flatpipes` module had bitrotted and was removed.
6809       * extra: All crypto functions have been removed and Rust now has a policy of
6810         not reimplementing crypto in the standard library. In the future crypto
6811         will be provided by external crates with bindings to established libraries.
6812       * extra: `c_vec` has been modernized.
6813       * extra: The `sort` module has been removed. Use the `sort` method on
6814         mutable slices.
6815
6816    * Tooling
6817       * The `rust` and `rusti` commands have been removed, due to lack of
6818         maintenance.
6819       * `rustdoc` was completely rewritten.
6820       * `rustdoc` can test code examples in documentation.
6821       * `rustpkg` can test packages with the argument, 'test'.
6822       * `rustpkg` supports arbitrary dependencies, including C libraries.
6823       * `rustc`'s support for generating debug info is improved again.
6824       * `rustc` has better error reporting for unbalanced delimiters.
6825       * `rustc`'s JIT support was removed due to bitrot.
6826       * Executables and static libraries can be built with LTO (-Z lto)
6827       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6828         build tools.
6829
6830
6831 Version 0.8 (2013-09-26)
6832 ============================
6833
6834    * ~2200 changes, numerous bugfixes
6835
6836    * Language
6837       * The `for` loop syntax has changed to work with the `Iterator` trait.
6838       * At long last, unwinding works on Windows.
6839       * Default methods are ready for use.
6840       * Many trait inheritance bugs fixed.
6841       * Owned and borrowed trait objects work more reliably.
6842       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6843       * rustc can omit emission of code for the `debug!` macro if it is passed
6844         `--cfg ndebug`
6845       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6846         for foo.rs, then foo/mod.rs, and will generate an error when both are
6847         present.
6848       * Strings no longer contain trailing nulls. The new `std::c_str` module
6849         provides new mechanisms for converting to C strings.
6850       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6851       * The FFI has been overhauled such that foreign functions are called directly,
6852         instead of through a stack-switching wrapper.
6853       * Calling a foreign function must be done through a Rust function with the
6854         `#[fixed_stack_segment]` attribute.
6855       * The `externfn!` macro can be used to declare both a foreign function and
6856         a `#[fixed_stack_segment]` wrapper at once.
6857       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6858       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6859       * `priv` is disallowed everywhere except for struct fields and enum variants.
6860       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6861       * `ref` bindings in irrefutable patterns work correctly now.
6862       * `char` is now prevented from containing invalid code points.
6863       * Casting to `bool` is no longer allowed.
6864       * `\0` is now accepted as an escape in chars and strings.
6865       * `yield` is a reserved keyword.
6866       * `typeof` is a reserved keyword.
6867       * Crates may be imported by URL with `extern mod foo = "url";`.
6868       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6869       * Static vectors can be initialized with repeating elements,
6870         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6871       * Static structs can be initialized with functional record update,
6872         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6873       * `cfg!` can be used to conditionally execute code based on the crate
6874         configuration, similarly to `#[cfg(...)]`.
6875       * The `unnecessary_qualification` lint detects unneeded module
6876         prefixes (default: allow).
6877       * Arithmetic operations have been implemented on the SIMD types in
6878         `std::unstable::simd`.
6879       * Exchange allocation headers were removed, reducing memory usage.
6880       * `format!` implements a completely new, extensible, and higher-performance
6881         string formatting system. It will replace `fmt!`.
6882       * `print!` and `println!` write formatted strings (using the `format!`
6883         extension) to stdout.
6884       * `write!` and `writeln!` write formatted strings (using the `format!`
6885         extension) to the new Writers in `std::rt::io`.
6886       * The library section in which a function or static is placed may
6887         be specified with `#[link_section = "..."]`.
6888       * The `proto!` syntax extension for defining bounded message protocols
6889         was removed.
6890       * `macro_rules!` is hygienic for `let` declarations.
6891       * The `#[export_name]` attribute specifies the name of a symbol.
6892       * `unreachable!` can be used to indicate unreachable code, and fails
6893         if executed.
6894
6895    * Libraries
6896       * std: Transitioned to the new runtime, written in Rust.
6897       * std: Added an experimental I/O library, `rt::io`, based on the new
6898         runtime.
6899       * std: A new generic `range` function was added to the prelude, replacing
6900         `uint::range` and friends.
6901       * std: `range_rev` no longer exists. Since range is an iterator it can be
6902         reversed with `range(lo, hi).invert()`.
6903       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6904         renamed to `unwrap_or`.
6905       * std: The `iterator` module was renamed to `iter`.
6906       * std: Integral types now support the `checked_add`, `checked_sub`, and
6907         `checked_mul` operations for detecting overflow.
6908       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6909         consistency.
6910       * std: Methods are standardizing on conventions for casting methods:
6911         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6912         and cheap casts.
6913       * std: The `CString` type in `c_str` provides new ways to convert to and
6914         from C strings.
6915       * std: `DoubleEndedIterator` can yield elements in two directions.
6916       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6917         two splices.
6918       * std: `str::from_bytes` renamed to `str::from_utf8`.
6919       * std: `pop_opt` and `shift_opt` methods added to vectors.
6920       * std: The task-local data interface no longer uses @, and keys are
6921         no longer function pointers.
6922       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6923       * std: Added `SharedPort` to `comm`.
6924       * std: `Eq` has a default method for `ne`; only `eq` is required
6925         in implementations.
6926       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6927         is required in implementations.
6928       * std: `is_utf8` performance is improved, impacting many string functions.
6929       * std: `os::MemoryMap` provides cross-platform mmap.
6930       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6931         are not 'in-bounds' are considered undefined.
6932       * std: Many freestanding functions in `vec` removed in favor of methods.
6933       * std: Many freestanding functions on scalar types removed in favor of
6934         methods.
6935       * std: Many options to task builders were removed since they don't make
6936         sense in the new scheduler design.
6937       * std: More containers implement `FromIterator` so can be created by the
6938         `collect` method.
6939       * std: More complete atomic types in `unstable::atomics`.
6940       * std: `comm::PortSet` removed.
6941       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6942         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6943         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6944         default implementations.
6945       * std: Various `from_str` functions were removed in favor of a generic
6946         `from_str` which is available in the prelude.
6947       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6948       * extra: `dlist`, the doubly-linked list was modernized.
6949       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6950       * extra: Added `glob` module, replacing `std::os::glob`.
6951       * extra: `rope` was removed.
6952       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6953       * extra: `net`, and `timer` were removed. The experimental replacements
6954         are `std::rt::io::net` and `std::rt::io::timer`.
6955       * extra: Iterators implemented for `SmallIntMap`.
6956       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6957       * extra: `SmallIntSet` removed. Use `BitvSet`.
6958       * extra: Performance of JSON parsing greatly improved.
6959       * extra: `semver` updated to SemVer 2.0.0.
6960       * extra: `term` handles more terminals correctly.
6961       * extra: `dbg` module removed.
6962       * extra: `par` module removed.
6963       * extra: `future` was cleaned up, with some method renames.
6964       * extra: Most free functions in `getopts` were converted to methods.
6965
6966    * Other
6967       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6968       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6969         similarly to gcc's `--march` flag.
6970       * rustc's performance compiling small crates is much better.
6971       * rustpkg has received many improvements.
6972       * rustpkg supports git tags as package IDs.
6973       * rustpkg builds into target-specific directories so it can be used for
6974         cross-compiling.
6975       * The number of concurrent test tasks is controlled by the environment
6976         variable RUST_TEST_TASKS.
6977       * The test harness can now report metrics for benchmarks.
6978       * All tools have man pages.
6979       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6980       * The runtime uses jemalloc for allocations.
6981       * Segmented stacks are temporarily disabled as part of the transition to
6982         the new runtime. Stack overflows are possible!
6983       * A new documentation backend, rustdoc_ng, is available for use. It is
6984         still invoked through the normal `rustdoc` command.
6985
6986
6987 Version 0.7 (2013-07-03)
6988 =======================
6989
6990    * ~2000 changes, numerous bugfixes
6991
6992    * Language
6993       * `impl`s no longer accept a visibility qualifier. Put them on methods
6994         instead.
6995       * The borrow checker has been rewritten with flow-sensitivity, fixing
6996         many bugs and inconveniences.
6997       * The `self` parameter no longer implicitly means `&'self self`,
6998         and can be explicitly marked with a lifetime.
6999       * Overloadable compound operators (`+=`, etc.) have been temporarily
7000         removed due to bugs.
7001       * The `for` loop protocol now requires `for`-iterators to return `bool`
7002         so they compose better.
7003       * The `Durable` trait is replaced with the `'static` bounds.
7004       * Trait default methods work more often.
7005       * Structs with the `#[packed]` attribute have byte alignment and
7006         no padding between fields.
7007       * Type parameters bound by `Copy` must now be copied explicitly with
7008         the `copy` keyword.
7009       * It is now illegal to move out of a dereferenced unsafe pointer.
7010       * `Option<~T>` is now represented as a nullable pointer.
7011       * `@mut` does dynamic borrow checks correctly.
7012       * The `main` function is only detected at the topmost level of the crate.
7013         The `#[main]` attribute is still valid anywhere.
7014       * Struct fields may no longer be mutable. Use inherited mutability.
7015       * The `#[no_send]` attribute makes a type that would otherwise be
7016         `Send`, not.
7017       * The `#[no_freeze]` attribute makes a type that would otherwise be
7018         `Freeze`, not.
7019       * Unbounded recursion will abort the process after reaching the limit
7020         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
7021       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7022         are never implicitly copyable.
7023       * `#[static_assert]` makes compile-time assertions about static bools.
7024       * At long last, 'argument modes' no longer exist.
7025       * The rarely used `use mod` statement no longer exists.
7026
7027    * Syntax extensions
7028       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
7029         argument list.
7030       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
7031         `Rand`, `Zero` and `ToStr` can all be automatically derived with
7032         `#[deriving(...)]`.
7033       * The `bytes!` macro returns a vector of bytes for string, u8, char,
7034         and unsuffixed integer literals.
7035
7036    * Libraries
7037       * The `core` crate was renamed to `std`.
7038       * The `std` crate was renamed to `extra`.
7039       * More and improved documentation.
7040       * std: `iterator` module for external iterator objects.
7041       * Many old-style (internal, higher-order function) iterators replaced by
7042         implementations of `Iterator`.
7043       * std: Many old internal vector and string iterators,
7044         incl. `any`, `all`. removed.
7045       * std: The `finalize` method of `Drop` renamed to `drop`.
7046       * std: The `drop` method now takes `&mut self` instead of `&self`.
7047       * std: The prelude no longer re-exports any modules, only types and traits.
7048       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
7049         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
7050       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
7051         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
7052       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
7053         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
7054       * std: Many types implement `Clone`.
7055       * std: `path` type renamed to `Path`.
7056       * std: `mut` module and `Mut` type removed.
7057       * std: Many standalone functions removed in favor of methods and iterators
7058         in `vec`, `str`. In the future methods will also work as functions.
7059       * std: `reinterpret_cast` removed. Use `transmute`.
7060       * std: ascii string handling in `std::ascii`.
7061       * std: `Rand` is implemented for ~/@.
7062       * std: `run` module for spawning processes overhauled.
7063       * std: Various atomic types added to `unstable::atomic`.
7064       * std: Various types implement `Zero`.
7065       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
7066       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
7067       * std: Added `os::mkdir_recursive`.
7068       * std: Added `os::glob` function performs filesystems globs.
7069       * std: `FuzzyEq` renamed to `ApproxEq`.
7070       * std: `Map` now defines `pop` and `swap` methods.
7071       * std: `Cell` constructors converted to static methods.
7072       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
7073       * extra: `flate` module moved from `std` to `extra`.
7074       * extra: `fileinput` module for iterating over a series of files.
7075       * extra: `Complex` number type and `complex` module.
7076       * extra: `Rational` number type and `rational` module.
7077       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
7078       * extra: `term` uses terminfo now, is more correct.
7079       * extra: `arc` functions converted to methods.
7080       * extra: Implementation of fixed output size variations of SHA-2.
7081
7082    * Tooling
7083       * `unused_variable`  lint mode for unused variables (default: warn).
7084       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
7085         (default: warn).
7086       * `unused_mut` lint mode for identifying unused `mut` qualifiers
7087         (default: warn).
7088       * `dead_assignment` lint mode for unread variables (default: warn).
7089       * `unnecessary_allocation` lint mode detects some heap allocations that are
7090         immediately borrowed so could be written without allocating (default: warn).
7091       * `missing_doc` lint mode (default: allow).
7092       * `unreachable_code` lint mode (default: warn).
7093       * The `rusti` command has been rewritten and a number of bugs addressed.
7094       * rustc outputs in color on more terminals.
7095       * rustc accepts a `--link-args` flag to pass arguments to the linker.
7096       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
7097       * Compiling with `-g` will make the binary record information about
7098         dynamic borrowcheck failures for debugging.
7099       * rustdoc has a nicer stylesheet.
7100       * Various improvements to rustdoc.
7101       * Improvements to rustpkg (see the detailed release notes).
7102
7103
7104 Version 0.6 (2013-04-03)
7105 ========================
7106
7107    * ~2100 changes, numerous bugfixes
7108
7109    * Syntax changes
7110       * The self type parameter in traits is now spelled `Self`
7111       * The `self` parameter in trait and impl methods must now be explicitly
7112         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
7113       * Static methods no longer require the `static` keyword and instead
7114         are distinguished by the lack of a `self` parameter
7115       * Replaced the `Durable` trait with the `'static` lifetime
7116       * The old closure type syntax with the trailing sigil has been
7117         removed in favor of the more consistent leading sigil
7118       * `super` is a keyword, and may be prefixed to paths
7119       * Trait bounds are separated with `+` instead of whitespace
7120       * Traits are implemented with `impl Trait for Type`
7121         instead of `impl Type: Trait`
7122       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
7123       * The `export` keyword has finally been removed
7124       * The `move` keyword has been removed (see "Semantic changes")
7125       * The interior mutability qualifier on vectors, `[mut T]`, has been
7126         removed. Use `&mut [T]`, etc.
7127       * `mut` is no longer valid in `~mut T`. Use inherited mutability
7128       * `fail` is no longer a keyword. Use `fail!()`
7129       * `assert` is no longer a keyword. Use `assert!()`
7130       * `log` is no longer a keyword. use `debug!`, etc.
7131       * 1-tuples may be represented as `(T,)`
7132       * Struct fields may no longer be `mut`. Use inherited mutability,
7133         `@mut T`, `core::mut` or `core::cell`
7134       * `extern mod { ... }` is no longer valid syntax for foreign
7135         function modules. Use extern blocks: `extern { ... }`
7136       * Newtype enums removed. Use tuple-structs.
7137       * Trait implementations no longer support visibility modifiers
7138       * Pattern matching over vectors improved and expanded
7139       * `const` renamed to `static` to correspond to lifetime name,
7140         and make room for future `static mut` unsafe mutable globals.
7141       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
7142       * `Clone` implementations can be automatically generated with
7143         `#[deriving(Clone)]`
7144       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
7145         instead of `foo as Bar`.
7146       * Fixed length vector types are now written as `[int, .. 3]`
7147         instead of `[int * 3]`.
7148       * Fixed length vector types can express the length as a constant
7149         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
7150
7151    * Semantic changes
7152       * Types with owned pointers or custom destructors move by default,
7153         eliminating the `move` keyword
7154       * All foreign functions are considered unsafe
7155       * &mut is now unaliasable
7156       * Writes to borrowed @mut pointers are prevented dynamically
7157       * () has size 0
7158       * The name of the main function can be customized using #[main]
7159       * The default type of an inferred closure is &fn instead of @fn
7160       * `use` statements may no longer be "chained" - they cannot import
7161         identifiers imported by previous `use` statements
7162       * `use` statements are crate relative, importing from the "top"
7163         of the crate by default. Paths may be prefixed with `super::`
7164         or `self::` to change the search behavior.
7165       * Method visibility is inherited from the implementation declaration
7166       * Structural records have been removed
7167       * Many more types can be used in static items, including enums
7168         'static-lifetime pointers and vectors
7169       * Pattern matching over vectors improved and expanded
7170       * Typechecking of closure types has been overhauled to
7171         improve inference and eliminate unsoundness
7172       * Macros leave scope at the end of modules, unless that module is
7173         tagged with #[macro_escape]
7174
7175    * Libraries
7176       * Added big integers to `std::bigint`
7177       * Removed `core::oldcomm` module
7178       * Added pipe-based `core::comm` module
7179       * Numeric traits have been reorganized under `core::num`
7180       * `vec::slice` finally returns a slice
7181       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
7182       * Containers reorganized around traits in `core::container`
7183       * `core::dvec` removed, `~[T]` is a drop-in replacement
7184       * `core::send_map` renamed to `core::hashmap`
7185       * `std::map` removed; replaced with `core::hashmap`
7186       * `std::treemap` reimplemented as an owned balanced tree
7187       * `std::deque` and `std::smallintmap` reimplemented as owned containers
7188       * `core::trie` added as a fast ordered map for integer keys
7189       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
7190       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
7191         overload the comparison operators, whereas `TotalOrd` is used
7192         by certain container types
7193
7194    * Other
7195       * Replaced the 'cargo' package manager with 'rustpkg'
7196       * Added all-purpose 'rust' tool
7197       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
7198       * rustc now *attempts* to offer spelling suggestions
7199       * Improved support for ARM and Android
7200       * Preliminary MIPS backend
7201       * Improved foreign function ABI implementation for x86, x86_64
7202       * Various memory usage improvements
7203       * Rust code may be embedded in foreign code under limited circumstances
7204       * Inline assembler supported by new asm!() syntax extension.
7205
7206
7207 Version 0.5 (2012-12-21)
7208 ===========================
7209
7210    * ~900 changes, numerous bugfixes
7211
7212    * Syntax changes
7213       * Removed `<-` move operator
7214       * Completed the transition from the `#fmt` extension syntax to `fmt!`
7215       * Removed old fixed length vector syntax - `[T]/N`
7216       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
7217       * Macros may now expand to items and statements
7218       * `a.b()` is always parsed as a method call, never as a field projection
7219       * `Eq` and `IterBytes` implementations can be automatically generated
7220         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
7221       * Removed the special crate language for `.rc` files
7222       * Function arguments may consist of any irrefutable pattern
7223
7224    * Semantic changes
7225       * `&` and `~` pointers may point to objects
7226       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
7227       * Enum variants may be structs
7228       * Destructors can be added to all nominal types with the Drop trait
7229       * Structs and nullary enum variants may be constants
7230       * Values that cannot be implicitly copied are now automatically moved
7231         without writing `move` explicitly
7232       * `&T` may now be coerced to `*T`
7233       * Coercions happen in `let` statements as well as function calls
7234       * `use` statements now take crate-relative paths
7235       * The module and type namespaces have been merged so that static
7236         method names can be resolved under the trait in which they are
7237         declared
7238
7239    * Improved support for language features
7240       * Trait inheritance works in many scenarios
7241       * More support for explicit self arguments in methods - `self`, `&self`
7242         `@self`, and `~self` all generally work as expected
7243       * Static methods work in more situations
7244       * Experimental: Traits may declare default methods for the implementations
7245         to use
7246
7247    * Libraries
7248       * New condition handling system in `core::condition`
7249       * Timsort added to `std::sort`
7250       * New priority queue, `std::priority_queue`
7251       * Pipes for serializable types, `std::flatpipes'
7252       * Serialization overhauled to be trait-based
7253       * Expanded `getopts` definitions
7254       * Moved futures to `std`
7255       * More functions are pure now
7256       * `core::comm` renamed to `oldcomm`. Still deprecated
7257       * `rustdoc` and `cargo` are libraries now
7258
7259    * Misc
7260       * Added a preliminary REPL, `rusti`
7261       * License changed from MIT to dual MIT/APL2
7262
7263
7264 Version 0.4 (2012-10-15)
7265 ==========================
7266
7267    * ~2000 changes, numerous bugfixes
7268
7269    * Syntax
7270       * All keywords are now strict and may not be used as identifiers anywhere
7271       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
7272         'of', 'with', 'to', 'class'.
7273       * Classes are replaced with simpler structs
7274       * Explicit method self types
7275       * `ret` became `return` and `alt` became `match`
7276       * `import` is now `use`; `use is now `extern mod`
7277       * `extern mod { ... }` is now `extern { ... }`
7278       * `use mod` is the recommended way to import modules
7279       * `pub` and `priv` replace deprecated export lists
7280       * The syntax of `match` pattern arms now uses fat arrow (=>)
7281       * `main` no longer accepts an args vector; use `os::args` instead
7282
7283    * Semantics
7284       * Trait implementations are now coherent, ala Haskell typeclasses
7285       * Trait methods may be static
7286       * Argument modes are deprecated
7287       * Borrowed pointers are much more mature and recommended for use
7288       * Strings and vectors in the static region are stored in constant memory
7289       * Typestate was removed
7290       * Resolution rewritten to be more reliable
7291       * Support for 'dual-mode' data structures (freezing and thawing)
7292
7293    * Libraries
7294       * Most binary operators can now be overloaded via the traits in
7295         `core::ops'
7296       * `std::net::url` for representing URLs
7297       * Sendable hash maps in `core::send_map`
7298       * `core::task' gained a (currently unsafe) task-local storage API
7299
7300    * Concurrency
7301       * An efficient new intertask communication primitive called the pipe,
7302         along with a number of higher-level channel types, in `core::pipes`
7303       * `std::arc`, an atomically reference counted, immutable, shared memory
7304         type
7305       * `std::sync`, various exotic synchronization tools based on arcs and pipes
7306       * Futures are now based on pipes and sendable
7307       * More robust linked task failure
7308       * Improved task builder API
7309
7310    * Other
7311       * Improved error reporting
7312       * Preliminary JIT support
7313       * Preliminary work on precise GC
7314       * Extensive architectural improvements to rustc
7315       * Begun a transition away from buggy C++-based reflection (shape) code to
7316         Rust-based (visitor) code
7317       * All hash functions and tables converted to secure, randomized SipHash
7318
7319
7320 Version 0.3  (2012-07-12)
7321 ========================
7322
7323    * ~1900 changes, numerous bugfixes
7324
7325    * New coding conveniences
7326       * Integer-literal suffix inference
7327       * Per-item control over warnings, errors
7328       * #[cfg(windows)] and #[cfg(unix)] attributes
7329       * Documentation comments
7330       * More compact closure syntax
7331       * 'do' expressions for treating higher-order functions as
7332         control structures
7333       * *-patterns (wildcard extended to all constructor fields)
7334
7335    * Semantic cleanup
7336       * Name resolution pass and exhaustiveness checker rewritten
7337       * Region pointers and borrow checking supersede alias
7338         analysis
7339       * Init-ness checking is now provided by a region-based liveness
7340         pass instead of the typestate pass; same for last-use analysis
7341       * Extensive work on region pointers
7342
7343    * Experimental new language features
7344       * Slices and fixed-size, interior-allocated vectors
7345       * #!-comments for lang versioning, shell execution
7346       * Destructors and iface implementation for classes;
7347         type-parameterized classes and class methods
7348       * 'const' type kind for types that can be used to implement
7349         shared-memory concurrency patterns
7350
7351    * Type reflection
7352
7353    * Removal of various obsolete features
7354       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
7355                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
7356
7357       * Constructs: do-while loops ('do' repurposed), fn binding,
7358                     resources (replaced by destructors)
7359
7360    * Compiler reorganization
7361       * Syntax-layer of compiler split into separate crate
7362       * Clang (from LLVM project) integrated into build
7363       * Typechecker split into sub-modules
7364
7365    * New library code
7366       * New time functions
7367       * Extension methods for many built-in types
7368       * Arc: atomic-refcount read-only / exclusive-use shared cells
7369       * Par: parallel map and search routines
7370       * Extensive work on libuv interface
7371       * Much vector code moved to libraries
7372       * Syntax extensions: #line, #col, #file, #mod, #stringify,
7373         #include, #include_str, #include_bin
7374
7375    * Tool improvements
7376       * Cargo automatically resolves dependencies
7377
7378
7379 Version 0.2  (2012-03-29)
7380 =========================
7381
7382    * >1500 changes, numerous bugfixes
7383
7384    * New docs and doc tooling
7385
7386    * New port: FreeBSD x86_64
7387
7388    * Compilation model enhancements
7389       * Generics now specialized, multiply instantiated
7390       * Functions now inlined across separate crates
7391
7392    * Scheduling, stack and threading fixes
7393       * Noticeably improved message-passing performance
7394       * Explicit schedulers
7395       * Callbacks from C
7396       * Helgrind clean
7397
7398    * Experimental new language features
7399       * Operator overloading
7400       * Region pointers
7401       * Classes
7402
7403    * Various language extensions
7404       * C-callback function types: 'crust fn ...'
7405       * Infinite-loop construct: 'loop { ... }'
7406       * Shorten 'mutable' to 'mut'
7407       * Required mutable-local qualifier: 'let mut ...'
7408       * Basic glob-exporting: 'export foo::*;'
7409       * Alt now exhaustive, 'alt check' for runtime-checked
7410       * Block-function form of 'for' loop, with 'break' and 'ret'.
7411
7412    * New library code
7413       * AST quasi-quote syntax extension
7414       * Revived libuv interface
7415       * New modules: core::{future, iter}, std::arena
7416       * Merged per-platform std::{os*, fs*} to core::{libc, os}
7417       * Extensive cleanup, regularization in libstd, libcore
7418
7419
7420 Version 0.1  (2012-01-20)
7421 ===============================
7422
7423    * Most language features work, including:
7424       * Unique pointers, unique closures, move semantics
7425       * Interface-constrained generics
7426       * Static interface dispatch
7427       * Stack growth
7428       * Multithread task scheduling
7429       * Typestate predicates
7430       * Failure unwinding, destructors
7431       * Pattern matching and destructuring assignment
7432       * Lightweight block-lambda syntax
7433       * Preliminary macro-by-example
7434
7435    * Compiler works with the following configurations:
7436       * Linux: x86 and x86_64 hosts and targets
7437       * macOS: x86 and x86_64 hosts and targets
7438       * Windows: x86 hosts and targets
7439
7440    * Cross compilation / multi-target configuration supported.
7441
7442    * Preliminary API-documentation and package-management tools included.
7443
7444 Known issues:
7445
7446    * Documentation is incomplete.
7447
7448    * Performance is below intended target.
7449
7450    * Standard library APIs are subject to extensive change, reorganization.
7451
7452    * Language-level versioning is not yet operational - future code will
7453      break unexpectedly.