]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Update RELEASES.md
[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 - [You can now have multiple patterns in `if let` and `while let`
9   expressions.][57532] You can do this with the same syntax as a `match`
10   expression. E.g.
11   ```rust
12   enum Creature {
13     Crab(String),
14     Person(String),
15   }
16
17   fn main() {
18     let state = Creature::Crab("Ferris");
19
20     if let Creature::Crab(name) | Creature::Person(name) = state {
21       println!("This creature's name is: {}", name);
22     }
23   }
24   ```
25 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
26   this feature will by default produce a warning as this behaviour can be
27   unintuitive. E.g. `if let _ = 5 {}`
28 - [You can now use `let` bindings, assignments, expression statements, and pattern destructuring in
29   constant functions.][57175]
30 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
31   E.g. `#[cfg_attr(all(), must_use, optimize)]`
32 - [You can now specify a specific alignment with the `#[repr(packed)]`
33   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
34   with an alignment of 2 bytes and a size of 6 bytes.
35 - [You can now call unsafe constant functions.][57067] E.g.
36   ```rust
37   const unsafe fn foo() -> i32 { 5 }
38   const fn bar() -> i32 {
39     unsafe { foo() }
40   }
41   ```
42 - [You can now import an item from a module as a `_`.][56303] This allows you to
43   import a trait's impls, and not have the name in the namespace. E.g.
44   ```rust
45   use std::io::Read as _;
46
47   // Allowed as there is only one `Read` in the module.
48   pub trait Read {}
49   ```
50 - [`extern` functions will now abort by default when panicking.][55982]
51
52 Compiler
53 --------
54 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
55   command line argument.][56351]
56 - [The mininum required LLVM version has been bumped to 6.0.][56642]
57 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
58 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
59   tier 2 support.][57130] Visit the [platform support][platform-support] page for
60   information on Rust's platform support.
61 - [Added support for the `thumbv7neon-linux-androideabi` and
62   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
63 - [Added support for the `x86_64-unknown-uefi` target.][56769]
64
65 Libraries
66 ---------
67 - [The functions `overflowing_{add, sub, mul, shl, shr}` are now constant
68   functions for all numeric types.][57566]
69 - [The `get` method for all `NonZero` types is now constant.][57167]
70 - [The functions `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
71   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now constant for all
72   numeric types.][57234]
73 - [`Ipv4Addr::new` is now a constant function][57234]
74
75 Stabilized APIs
76 ---------------
77 - [`unix::FileExt::read_exact_at`]
78 - [`unix::FileExt::write_exact_at`]
79 - [`Option::transpose`]
80 - [`Result::transpose`]
81 - [`convert::identity`]
82 - [`pin::Pin`]
83 - [`Vec::resize_with`]
84 - [`VecDeque::resize_with`]
85 - [`Duration::as_millis`]
86 - [`Duration::as_micros`]
87 - [`Duration::as_nanos`]
88
89 Cargo
90 -----
91 - [Cargo should now rebuild a crate if a file was modified during the initial
92   build.][cargo/6484]
93
94
95 [57615]: https://github.com/rust-lang/rust/pull/57615/
96 [57465]: https://github.com/rust-lang/rust/pull/57465/
97 [57532]: https://github.com/rust-lang/rust/pull/57532/
98 [57535]: https://github.com/rust-lang/rust/pull/57535/
99 [57566]: https://github.com/rust-lang/rust/pull/57566/
100 [57130]: https://github.com/rust-lang/rust/pull/57130/
101 [57167]: https://github.com/rust-lang/rust/pull/57167/
102 [57175]: https://github.com/rust-lang/rust/pull/57175/
103 [57234]: https://github.com/rust-lang/rust/pull/57234/
104 [57332]: https://github.com/rust-lang/rust/pull/57332/
105 [56947]: https://github.com/rust-lang/rust/pull/56947/
106 [57049]: https://github.com/rust-lang/rust/pull/57049/
107 [57067]: https://github.com/rust-lang/rust/pull/57067/
108 [56769]: https://github.com/rust-lang/rust/pull/56769/
109 [56642]: https://github.com/rust-lang/rust/pull/56642/
110 [56303]: https://github.com/rust-lang/rust/pull/56303/
111 [56351]: https://github.com/rust-lang/rust/pull/56351/
112 [55982]: https://github.com/rust-lang/rust/pull/55982/
113 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
114 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#read_exact_at
115 [`unix::FileExt::write_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#write_exact_at
116 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#transpose
117 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#transpose
118 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
119 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
120 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#resize_with
121 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#resize_with
122 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#as_millis
123 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#as_micros
124 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#as_millis
125 [platform-support]: https://forge.rust-lang.org/platform-support.html
126
127 Version 1.32.0 (2019-01-17)
128 ==========================
129
130 Language
131 --------
132 #### 2018 edition
133 - [You can now use the `?` operator in macro definitions.][56245] The `?`
134   operator allows you to specify zero or one repetitions similar to the `*` and
135   `+` operators.
136 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
137   now always resolve to the item (`enum`, `struct`, etc.) available in the
138   module if present, before resolving to a external crate or an item the prelude.][56759]
139   E.g.
140   ```rust
141   enum Color { Red, Green, Blue }
142
143   use Color::*;
144   ```
145
146 #### All editions
147 - [You can now match against `PhantomData<T>` types.][55837]
148 - [You can now match against literals in macros with the `literal`
149   specifier.][56072] This will match against a literal of any type.
150   E.g. `1`, `'A'`, `"Hello World"`
151 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g. 
152   ```rust
153   struct Point(i32, i32);
154
155   impl Point {
156       pub fn new(x: i32, y: i32) -> Self {
157           Self(x, y)
158       }
159
160       pub fn is_origin(&self) -> bool {
161           match self {
162               Self(0, 0) => true,
163               _ => false,
164           }
165       }
166   }
167   ```
168 - [Self can also now be used in type definitions.][56366] E.g.
169   ```rust
170   enum List<T>
171   where
172       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
173   {
174       Nil,
175       Cons(T, Box<Self>) // likewise here
176   }
177   ```
178 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
179   a `impl Trait` or `dyn Trait` is returned and unused in the program.
180
181 Compiler
182 --------
183 - [The default allocator has changed from jemalloc to the default allocator on
184   your system.][55238] The compiler itself on Linux & macOS will still use
185   jemalloc, but programs compiled with it will use the system allocator.
186 - [Added the `aarch64-pc-windows-msvc` target.][55702]
187
188 Libraries
189 ---------
190 - [`PathBuf` now implements `FromStr`.][55148]
191 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
192 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
193   easily debug expressions in your rust program. E.g.
194   ```rust
195   let a = 2;
196   let b = dbg!(a * 2) + 1;
197   //      ^-- prints: [src/main.rs:4] a * 2 = 4
198   assert_eq!(b, 5);
199   ```
200
201 The following APIs are now `const` functions and can be used in a
202 `const` context.
203
204 - [`Cell::as_ptr`]
205 - [`UnsafeCell::get`]
206 - [`char::is_ascii`]
207 - [`iter::empty`]
208 - [`ManuallyDrop::new`]
209 - [`ManuallyDrop::into_inner`]
210 - [`RangeInclusive::start`]
211 - [`RangeInclusive::end`]
212 - [`NonNull::as_ptr`]
213 - [`slice::as_ptr`]
214 - [`str::as_ptr`]
215 - [`Duration::as_secs`]
216 - [`Duration::subsec_millis`]
217 - [`Duration::subsec_micros`]
218 - [`Duration::subsec_nanos`]
219 - [`CStr::as_ptr`]
220 - [`Ipv4Addr::is_unspecified`]
221 - [`Ipv6Addr::new`]
222 - [`Ipv6Addr::octets`]
223
224 Stabilized APIs
225 ---------------
226 - [`i8::to_be_bytes`]
227 - [`i8::to_le_bytes`]
228 - [`i8::to_ne_bytes`]
229 - [`i8::from_be_bytes`]
230 - [`i8::from_le_bytes`]
231 - [`i8::from_ne_bytes`]
232 - [`i16::to_be_bytes`]
233 - [`i16::to_le_bytes`]
234 - [`i16::to_ne_bytes`]
235 - [`i16::from_be_bytes`]
236 - [`i16::from_le_bytes`]
237 - [`i16::from_ne_bytes`]
238 - [`i32::to_be_bytes`]
239 - [`i32::to_le_bytes`]
240 - [`i32::to_ne_bytes`]
241 - [`i32::from_be_bytes`]
242 - [`i32::from_le_bytes`]
243 - [`i32::from_ne_bytes`]
244 - [`i64::to_be_bytes`]
245 - [`i64::to_le_bytes`]
246 - [`i64::to_ne_bytes`]
247 - [`i64::from_be_bytes`]
248 - [`i64::from_le_bytes`]
249 - [`i64::from_ne_bytes`]
250 - [`i128::to_be_bytes`]
251 - [`i128::to_le_bytes`]
252 - [`i128::to_ne_bytes`]
253 - [`i128::from_be_bytes`]
254 - [`i128::from_le_bytes`]
255 - [`i128::from_ne_bytes`]
256 - [`isize::to_be_bytes`]
257 - [`isize::to_le_bytes`]
258 - [`isize::to_ne_bytes`]
259 - [`isize::from_be_bytes`]
260 - [`isize::from_le_bytes`]
261 - [`isize::from_ne_bytes`]
262 - [`u8::to_be_bytes`]
263 - [`u8::to_le_bytes`]
264 - [`u8::to_ne_bytes`]
265 - [`u8::from_be_bytes`]
266 - [`u8::from_le_bytes`]
267 - [`u8::from_ne_bytes`]
268 - [`u16::to_be_bytes`]
269 - [`u16::to_le_bytes`]
270 - [`u16::to_ne_bytes`]
271 - [`u16::from_be_bytes`]
272 - [`u16::from_le_bytes`]
273 - [`u16::from_ne_bytes`]
274 - [`u32::to_be_bytes`]
275 - [`u32::to_le_bytes`]
276 - [`u32::to_ne_bytes`]
277 - [`u32::from_be_bytes`]
278 - [`u32::from_le_bytes`]
279 - [`u32::from_ne_bytes`]
280 - [`u64::to_be_bytes`]
281 - [`u64::to_le_bytes`]
282 - [`u64::to_ne_bytes`]
283 - [`u64::from_be_bytes`]
284 - [`u64::from_le_bytes`]
285 - [`u64::from_ne_bytes`]
286 - [`u128::to_be_bytes`]
287 - [`u128::to_le_bytes`]
288 - [`u128::to_ne_bytes`]
289 - [`u128::from_be_bytes`]
290 - [`u128::from_le_bytes`]
291 - [`u128::from_ne_bytes`]
292 - [`usize::to_be_bytes`]
293 - [`usize::to_le_bytes`]
294 - [`usize::to_ne_bytes`]
295 - [`usize::from_be_bytes`]
296 - [`usize::from_le_bytes`]
297 - [`usize::from_ne_bytes`]
298
299 Cargo
300 -----
301 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
302 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
303
304 Misc
305 ----
306 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
307
308 Compatibility Notes
309 -------------------
310 - [The argument types for AVX's
311   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
312   been changed from `*const` to `*mut` as the previous implementation
313   was unsound.
314
315
316 [55148]: https://github.com/rust-lang/rust/pull/55148/
317 [55238]: https://github.com/rust-lang/rust/pull/55238/
318 [55280]: https://github.com/rust-lang/rust/pull/55280/
319 [55610]: https://github.com/rust-lang/rust/pull/55610/
320 [55663]: https://github.com/rust-lang/rust/pull/55663/
321 [55702]: https://github.com/rust-lang/rust/pull/55702/
322 [55837]: https://github.com/rust-lang/rust/pull/55837/
323 [55843]: https://github.com/rust-lang/rust/pull/55843/
324 [56072]: https://github.com/rust-lang/rust/pull/56072/
325 [56245]: https://github.com/rust-lang/rust/pull/56245/
326 [56365]: https://github.com/rust-lang/rust/pull/56365/
327 [56366]: https://github.com/rust-lang/rust/pull/56366/
328 [56395]: https://github.com/rust-lang/rust/pull/56395/
329 [56759]: https://github.com/rust-lang/rust/pull/56759/
330 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
331 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
332 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
333 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
334 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
335 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
336 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
337 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
338 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
339 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
340 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
341 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
342 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
343 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
344 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
345 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
346 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
347 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
348 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
349 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
350 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
351 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
352 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
353 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
354 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
355 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
356 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
357 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
358 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
359 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
360 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
361 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
362 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
363 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
364 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
365 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
366 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
367 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
368 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
369 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
370 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
371 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
372 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
373 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
374 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
375 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
376 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
377 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
378 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
379 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
380 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
381 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
382 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
383 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
384 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
385 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
386 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
387 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
388 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
389 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
390 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
391 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
392 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
393 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
394 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
395 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
396 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
397 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
398 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
399 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
400 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
401 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
402 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
403 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
404 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
405 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
406 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
407 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
408 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
409 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
410 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
411 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
412 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
413 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
414 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
415 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
416 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
417 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
418 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
419 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
420 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
421 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
422 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
423
424
425 Version 1.31.1 (2018-12-20)
426 ===========================
427
428 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
429 - [Fix broken go-to-definition in RLS][rls/1171]
430 - [Fix infinite loop on hover in RLS][rls/1170]
431
432 [56562]: https://github.com/rust-lang/rust/pull/56562
433 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
434 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
435
436 Version 1.31.0 (2018-12-06)
437 ==========================
438
439 Language
440 --------
441 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉 
442 - [New lifetime elision rules now allow for eliding lifetimes in functions and
443   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
444   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
445   in structs.
446 - [You can now define and use `const` functions.][54835] These are currently
447   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
448   [language reference][const-reference] for what exactly is available.
449 - [You can now use tool lints, which allow you to scope lints from external
450   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
451 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
452   a crate, not just in exported functions.][54451]
453 - [You can now use parentheses in pattern matches.][54497]
454
455 Compiler
456 --------
457 - [Updated musl to 1.1.20][54430]
458
459 Libraries
460 ---------
461 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
462   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
463 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
464   into `Option<&mut T>` using the `From` trait.][53218]
465 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
466
467
468 Stabilized APIs
469 ---------------
470 - [`slice::align_to`]
471 - [`slice::align_to_mut`]
472 - [`slice::chunks_exact`]
473 - [`slice::chunks_exact_mut`]
474 - [`slice::rchunks`]
475 - [`slice::rchunks_mut`]
476 - [`slice::rchunks_exact`]
477 - [`slice::rchunks_exact_mut`]
478 - [`Option::replace`]
479
480 Cargo
481 -----
482 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
483 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
484   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
485
486 [52813]: https://github.com/rust-lang/rust/pull/52813/
487 [53218]: https://github.com/rust-lang/rust/pull/53218/
488 [53555]: https://github.com/rust-lang/rust/issues/53555/
489 [54057]: https://github.com/rust-lang/rust/pull/54057/
490 [54240]: https://github.com/rust-lang/rust/pull/54240/
491 [54430]: https://github.com/rust-lang/rust/pull/54430/
492 [54451]: https://github.com/rust-lang/rust/pull/54451/
493 [54497]: https://github.com/rust-lang/rust/pull/54497/
494 [54778]: https://github.com/rust-lang/rust/pull/54778/
495 [54835]: https://github.com/rust-lang/rust/pull/54835/
496 [54870]: https://github.com/rust-lang/rust/pull/54870/
497 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
498 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
499 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
500 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
501 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
502 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
503 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
504 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
505 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
506 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
507 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
508 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
509 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
510 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
511
512 Version 1.30.1 (2018-11-08)
513 ===========================
514
515 - [Fixed overflow ICE in rustdoc][54199]
516 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
517
518 [54199]: https://github.com/rust-lang/rust/pull/54199
519 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
520
521 Version 1.30.0 (2018-10-25)
522 ==========================
523
524 Language
525 --------
526 - [Procedural macros are now available.][52081] These kinds of macros allow for
527   more powerful code generation. There is a [new chapter available][proc-macros]
528   in the Rust Programming Language book that goes further in depth.
529 - [You can now use keywords as identifiers using the raw identifiers
530   syntax (`r#`),][53236] e.g. `let r#for = true;`
531 - [Using anonymous parameters in traits is now deprecated with a warning and
532   will be a hard error in the 2018 edition.][53272]
533 - [You can now use `crate` in paths.][54404] This allows you to refer to the
534   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
535 - [Using a external crate no longer requires being prefixed with `::`.][54404]
536   Previously, using a external crate in a module without a use statement
537   required `let json = ::serde_json::from_str(foo);` but can now be written
538   as `let json = serde_json::from_str(foo);`.
539 - [You can now apply the `#[used]` attribute to static items to prevent the
540   compiler from optimising them away, even if they appear to be unused,][51363]
541   e.g. `#[used] static FOO: u32 = 1;`
542 - [You can now import and reexport macros from other crates with the `use`
543   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
544   the root module of the crate. If your macro relies on calling other local
545   macros, it is recommended to export with the
546   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
547   those macros.
548 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
549   using the `vis` specifier.][53370]
550 - [Non-macro attributes now allow all forms of literals, not just
551   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
552   write `#[attr(true)]`.
553 - [You can now specify a function to handle a panic in the Rust runtime with the
554   `#[panic_handler]` attribute.][51366]
555
556 Compiler
557 --------
558 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
559 - [Added the `aarch64-unknown-netbsd` target][53165]
560
561 Libraries
562 ---------
563 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
564
565 Stabilized APIs
566 ---------------
567 - [`Ipv4Addr::BROADCAST`]
568 - [`Ipv4Addr::LOCALHOST`]
569 - [`Ipv4Addr::UNSPECIFIED`]
570 - [`Ipv6Addr::LOCALHOST`]
571 - [`Ipv6Addr::UNSPECIFIED`]
572 - [`Iterator::find_map`]
573
574   The following methods are replacement methods for `trim_left`, `trim_right`,
575   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
576   in 1.33.0:
577 - [`str::trim_end_matches`]
578 - [`str::trim_end`]
579 - [`str::trim_start_matches`]
580 - [`str::trim_start`]
581
582 Cargo
583 ----
584 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
585 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
586   equivalent to calling `rustdoc --error-format=json`.
587 - [Cargo will now provide a progress bar for builds.][cargo/5995]
588
589 Misc
590 ----
591 - [`rustdoc` allows you to specify what edition to treat your code as with the
592   `--edition` option.][54057]
593 - [`rustdoc` now has the `--color` (specify whether to output color) and
594   `--error-format` (specify error format, e.g. `json`) options.][53003]
595 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
596   debug symbols.][53774]
597 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
598   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
599
600 [50911]: https://github.com/rust-lang/rust/pull/50911/
601 [51363]: https://github.com/rust-lang/rust/pull/51363/
602 [51366]: https://github.com/rust-lang/rust/pull/51366/
603 [52081]: https://github.com/rust-lang/rust/pull/52081/
604 [53003]: https://github.com/rust-lang/rust/pull/53003/
605 [53033]: https://github.com/rust-lang/rust/pull/53033/
606 [53044]: https://github.com/rust-lang/rust/pull/53044/
607 [53165]: https://github.com/rust-lang/rust/pull/53165/
608 [53213]: https://github.com/rust-lang/rust/pull/53213/
609 [53236]: https://github.com/rust-lang/rust/pull/53236/
610 [53272]: https://github.com/rust-lang/rust/pull/53272/
611 [53370]: https://github.com/rust-lang/rust/pull/53370/
612 [53459]: https://github.com/rust-lang/rust/pull/53459/
613 [53774]: https://github.com/rust-lang/rust/pull/53774/
614 [53822]: https://github.com/rust-lang/rust/pull/53822/
615 [54057]: https://github.com/rust-lang/rust/pull/54057/
616 [54146]: https://github.com/rust-lang/rust/pull/54146/
617 [54404]: https://github.com/rust-lang/rust/pull/54404/
618 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
619 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
620 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
621 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
622
623 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
624 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
625 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
626 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
627 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
628 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
629 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
630 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
631 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
632 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
633
634
635 Version 1.29.2 (2018-10-11)
636 ===========================
637
638 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
639 - The `rls-preview` component on the windows-gnu targets has been restored.
640
641 [54639]: https://github.com/rust-lang/rust/pull/54639
642
643
644 Version 1.29.1 (2018-09-25)
645 ===========================
646
647 Security Notes
648 --------------
649
650 - The standard library's `str::repeat` function contained an out of bounds write
651   caused by an integer overflow. This has been fixed by deterministically
652   panicking when an overflow happens.
653
654   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
655   us.
656
657
658 Version 1.29.0 (2018-09-13)
659 ==========================
660
661 Compiler
662 --------
663 - [Bumped minimum LLVM version to 5.0.][51899]
664 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
665 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
666
667 Libraries
668 ---------
669 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
670 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
671 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
672 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
673   for `&str`.][51178]
674 - [`Cell<T>` now allows `T` to be unsized.][50494]
675 - [`SocketAddr` is now stable on Redox.][52656]
676
677 Stabilized APIs
678 ---------------
679 - [`Arc::downcast`]
680 - [`Iterator::flatten`]
681 - [`Rc::downcast`]
682
683 Cargo
684 -----
685 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
686   `--locked` to disable this behavior.
687 - [`cargo-install` will now allow you to cross compile an install
688   using `--target`.][cargo/5614]
689 - [Added the `cargo-fix` subcommand to automatically move project code from
690   2015 edition to 2018.][cargo/5723]
691 - [`cargo doc` can now optionally document private types using the
692   `--document-private-items` flag.][cargo/5543]
693
694 Misc
695 ----
696 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
697   the specified level to that level.][52354] For example `--cap-lints warn`
698   will demote `deny` and `forbid` lints to `warn`.
699 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
700   fails and `101` if there is a panic.][52197]
701 - [A preview of clippy has been made available through rustup.][51122]
702   You can install the preview with `rustup component add clippy-preview`.
703
704 Compatibility Notes
705 -------------------
706 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
707   Use `str::get_unchecked(begin..end)` instead.
708 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
709   Consider using the `home_dir` function from
710   https://crates.io/crates/dirs instead.
711 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
712 - [`cfg` attributes and `--cfg` command line flags are now more
713   strictly validated.][53893]
714
715 [53893]: https://github.com/rust-lang/rust/pull/53893/
716 [52861]: https://github.com/rust-lang/rust/pull/52861/
717 [52656]: https://github.com/rust-lang/rust/pull/52656/
718 [52239]: https://github.com/rust-lang/rust/pull/52239/
719 [52330]: https://github.com/rust-lang/rust/pull/52330/
720 [52354]: https://github.com/rust-lang/rust/pull/52354/
721 [52402]: https://github.com/rust-lang/rust/pull/52402/
722 [52103]: https://github.com/rust-lang/rust/pull/52103/
723 [52197]: https://github.com/rust-lang/rust/pull/52197/
724 [51807]: https://github.com/rust-lang/rust/pull/51807/
725 [51899]: https://github.com/rust-lang/rust/pull/51899/
726 [51912]: https://github.com/rust-lang/rust/pull/51912/
727 [51511]: https://github.com/rust-lang/rust/pull/51511/
728 [51619]: https://github.com/rust-lang/rust/pull/51619/
729 [51656]: https://github.com/rust-lang/rust/pull/51656/
730 [51178]: https://github.com/rust-lang/rust/pull/51178/
731 [51122]: https://github.com/rust-lang/rust/pull/51122
732 [50494]: https://github.com/rust-lang/rust/pull/50494/
733 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
734 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
735 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
736 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
737 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
738 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
739 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
740
741
742 Version 1.28.0 (2018-08-02)
743 ===========================
744
745 Language
746 --------
747 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
748   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
749   the inner type across Foreign Function Interface (FFI) boundaries.
750 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
751   and can now be used as identifiers.][51196]
752 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
753   stable.][51241] This will allow users to specify a global allocator for
754   their program.
755 - [Unit test functions marked with the `#[test]` attribute can now return
756   `Result<(), E: Debug>` in addition to `()`.][51298]
757 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
758   allows macros to easily target lifetimes.
759
760 Compiler
761 --------
762 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
763   prioritise making smaller binary sizes. `z` is the same as `s` with the
764   exception that it does not vectorise loops, which typically results in an even
765   smaller binary.
766 - [The short error format is now stable.][49546] Specified with
767   `--error-format=short` this option will provide a more compressed output of
768   rust error messages.
769 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
770 - [Reduced the number of allocations in the macro parser.][50855] This can
771   improve compile times of macro heavy crates on average by 5%.
772
773 Libraries
774 ---------
775 - [Implemented `Default` for `&mut str`.][51306]
776 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
777 - [Implemented `Extend` for `()`.][50234]
778 - [The `Debug` implementation of `time::Duration` should now be more easily
779   human readable.][50364] Previously a `Duration` of one second would printed as
780   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
781 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
782   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
783   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
784   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
785   for `PathBuf`.][50170]
786 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
787   and `Wrapping<i128>`.][50465]
788 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
789   possible.][51050] This can provide up to a 40% speed increase.
790 - [Improved error messages when using `format!`.][50610]
791
792 Stabilized APIs
793 ---------------
794 - [`Iterator::step_by`]
795 - [`Path::ancestors`]
796 - [`SystemTime::UNIX_EPOCH`]
797 - [`alloc::GlobalAlloc`]
798 - [`alloc::Layout`]
799 - [`alloc::LayoutErr`]
800 - [`alloc::System`]
801 - [`alloc::alloc`]
802 - [`alloc::alloc_zeroed`]
803 - [`alloc::dealloc`]
804 - [`alloc::realloc`]
805 - [`alloc::handle_alloc_error`]
806 - [`btree_map::Entry::or_default`]
807 - [`fmt::Alignment`]
808 - [`hash_map::Entry::or_default`]
809 - [`iter::repeat_with`]
810 - [`num::NonZeroUsize`]
811 - [`num::NonZeroU128`]
812 - [`num::NonZeroU16`]
813 - [`num::NonZeroU32`]
814 - [`num::NonZeroU64`]
815 - [`num::NonZeroU8`]
816 - [`ops::RangeBounds`]
817 - [`slice::SliceIndex`]
818 - [`slice::from_mut`]
819 - [`slice::from_ref`]
820 - [`{Any + Send + Sync}::downcast_mut`]
821 - [`{Any + Send + Sync}::downcast_ref`]
822 - [`{Any + Send + Sync}::is`]
823
824 Cargo
825 -----
826 - [Cargo will now no longer allow you to publish crates with build scripts that
827   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
828   considered to be immutable.
829
830 Misc
831 ----
832 - [The `suggestion_applicability` field in `rustc`'s json output is now
833   stable.][50486] This will allow dev tools to check whether a code suggestion
834   would apply to them.
835
836 Compatibility Notes
837 -------------------
838 - [Rust will consider trait objects with duplicated constraints to be the same
839   type as without the duplicated constraint.][51276] For example the below code will
840   now fail to compile.
841   ```rust
842   trait Trait {}
843
844   impl Trait + Send {
845       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
846   }
847
848   impl Trait + Send + Send {
849       fn test(&self) { println!("two"); }
850   }
851   ```
852
853 [49546]: https://github.com/rust-lang/rust/pull/49546/
854 [50143]: https://github.com/rust-lang/rust/pull/50143/
855 [50170]: https://github.com/rust-lang/rust/pull/50170/
856 [50234]: https://github.com/rust-lang/rust/pull/50234/
857 [50265]: https://github.com/rust-lang/rust/pull/50265/
858 [50364]: https://github.com/rust-lang/rust/pull/50364/
859 [50385]: https://github.com/rust-lang/rust/pull/50385/
860 [50465]: https://github.com/rust-lang/rust/pull/50465/
861 [50486]: https://github.com/rust-lang/rust/pull/50486/
862 [50554]: https://github.com/rust-lang/rust/pull/50554/
863 [50610]: https://github.com/rust-lang/rust/pull/50610/
864 [50855]: https://github.com/rust-lang/rust/pull/50855/
865 [51050]: https://github.com/rust-lang/rust/pull/51050/
866 [51196]: https://github.com/rust-lang/rust/pull/51196/
867 [51200]: https://github.com/rust-lang/rust/pull/51200/
868 [51241]: https://github.com/rust-lang/rust/pull/51241/
869 [51276]: https://github.com/rust-lang/rust/pull/51276/
870 [51298]: https://github.com/rust-lang/rust/pull/51298/
871 [51306]: https://github.com/rust-lang/rust/pull/51306/
872 [51562]: https://github.com/rust-lang/rust/pull/51562/
873 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
874 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
875 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
876 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
877 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
878 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
879 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
880 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
881 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
882 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
883 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
884 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
885 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
886 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
887 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
888 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
889 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
890 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
891 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
892 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
893 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
894 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
895 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
896 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
897 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
898 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
899 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
900 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
901 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
902 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
903
904 Version 1.27.2 (2018-07-20)
905 ===========================
906
907 Compatibility Notes
908 -------------------
909
910 - The borrow checker was fixed to avoid potential unsoundness when using
911   match ergonomics: [#52213][52213].
912
913 [52213]: https://github.com/rust-lang/rust/issues/52213
914
915 Version 1.27.1 (2018-07-10)
916 ===========================
917
918 Security Notes
919 --------------
920
921 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
922   when running, which enabled executing code as some other user on a
923   given machine. This release fixes that vulnerability; you can read
924   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
925
926   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
927
928 Compatibility Notes
929 -------------------
930
931 - The borrow checker was fixed to avoid an additional potential unsoundness when using
932   match ergonomics: [#51415][51415], [#49534][49534].
933
934 [51415]: https://github.com/rust-lang/rust/issues/51415
935 [49534]: https://github.com/rust-lang/rust/issues/49534
936 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
937 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
938
939 Version 1.27.0 (2018-06-21)
940 ==========================
941
942 Language
943 --------
944 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
945   be used as an identifier.
946 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
947   bare `Trait` syntax, and should make it clearer when being used in tandem with
948   `impl Trait` because it is equivalent to the following syntax:
949   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
950   `Box<Trait> == Box<dyn Trait>`.
951 - [Attributes on generic parameters such as types and lifetimes are
952   now stable.][48851] e.g.
953   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
954 - [The `#[must_use]` attribute can now also be used on functions as well as
955   types.][48925] It provides a lint that by default warns users when the
956   value returned by a function has not been used.
957
958 Compiler
959 --------
960 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
961
962 Libraries
963 ---------
964 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
965   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
966   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
967   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
968   the `cfg` attribute.
969 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
970   std are now available in core.][49896]
971 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
972   to `Self`.][49630]
973 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
974   that the operation isn't done in place.
975 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
976   the `#[must_use]` attribute][49533] to warn about unused potentially
977   expensive allocations.
978
979 Stabilized APIs
980 ---------------
981 - [`DoubleEndedIterator::rfind`]
982 - [`DoubleEndedIterator::rfold`]
983 - [`DoubleEndedIterator::try_rfold`]
984 - [`Duration::from_micros`]
985 - [`Duration::from_nanos`]
986 - [`Duration::subsec_micros`]
987 - [`Duration::subsec_millis`]
988 - [`HashMap::remove_entry`]
989 - [`Iterator::try_fold`]
990 - [`Iterator::try_for_each`]
991 - [`NonNull::cast`]
992 - [`Option::filter`]
993 - [`String::replace_range`]
994 - [`Take::set_limit`]
995 - [`hint::unreachable_unchecked`]
996 - [`os::unix::process::parent_id`]
997 - [`ptr::swap_nonoverlapping`]
998 - [`slice::rsplit_mut`]
999 - [`slice::rsplit`]
1000 - [`slice::swap_with_slice`]
1001
1002 Cargo
1003 -----
1004 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
1005   `readme`, and `repository` fields.][cargo/5386]
1006 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
1007 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
1008   a different directory than `target` for placing compilation artifacts.
1009 - [Cargo will be adding automatic target inference for binaries, benchmarks,
1010   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
1011   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
1012   where cargo would infer a binary, Cargo will produce a warning. You can
1013   disable this feature ahead of time by setting any of the following to false:
1014   `autobins`, `autobenches`, `autoexamples`, `autotests`.
1015 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
1016   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
1017
1018 Misc
1019 ----
1020 - [Added “The Rustc book” into the official documentation.][49707]
1021   [“The Rustc book”] documents and teaches how to use the rustc compiler.
1022 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
1023
1024 Compatibility Notes
1025 -------------------
1026 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
1027   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
1028   compile, `"".is_empty()` will still compile.
1029 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
1030   will only print the inner type.][48553] E.g.
1031   `print!("{:?}", AtomicBool::new(true))` will print `true`,
1032   not `AtomicBool(true)`.
1033 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
1034   could enter higher numbers but they were not supported by LLVM. Up to 512MB
1035   alignment should cover all use cases.
1036 - The `.description()` method on the `std::error::Error` trait
1037   [has been soft-deprecated][50163]. It is no longer required to implement it.
1038
1039 [48553]: https://github.com/rust-lang/rust/pull/48553/
1040 [48851]: https://github.com/rust-lang/rust/pull/48851/
1041 [48925]: https://github.com/rust-lang/rust/pull/48925/
1042 [49533]: https://github.com/rust-lang/rust/pull/49533/
1043 [49623]: https://github.com/rust-lang/rust/pull/49623/
1044 [49630]: https://github.com/rust-lang/rust/pull/49630/
1045 [49664]: https://github.com/rust-lang/rust/pull/49664/
1046 [49699]: https://github.com/rust-lang/rust/pull/49699/
1047 [49707]: https://github.com/rust-lang/rust/pull/49707/
1048 [49719]: https://github.com/rust-lang/rust/pull/49719/
1049 [49896]: https://github.com/rust-lang/rust/pull/49896/
1050 [49968]: https://github.com/rust-lang/rust/pull/49968/
1051 [50163]: https://github.com/rust-lang/rust/pull/50163
1052 [50177]: https://github.com/rust-lang/rust/pull/50177/
1053 [50378]: https://github.com/rust-lang/rust/pull/50378/
1054 [50398]: https://github.com/rust-lang/rust/pull/50398/
1055 [50423]: https://github.com/rust-lang/rust/pull/50423/
1056 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
1057 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
1058 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
1059 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
1060 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
1061 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
1062 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
1063 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
1064 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
1065 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
1066 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
1067 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1068 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1069 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
1070 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
1071 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
1072 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
1073 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
1074 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
1075 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
1076 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
1077 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
1078 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1079 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
1080 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
1081 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
1082 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
1083 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
1084 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
1085 [“The Rustc book”]: https://doc.rust-lang.org/rustc
1086
1087
1088 Version 1.26.2 (2018-06-05)
1089 ==========================
1090
1091 Compatibility Notes
1092 -------------------
1093
1094 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
1095
1096 [51117]: https://github.com/rust-lang/rust/issues/51117
1097
1098
1099 Version 1.26.1 (2018-05-29)
1100 ==========================
1101
1102 Tools
1103 -----
1104
1105 - [RLS now works on Windows.][50646]
1106 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
1107
1108
1109 Compatibility Notes
1110 --------
1111
1112 - [`fn main() -> impl Trait` no longer works for non-Termination
1113   trait.][50656]
1114   This reverts an accidental stabilization.
1115 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
1116 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
1117
1118 [50646]: https://github.com/rust-lang/rust/issues/50646
1119 [50656]: https://github.com/rust-lang/rust/pull/50656
1120 [50812]: https://github.com/rust-lang/rust/pull/50812
1121 [50950]: https://github.com/rust-lang/rust/issues/50950
1122 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
1123
1124 Version 1.26.0 (2018-05-10)
1125 ==========================
1126
1127 Language
1128 --------
1129 - [Closures now implement `Copy` and/or `Clone` if all captured variables
1130   implement either or both traits.][49299]
1131 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
1132 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
1133   lifetime can be elided.][49458]
1134 - [`impl Trait` is now stable allowing you to have abstract types in returns
1135    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
1136   `fn open(path: impl AsRef<Path>)`.
1137 - [Pattern matching will now automatically apply dereferences.][49394]
1138 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
1139 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
1140 - [A lot of operations are now available in a const context.][46882] E.g. You
1141   can now index into constant arrays, reference and dereference into constants,
1142   and use tuple struct constructors.
1143 - [Fixed entry slice patterns are now stable.][48516] E.g.
1144   ```rust
1145   let points = [1, 2, 3, 4];
1146   match points {
1147       [1, 2, 3, 4] => println!("All points were sequential."),
1148       _ => println!("Not all points were sequential."),
1149   }
1150   ```
1151
1152
1153 Compiler
1154 --------
1155 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
1156 - [Fixed exponential projection complexity on nested types.][48296]
1157   This can provide up to a ~12% reduction in compile times for certain crates.
1158 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
1159   to remap path prefixes outputted by the compiler.
1160 - [Added `powerpc-unknown-netbsd` target.][48281]
1161
1162 Libraries
1163 ---------
1164 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
1165 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
1166   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
1167 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
1168 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
1169 - [`ascii::escape_default` is now available in libcore.][48735]
1170 - [Trailing commas are now supported in std and core macros.][48056]
1171 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
1172 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
1173
1174 Stabilized APIs
1175 ---------------
1176 - [`*const T::add`]
1177 - [`*const T::copy_to_nonoverlapping`]
1178 - [`*const T::copy_to`]
1179 - [`*const T::read_unaligned`]
1180 - [`*const T::read_volatile`]
1181 - [`*const T::read`]
1182 - [`*const T::sub`]
1183 - [`*const T::wrapping_add`]
1184 - [`*const T::wrapping_sub`]
1185 - [`*mut T::add`]
1186 - [`*mut T::copy_to_nonoverlapping`]
1187 - [`*mut T::copy_to`]
1188 - [`*mut T::read_unaligned`]
1189 - [`*mut T::read_volatile`]
1190 - [`*mut T::read`]
1191 - [`*mut T::replace`]
1192 - [`*mut T::sub`]
1193 - [`*mut T::swap`]
1194 - [`*mut T::wrapping_add`]
1195 - [`*mut T::wrapping_sub`]
1196 - [`*mut T::write_bytes`]
1197 - [`*mut T::write_unaligned`]
1198 - [`*mut T::write_volatile`]
1199 - [`*mut T::write`]
1200 - [`Box::leak`]
1201 - [`FromUtf8Error::as_bytes`]
1202 - [`LocalKey::try_with`]
1203 - [`Option::cloned`]
1204 - [`btree_map::Entry::and_modify`]
1205 - [`fs::read_to_string`]
1206 - [`fs::read`]
1207 - [`fs::write`]
1208 - [`hash_map::Entry::and_modify`]
1209 - [`iter::FusedIterator`]
1210 - [`ops::RangeInclusive`]
1211 - [`ops::RangeToInclusive`]
1212 - [`process::id`]
1213 - [`slice::rotate_left`]
1214 - [`slice::rotate_right`]
1215 - [`String::retain`]
1216
1217
1218 Cargo
1219 -----
1220 - [Cargo will now output path to custom commands when `-v` is
1221   passed with `--list`][cargo/5041]
1222 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
1223
1224 Misc
1225 ----
1226 - [The second edition of "The Rust Programming Language" book is now recommended
1227   over the first.][48404]
1228
1229 Compatibility Notes
1230 -------------------
1231
1232 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
1233   syntax is now invalid.
1234   ```
1235   use std::ops::Fn as dyn;
1236   fn g(_: Box<dyn(std::fmt::Debug)>) {}
1237   ```
1238 - [The result of dereferences are no longer promoted to `'static`.][47408]
1239   e.g.
1240   ```rust
1241   fn main() {
1242       const PAIR: &(i32, i32) = &(0, 1);
1243       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
1244   }
1245   ```
1246 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
1247 - [`".e0"` will now no longer parse as `0.0` and will instead cause
1248   an error.][48235]
1249 - [Removed hoedown from rustdoc.][48274]
1250 - [Bounds on higher-kinded lifetimes a hard error.][48326]
1251
1252 [46882]: https://github.com/rust-lang/rust/pull/46882
1253 [47379]: https://github.com/rust-lang/rust/pull/47379
1254 [47408]: https://github.com/rust-lang/rust/pull/47408
1255 [47813]: https://github.com/rust-lang/rust/pull/47813
1256 [48056]: https://github.com/rust-lang/rust/pull/48056
1257 [48125]: https://github.com/rust-lang/rust/pull/48125
1258 [48166]: https://github.com/rust-lang/rust/pull/48166
1259 [48235]: https://github.com/rust-lang/rust/pull/48235
1260 [48274]: https://github.com/rust-lang/rust/pull/48274
1261 [48281]: https://github.com/rust-lang/rust/pull/48281
1262 [48296]: https://github.com/rust-lang/rust/pull/48296
1263 [48326]: https://github.com/rust-lang/rust/pull/48326
1264 [48359]: https://github.com/rust-lang/rust/pull/48359
1265 [48404]: https://github.com/rust-lang/rust/pull/48404
1266 [48481]: https://github.com/rust-lang/rust/pull/48481
1267 [48516]: https://github.com/rust-lang/rust/pull/48516
1268 [48628]: https://github.com/rust-lang/rust/pull/48628
1269 [48629]: https://github.com/rust-lang/rust/pull/48629
1270 [48657]: https://github.com/rust-lang/rust/pull/48657
1271 [48735]: https://github.com/rust-lang/rust/pull/48735
1272 [48978]: https://github.com/rust-lang/rust/pull/48978
1273 [49101]: https://github.com/rust-lang/rust/pull/49101
1274 [49109]: https://github.com/rust-lang/rust/pull/49109
1275 [49121]: https://github.com/rust-lang/rust/pull/49121
1276 [49162]: https://github.com/rust-lang/rust/pull/49162
1277 [49184]: https://github.com/rust-lang/rust/pull/49184
1278 [49234]: https://github.com/rust-lang/rust/pull/49234
1279 [49255]: https://github.com/rust-lang/rust/pull/49255
1280 [49299]: https://github.com/rust-lang/rust/pull/49299
1281 [49305]: https://github.com/rust-lang/rust/pull/49305
1282 [49394]: https://github.com/rust-lang/rust/pull/49394
1283 [49458]: https://github.com/rust-lang/rust/pull/49458
1284 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
1285 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
1286 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
1287 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
1288 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
1289 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
1290 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
1291 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
1292 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
1293 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
1294 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
1295 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
1296 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
1297 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
1298 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
1299 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
1300 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
1301 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
1302 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
1303 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
1304 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
1305 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
1306 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
1307 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
1308 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
1309 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
1310 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
1311 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
1312 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
1313 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
1314 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
1315 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
1316 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
1317 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
1318 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
1319 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
1320 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1321 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
1322 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
1323 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
1324 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
1325 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
1326
1327
1328 Version 1.25.0 (2018-03-29)
1329 ==========================
1330
1331 Language
1332 --------
1333 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
1334 - [You can now use nested groups of imports.][47948]
1335   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
1336 - [You can now have `|` at the start of a match arm.][47947] e.g.
1337 ```rust
1338 enum Foo { A, B, C }
1339
1340 fn main() {
1341     let x = Foo::A;
1342     match x {
1343         | Foo::A
1344         | Foo::B => println!("AB"),
1345         | Foo::C => println!("C"),
1346     }
1347 }
1348 ```
1349
1350 Compiler
1351 --------
1352 - [Upgraded to LLVM 6.][47828]
1353 - [Added `-C lto=val` option.][47521]
1354 - [Added `i586-unknown-linux-musl` target][47282]
1355
1356 Libraries
1357 ---------
1358 - [Impl Send for `process::Command` on Unix.][47760]
1359 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
1360 - [`UnsafeCell::into_inner` is now safe.][47204]
1361 - [Implement libstd for CloudABI.][47268]
1362 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
1363 - [Implement `AsRef<Path>` for Component][46985]
1364 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
1365 - [Moved `Duration` to libcore.][46666]
1366
1367 Stabilized APIs
1368 ---------------
1369 - [`Location::column`]
1370 - [`ptr::NonNull`]
1371
1372 The following functions can now be used in a constant expression.
1373 eg. `static MINUTE: Duration = Duration::from_secs(60);`
1374 - [`Duration::new`][47300]
1375 - [`Duration::from_secs`][47300]
1376 - [`Duration::from_millis`][47300]
1377
1378 Cargo
1379 -----
1380 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
1381 - [`cargo new` now defaults to creating a binary crate, instead of a
1382   library crate.][cargo/5029]
1383
1384 Misc
1385 ----
1386 - [Rust by example is now shipped with new releases][46196]
1387
1388 Compatibility Notes
1389 -------------------
1390 - [Deprecated `net::lookup_host`.][47510]
1391 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
1392 - The borrow checker was sometimes incorrectly permitting overlapping borrows
1393   around indexing operations (see [#47349][47349]). This has been fixed (which also
1394   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
1395 - [Removed deprecated unstable attribute `#[simd]`.][47251]
1396
1397 [33903]: https://github.com/rust-lang/rust/pull/33903
1398 [47947]: https://github.com/rust-lang/rust/pull/47947
1399 [47948]: https://github.com/rust-lang/rust/pull/47948
1400 [47760]: https://github.com/rust-lang/rust/pull/47760
1401 [47790]: https://github.com/rust-lang/rust/pull/47790
1402 [47828]: https://github.com/rust-lang/rust/pull/47828
1403 [47398]: https://github.com/rust-lang/rust/pull/47398
1404 [47510]: https://github.com/rust-lang/rust/pull/47510
1405 [47521]: https://github.com/rust-lang/rust/pull/47521
1406 [47204]: https://github.com/rust-lang/rust/pull/47204
1407 [47251]: https://github.com/rust-lang/rust/pull/47251
1408 [47268]: https://github.com/rust-lang/rust/pull/47268
1409 [47282]: https://github.com/rust-lang/rust/pull/47282
1410 [47300]: https://github.com/rust-lang/rust/pull/47300
1411 [47349]: https://github.com/rust-lang/rust/pull/47349
1412 [46931]: https://github.com/rust-lang/rust/pull/46931
1413 [46985]: https://github.com/rust-lang/rust/pull/46985
1414 [47006]: https://github.com/rust-lang/rust/pull/47006
1415 [46830]: https://github.com/rust-lang/rust/pull/46830
1416 [46095]: https://github.com/rust-lang/rust/pull/46095
1417 [46666]: https://github.com/rust-lang/rust/pull/46666
1418 [46196]: https://github.com/rust-lang/rust/pull/46196
1419 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
1420 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
1421 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
1422 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
1423 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
1424
1425
1426 Version 1.24.1 (2018-03-01)
1427 ==========================
1428
1429  - [Do not abort when unwinding through FFI][48251]
1430  - [Emit UTF-16 files for linker arguments on Windows][48318]
1431  - [Make the error index generator work again][48308]
1432  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
1433
1434 [48251]: https://github.com/rust-lang/rust/issues/48251
1435 [48308]: https://github.com/rust-lang/rust/issues/48308
1436 [48318]: https://github.com/rust-lang/rust/issues/48318
1437 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
1438
1439
1440 Version 1.24.0 (2018-02-15)
1441 ==========================
1442
1443 Language
1444 --------
1445 - [External `sysv64` ffi is now available.][46528]
1446   eg. `extern "sysv64" fn foo () {}`
1447
1448 Compiler
1449 --------
1450 - [rustc now uses 16 codegen units by default for release builds.][46910]
1451   For the fastest builds, utilize `codegen-units=1`.
1452 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1453 - [Add `aarch64-unknown-openbsd` support][46760]
1454
1455 Libraries
1456 ---------
1457 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1458   improvement in performance in the majority of cases.
1459 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1460   with Windows.][46798]
1461 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1462 - [impl `From<bool>` for `AtomicBool`][46293]
1463 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1464 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1465 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1466 - [float::from_bits now just uses transmute.][46012] This provides
1467   some optimisations from LLVM.
1468 - [Copied `AsciiExt` methods onto `char`][46077]
1469 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1470 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1471 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1472 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1473
1474 Stabilized APIs
1475 ---------------
1476 - [`RefCell::replace`]
1477 - [`RefCell::swap`]
1478 - [`atomic::spin_loop_hint`]
1479
1480 The following functions can now be used in a constant expression.
1481 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1482
1483 - [`AtomicBool::new`][46287]
1484 - [`AtomicUsize::new`][46287]
1485 - [`AtomicIsize::new`][46287]
1486 - [`AtomicPtr::new`][46287]
1487 - [`Cell::new`][46287]
1488 - [`{integer}::min_value`][46287]
1489 - [`{integer}::max_value`][46287]
1490 - [`mem::size_of`][46287]
1491 - [`mem::align_of`][46287]
1492 - [`ptr::null`][46287]
1493 - [`ptr::null_mut`][46287]
1494 - [`RefCell::new`][46287]
1495 - [`UnsafeCell::new`][46287]
1496
1497 Cargo
1498 -----
1499 - [Added a `workspace.default-members` config that
1500   overrides implied `--all` in virtual workspaces.][cargo/4743]
1501 - [Enable incremental by default on development builds.][cargo/4817] Also added
1502   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1503   per-project or global basis respectively.
1504
1505 Misc
1506 ----
1507
1508 Compatibility Notes
1509 -------------------
1510 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1511 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1512   in accordance with IETF RFC 4291 §2.2.
1513 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1514 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1515   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1516 - [Leading zeros in tuple struct members is now an error][47084]
1517 - [`column!()` macro is one-based instead of zero-based][46977]
1518 - [`fmt::Arguments` can no longer be shared across threads][45198]
1519 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1520 - [Cargo sets a different working directory for the compiler][cargo/4788]
1521
1522 [44884]: https://github.com/rust-lang/rust/pull/44884
1523 [45198]: https://github.com/rust-lang/rust/pull/45198
1524 [45506]: https://github.com/rust-lang/rust/pull/45506
1525 [45904]: https://github.com/rust-lang/rust/pull/45904
1526 [45990]: https://github.com/rust-lang/rust/pull/45990
1527 [46012]: https://github.com/rust-lang/rust/pull/46012
1528 [46077]: https://github.com/rust-lang/rust/pull/46077
1529 [46094]: https://github.com/rust-lang/rust/pull/46094
1530 [46284]: https://github.com/rust-lang/rust/pull/46284
1531 [46287]: https://github.com/rust-lang/rust/pull/46287
1532 [46293]: https://github.com/rust-lang/rust/pull/46293
1533 [46528]: https://github.com/rust-lang/rust/pull/46528
1534 [46671]: https://github.com/rust-lang/rust/pull/46671
1535 [46713]: https://github.com/rust-lang/rust/pull/46713
1536 [46735]: https://github.com/rust-lang/rust/pull/46735
1537 [46749]: https://github.com/rust-lang/rust/pull/46749
1538 [46760]: https://github.com/rust-lang/rust/pull/46760
1539 [46798]: https://github.com/rust-lang/rust/pull/46798
1540 [46828]: https://github.com/rust-lang/rust/pull/46828
1541 [46831]: https://github.com/rust-lang/rust/pull/46831
1542 [46833]: https://github.com/rust-lang/rust/pull/46833
1543 [46910]: https://github.com/rust-lang/rust/pull/46910
1544 [46977]: https://github.com/rust-lang/rust/pull/46977
1545 [47018]: https://github.com/rust-lang/rust/pull/47018
1546 [47080]: https://github.com/rust-lang/rust/pull/47080
1547 [47084]: https://github.com/rust-lang/rust/pull/47084
1548 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1549 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1550 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1551 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1552 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1553 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1554
1555
1556 Version 1.23.0 (2018-01-04)
1557 ==========================
1558
1559 Language
1560 --------
1561 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1562 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1563   Which should fix some confusing errors in some operations.
1564
1565 Compiler
1566 --------
1567 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1568   undefined behavior.][45920]
1569 - [rustc now suggests renaming import if names clash.][45660]
1570 - [Display errors/warnings correctly when there are zero-width or
1571   wide characters.][45711]
1572 - [rustc now avoids unnecessary copies of arguments that are
1573   simple bindings][45380] This should improve memory usage on average by 5-10%.
1574 - [Updated musl used to build musl rustc to 1.1.17][45393]
1575
1576 Libraries
1577 ---------
1578 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1579 - [Implement Hash for raw pointers to unsized types][45483]
1580 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1581 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1582 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1583 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1584   and `<*mut T>::as_mut`][44932]
1585 - [Optimized `Thread::{park, unpark}` implementation][45524]
1586 - [Improved `SliceExt::binary_search` performance.][45333]
1587 - [impl `FromIterator<()>` for `()`][45379]
1588 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1589   is now deprecated.
1590
1591 Stabilized APIs
1592 ---------------
1593
1594 Cargo
1595 -----
1596 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1597   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1598 - [Added unit test checking to `cargo check`][cargo/4592]
1599 - [Cargo now lets you install a specific version
1600   using `cargo install --version`][cargo/4637]
1601
1602 Misc
1603 ----
1604 - [Releases now ship with the Cargo book documentation.][45692]
1605 - [rustdoc now prints rendering warnings on every run.][45324]
1606
1607 Compatibility Notes
1608 -------------------
1609 - [Changes have been made to type equality to make it more correct,
1610   in rare cases this could break some code.][45853] [Tracking issue for
1611   further information][45852]
1612 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1613 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1614   Android 9, the minimum supported version is Android 14.
1615 - [Bumped the minimum LLVM to 3.9][45326]
1616
1617 [44042]: https://github.com/rust-lang/rust/pull/44042
1618 [44932]: https://github.com/rust-lang/rust/pull/44932
1619 [45267]: https://github.com/rust-lang/rust/pull/45267
1620 [45324]: https://github.com/rust-lang/rust/pull/45324
1621 [45326]: https://github.com/rust-lang/rust/pull/45326
1622 [45333]: https://github.com/rust-lang/rust/pull/45333
1623 [45379]: https://github.com/rust-lang/rust/pull/45379
1624 [45380]: https://github.com/rust-lang/rust/pull/45380
1625 [45393]: https://github.com/rust-lang/rust/pull/45393
1626 [45435]: https://github.com/rust-lang/rust/pull/45435
1627 [45483]: https://github.com/rust-lang/rust/pull/45483
1628 [45524]: https://github.com/rust-lang/rust/pull/45524
1629 [45571]: https://github.com/rust-lang/rust/pull/45571
1630 [45580]: https://github.com/rust-lang/rust/pull/45580
1631 [45610]: https://github.com/rust-lang/rust/pull/45610
1632 [45660]: https://github.com/rust-lang/rust/pull/45660
1633 [45692]: https://github.com/rust-lang/rust/pull/45692
1634 [45711]: https://github.com/rust-lang/rust/pull/45711
1635 [45772]: https://github.com/rust-lang/rust/pull/45772
1636 [45852]: https://github.com/rust-lang/rust/issues/45852
1637 [45853]: https://github.com/rust-lang/rust/pull/45853
1638 [45887]: https://github.com/rust-lang/rust/pull/45887
1639 [45920]: https://github.com/rust-lang/rust/pull/45920
1640 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1641 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1642 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1643
1644
1645 Version 1.22.1 (2017-11-22)
1646 ==========================
1647
1648 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1649
1650 [46183]: https://github.com/rust-lang/rust/pull/46183
1651
1652 Version 1.22.0 (2017-11-22)
1653 ==========================
1654
1655 Language
1656 --------
1657 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1658 - [Now accepts underscores in unicode escapes][43716]
1659 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1660 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1661
1662 Compiler
1663 --------
1664 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1665 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1666   This should decrease compile times for debug builds.
1667 - [strict memory alignment now enabled on ARMv6][45094]
1668 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1669
1670 Libraries
1671 ---------
1672 - [Allow atomic operations up to 32 bits
1673   on `armv5te_unknown_linux_gnueabi`][44978]
1674 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1675 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1676 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1677 - [Properly detect overflow in `Instant += Duration`.][44220]
1678 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1679 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1680 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1681
1682 Stabilized APIs
1683 ---------------
1684
1685 Cargo
1686 -----
1687 - [Cargo will now build multi file examples in subdirectories of the `examples`
1688   folder that have a `main.rs` file.][cargo/4496]
1689 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1690   the old format will continue to work and can be updated with `cargo update`.
1691 - [Now supports vendoring git repositories][cargo/3992]
1692
1693 Misc
1694 ----
1695 - [`libbacktrace` is now available on Apple platforms.][44251]
1696 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1697   This now lets you specify that a given code example will fail to compile.
1698
1699 Compatibility Notes
1700 -------------------
1701 - [The minimum Android version that rustc can build for has been bumped
1702   to `4.0` from `2.3`][45656]
1703 - [Allowing `T op= &T` for numeric types has broken some type
1704   inference cases][45480]
1705
1706
1707 [42526]: https://github.com/rust-lang/rust/pull/42526
1708 [43017]: https://github.com/rust-lang/rust/pull/43017
1709 [43716]: https://github.com/rust-lang/rust/pull/43716
1710 [43949]: https://github.com/rust-lang/rust/pull/43949
1711 [44015]: https://github.com/rust-lang/rust/pull/44015
1712 [44220]: https://github.com/rust-lang/rust/pull/44220
1713 [44251]: https://github.com/rust-lang/rust/pull/44251
1714 [44287]: https://github.com/rust-lang/rust/pull/44287
1715 [44303]: https://github.com/rust-lang/rust/pull/44303
1716 [44456]: https://github.com/rust-lang/rust/pull/44456
1717 [44466]: https://github.com/rust-lang/rust/pull/44466
1718 [44895]: https://github.com/rust-lang/rust/pull/44895
1719 [44966]: https://github.com/rust-lang/rust/pull/44966
1720 [44978]: https://github.com/rust-lang/rust/pull/44978
1721 [45041]: https://github.com/rust-lang/rust/pull/45041
1722 [45064]: https://github.com/rust-lang/rust/pull/45064
1723 [45075]: https://github.com/rust-lang/rust/pull/45075
1724 [45094]: https://github.com/rust-lang/rust/pull/45094
1725 [45095]: https://github.com/rust-lang/rust/pull/45095
1726 [45480]: https://github.com/rust-lang/rust/issues/45480
1727 [45656]: https://github.com/rust-lang/rust/pull/45656
1728 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1729 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1730 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1731
1732
1733
1734
1735
1736
1737 Version 1.21.0 (2017-10-12)
1738 ==========================
1739
1740 Language
1741 --------
1742 - [You can now use static references for literals.][43838]
1743   Example:
1744   ```rust
1745   fn main() {
1746       let x: &'static u32 = &0;
1747   }
1748   ```
1749 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1750   Example:
1751   ```rust
1752   my_macro!(Vec<i32>::new); // Always worked
1753   my_macro!(Vec::<i32>::new); // Now works
1754   ```
1755
1756 Compiler
1757 --------
1758 - [Upgraded jemalloc to 4.5.0][43911]
1759 - [Enabled unwinding panics on Redox][43917]
1760 - [Now runs LLVM in parallel during translation phase.][43506]
1761   This should reduce peak memory usage.
1762
1763 Libraries
1764 ---------
1765 - [Generate builtin impls for `Clone` for all arrays and tuples that
1766   are `T: Clone`][43690]
1767 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1768 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1769   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1770
1771 Stabilized APIs
1772 ---------------
1773
1774 [`std::mem::discriminant`]
1775
1776 Cargo
1777 -----
1778 - [You can now call `cargo install` with multiple package names][cargo/4216]
1779 - [Cargo commands inside a virtual workspace will now implicitly
1780   pass `--all`][cargo/4335]
1781 - [Added a `[patch]` section to `Cargo.toml` to handle
1782   prepublication dependencies][cargo/4123] [RFC 1969]
1783 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1784   like patterns][cargo/4270]
1785 - [Added the `--all-targets` option][cargo/4400]
1786 - [Using required dependencies as a feature is now deprecated and emits
1787   a warning][cargo/4364]
1788
1789
1790 Misc
1791 ----
1792 - [Cargo docs are moving][43916]
1793   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1794 - [The rustdoc book is now available][43863]
1795   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1796 - [Added a preview of RLS has been made available through rustup][44204]
1797   Install with `rustup component add rls-preview`
1798 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1799   Previously only showed `std::os::unix`.
1800
1801 Compatibility Notes
1802 -------------------
1803 - [Changes in method matching against higher-ranked types][43880] This may cause
1804   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1805 - [rustc's JSON error output's byte position start at top of file.][42973]
1806   Was previously relative to the rustc's internal `CodeMap` struct which
1807   required the unstable library `libsyntax` to correctly use.
1808 - [`unused_results` lint no longer ignores booleans][43728]
1809
1810 [42565]: https://github.com/rust-lang/rust/pull/42565
1811 [42973]: https://github.com/rust-lang/rust/pull/42973
1812 [43348]: https://github.com/rust-lang/rust/pull/43348
1813 [43459]: https://github.com/rust-lang/rust/pull/43459
1814 [43506]: https://github.com/rust-lang/rust/pull/43506
1815 [43540]: https://github.com/rust-lang/rust/pull/43540
1816 [43690]: https://github.com/rust-lang/rust/pull/43690
1817 [43728]: https://github.com/rust-lang/rust/pull/43728
1818 [43838]: https://github.com/rust-lang/rust/pull/43838
1819 [43863]: https://github.com/rust-lang/rust/pull/43863
1820 [43880]: https://github.com/rust-lang/rust/pull/43880
1821 [43911]: https://github.com/rust-lang/rust/pull/43911
1822 [43916]: https://github.com/rust-lang/rust/pull/43916
1823 [43917]: https://github.com/rust-lang/rust/pull/43917
1824 [44204]: https://github.com/rust-lang/rust/pull/44204
1825 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1826 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1827 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1828 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1829 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1830 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1831 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1832 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1833 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1834
1835 Version 1.20.0 (2017-08-31)
1836 ===========================
1837
1838 Language
1839 --------
1840 - [Associated constants are now stabilised.][42809]
1841 - [A lot of macro bugs are now fixed.][42913]
1842
1843 Compiler
1844 --------
1845
1846 - [Struct fields are now properly coerced to the expected field type.][42807]
1847 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1848   `wasm32-experimental-emscripten` target.
1849 - [Changed some of the error messages to be more helpful.][42033]
1850 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1851   it.][43170]
1852 - [rustc now reports the total number of errors on compilation failure][43015]
1853   previously this was only the number of errors in the pass that failed.
1854 - [Expansion in rustc has been sped up 29x.][42533]
1855 - [added `msp430-none-elf` target.][43099]
1856 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1857   applicable][43178]
1858 - [Fixes backtraces on Redox][43228]
1859 - [rustc now identifies different versions of same crate when absolute paths of
1860   different types match in an error message.][42826]
1861
1862 Libraries
1863 ---------
1864
1865
1866 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1867 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1868   tuples.][43011]
1869 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1870   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1871 - [Impl `Clone` for `DefaultHasher`.][42799]
1872 - [Impl `Sync` for `SyncSender`.][42397]
1873 - [Impl `FromStr` for `char`][42271]
1874 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1875   NaN.][42431]
1876 - [allow messages in the `unimplemented!()` macro.][42155]
1877   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1878 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1879 - [Upgrade to Unicode 10.0.0][42999]
1880 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1881 - [Skip the main thread's manual stack guard on Linux][43072]
1882 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1883 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1884   previously 2^15.
1885 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1886
1887 Stabilized APIs
1888 ---------------
1889
1890 - [`CStr::into_c_string`]
1891 - [`CString::as_c_str`]
1892 - [`CString::into_boxed_c_str`]
1893 - [`Chain::get_mut`]
1894 - [`Chain::get_ref`]
1895 - [`Chain::into_inner`]
1896 - [`Option::get_or_insert_with`]
1897 - [`Option::get_or_insert`]
1898 - [`OsStr::into_os_string`]
1899 - [`OsString::into_boxed_os_str`]
1900 - [`Take::get_mut`]
1901 - [`Take::get_ref`]
1902 - [`Utf8Error::error_len`]
1903 - [`char::EscapeDebug`]
1904 - [`char::escape_debug`]
1905 - [`compile_error!`]
1906 - [`f32::from_bits`]
1907 - [`f32::to_bits`]
1908 - [`f64::from_bits`]
1909 - [`f64::to_bits`]
1910 - [`mem::ManuallyDrop`]
1911 - [`slice::sort_unstable_by_key`]
1912 - [`slice::sort_unstable_by`]
1913 - [`slice::sort_unstable`]
1914 - [`str::from_boxed_utf8_unchecked`]
1915 - [`str::as_bytes_mut`]
1916 - [`str::as_bytes_mut`]
1917 - [`str::from_utf8_mut`]
1918 - [`str::from_utf8_unchecked_mut`]
1919 - [`str::get_mut`]
1920 - [`str::get_unchecked_mut`]
1921 - [`str::get_unchecked`]
1922 - [`str::get`]
1923 - [`str::into_boxed_bytes`]
1924
1925
1926 Cargo
1927 -----
1928 - [Cargo API token location moved from `~/.cargo/config` to
1929   `~/.cargo/credentials`.][cargo/3978]
1930 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1931   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1932   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1933 - [You can now specify version of a binary when installed through
1934   `cargo install` using `--vers`.][cargo/4229]
1935 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1936   failure.][cargo/4248]
1937 - [Changed the convention around which file is the crate root.][cargo/4259]
1938 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1939   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1940
1941 Compatibility Notes
1942 -------------------
1943
1944 - [Functions with `'static` in their return types will now not be as usable as
1945   if they were using lifetime parameters instead.][42417]
1946 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1947   takes the sign of NaN into account where previously didn't.][42430]
1948
1949 [42033]: https://github.com/rust-lang/rust/pull/42033
1950 [42155]: https://github.com/rust-lang/rust/pull/42155
1951 [42271]: https://github.com/rust-lang/rust/pull/42271
1952 [42397]: https://github.com/rust-lang/rust/pull/42397
1953 [42417]: https://github.com/rust-lang/rust/pull/42417
1954 [42430]: https://github.com/rust-lang/rust/pull/42430
1955 [42431]: https://github.com/rust-lang/rust/pull/42431
1956 [42533]: https://github.com/rust-lang/rust/pull/42533
1957 [42571]: https://github.com/rust-lang/rust/pull/42571
1958 [42613]: https://github.com/rust-lang/rust/pull/42613
1959 [42799]: https://github.com/rust-lang/rust/pull/42799
1960 [42807]: https://github.com/rust-lang/rust/pull/42807
1961 [42809]: https://github.com/rust-lang/rust/pull/42809
1962 [42822]: https://github.com/rust-lang/rust/pull/42822
1963 [42826]: https://github.com/rust-lang/rust/pull/42826
1964 [42854]: https://github.com/rust-lang/rust/pull/42854
1965 [42913]: https://github.com/rust-lang/rust/pull/42913
1966 [42999]: https://github.com/rust-lang/rust/pull/42999
1967 [43011]: https://github.com/rust-lang/rust/pull/43011
1968 [43015]: https://github.com/rust-lang/rust/pull/43015
1969 [43072]: https://github.com/rust-lang/rust/pull/43072
1970 [43077]: https://github.com/rust-lang/rust/pull/43077
1971 [43097]: https://github.com/rust-lang/rust/pull/43097
1972 [43099]: https://github.com/rust-lang/rust/pull/43099
1973 [43170]: https://github.com/rust-lang/rust/pull/43170
1974 [43178]: https://github.com/rust-lang/rust/pull/43178
1975 [43185]: https://github.com/rust-lang/rust/pull/43185
1976 [43228]: https://github.com/rust-lang/rust/pull/43228
1977 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1978 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1979 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1980 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1981 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1982 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1983 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1984 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1985 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1986 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1987 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1988 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1989 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1990 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1991 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1992 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1993 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1994 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1995 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1996 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1997 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1998 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1999 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2000 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
2001 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
2002 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
2003 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
2004 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
2005 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
2006 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
2007 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
2008 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
2009 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
2010 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
2011 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
2012 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
2013 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
2014 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
2015 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
2016
2017
2018 Version 1.19.0 (2017-07-20)
2019 ===========================
2020
2021 Language
2022 --------
2023
2024 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
2025   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
2026 - [Macro recursion limit increased to 1024 from 64.][41676]
2027 - [Added lint for detecting unused macros.][41907]
2028 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
2029   For example: `let x = loop { break 7; };`
2030 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
2031   contain `Copy` types and cannot have a `Drop` implementation.
2032   Example: `union Foo { bar: u8, baz: usize }`
2033 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
2034   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
2035
2036 Compiler
2037 --------
2038
2039 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
2040 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
2041   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
2042   you should use `--target armv7-linux-androideabi`.
2043 - [Fixed ICE when removing a source file between compilation sessions.][41873]
2044 - [Minor optimisation of string operations.][42037]
2045 - [Compiler error message is now `aborting due to previous error(s)` instead of
2046   `aborting due to N previous errors`][42150] This was previously inaccurate and
2047   would only count certain kinds of errors.
2048 - [The compiler now supports Visual Studio 2017][42225]
2049 - [The compiler is now built against LLVM 4.0.1 by default][42948]
2050 - [Added a lot][42264] of [new error codes][42302]
2051 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
2052   libraries with C Run-time Libraries(CRT) to be statically linked.
2053 - [Fixed various ARM codegen bugs][42740]
2054
2055 Libraries
2056 ---------
2057
2058 - [`String` now implements `FromIterator<Cow<'a, str>>` and
2059   `Extend<Cow<'a, str>>`][41449]
2060 - [`Vec` now implements `From<&mut [T]>`][41530]
2061 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
2062 - [`SplitWhitespace` now implements `Clone`][41659]
2063 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
2064   1.5x faster][41764]
2065 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
2066   macros, but for printing to stderr.
2067
2068 Stabilized APIs
2069 ---------------
2070
2071 - [`OsString::shrink_to_fit`]
2072 - [`cmp::Reverse`]
2073 - [`Command::envs`]
2074 - [`thread::ThreadId`]
2075
2076 Cargo
2077 -----
2078
2079 - [Build scripts can now add environment variables to the environment
2080   the crate is being compiled in.
2081   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
2082 - [Subcommands now replace the current process rather than spawning a new
2083   child process][cargo/3970]
2084 - [Workspace members can now accept glob file patterns][cargo/3979]
2085 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
2086   the members in a given workspace.][cargo/3988]
2087 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
2088 - [Target directory path is now in the cargo metadata][cargo/4022]
2089 - [Cargo no longer checks out a local working directory for the
2090   crates.io index][cargo/4026] This should provide smaller file size for the
2091   registry, and improve cloning times, especially on Windows machines.
2092 - [Added an `--exclude` option for excluding certain packages when using the
2093   `--all` option][cargo/4031]
2094 - [Cargo will now automatically retry when receiving a 5xx error
2095   from crates.io][cargo/4032]
2096 - [The `--features` option now accepts multiple comma or space
2097   delimited values.][cargo/4084]
2098 - [Added support for custom target specific runners][cargo/3954]
2099
2100 Misc
2101 ----
2102
2103 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
2104   Windows Debugger.
2105 - [Rust will now release XZ compressed packages][rust-installer/57]
2106 - [rustup will now prefer to download rust packages with
2107   XZ compression][rustup/1100] over GZip packages.
2108 - [Added the ability to escape `#` in rust documentation][41785] By adding
2109   additional `#`'s ie. `##` is now `#`
2110
2111 Compatibility Notes
2112 -------------------
2113
2114 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
2115 - [`-Z` flags are now no longer allowed to be used on the stable
2116   compiler.][41751] This has been a warning for a year previous to this.
2117 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
2118   longer works][42844]. Users should migrate to the built-in `check`
2119   command, which has been available since 1.16.
2120 - [Ending a float literal with `._` is now a hard error.
2121   Example: `42._` .][41946]
2122 - [Any use of a private `extern crate` outside of its module is now a
2123   hard error.][36886] This was previously a warning.
2124 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
2125   relative while the `::` prefix makes a path absolute, but was ignored and the
2126   path was relative regardless.
2127 - [Floating point constants in match patterns is now a hard error][36890]
2128   This was previously a warning.
2129 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
2130   match patterns is now a hard error][36891] This was previously a warning.
2131 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
2132   a warning.
2133 - [From the pound escape, lines consisting of multiple `#`s are
2134   now visible][41785]
2135 - [It is an error to re-export private enum variants][42460]. This is
2136   known to break a number of crates that depend on an older version of
2137   mustache.
2138 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
2139   to use it to find the linker, and the build will fail where it did
2140   not previously][42607]
2141
2142 [36886]: https://github.com/rust-lang/rust/issues/36886
2143 [36888]: https://github.com/rust-lang/rust/issues/36888
2144 [36890]: https://github.com/rust-lang/rust/issues/36890
2145 [36891]: https://github.com/rust-lang/rust/issues/36891
2146 [36892]: https://github.com/rust-lang/rust/issues/36892
2147 [37406]: https://github.com/rust-lang/rust/issues/37406
2148 [39983]: https://github.com/rust-lang/rust/pull/39983
2149 [41145]: https://github.com/rust-lang/rust/pull/41145
2150 [41192]: https://github.com/rust-lang/rust/pull/41192
2151 [41258]: https://github.com/rust-lang/rust/pull/41258
2152 [41370]: https://github.com/rust-lang/rust/pull/41370
2153 [41449]: https://github.com/rust-lang/rust/pull/41449
2154 [41530]: https://github.com/rust-lang/rust/pull/41530
2155 [41624]: https://github.com/rust-lang/rust/pull/41624
2156 [41656]: https://github.com/rust-lang/rust/pull/41656
2157 [41659]: https://github.com/rust-lang/rust/pull/41659
2158 [41676]: https://github.com/rust-lang/rust/pull/41676
2159 [41751]: https://github.com/rust-lang/rust/pull/41751
2160 [41764]: https://github.com/rust-lang/rust/pull/41764
2161 [41785]: https://github.com/rust-lang/rust/pull/41785
2162 [41873]: https://github.com/rust-lang/rust/pull/41873
2163 [41907]: https://github.com/rust-lang/rust/pull/41907
2164 [41946]: https://github.com/rust-lang/rust/pull/41946
2165 [42016]: https://github.com/rust-lang/rust/pull/42016
2166 [42037]: https://github.com/rust-lang/rust/pull/42037
2167 [42068]: https://github.com/rust-lang/rust/pull/42068
2168 [42150]: https://github.com/rust-lang/rust/pull/42150
2169 [42162]: https://github.com/rust-lang/rust/pull/42162
2170 [42225]: https://github.com/rust-lang/rust/pull/42225
2171 [42264]: https://github.com/rust-lang/rust/pull/42264
2172 [42302]: https://github.com/rust-lang/rust/pull/42302
2173 [42460]: https://github.com/rust-lang/rust/issues/42460
2174 [42607]: https://github.com/rust-lang/rust/issues/42607
2175 [42740]: https://github.com/rust-lang/rust/pull/42740
2176 [42844]: https://github.com/rust-lang/rust/issues/42844
2177 [42948]: https://github.com/rust-lang/rust/pull/42948
2178 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
2179 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
2180 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
2181 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
2182 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
2183 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
2184 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
2185 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
2186 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
2187 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
2188 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
2189 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
2190 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
2191 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
2192 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
2193 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
2194 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
2195 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
2196 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
2197 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
2198 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
2199 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
2200
2201
2202 Version 1.18.0 (2017-06-08)
2203 ===========================
2204
2205 Language
2206 --------
2207
2208 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
2209   make the item visible to just that module tree. Also accepts the keyword
2210   `crate` to make something public to the whole crate but not users of the
2211   library. Example: `pub(crate) mod utils;`. [RFC 1422].
2212 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
2213   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
2214 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
2215   types like `Write + Send`, trailing `+` are now supported in trait objects,
2216   and better error reporting for trait objects starting with `?Sized`.
2217 - [0e+10 is now a valid floating point literal][40589]
2218 - [Now warns if you bind a lifetime parameter to 'static][40734]
2219 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
2220   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
2221   representation in some cases.][40377]
2222
2223 Compiler
2224 --------
2225
2226 - [rustc can now emit mir with `--emit mir`][39891]
2227 - [Improved LLVM IR for trivial functions][40367]
2228 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
2229 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
2230   opportunities found through profiling
2231 - [Improved backtrace formatting when panicking][38165]
2232
2233 Libraries
2234 ---------
2235
2236 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
2237   iterator hasn't been advanced the original `Vec` is reassembled with no actual
2238   iteration or reallocation.
2239 - [Simplified HashMap Bucket interface][40561] provides performance
2240   improvements for iterating and cloning.
2241 - [Specialize Vec::from_elem to use calloc][40409]
2242 - [Fixed Race condition in fs::create_dir_all][39799]
2243 - [No longer caching stdio on Windows][40516]
2244 - [Optimized insertion sort in slice][40807] insertion sort in some cases
2245   2.50%~ faster and in one case now 12.50% faster.
2246 - [Optimized `AtomicBool::fetch_nand`][41143]
2247
2248 Stabilized APIs
2249 ---------------
2250
2251 - [`Child::try_wait`]
2252 - [`HashMap::retain`]
2253 - [`HashSet::retain`]
2254 - [`PeekMut::pop`]
2255 - [`TcpStream::peek`]
2256 - [`UdpSocket::peek`]
2257 - [`UdpSocket::peek_from`]
2258
2259 Cargo
2260 -----
2261
2262 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
2263   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
2264 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
2265 - [Added Android build support][cargo/3885]
2266 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
2267   of a certain type, for example `cargo build --bins` will build all
2268   binaries.
2269 - [Added support for haiku][cargo/3952]
2270
2271 Misc
2272 ----
2273
2274 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
2275 - [Added rust-windbg script for better debugging on Windows][39983]
2276 - [Rust now uses the official cross compiler for NetBSD][40612]
2277 - [rustdoc now accepts `#` at the start of files][40828]
2278 - [Fixed jemalloc support for musl][41168]
2279
2280 Compatibility Notes
2281 -------------------
2282
2283 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
2284   always placed after the sign if it exists and before the digits. With the `#`
2285   flag the zeroes are placed after the prefix and before the digits.
2286 - [Due to the struct field optimisation][40377], using `transmute` on structs
2287   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
2288   always been undefined behavior, but is now more likely to break in practice.
2289 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
2290   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
2291   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
2292 - [Overlapping inherent `impl`s are now a hard error][40728]
2293 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
2294 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
2295   `out.asm` and `out.ll` instead of only one of the filetypes.
2296 - [ calling a function that returns `Self` will no longer work][41805] when
2297   the size of `Self` cannot be statically determined.
2298 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
2299   this has caused a few regressions namely:
2300
2301   - Changed the link order of local static/dynamic libraries (respecting the
2302     order on given rather than having the compiler reorder).
2303   - Changed how MinGW is linked, native code linked to dynamic libraries
2304     may require manually linking to the gcc support library (for the native
2305     code itself)
2306
2307 [38165]: https://github.com/rust-lang/rust/pull/38165
2308 [39799]: https://github.com/rust-lang/rust/pull/39799
2309 [39891]: https://github.com/rust-lang/rust/pull/39891
2310 [39983]: https://github.com/rust-lang/rust/pull/39983
2311 [40043]: https://github.com/rust-lang/rust/pull/40043
2312 [40241]: https://github.com/rust-lang/rust/pull/40241
2313 [40338]: https://github.com/rust-lang/rust/pull/40338
2314 [40367]: https://github.com/rust-lang/rust/pull/40367
2315 [40377]: https://github.com/rust-lang/rust/pull/40377
2316 [40409]: https://github.com/rust-lang/rust/pull/40409
2317 [40516]: https://github.com/rust-lang/rust/pull/40516
2318 [40556]: https://github.com/rust-lang/rust/pull/40556
2319 [40561]: https://github.com/rust-lang/rust/pull/40561
2320 [40589]: https://github.com/rust-lang/rust/pull/40589
2321 [40612]: https://github.com/rust-lang/rust/pull/40612
2322 [40723]: https://github.com/rust-lang/rust/pull/40723
2323 [40728]: https://github.com/rust-lang/rust/pull/40728
2324 [40731]: https://github.com/rust-lang/rust/pull/40731
2325 [40734]: https://github.com/rust-lang/rust/pull/40734
2326 [40805]: https://github.com/rust-lang/rust/pull/40805
2327 [40807]: https://github.com/rust-lang/rust/pull/40807
2328 [40828]: https://github.com/rust-lang/rust/pull/40828
2329 [40870]: https://github.com/rust-lang/rust/pull/40870
2330 [41085]: https://github.com/rust-lang/rust/pull/41085
2331 [41143]: https://github.com/rust-lang/rust/pull/41143
2332 [41168]: https://github.com/rust-lang/rust/pull/41168
2333 [41270]: https://github.com/rust-lang/rust/issues/41270
2334 [41469]: https://github.com/rust-lang/rust/pull/41469
2335 [41805]: https://github.com/rust-lang/rust/issues/41805
2336 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
2337 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
2338 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
2339 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
2340 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
2341 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
2342 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
2343 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
2344 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
2345 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
2346 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
2347 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
2348 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
2349 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
2350
2351
2352 Version 1.17.0 (2017-04-27)
2353 ===========================
2354
2355 Language
2356 --------
2357
2358 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
2359 * [Fields of structs may be initialized without duplicating the field/variable
2360   names][39761]. [RFC 1682]
2361 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
2362 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2363   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
2364   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
2365   `'b`. Soundness fix.
2366 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
2367 * [Static variables may contain references to other statics][40027]
2368
2369 Compiler
2370 --------
2371
2372 * [Exit quickly on only `--emit dep-info`][40336]
2373 * [Make `-C relocation-model` more correctly determine whether the linker
2374   creates a position-independent executable][40245]
2375 * [Add `-C overflow-checks` to directly control whether integer overflow
2376   panics][40037]
2377 * [The rustc type checker now checks items on demand instead of in a single
2378   in-order pass][40008]. This is mostly an internal refactoring in support of
2379   future work, including incremental type checking, but also resolves [RFC
2380   1647], allowing `Self` to appear in `impl` `where` clauses.
2381 * [Optimize vtable loads][39995]
2382 * [Turn off vectorization for Emscripten targets][39990]
2383 * [Provide suggestions for unknown macros imported with `use`][39953]
2384 * [Fix ICEs in path resolution][39939]
2385 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
2386 * [Add clearer error message using `&str + &str`][39116]
2387
2388 Stabilized APIs
2389 ---------------
2390
2391 * [`Arc::into_raw`]
2392 * [`Arc::from_raw`]
2393 * [`Arc::ptr_eq`]
2394 * [`Rc::into_raw`]
2395 * [`Rc::from_raw`]
2396 * [`Rc::ptr_eq`]
2397 * [`Ordering::then`]
2398 * [`Ordering::then_with`]
2399 * [`BTreeMap::range`]
2400 * [`BTreeMap::range_mut`]
2401 * [`collections::Bound`]
2402 * [`process::abort`]
2403 * [`ptr::read_unaligned`]
2404 * [`ptr::write_unaligned`]
2405 * [`Result::expect_err`]
2406 * [`Cell::swap`]
2407 * [`Cell::replace`]
2408 * [`Cell::into_inner`]
2409 * [`Cell::take`]
2410
2411 Libraries
2412 ---------
2413
2414 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
2415 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
2416 * [`String` implements `FromIterator<&char>`][40028]
2417 * `Box` [implements][40009] a number of new conversions:
2418   `From<Box<str>> for String`,
2419   `From<Box<[T]>> for Vec<T>`,
2420   `From<Box<CStr>> for CString`,
2421   `From<Box<OsStr>> for OsString`,
2422   `From<Box<Path>> for PathBuf`,
2423   `Into<Box<str>> for String`,
2424   `Into<Box<[T]>> for Vec<T>`,
2425   `Into<Box<CStr>> for CString`,
2426   `Into<Box<OsStr>> for OsString`,
2427   `Into<Box<Path>> for PathBuf`,
2428   `Default for Box<str>`,
2429   `Default for Box<CStr>`,
2430   `Default for Box<OsStr>`,
2431   `From<&CStr> for Box<CStr>`,
2432   `From<&OsStr> for Box<OsStr>`,
2433   `From<&Path> for Box<Path>`
2434 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
2435 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
2436 * [Slightly optimize `slice::sort`][39538]
2437 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
2438 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
2439   `Box<str>` implements `From<&str>`][39438]
2440 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
2441   `From<(I, u16)> where I: Into<IpAddr>`][39372]
2442 * [`format!` estimates the needed capacity before writing a string][39356]
2443 * [Support unprivileged symlink creation in Windows][38921]
2444 * [`PathBuf` implements `Default`][38764]
2445 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2446 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2447   and poor hash functions.
2448
2449 Cargo
2450 -----
2451
2452 * [Add `cargo check --all`][cargo/3731]
2453 * [Add an option to ignore SSL revocation checking][cargo/3699]
2454 * [Add `cargo run --package`][cargo/3691]
2455 * [Add `required_features`][cargo/3667]
2456 * [Assume `build.rs` is a build script][cargo/3664]
2457 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2458
2459 Misc
2460 ----
2461
2462 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2463   `rustbook`][39633]
2464 * [The "Unstable Book" documents nightly-only features][ubook]
2465 * [Improve the style of the sidebar in rustdoc output][40265]
2466 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2467 * [Fix MSP430 breakage due to `i128`][40257]
2468 * [Preliminary Solaris/SPARCv9 support][39903]
2469 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2470   run without installing the MSVC runtime.
2471 * [`rustdoc --test` includes file names in test names][39788]
2472 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2473   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2474 * [Initial support for `aarch64-unknown-freebsd`][39491]
2475 * [Initial support for `i686-unknown-netbsd`][39426]
2476 * [This release no longer includes the old makefile build system][39431]. Rust
2477   is built with a custom build system, written in Rust, and with Cargo.
2478 * [Add Debug implementations for libcollection structs][39002]
2479 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2480 * [`--test-threads=0` produces an error][38945]
2481 * [`rustup` installs documentation by default][40526]
2482 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2483   WinDbg and Visual Studio to improve the debugging experience.
2484
2485 Compatibility Notes
2486 -------------------
2487
2488 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2489   workaround, either use MSVC 2015 or run vcvars.bat.
2490 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2491   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2492   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2493   fix.
2494 * [`format!` and `Display::to_string` panic if an underlying formatting
2495   implementation returns an error][40117]. Previously the error was silently
2496   ignored. It is incorrect for `write_fmt` to return an error when writing
2497   to a string.
2498 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2499   crates were marked stable and could be accessed from the stable toolchain.
2500 * [Rust git source no longer includes vendored crates][39728]. Those that need
2501   to build with vendored crates should build from release tarballs.
2502 * [Fix inert attributes from `proc_macro_derives`][39572]
2503 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2504   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2505   build system.
2506 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2507   existing code generally ignores the type of dead-code unless a type-hint is
2508   provided; this can cause surprising inference interactions particularly around
2509   defaulting. The new code uniformly ignores the result type of dead-code.
2510 * [Tuple-struct constructors with private fields are no longer visible][38932]
2511 * [Lifetime parameters that do not appear in the arguments are now considered
2512   early-bound][38897], resolving a soundness bug (#[32330]). The
2513   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2514   April of 2016.
2515 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2516 * [Make transmuting from fn item types to pointer-sized types a hard
2517   error][34198]
2518
2519 [27787]: https://github.com/rust-lang/rust/issues/27787
2520 [32330]: https://github.com/rust-lang/rust/issues/32330
2521 [34198]: https://github.com/rust-lang/rust/pull/34198
2522 [38161]: https://github.com/rust-lang/rust/pull/38161
2523 [38368]: https://github.com/rust-lang/rust/pull/38368
2524 [38584]: https://github.com/rust-lang/rust/issues/38584
2525 [38661]: https://github.com/rust-lang/rust/pull/38661
2526 [38764]: https://github.com/rust-lang/rust/pull/38764
2527 [38864]: https://github.com/rust-lang/rust/issues/38864
2528 [38897]: https://github.com/rust-lang/rust/pull/38897
2529 [38921]: https://github.com/rust-lang/rust/pull/38921
2530 [38932]: https://github.com/rust-lang/rust/pull/38932
2531 [38945]: https://github.com/rust-lang/rust/pull/38945
2532 [38981]: https://github.com/rust-lang/rust/pull/38981
2533 [39002]: https://github.com/rust-lang/rust/pull/39002
2534 [39116]: https://github.com/rust-lang/rust/pull/39116
2535 [39193]: https://github.com/rust-lang/rust/pull/39193
2536 [39265]: https://github.com/rust-lang/rust/pull/39265
2537 [39356]: https://github.com/rust-lang/rust/pull/39356
2538 [39372]: https://github.com/rust-lang/rust/pull/39372
2539 [39426]: https://github.com/rust-lang/rust/pull/39426
2540 [39431]: https://github.com/rust-lang/rust/pull/39431
2541 [39438]: https://github.com/rust-lang/rust/pull/39438
2542 [39440]: https://github.com/rust-lang/rust/pull/39440
2543 [39485]: https://github.com/rust-lang/rust/pull/39485
2544 [39491]: https://github.com/rust-lang/rust/pull/39491
2545 [39518]: https://github.com/rust-lang/rust/pull/39518
2546 [39538]: https://github.com/rust-lang/rust/pull/39538
2547 [39572]: https://github.com/rust-lang/rust/pull/39572
2548 [39633]: https://github.com/rust-lang/rust/pull/39633
2549 [39642]: https://github.com/rust-lang/rust/pull/39642
2550 [39728]: https://github.com/rust-lang/rust/pull/39728
2551 [39761]: https://github.com/rust-lang/rust/pull/39761
2552 [39788]: https://github.com/rust-lang/rust/pull/39788
2553 [39793]: https://github.com/rust-lang/rust/pull/39793
2554 [39837]: https://github.com/rust-lang/rust/pull/39837
2555 [39843]: https://github.com/rust-lang/rust/pull/39843
2556 [39851]: https://github.com/rust-lang/rust/pull/39851
2557 [39903]: https://github.com/rust-lang/rust/pull/39903
2558 [39939]: https://github.com/rust-lang/rust/pull/39939
2559 [39953]: https://github.com/rust-lang/rust/pull/39953
2560 [39960]: https://github.com/rust-lang/rust/pull/39960
2561 [39990]: https://github.com/rust-lang/rust/pull/39990
2562 [39995]: https://github.com/rust-lang/rust/pull/39995
2563 [40008]: https://github.com/rust-lang/rust/pull/40008
2564 [40009]: https://github.com/rust-lang/rust/pull/40009
2565 [40027]: https://github.com/rust-lang/rust/pull/40027
2566 [40028]: https://github.com/rust-lang/rust/pull/40028
2567 [40037]: https://github.com/rust-lang/rust/pull/40037
2568 [40117]: https://github.com/rust-lang/rust/pull/40117
2569 [40166]: https://github.com/rust-lang/rust/pull/40166
2570 [40245]: https://github.com/rust-lang/rust/pull/40245
2571 [40257]: https://github.com/rust-lang/rust/pull/40257
2572 [40261]: https://github.com/rust-lang/rust/pull/40261
2573 [40265]: https://github.com/rust-lang/rust/pull/40265
2574 [40319]: https://github.com/rust-lang/rust/pull/40319
2575 [40336]: https://github.com/rust-lang/rust/pull/40336
2576 [40526]: https://github.com/rust-lang/rust/pull/40526
2577 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2578 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2579 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2580 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2581 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2582 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2583 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2584 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2585 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2586 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2587 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2588 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2589 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2590 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2591 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2592 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2593 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2594 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2595 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2596 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2597 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2598 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2599 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2600 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2601 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2602 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2603 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2604 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2605 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2606 [mdbook]: https://crates.io/crates/mdbook
2607 [ubook]: https://doc.rust-lang.org/unstable-book/
2608
2609
2610 Version 1.16.0 (2017-03-16)
2611 ===========================
2612
2613 Language
2614 --------
2615
2616 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2617 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2618   match patterns][38069]
2619 * [Clean up semantics of `self` in an import list][38313]
2620 * [`Self` may appear in `impl` headers][38920]
2621 * [`Self` may appear in struct expressions][39282]
2622
2623 Compiler
2624 --------
2625
2626 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2627   a `.rmeta` file containing only crate metadata][38571]. This can be
2628   used by tools like the Rust Language Service to perform
2629   metadata-only builds.
2630 * [Levenshtein based typo suggestions now work in most places, while
2631   previously they worked only for fields and sometimes for local
2632   variables][38927]. Together with the overhaul of "no
2633   resolution"/"unexpected resolution" errors (#[38154]) they result in
2634   large and systematic improvement in resolution diagnostics.
2635 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2636   `U`][38670]
2637 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2638 * [`rustc` no longer attempts to provide "consider using an explicit
2639   lifetime" suggestions][37057]. They were inaccurate.
2640
2641 Stabilized APIs
2642 ---------------
2643
2644 * [`VecDeque::truncate`]
2645 * [`VecDeque::resize`]
2646 * [`String::insert_str`]
2647 * [`Duration::checked_add`]
2648 * [`Duration::checked_sub`]
2649 * [`Duration::checked_div`]
2650 * [`Duration::checked_mul`]
2651 * [`str::replacen`]
2652 * [`str::repeat`]
2653 * [`SocketAddr::is_ipv4`]
2654 * [`SocketAddr::is_ipv6`]
2655 * [`IpAddr::is_ipv4`]
2656 * [`IpAddr::is_ipv6`]
2657 * [`Vec::dedup_by`]
2658 * [`Vec::dedup_by_key`]
2659 * [`Result::unwrap_or_default`]
2660 * [`<*const T>::wrapping_offset`]
2661 * [`<*mut T>::wrapping_offset`]
2662 * `CommandExt::creation_flags`
2663 * [`File::set_permissions`]
2664 * [`String::split_off`]
2665
2666 Libraries
2667 ---------
2668
2669 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2670   their argument by `Borrow` parameter][37761]
2671 * [All public types in std implement `Debug`][38006]
2672 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2673 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2674 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2675   Windows][38274]
2676 * [std: Fix partial writes in `LineWriter`][38062]
2677 * [std: Clamp max read/write sizes on Unix][38062]
2678 * [Use more specific panic message for `&str` slicing errors][38066]
2679 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2680   functionality cannot be achieved in std currently.
2681 * [`writeln!`, like `println!`, now accepts a form with no string
2682   or formatting arguments, to just print a newline][38469]
2683 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2684 * [Reduce the size of static data in `std_unicode::tables`][38781]
2685 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2686   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2687   `Display`][38909]
2688 * [`Duration` implements `Sum`][38712]
2689 * [`String` implements `ToSocketAddrs`][39048]
2690
2691 Cargo
2692 -----
2693
2694 * [The `cargo check` command does a type check of a project without
2695   building it][cargo/3296]
2696 * [crates.io will display CI badges from Travis and AppVeyor, if
2697   specified in Cargo.toml][cargo/3546]
2698 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2699 * [Compilation profiles accept integer values for `debug`, in addition
2700   to `true` and `false`. These are passed to `rustc` as the value to
2701   `-C debuginfo`][cargo/3534]
2702 * [Implement `cargo --version --verbose`][cargo/3604]
2703 * [All builds now output 'dep-info' build dependencies compatible with
2704   make and ninja][cargo/3557]
2705 * [Build all workspace members with `build --all`][cargo/3511]
2706 * [Document all workspace members with `doc --all`][cargo/3515]
2707 * [Path deps outside workspace are not members][cargo/3443]
2708
2709 Misc
2710 ----
2711
2712 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2713   the path to the Rust implementation][38589]
2714 * [The `armv7-linux-androideabi` target no longer enables NEON
2715   extensions, per Google's ABI guide][38413]
2716 * [The stock standard library can be compiled for Redox OS][38401]
2717 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2718   available.
2719 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2720   builds available.
2721 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2722
2723 Compatibility Notes
2724 -------------------
2725
2726 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2727   match patterns][38069]
2728 * In this release, references to uninhabited types can not be
2729   pattern-matched. This was accidentally allowed in 1.15.
2730 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2731 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2732   Windows][38274]
2733 * [Clean up semantics of `self` in an import list][38313]
2734 * Reimplemented lifetime elision. This change was almost entirely compatible
2735   with existing code, but it did close a number of small bugs and loopholes,
2736   as well as being more accepting in some other [cases][41105].
2737
2738 [37057]: https://github.com/rust-lang/rust/pull/37057
2739 [37761]: https://github.com/rust-lang/rust/pull/37761
2740 [38006]: https://github.com/rust-lang/rust/pull/38006
2741 [38051]: https://github.com/rust-lang/rust/pull/38051
2742 [38062]: https://github.com/rust-lang/rust/pull/38062
2743 [38062]: https://github.com/rust-lang/rust/pull/38622
2744 [38066]: https://github.com/rust-lang/rust/pull/38066
2745 [38069]: https://github.com/rust-lang/rust/pull/38069
2746 [38131]: https://github.com/rust-lang/rust/pull/38131
2747 [38154]: https://github.com/rust-lang/rust/pull/38154
2748 [38274]: https://github.com/rust-lang/rust/pull/38274
2749 [38304]: https://github.com/rust-lang/rust/pull/38304
2750 [38313]: https://github.com/rust-lang/rust/pull/38313
2751 [38314]: https://github.com/rust-lang/rust/pull/38314
2752 [38327]: https://github.com/rust-lang/rust/pull/38327
2753 [38401]: https://github.com/rust-lang/rust/pull/38401
2754 [38413]: https://github.com/rust-lang/rust/pull/38413
2755 [38469]: https://github.com/rust-lang/rust/pull/38469
2756 [38559]: https://github.com/rust-lang/rust/pull/38559
2757 [38571]: https://github.com/rust-lang/rust/pull/38571
2758 [38580]: https://github.com/rust-lang/rust/pull/38580
2759 [38589]: https://github.com/rust-lang/rust/pull/38589
2760 [38670]: https://github.com/rust-lang/rust/pull/38670
2761 [38712]: https://github.com/rust-lang/rust/pull/38712
2762 [38726]: https://github.com/rust-lang/rust/pull/38726
2763 [38781]: https://github.com/rust-lang/rust/pull/38781
2764 [38798]: https://github.com/rust-lang/rust/pull/38798
2765 [38909]: https://github.com/rust-lang/rust/pull/38909
2766 [38920]: https://github.com/rust-lang/rust/pull/38920
2767 [38927]: https://github.com/rust-lang/rust/pull/38927
2768 [39048]: https://github.com/rust-lang/rust/pull/39048
2769 [39282]: https://github.com/rust-lang/rust/pull/39282
2770 [39379]: https://github.com/rust-lang/rust/pull/39379
2771 [41105]: https://github.com/rust-lang/rust/issues/41105
2772 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2773 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2774 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2775 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2776 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2777 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2778 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2779 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2780 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2781 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2782 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2783 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2784 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2785 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2786 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2787 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2788 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2789 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2790 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2791 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2792 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2793 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2794 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2795 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2796 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2797 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2798 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2799 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2800 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2801 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2802
2803
2804 Version 1.15.1 (2017-02-09)
2805 ===========================
2806
2807 * [Fix IntoIter::as_mut_slice's signature][39466]
2808 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2809
2810 [39466]: https://github.com/rust-lang/rust/pull/39466
2811 [39523]: https://github.com/rust-lang/rust/pull/39523
2812
2813
2814 Version 1.15.0 (2017-02-02)
2815 ===========================
2816
2817 Language
2818 --------
2819
2820 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2821   stable. This allows popular code-generating crates like Serde and Diesel to
2822   work ergonomically. [RFC 1681].
2823 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2824   with curly braces][36868]. Part of [RFC 1506].
2825 * [A number of minor changes to name resolution have been activated][37127].
2826   They add up to more consistent semantics, allowing for future evolution of
2827   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2828   details of what is different. The breaking changes here have been transitioned
2829   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2830 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2831   bounds][38279]
2832 * [`?Sized` can be used in `where` clauses][37791]
2833 * [There is now a limit on the size of monomorphized types and it can be
2834   modified with the `#![type_size_limit]` crate attribute, similarly to
2835   the `#![recursion_limit]` attribute][37789]
2836
2837 Compiler
2838 --------
2839
2840 * [On Windows, the compiler will apply dllimport attributes when linking to
2841   extern functions][37973]. Additional attributes and flags can control which
2842   library kind is linked and its name. [RFC 1717].
2843 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2844 * [The `--test` flag works with procedural macro crates][38107]
2845 * [Fix `extern "aapcs" fn` ABI][37814]
2846 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2847 * [The `format!` expander recognizes incorrect `printf` and shell-style
2848   formatting directives and suggests the correct format][37613].
2849 * [Only report one error for all unused imports in an import list][37456]
2850
2851 Compiler Performance
2852 --------------------
2853
2854 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2855 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2856 * [Don't clone in `UnificationTable::probe`][37848]
2857 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2858 * [Use small vectors in type walker][37760]
2859 * [Macro expansion performance was improved][37701]
2860 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2861 * [Replace FNV with a faster hash function][37229]
2862
2863 Stabilized APIs
2864 ---------------
2865
2866 * [`std::iter::Iterator::min_by`]
2867 * [`std::iter::Iterator::max_by`]
2868 * [`std::os::*::fs::FileExt`]
2869 * [`std::sync::atomic::Atomic*::get_mut`]
2870 * [`std::sync::atomic::Atomic*::into_inner`]
2871 * [`std::vec::IntoIter::as_slice`]
2872 * [`std::vec::IntoIter::as_mut_slice`]
2873 * [`std::sync::mpsc::Receiver::try_iter`]
2874 * [`std::os::unix::process::CommandExt::before_exec`]
2875 * [`std::rc::Rc::strong_count`]
2876 * [`std::rc::Rc::weak_count`]
2877 * [`std::sync::Arc::strong_count`]
2878 * [`std::sync::Arc::weak_count`]
2879 * [`std::char::encode_utf8`]
2880 * [`std::char::encode_utf16`]
2881 * [`std::cell::Ref::clone`]
2882 * [`std::io::Take::into_inner`]
2883
2884 Libraries
2885 ---------
2886
2887 * [The standard sorting algorithm has been rewritten for dramatic performance
2888   improvements][38192]. It is a hybrid merge sort, drawing influences from
2889   Timsort. Previously it was a naive merge sort.
2890 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2891 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2892   performance.
2893 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2894   and `char_indices().last()`][37882]
2895 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2896 * [Chinese characters display correctly in `fmt::Debug`][37855]
2897 * [Derive `Default` for `Duration`][37699]
2898 * [Support creation of anonymous pipes on WinXP/2k][37677]
2899 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2900 * [Don't pass overlapped handles to processes][38835]
2901
2902 Cargo
2903 -----
2904
2905 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2906   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2907   should instead check the variable at runtime with `std::env`. That the value
2908   was set at build time was a bug, and incorrect when cross-compiling. This
2909   change is known to cause breakage.
2910 * [Add `--all` flag to `cargo test`][cargo/3221]
2911 * [Compile statically against the MSVC CRT][cargo/3363]
2912 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2913 * [Link OpenSSL statically on OSX][cargo/3311]
2914 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2915 * [Test for bad path overrides with summaries][cargo/3336]
2916 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2917 * [Fix retrying crate downloads for network errors][cargo/3348]
2918 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2919 * [Emit more info on --message-format=json][cargo/3319]
2920 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2921 * [Don't ignore errors in workspace manifest][cargo/3409]
2922 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2923
2924 Tooling
2925 -------
2926
2927 * [Test runners (binaries built with `--test`) now support a `--list` argument
2928   that lists the tests it contains][38185]
2929 * [Test runners now support a `--exact` argument that makes the test filter
2930   match exactly, instead of matching only a substring of the test name][38181]
2931 * [rustdoc supports a `--playground-url` flag][37763]
2932 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2933
2934 Misc
2935 ----
2936
2937 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2938   continue to be used in this release by passing `--disable-rustbuild` to the
2939   configure script, but they will be deleted soon. Note that the new build
2940   system uses a different on-disk layout that will likely affect any scripts
2941   building Rust.
2942 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2943   releases.
2944 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2945 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2946   releases.
2947
2948 Compatibility Notes
2949 -------------------
2950
2951 * [A number of minor changes to name resolution have been activated][37127].
2952   They add up to more consistent semantics, allowing for future evolution of
2953   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2954   details of what is different. The breaking changes here have been transitioned
2955   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2956 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2957   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2958   should instead check the variable at runtime with `std::env`. That the value
2959   was set at build time was a bug, and incorrect when cross-compiling. This
2960   change is known to cause breakage.
2961 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2962   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2963   1.10 and is now an error by default. It will become a hard error in the near
2964   future.
2965 * [The semantics relating modules to file system directories are changing in
2966   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2967   lint, which is a warning in this release, and will become a hard error in the
2968   future.
2969 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2970 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2971   the underlying iterator][37834]
2972
2973 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2974 [33685]: https://github.com/rust-lang/rust/issues/33685
2975 [36868]: https://github.com/rust-lang/rust/pull/36868
2976 [37127]: https://github.com/rust-lang/rust/pull/37127
2977 [37229]: https://github.com/rust-lang/rust/pull/37229
2978 [37456]: https://github.com/rust-lang/rust/pull/37456
2979 [37527]: https://github.com/rust-lang/rust/pull/37527
2980 [37602]: https://github.com/rust-lang/rust/pull/37602
2981 [37613]: https://github.com/rust-lang/rust/pull/37613
2982 [37615]: https://github.com/rust-lang/rust/pull/37615
2983 [37636]: https://github.com/rust-lang/rust/pull/37636
2984 [37627]: https://github.com/rust-lang/rust/pull/37627
2985 [37642]: https://github.com/rust-lang/rust/pull/37642
2986 [37677]: https://github.com/rust-lang/rust/pull/37677
2987 [37699]: https://github.com/rust-lang/rust/pull/37699
2988 [37701]: https://github.com/rust-lang/rust/pull/37701
2989 [37705]: https://github.com/rust-lang/rust/pull/37705
2990 [37749]: https://github.com/rust-lang/rust/pull/37749
2991 [37760]: https://github.com/rust-lang/rust/pull/37760
2992 [37763]: https://github.com/rust-lang/rust/pull/37763
2993 [37764]: https://github.com/rust-lang/rust/pull/37764
2994 [37789]: https://github.com/rust-lang/rust/pull/37789
2995 [37791]: https://github.com/rust-lang/rust/pull/37791
2996 [37814]: https://github.com/rust-lang/rust/pull/37814
2997 [37817]: https://github.com/rust-lang/rust/pull/37817
2998 [37834]: https://github.com/rust-lang/rust/pull/37834
2999 [37848]: https://github.com/rust-lang/rust/pull/37848
3000 [37855]: https://github.com/rust-lang/rust/pull/37855
3001 [37882]: https://github.com/rust-lang/rust/pull/37882
3002 [37888]: https://github.com/rust-lang/rust/pull/37888
3003 [37973]: https://github.com/rust-lang/rust/pull/37973
3004 [37979]: https://github.com/rust-lang/rust/pull/37979
3005 [38086]: https://github.com/rust-lang/rust/pull/38086
3006 [38107]: https://github.com/rust-lang/rust/pull/38107
3007 [38117]: https://github.com/rust-lang/rust/pull/38117
3008 [38134]: https://github.com/rust-lang/rust/pull/38134
3009 [38146]: https://github.com/rust-lang/rust/pull/38146
3010 [38181]: https://github.com/rust-lang/rust/pull/38181
3011 [38182]: https://github.com/rust-lang/rust/pull/38182
3012 [38185]: https://github.com/rust-lang/rust/pull/38185
3013 [38192]: https://github.com/rust-lang/rust/pull/38192
3014 [38279]: https://github.com/rust-lang/rust/pull/38279
3015 [38835]: https://github.com/rust-lang/rust/pull/38835
3016 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3017 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3018 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
3019 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
3020 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
3021 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
3022 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
3023 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
3024 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
3025 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
3026 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
3027 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
3028 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
3029 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
3030 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
3031 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
3032 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
3033 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
3034 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
3035 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
3036 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
3037 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
3038 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
3039 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
3040 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
3041 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
3042 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
3043 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
3044 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
3045 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
3046 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
3047 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
3048 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
3049 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
3050 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
3051 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
3052 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
3053 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
3054
3055
3056 Version 1.14.0 (2016-12-22)
3057 ===========================
3058
3059 Language
3060 --------
3061
3062 * [`..` matches multiple tuple fields in enum variants, structs
3063   and tuples][36843]. [RFC 1492].
3064 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
3065 * [`use *` and `use ::*` both glob-import from the crate root][37367]
3066 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
3067   dereferencing][36822]
3068
3069 Compiler
3070 --------
3071
3072 * [Mark enums with non-zero discriminant as non-zero][37224]
3073 * [Lower-case `static mut` names are linted like other
3074   statics and consts][37162]
3075 * [Fix ICE on some macros in const integer positions
3076    (e.g. `[u8; m!()]`)][36819]
3077 * [Improve error message and snippet for "did you mean `x`"][36798]
3078 * [Add a panic-strategy field to the target specification][36794]
3079 * [Include LLVM version in `--version --verbose`][37200]
3080
3081 Compile-time Optimizations
3082 --------------------------
3083
3084 * [Improve macro expansion performance][37569]
3085 * [Shrink `Expr_::ExprInlineAsm`][37445]
3086 * [Replace all uses of SHA-256 with BLAKE2b][37439]
3087 * [Reduce the number of bytes hashed by `IchHasher`][37427]
3088 * [Avoid more allocations when compiling html5ever][37373]
3089 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
3090 * [Avoid some allocations in the macro parser][37318]
3091 * [Use a faster deflate setting][37298]
3092 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
3093   during interning of slices][37270]
3094 * [Optimize `write_metadata`][37267]
3095 * [Don't process obligation forest cycles when stalled][37231]
3096 * [Avoid many `CrateConfig` clones][37161]
3097 * [Optimize `Substs::super_fold_with`][37108]
3098 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
3099 * [Speed up `plug_leaks`][36917]
3100
3101 Libraries
3102 ---------
3103
3104 * [`println!()`, with no arguments, prints newline][36825].
3105   Previously, an empty string was required to achieve the same.
3106 * [`Wrapping` impls standard binary and unary operators, as well as
3107    the `Sum` and `Product` iterators][37356]
3108 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
3109   Vec<T>`][37326]
3110 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
3111   `VecDeque` iterators][37315]
3112 * [Improve `SipHasher` performance on small values][37312]
3113 * [Add Iterator trait TrustedLen to enable better FromIterator /
3114   Extend][37306]
3115 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
3116 * [`ReadDir` implements `Debug`][37221]
3117 * [Implement `RefUnwindSafe` for atomic types][37178]
3118 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
3119 * [Avoid allocations in `Decoder::read_str`][37064]
3120 * [`io::Error` implements `From<io::ErrorKind>`][37037]
3121 * [Impl `Debug` for raw pointers to unsized data][36880]
3122 * [Don't reuse `HashMap` random seeds][37470]
3123 * [The internal memory layout of `HashMap` is more cache-friendly, for
3124   significant improvements in some operations][36692]
3125 * [`HashMap` uses less memory on 32-bit architectures][36595]
3126 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
3127
3128 Cargo
3129 -----
3130
3131 * [Expose rustc cfg values to build scripts][cargo/3243]
3132 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
3133 * [Fix passing --features when testing multiple packages][cargo/3280]
3134 * [Use a single profile set per workspace][cargo/3249]
3135 * [Load `replace` sections from lock files][cargo/3220]
3136 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
3137
3138 Tooling
3139 -------
3140
3141 * [rustup is the recommended Rust installation method][1.14rustup]
3142 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
3143   S390x. These are [tier 2] platforms and may have major defects. Follow the
3144   instructions on the website to install, or add the targets to an existing
3145   installation with `rustup target add`. The new target triples are:
3146   - `mips-unknown-linux-gnu`
3147   - `mipsel-unknown-linux-gnu`
3148   - `mips64-unknown-linux-gnuabi64`
3149   - `mips64el-unknown-linux-gnuabi64 `
3150   - `powerpc-unknown-linux-gnu`
3151   - `powerpc64-unknown-linux-gnu`
3152   - `powerpc64le-unknown-linux-gnu`
3153   - `s390x-unknown-linux-gnu `
3154 * This release includes target (std) builds for ARM Linux running MUSL
3155   libc. These are [tier 2] platforms and may have major defects. Add the
3156   following triples to an existing rustup installation with `rustup target add`:
3157   - `arm-unknown-linux-musleabi`
3158   - `arm-unknown-linux-musleabihf`
3159   - `armv7-unknown-linux-musleabihf`
3160 * This release includes [experimental support for WebAssembly][1.14wasm], via
3161   the `wasm32-unknown-emscripten` target. This target is known to have major
3162   defects. Please test, report, and fix.
3163 * rustup no longer installs documentation by default. Run `rustup
3164   component add rust-docs` to install.
3165 * [Fix line stepping in debugger][37310]
3166 * [Enable line number debuginfo in releases][37280]
3167
3168 Misc
3169 ----
3170
3171 * [Disable jemalloc on aarch64/powerpc/mips][37392]
3172 * [Add support for Fuchsia OS][37313]
3173 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
3174
3175 Compatibility Notes
3176 -------------------
3177
3178 * [A number of forward-compatibility lints used by the compiler
3179   to gradually introduce language changes have been converted
3180   to deny by default][36894]:
3181   - ["use of inaccessible extern crate erroneously allowed"][36886]
3182   - ["type parameter default erroneously allowed in invalid location"][36887]
3183   - ["detects super or self keywords at the beginning of global path"][36888]
3184   - ["two overlapping inherent impls define an item with the same name
3185     were erroneously allowed"][36889]
3186   - ["floating-point constants cannot be used in patterns"][36890]
3187   - ["constants of struct or enum type can only be used in a pattern if
3188      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
3189   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
3190 * [Prohibit patterns in trait methods without bodies][37378]
3191 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
3192 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
3193 * [The `$crate` macro variable is accepted in fewer locations][37213]
3194 * [Impls specifying extra region requirements beyond the trait
3195   they implement are rejected][37167]
3196 * [Enums may not be unsized][37111]. Unsized enums are intended to
3197   work but never have. For now they are forbidden.
3198 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
3199
3200 [tier 2]: https://forge.rust-lang.org/platform-support.html
3201 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
3202 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
3203 [36430]: https://github.com/rust-lang/rust/pull/36430
3204 [36595]: https://github.com/rust-lang/rust/pull/36595
3205 [36595]: https://github.com/rust-lang/rust/pull/36595
3206 [36692]: https://github.com/rust-lang/rust/pull/36692
3207 [36767]: https://github.com/rust-lang/rust/pull/36767
3208 [36794]: https://github.com/rust-lang/rust/pull/36794
3209 [36798]: https://github.com/rust-lang/rust/pull/36798
3210 [36819]: https://github.com/rust-lang/rust/pull/36819
3211 [36822]: https://github.com/rust-lang/rust/pull/36822
3212 [36825]: https://github.com/rust-lang/rust/pull/36825
3213 [36843]: https://github.com/rust-lang/rust/pull/36843
3214 [36880]: https://github.com/rust-lang/rust/pull/36880
3215 [36886]: https://github.com/rust-lang/rust/issues/36886
3216 [36887]: https://github.com/rust-lang/rust/issues/36887
3217 [36888]: https://github.com/rust-lang/rust/issues/36888
3218 [36889]: https://github.com/rust-lang/rust/issues/36889
3219 [36890]: https://github.com/rust-lang/rust/issues/36890
3220 [36891]: https://github.com/rust-lang/rust/issues/36891
3221 [36892]: https://github.com/rust-lang/rust/issues/36892
3222 [36894]: https://github.com/rust-lang/rust/pull/36894
3223 [36917]: https://github.com/rust-lang/rust/pull/36917
3224 [36993]: https://github.com/rust-lang/rust/pull/36993
3225 [37037]: https://github.com/rust-lang/rust/pull/37037
3226 [37064]: https://github.com/rust-lang/rust/pull/37064
3227 [37094]: https://github.com/rust-lang/rust/pull/37094
3228 [37108]: https://github.com/rust-lang/rust/pull/37108
3229 [37111]: https://github.com/rust-lang/rust/pull/37111
3230 [37161]: https://github.com/rust-lang/rust/pull/37161
3231 [37162]: https://github.com/rust-lang/rust/pull/37162
3232 [37167]: https://github.com/rust-lang/rust/pull/37167
3233 [37178]: https://github.com/rust-lang/rust/pull/37178
3234 [37200]: https://github.com/rust-lang/rust/pull/37200
3235 [37213]: https://github.com/rust-lang/rust/pull/37213
3236 [37221]: https://github.com/rust-lang/rust/pull/37221
3237 [37224]: https://github.com/rust-lang/rust/pull/37224
3238 [37230]: https://github.com/rust-lang/rust/pull/37230
3239 [37231]: https://github.com/rust-lang/rust/pull/37231
3240 [37247]: https://github.com/rust-lang/rust/pull/37247
3241 [37267]: https://github.com/rust-lang/rust/pull/37267
3242 [37270]: https://github.com/rust-lang/rust/pull/37270
3243 [37273]: https://github.com/rust-lang/rust/pull/37273
3244 [37280]: https://github.com/rust-lang/rust/pull/37280
3245 [37298]: https://github.com/rust-lang/rust/pull/37298
3246 [37306]: https://github.com/rust-lang/rust/pull/37306
3247 [37310]: https://github.com/rust-lang/rust/pull/37310
3248 [37312]: https://github.com/rust-lang/rust/pull/37312
3249 [37313]: https://github.com/rust-lang/rust/pull/37313
3250 [37315]: https://github.com/rust-lang/rust/pull/37315
3251 [37318]: https://github.com/rust-lang/rust/pull/37318
3252 [37322]: https://github.com/rust-lang/rust/pull/37322
3253 [37326]: https://github.com/rust-lang/rust/pull/37326
3254 [37351]: https://github.com/rust-lang/rust/pull/37351
3255 [37356]: https://github.com/rust-lang/rust/pull/37356
3256 [37367]: https://github.com/rust-lang/rust/pull/37367
3257 [37373]: https://github.com/rust-lang/rust/pull/37373
3258 [37378]: https://github.com/rust-lang/rust/pull/37378
3259 [37389]: https://github.com/rust-lang/rust/pull/37389
3260 [37392]: https://github.com/rust-lang/rust/pull/37392
3261 [37427]: https://github.com/rust-lang/rust/pull/37427
3262 [37439]: https://github.com/rust-lang/rust/pull/37439
3263 [37445]: https://github.com/rust-lang/rust/pull/37445
3264 [37470]: https://github.com/rust-lang/rust/pull/37470
3265 [37569]: https://github.com/rust-lang/rust/pull/37569
3266 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3267 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
3268 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
3269 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
3270 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
3271 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
3272 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
3273
3274
3275 Version 1.13.0 (2016-11-10)
3276 ===========================
3277
3278 Language
3279 --------
3280
3281 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
3282   errors, like the `try!` macro, described in [RFC 0243].
3283 * [Stabilize macros in type position][36014]. Described in [RFC 873].
3284 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
3285 * [Fix `#[derive]` for empty tuple structs/variants][35728]
3286 * [Fix lifetime rules for 'if' conditions][36029]
3287 * [Avoid loading and parsing unconfigured non-inline modules][36482]
3288
3289 Compiler
3290 --------
3291
3292 * [Add the `-C link-arg` argument][36574]
3293 * [Remove the old AST-based backend from rustc_trans][35764]
3294 * [Don't enable NEON by default on armv7 Linux][35814]
3295 * [Fix debug line number info for macro expansions][35238]
3296 * [Do not emit "class method" debuginfo for types that are not
3297   DICompositeType][36008]
3298 * [Warn about multiple conflicting #[repr] hints][34623]
3299 * [When sizing DST, don't double-count nested struct prefixes][36351]
3300 * [Default RUST_MIN_STACK to 16MiB for now][36505]
3301 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
3302 * [Reject macros with empty repetitions to avoid infinite loop][36721]
3303 * [Expand macros without recursing to avoid stack overflows][36214]
3304
3305 Diagnostics
3306 -----------
3307
3308 * [Replace macro backtraces with labeled local uses][35702]
3309 * [Improve error message for misplaced doc comments][33922]
3310 * [Buffer unix and lock windows to prevent message interleaving][35975]
3311 * [Update lifetime errors to specifically note temporaries][36171]
3312 * [Special case a few colors for Windows][36178]
3313 * [Suggest `use self` when such an import resolves][36289]
3314 * [Be more specific when type parameter shadows primitive type][36338]
3315 * Many minor improvements
3316
3317 Compile-time Optimizations
3318 --------------------------
3319
3320 * [Compute and cache HIR hashes at beginning][35854]
3321 * [Don't hash types in loan paths][36004]
3322 * [Cache projections in trans][35761]
3323 * [Optimize the parser's last token handling][36527]
3324 * [Only instantiate #[inline] functions in codegen units referencing
3325   them][36524]. This leads to big improvements in cases where crates export
3326   define many inline functions without using them directly.
3327 * [Lazily allocate TypedArena's first chunk][36592]
3328 * [Don't allocate during default HashSet creation][36734]
3329
3330 Stabilized APIs
3331 ---------------
3332
3333 * [`checked_abs`]
3334 * [`wrapping_abs`]
3335 * [`overflowing_abs`]
3336 * [`RefCell::try_borrow`]
3337 * [`RefCell::try_borrow_mut`]
3338
3339 Libraries
3340 ---------
3341
3342 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
3343 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
3344   covariant][35354]
3345 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
3346 * [Implement `Debug` for `std::vec::IntoIter`][35707]
3347 * [`CString`: avoid excessive growth just to 0-terminate][35871]
3348 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
3349 * [Use arc4rand on FreeBSD][35884]
3350 * [memrchr: Correct aligned offset computation][35969]
3351 * [Improve Demangling of Rust Symbols][36059]
3352 * [Use monotonic time in condition variables][35048]
3353 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
3354 * [Implement conversion traits for `char`][35755]
3355 * [Fix illegal instruction caused by overflow in channel cloning][36104]
3356 * [Zero first byte of CString on drop][36264]
3357 * [Inherit overflow checks for sum and product][36372]
3358 * [Add missing Eq implementations][36423]
3359 * [Implement `Debug` for `DirEntry`][36631]
3360 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
3361   `errno`][36754]
3362 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3363 * [Implement more traits for `std::io::ErrorKind`][35911]
3364 * [Optimize BinaryHeap bounds checking][36072]
3365 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
3366   `extend_with_element`][36355]
3367 * [Fix overflow checking in unsigned pow()][34942]
3368
3369 Cargo
3370 -----
3371
3372 * This release includes security fixes to both curl and OpenSSL.
3373 * [Fix transitive doctests when panic=abort][cargo/3021]
3374 * [Add --all-features flag to cargo][cargo/3038]
3375 * [Reject path-based dependencies in `cargo package`][cargo/3060]
3376 * [Don't parse the home directory more than once][cargo/3078]
3377 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
3378 * [Update OpenSSL to 1.0.2j][cargo/3121]
3379 * [Add license and license_file to cargo metadata output][cargo/3110]
3380 * [Make crates-io registry URL optional in config; ignore all changes to
3381   source.crates-io][cargo/3089]
3382 * [Don't download dependencies from other platforms][cargo/3123]
3383 * [Build transitive dev-dependencies when needed][cargo/3125]
3384 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
3385 * [Avoid updating registry when adding existing deps][cargo/3144]
3386 * [Warn about path overrides that won't work][cargo/3136]
3387 * [Use workspaces during `cargo install`][cargo/3146]
3388 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
3389 * [Add --message-format flag][cargo/3000]
3390 * [Pass target environment for rustdoc][cargo/3205]
3391 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
3392 * [Update curl and curl-sys][cargo/3241]
3393 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
3394
3395 Tooling
3396 -------
3397
3398 * [rustdoc: Add the `--sysroot` argument][36586]
3399 * [rustdoc: Fix a couple of issues with the search results][35655]
3400 * [rustdoc: remove the `!` from macro URLs and titles][35234]
3401 * [gdb: Fix pretty-printing special-cased Rust types][35585]
3402 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
3403
3404 Misc
3405 ----
3406
3407 * [Remove unmaintained style guide][35124]
3408 * [Add s390x support][36369]
3409 * [Initial work at Haiku OS support][36727]
3410 * [Add mips-uclibc targets][35734]
3411 * [Crate-ify compiler-rt into compiler-builtins][35021]
3412 * [Add rustc version info (git hash + date) to dist tarball][36213]
3413 * Many documentation improvements
3414
3415 Compatibility Notes
3416 -------------------
3417
3418 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3419 * [Deny (by default) transmuting from fn item types to pointer-sized
3420   types][34923]. Continuing the long transition to zero-sized fn items,
3421   per [RFC 401].
3422 * [Fix `#[derive]` for empty tuple structs/variants][35728].
3423   Part of [RFC 1506].
3424 * [Issue deprecation warnings for safe accesses to extern statics][36173]
3425 * [Fix lifetime rules for 'if' conditions][36029].
3426 * [Inherit overflow checks for sum and product][36372].
3427 * [Forbid user-defined macros named "macro_rules"][36730].
3428
3429 [33922]: https://github.com/rust-lang/rust/pull/33922
3430 [34623]: https://github.com/rust-lang/rust/pull/34623
3431 [34923]: https://github.com/rust-lang/rust/pull/34923
3432 [34942]: https://github.com/rust-lang/rust/pull/34942
3433 [34982]: https://github.com/rust-lang/rust/pull/34982
3434 [35021]: https://github.com/rust-lang/rust/pull/35021
3435 [35048]: https://github.com/rust-lang/rust/pull/35048
3436 [35074]: https://github.com/rust-lang/rust/pull/35074
3437 [35124]: https://github.com/rust-lang/rust/pull/35124
3438 [35234]: https://github.com/rust-lang/rust/pull/35234
3439 [35238]: https://github.com/rust-lang/rust/pull/35238
3440 [35354]: https://github.com/rust-lang/rust/pull/35354
3441 [35559]: https://github.com/rust-lang/rust/pull/35559
3442 [35585]: https://github.com/rust-lang/rust/pull/35585
3443 [35627]: https://github.com/rust-lang/rust/pull/35627
3444 [35655]: https://github.com/rust-lang/rust/pull/35655
3445 [35702]: https://github.com/rust-lang/rust/pull/35702
3446 [35707]: https://github.com/rust-lang/rust/pull/35707
3447 [35728]: https://github.com/rust-lang/rust/pull/35728
3448 [35734]: https://github.com/rust-lang/rust/pull/35734
3449 [35755]: https://github.com/rust-lang/rust/pull/35755
3450 [35761]: https://github.com/rust-lang/rust/pull/35761
3451 [35764]: https://github.com/rust-lang/rust/pull/35764
3452 [35814]: https://github.com/rust-lang/rust/pull/35814
3453 [35854]: https://github.com/rust-lang/rust/pull/35854
3454 [35871]: https://github.com/rust-lang/rust/pull/35871
3455 [35884]: https://github.com/rust-lang/rust/pull/35884
3456 [35911]: https://github.com/rust-lang/rust/pull/35911
3457 [35969]: https://github.com/rust-lang/rust/pull/35969
3458 [35975]: https://github.com/rust-lang/rust/pull/35975
3459 [36004]: https://github.com/rust-lang/rust/pull/36004
3460 [36008]: https://github.com/rust-lang/rust/pull/36008
3461 [36014]: https://github.com/rust-lang/rust/pull/36014
3462 [36029]: https://github.com/rust-lang/rust/pull/36029
3463 [36059]: https://github.com/rust-lang/rust/pull/36059
3464 [36072]: https://github.com/rust-lang/rust/pull/36072
3465 [36101]: https://github.com/rust-lang/rust/pull/36101
3466 [36104]: https://github.com/rust-lang/rust/pull/36104
3467 [36171]: https://github.com/rust-lang/rust/pull/36171
3468 [36173]: https://github.com/rust-lang/rust/pull/36173
3469 [36178]: https://github.com/rust-lang/rust/pull/36178
3470 [36213]: https://github.com/rust-lang/rust/pull/36213
3471 [36214]: https://github.com/rust-lang/rust/pull/36214
3472 [36264]: https://github.com/rust-lang/rust/pull/36264
3473 [36266]: https://github.com/rust-lang/rust/pull/36266
3474 [36289]: https://github.com/rust-lang/rust/pull/36289
3475 [36338]: https://github.com/rust-lang/rust/pull/36338
3476 [36351]: https://github.com/rust-lang/rust/pull/36351
3477 [36355]: https://github.com/rust-lang/rust/pull/36355
3478 [36369]: https://github.com/rust-lang/rust/pull/36369
3479 [36372]: https://github.com/rust-lang/rust/pull/36372
3480 [36423]: https://github.com/rust-lang/rust/pull/36423
3481 [36482]: https://github.com/rust-lang/rust/pull/36482
3482 [36505]: https://github.com/rust-lang/rust/pull/36505
3483 [36524]: https://github.com/rust-lang/rust/pull/36524
3484 [36527]: https://github.com/rust-lang/rust/pull/36527
3485 [36551]: https://github.com/rust-lang/rust/pull/36551
3486 [36574]: https://github.com/rust-lang/rust/pull/36574
3487 [36586]: https://github.com/rust-lang/rust/pull/36586
3488 [36592]: https://github.com/rust-lang/rust/pull/36592
3489 [36631]: https://github.com/rust-lang/rust/pull/36631
3490 [36639]: https://github.com/rust-lang/rust/pull/36639
3491 [36721]: https://github.com/rust-lang/rust/pull/36721
3492 [36727]: https://github.com/rust-lang/rust/pull/36727
3493 [36730]: https://github.com/rust-lang/rust/pull/36730
3494 [36734]: https://github.com/rust-lang/rust/pull/36734
3495 [36754]: https://github.com/rust-lang/rust/pull/36754
3496 [36995]: https://github.com/rust-lang/rust/pull/36995
3497 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3498 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3499 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3500 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3501 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3502 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3503 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3504 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3505 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3506 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3507 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3508 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3509 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3510 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3511 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3512 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3513 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3514 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3515 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3516 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3517 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3518 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3519 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3520 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3521 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3522 [rustup]: https://www.rustup.rs
3523 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3524 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3525 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3526 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3527 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3528 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3529 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3530
3531
3532 Version 1.12.1 (2016-10-20)
3533 ===========================
3534
3535 Regression Fixes
3536 ----------------
3537
3538 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3539 * [Confusion with double negation and booleans][36856]
3540 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3541 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3542 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3543 * [Corrupted memory after updated to 1.12][36936]
3544 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3545 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3546 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3547
3548 [36381]: https://github.com/rust-lang/rust/issues/36381
3549 [36856]: https://github.com/rust-lang/rust/issues/36856
3550 [36875]: https://github.com/rust-lang/rust/issues/36875
3551 [36924]: https://github.com/rust-lang/rust/issues/36924
3552 [36926]: https://github.com/rust-lang/rust/issues/36926
3553 [36936]: https://github.com/rust-lang/rust/issues/36936
3554 [37026]: https://github.com/rust-lang/rust/issues/37026
3555 [37112]: https://github.com/rust-lang/rust/issues/37112
3556 [37153]: https://github.com/rust-lang/rust/issues/37153
3557
3558
3559 Version 1.12.0 (2016-09-29)
3560 ===========================
3561
3562 Highlights
3563 ----------
3564
3565 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3566   This translation pass is far simpler than the previous AST->LLVM pass, and
3567   creates opportunities to perform new optimizations directly on the MIR. It
3568   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3569 * [`rustc` presents a new, more readable error format, along with
3570   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3571   Most common editors supporting Rust have been updated to work with it. It was
3572   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3573
3574 Compiler
3575 --------
3576
3577 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3578   This translation pass is far simpler than the previous AST->LLVM pass, and
3579   creates opportunities to perform new optimizations directly on the MIR. It
3580   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3581 * [Print the Rust target name, not the LLVM target name, with
3582   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3583 * [The computation of `TypeId` is correct in some cases where it was previously
3584   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3585 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3586 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3587   `--print relocation-models`, and `--print code-models` print the available
3588   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3589   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3590 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3591   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3592   These targets produce statically-linked binaries. There are no binary release
3593   builds yet though.
3594
3595 Diagnostics
3596 -----------
3597
3598 * [`rustc` presents a new, more readable error format, along with
3599   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3600   Most common editors supporting Rust have been updated to work with it. It was
3601   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3602 * [In error descriptions, references are now described in plain English,
3603   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3604 * [In error type descriptions, unknown numeric types are named `{integer}` or
3605   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3606 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3607
3608 Language
3609 --------
3610
3611 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3612 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3613 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3614   useful](https://github.com/rust-lang/rust/pull/34908)
3615 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3616   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3617 * [Semicolons are properly required as statement delimiters inside
3618   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3619 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3620
3621 Stabilized APIs
3622 ---------------
3623
3624 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3625 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3626 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3627 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3628 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3629 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3630 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3631 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3632 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3633 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3634   Both on Unix and Windows.
3635 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3636 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3637 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3638 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3639 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3640 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3641 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3642 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3643
3644 Libraries
3645 ---------
3646
3647 * [The `format!` macro and friends now allow a single argument to be formatted
3648   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3649 * [The lifetime bounds on `[T]::binary_search_by` and
3650   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3651 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3652 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3653 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3654 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3655 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3656 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3657 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3658 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3659   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3660 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3661   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3662 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3663 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3664   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3665 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3666 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3667 * [`mpsc::sync_channel` `Receiver`s return any available message before
3668   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3669 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3670 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3671
3672 Cargo
3673 -----
3674
3675 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3676 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3677 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3678 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3679 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3680 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3681 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3682 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3683 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3684 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3685 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3686 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3687 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3688 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3689 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3690 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3691
3692 Performance
3693 -----------
3694
3695 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3696 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3697
3698 Tooling
3699 -------
3700
3701 * [Test binaries now support a `--test-threads` argument to specify the number
3702   of threads used to run tests, and which acts the same as the
3703   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3704 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3705 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3706 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3707 * [Rust releases now come with source packages that can be installed by rustup
3708   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3709   The resulting source code can be used by tools and IDES, located in the
3710   sysroot under `lib/rustlib/src`.
3711
3712 Misc
3713 ----
3714
3715 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3716 * Many minor improvements to the documentation.
3717 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3718
3719 Compatibility Notes
3720 -------------------
3721
3722 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3723   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3724 * [When formatting strings, if "precision" is specified, the "fill",
3725   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3726 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3727
3728
3729 Version 1.11.0 (2016-08-18)
3730 ===========================
3731
3732 Language
3733 --------
3734
3735 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3736 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3737 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3738 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3739 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3740
3741 Stabilized APIs
3742 ---------------
3743
3744 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3745 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3746 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3747 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3748 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3749 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3750   (in libcore - previously stabilized in libstd)
3751 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3752   (in libcore - previously stabilized in libstd)
3753 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3754   (in libcore - previously stabilized in libstd)
3755 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3756   (in libcore - previously stabilized in libstd)
3757 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3758 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3759 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3760 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3761
3762 Libraries
3763 ---------
3764
3765 * [The `thread_local!` macro supports multiple definitions in a single
3766    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3767 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3768 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3769   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3770 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3771 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3772 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3773 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3774
3775 Cargo
3776 -----
3777
3778 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3779 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3780 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3781 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3782 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3783   and `-vv` prints warnings for all crates.
3784 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3785 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3786   This provides room for expansion by arbitrary tools.
3787 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3788 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3789 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3790 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3791 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3792 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3793 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3794
3795 Performance
3796 -----------
3797
3798 * [Caching projections speeds up type check dramatically for some
3799   workloads](https://github.com/rust-lang/rust/pull/33816)
3800 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3801   This hasher is faster, but is believed to provide sufficient
3802   protection from collision attacks.
3803 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3804
3805 Rustdoc
3806 -------
3807
3808 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3809 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3810 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3811 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3812 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3813
3814 Tooling
3815 -------
3816
3817 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3818 * [When emitting debug info, rustc emits frame pointers for closures,
3819   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3820 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3821 * Many more errors have been given error codes and extended
3822   explanations
3823 * API documentation continues to be improved, with many new examples
3824
3825 Misc
3826 ----
3827
3828 * [rustc no longer hangs when dependencies recursively re-export
3829   submodules](https://github.com/rust-lang/rust/pull/34542)
3830 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3831 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3832   rewritten](https://github.com/rust-lang/rust/pull/33895)
3833 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3834   No targets use this yet, but it works toward AVR support.
3835
3836 Compatibility Notes
3837 -------------------
3838
3839 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3840 * [The new follow-set rules that place restrictions on `macro_rules!`
3841   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3842   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3843   and has been a warning since 1.10.
3844 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3845   This causes breakage in some corner cases.
3846
3847
3848 Version 1.10.0 (2016-07-07)
3849 ===========================
3850
3851 Language
3852 --------
3853
3854 * [Allow `concat_idents!` in type positions as well as in expression
3855   positions](https://github.com/rust-lang/rust/pull/33735).
3856 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3857   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3858 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3859 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3860 * [`panic!` can be converted to a runtime abort with the
3861   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3862   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3863 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3864   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3865   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3866   Note that Cargo does not yet directly support cdylibs.
3867
3868 Stabilized APIs
3869 ---------------
3870
3871 * `os::windows::fs::OpenOptionsExt::access_mode`
3872 * `os::windows::fs::OpenOptionsExt::share_mode`
3873 * `os::windows::fs::OpenOptionsExt::custom_flags`
3874 * `os::windows::fs::OpenOptionsExt::attributes`
3875 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3876 * `os::unix::fs::OpenOptionsExt::custom_flags`
3877 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3878 * `Default for sync::Weak`
3879 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3880 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3881 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3882 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3883 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3884 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3885 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3886 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3887 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3888 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3889 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3890 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3891 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3892 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3893 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3894 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3895 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3896 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3897 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3898 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3899 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3900 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3901 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3902 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3903 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3904 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3905 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3906 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3907 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3908 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3909 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3910 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3911 * Read/Write/RawFd impls for `UnixStream`
3912 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3913 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3914 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3915 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3916 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3917 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3918 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3919 * RawFd impls for `UnixListener`
3920 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3921 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3922 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3923 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3924 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3925 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3926 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3927 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3928 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3929 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3930 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3931 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3932 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3933 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3934 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3935 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3936 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3937 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3938 * RawFd impls for `UnixDatagram`
3939 * `{BTree,Hash}Map::values_mut`
3940 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3941
3942 Libraries
3943 ---------
3944
3945 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3946   The semantics of this minor method are subtle and probably not what
3947   most people want.
3948 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3949 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3950   will fall back to `/dev/urandom` temporarily to avoid blocking
3951   during early boot](https://github.com/rust-lang/rust/pull/33086).
3952 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3953 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3954 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3955 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3956 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3957 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3958   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3959
3960 Cargo
3961 -----
3962 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3963   This controls the runtime behavior of the `panic!` macro
3964   and can be either "unwind" (the default), or "abort".
3965   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3966 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3967 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3968 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3969   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3970 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3971 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3972 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3973   By default they are retried twice, which can be customized with the
3974   `net.retry` value in `.cargo/config`.
3975 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3976 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3977 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3978 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3979   Makes it possible to install multiple crates in parallel.
3980 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3981 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3982 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3983 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3984 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3985 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3986
3987 Performance
3988 -----------
3989
3990 * [rustc memory usage was reduced by refactoring the context used for
3991   type checking](https://github.com/rust-lang/rust/pull/33425).
3992 * [Speed up creation of `HashMap`s by caching the random keys used
3993   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3994 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3995 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3996 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3997   10x faster than the previous lookup tables.
3998 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3999
4000 Usability
4001 ---------
4002
4003 * Many incremental improvements to documentation and rustdoc.
4004 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
4005 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
4006 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
4007 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
4008 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
4009 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
4010 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
4011
4012 Misc
4013 ----
4014
4015 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
4016 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
4017 * [`std` no longer prints backtraces on platforms where the running
4018   module must be loaded with `env::current_exe`, which can't be relied
4019   on](https://github.com/rust-lang/rust/pull/33554).
4020 * This release includes std binaries for the i586-unknown-linux-gnu,
4021   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
4022   i586 target is for old x86 hardware without SSE2, and the armv7
4023   target is for Android running on modern ARM architectures.
4024 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
4025   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
4026 * [On Unix the runtime aborts by calling `libc::abort` instead of
4027   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
4028 * [Rust is now bootstrapped from the previous release of Rust,
4029   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
4030
4031 Compatibility Notes
4032 -------------------
4033
4034 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
4035 * [`target_env` for Linux ARM targets is just `gnu`, not
4036   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
4037 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
4038 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
4039 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
4040   Affects how macros are parsed.
4041 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
4042 * [Feature-gated attributes on macro-generated macro invocations are
4043   now rejected](https://github.com/rust-lang/rust/pull/32791).
4044 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
4045   This caused some minor changes to type inference.
4046
4047
4048 Version 1.9.0 (2016-05-26)
4049 ==========================
4050
4051 Language
4052 --------
4053
4054 * The `#[deprecated]` attribute when applied to an API will generate
4055   warnings when used. The warnings may be suppressed with
4056   `#[allow(deprecated)]`. [RFC 1270].
4057 * [`fn` item types are zero sized, and each `fn` names a unique
4058   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4059   `transmute` on a `fn` type will generate a warning for a few cycles,
4060   then will be converted to an error.
4061 * [Field and method resolution understand visibility, so private
4062   fields and methods cannot prevent the proper use of public fields
4063   and methods][1.9fv].
4064 * [The parser considers unicode codepoints in the
4065   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
4066
4067 Stabilized APIs
4068 ---------------
4069
4070 * [`std::panic`]
4071 * [`std::panic::catch_unwind`][] (renamed from `recover`)
4072 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
4073 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
4074 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
4075 * [`str::is_char_boundary`]
4076 * [`<*const T>::as_ref`]
4077 * [`<*mut T>::as_ref`]
4078 * [`<*mut T>::as_mut`]
4079 * [`AsciiExt::make_ascii_uppercase`]
4080 * [`AsciiExt::make_ascii_lowercase`]
4081 * [`char::decode_utf16`]
4082 * [`char::DecodeUtf16`]
4083 * [`char::DecodeUtf16Error`]
4084 * [`char::DecodeUtf16Error::unpaired_surrogate`]
4085 * [`BTreeSet::take`]
4086 * [`BTreeSet::replace`]
4087 * [`BTreeSet::get`]
4088 * [`HashSet::take`]
4089 * [`HashSet::replace`]
4090 * [`HashSet::get`]
4091 * [`OsString::with_capacity`]
4092 * [`OsString::clear`]
4093 * [`OsString::capacity`]
4094 * [`OsString::reserve`]
4095 * [`OsString::reserve_exact`]
4096 * [`OsStr::is_empty`]
4097 * [`OsStr::len`]
4098 * [`std::os::unix::thread`]
4099 * [`RawPthread`]
4100 * [`JoinHandleExt`]
4101 * [`JoinHandleExt::as_pthread_t`]
4102 * [`JoinHandleExt::into_pthread_t`]
4103 * [`HashSet::hasher`]
4104 * [`HashMap::hasher`]
4105 * [`CommandExt::exec`]
4106 * [`File::try_clone`]
4107 * [`SocketAddr::set_ip`]
4108 * [`SocketAddr::set_port`]
4109 * [`SocketAddrV4::set_ip`]
4110 * [`SocketAddrV4::set_port`]
4111 * [`SocketAddrV6::set_ip`]
4112 * [`SocketAddrV6::set_port`]
4113 * [`SocketAddrV6::set_flowinfo`]
4114 * [`SocketAddrV6::set_scope_id`]
4115 * [`slice::copy_from_slice`]
4116 * [`ptr::read_volatile`]
4117 * [`ptr::write_volatile`]
4118 * [`OpenOptions::create_new`]
4119 * [`TcpStream::set_nodelay`]
4120 * [`TcpStream::nodelay`]
4121 * [`TcpStream::set_ttl`]
4122 * [`TcpStream::ttl`]
4123 * [`TcpStream::set_only_v6`]
4124 * [`TcpStream::only_v6`]
4125 * [`TcpStream::take_error`]
4126 * [`TcpStream::set_nonblocking`]
4127 * [`TcpListener::set_ttl`]
4128 * [`TcpListener::ttl`]
4129 * [`TcpListener::set_only_v6`]
4130 * [`TcpListener::only_v6`]
4131 * [`TcpListener::take_error`]
4132 * [`TcpListener::set_nonblocking`]
4133 * [`UdpSocket::set_broadcast`]
4134 * [`UdpSocket::broadcast`]
4135 * [`UdpSocket::set_multicast_loop_v4`]
4136 * [`UdpSocket::multicast_loop_v4`]
4137 * [`UdpSocket::set_multicast_ttl_v4`]
4138 * [`UdpSocket::multicast_ttl_v4`]
4139 * [`UdpSocket::set_multicast_loop_v6`]
4140 * [`UdpSocket::multicast_loop_v6`]
4141 * [`UdpSocket::set_multicast_ttl_v6`]
4142 * [`UdpSocket::multicast_ttl_v6`]
4143 * [`UdpSocket::set_ttl`]
4144 * [`UdpSocket::ttl`]
4145 * [`UdpSocket::set_only_v6`]
4146 * [`UdpSocket::only_v6`]
4147 * [`UdpSocket::join_multicast_v4`]
4148 * [`UdpSocket::join_multicast_v6`]
4149 * [`UdpSocket::leave_multicast_v4`]
4150 * [`UdpSocket::leave_multicast_v6`]
4151 * [`UdpSocket::take_error`]
4152 * [`UdpSocket::connect`]
4153 * [`UdpSocket::send`]
4154 * [`UdpSocket::recv`]
4155 * [`UdpSocket::set_nonblocking`]
4156
4157 Libraries
4158 ---------
4159
4160 * [`std::sync::Once` is poisoned if its initialization function
4161   fails][1.9o].
4162 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
4163 * [Most types implement `fmt::Debug`][1.9db].
4164 * [The default buffer size used by `BufReader` and `BufWriter` was
4165   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
4166   used by other languages.
4167 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
4168   `Duration` additionally implements `*=` and `/=`][1.9ta].
4169 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
4170 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
4171 * [`Chain` implements `BufRead`][1.9ch].
4172 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
4173
4174 Cargo
4175 -----
4176
4177 * [Cargo can now run concurrently][1.9cc].
4178 * [Top-level overrides allow specific revisions of crates to be
4179   overridden through the entire crate graph][1.9ct].  This is intended
4180   to make upgrades easier for large projects, by allowing crates to be
4181   forked temporarily until they've been upgraded and republished.
4182 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
4183 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
4184   on the commandline][1.9cf]. `rustc` arguments can also be specified
4185   in the `build.rustflags` configuration key.
4186
4187 Performance
4188 -----------
4189
4190 * [The time complexity of comparing variables for equivalence during type
4191   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
4192   to major compilation time improvement in some scenarios.
4193 * [`ToString` is specialized for `str`, giving it the same performance
4194   as `to_owned`][1.9ts].
4195 * [Spawning processes with `Command::output` no longer creates extra
4196   threads][1.9sp].
4197 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
4198   for C-like enums][1.9cl].
4199
4200 Misc
4201 ----
4202
4203 * [Passing the `--quiet` flag to a test runner will produce
4204   much-abbreviated output][1.9q].
4205 * The Rust Project now publishes std binaries for the
4206   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
4207   `i586-pc-windows-msvc` targets.
4208
4209 Compatibility Notes
4210 -------------------
4211
4212 * [`std::sync::Once` is poisoned if its initialization function
4213   fails][1.9o].
4214 * [It is illegal to define methods with the same name in overlapping
4215   inherent `impl` blocks][1.9sn].
4216 * [`fn` item types are zero sized, and each `fn` names a unique
4217   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4218   `transmute` on a `fn` type will generate a warning for a few cycles,
4219   then will be converted to an error.
4220 * [Improvements to const evaluation may trigger new errors when integer
4221   literals are out of range][1.9ce].
4222
4223
4224 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
4225 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
4226 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
4227 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
4228 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
4229 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
4230 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
4231 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
4232 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
4233 [1.9db]: https://github.com/rust-lang/rust/pull/32054
4234 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
4235 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
4236 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
4237 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
4238 [1.9o]: https://github.com/rust-lang/rust/pull/32325
4239 [1.9q]: https://github.com/rust-lang/rust/pull/31887
4240 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
4241 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
4242 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
4243 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
4244 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
4245 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
4246 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
4247 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
4248 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4249 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
4250 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4251 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
4252 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
4253 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
4254 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
4255 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
4256 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
4257 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
4258 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
4259 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
4260 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
4261 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
4262 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
4263 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
4264 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
4265 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
4266 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
4267 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
4268 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
4269 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
4270 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
4271 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
4272 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
4273 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
4274 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
4275 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
4276 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
4277 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
4278 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
4279 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
4280 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
4281 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
4282 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
4283 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
4284 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4285 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4286 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4287 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4288 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4289 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4290 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
4291 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4292 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
4293 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4294 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4295 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4296 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4297 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4298 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
4299 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
4300 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
4301 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
4302 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
4303 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
4304 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
4305 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
4306 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
4307 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
4308 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
4309 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
4310 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
4311 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
4312 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
4313 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
4314 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
4315 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
4316 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
4317 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
4318 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
4319 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
4320 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
4321 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
4322 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
4323 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
4324 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
4325 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
4326 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
4327 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
4328 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
4329 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
4330 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
4331 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
4332 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
4333 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
4334
4335
4336 Version 1.8.0 (2016-04-14)
4337 ==========================
4338
4339 Language
4340 --------
4341
4342 * Rust supports overloading of compound assignment statements like
4343   `+=` by implementing the [`AddAssign`], [`SubAssign`],
4344   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
4345   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
4346   traits. [RFC 953].
4347 * Empty structs can be defined with braces, as in `struct Foo { }`, in
4348   addition to the non-braced form, `struct Foo;`. [RFC 218].
4349
4350 Libraries
4351 ---------
4352
4353 * Stabilized APIs:
4354   * [`str::encode_utf16`][] (renamed from `utf16_units`)
4355   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
4356   * [`Ref::map`]
4357   * [`RefMut::map`]
4358   * [`ptr::drop_in_place`]
4359   * [`time::Instant`]
4360   * [`time::SystemTime`]
4361   * [`Instant::now`]
4362   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
4363   * [`Instant::elapsed`]
4364   * [`SystemTime::now`]
4365   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
4366   * [`SystemTime::elapsed`]
4367   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
4368   * [`SystemTimeError`]
4369   * [`SystemTimeError::duration`]
4370   * Various impls for `SystemTimeError`
4371   * [`UNIX_EPOCH`]
4372   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
4373     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
4374     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
4375 * [The `write!` and `writeln!` macros correctly emit errors if any of
4376   their arguments can't be formatted][1.8w].
4377 * [Various I/O functions support large files on 32-bit Linux][1.8l].
4378 * [The Unix-specific `raw` modules, which contain a number of
4379   redefined C types are deprecated][1.8r], including `os::raw::unix`,
4380   `os::raw::macos`, and `os::raw::linux`. These modules defined types
4381   such as `ino_t` and `dev_t`. The inconsistency of these definitions
4382   across platforms was making it difficult to implement `std`
4383   correctly. Those that need these definitions should use the `libc`
4384   crate. [RFC 1415].
4385 * The Unix-specific `MetadataExt` traits, including
4386   `os::unix::fs::MetadataExt`, which expose values such as inode
4387   numbers [no longer return platform-specific types][1.8r], but
4388   instead return widened integers. [RFC 1415].
4389 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
4390 * [Atomic loads and stores are not volatile][1.8a].
4391 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
4392
4393 Performance
4394 -----------
4395
4396 * [Inlining hash functions lead to a 3% compile-time improvement in
4397   some workloads][1.8h].
4398 * When using jemalloc, its symbols are [unprefixed so that it
4399   overrides the libc malloc implementation][1.8h]. This means that for
4400   rustc, LLVM is now using jemalloc, which results in a 6%
4401   compile-time improvement on a specific workload.
4402 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
4403
4404 Misc
4405 ----
4406
4407 * [32-bit MSVC builds finally implement unwinding][1.8ms].
4408   i686-pc-windows-msvc is now considered a tier-1 platform.
4409 * [The `--print targets` flag prints a list of supported targets][1.8t].
4410 * [The `--print cfg` flag prints the `cfg`s defined for the current
4411   target][1.8cf].
4412 * [`rustc` can be built with an new Cargo-based build system, written
4413   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
4414   build system. To enable it configure with `configure --rustbuild`.
4415 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
4416   variants while also indicating the total number of missing variants
4417   if more than 3][1.8m].
4418 * [Executable stacks are disabled on Linux and BSD][1.8nx].
4419 * The Rust Project now publishes binary releases of the standard
4420   library for a number of tier-2 targets:
4421   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
4422   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
4423   `x86_64-rumprun-netbsd`. These can be installed with
4424   tools such as [multirust][1.8mr].
4425
4426 Cargo
4427 -----
4428
4429 * [`cargo init` creates a new Cargo project in the current
4430   directory][1.8ci].  It is otherwise like `cargo new`.
4431 * [Cargo has configuration keys for `-v` and
4432   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
4433   `[term]` section of `.cargo/config`.
4434 * [Configuration keys that evaluate to strings or integers can be set
4435   via environment variables][1.8ce]. For example the `build.jobs` key
4436   can be set via `CARGO_BUILD_JOBS`. Environment variables take
4437   precedence over config files.
4438 * [Target-specific dependencies support Rust `cfg` syntax for
4439   describing targets][1.8cfg] so that dependencies for multiple
4440   targets can be specified together. [RFC 1361].
4441 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
4442   `RUSTDOC` take precedence over the `build.target-dir`,
4443   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4444 * [The child process tree is killed on Windows when Cargo is
4445   killed][1.8ck].
4446 * [The `build.target` configuration value sets the target platform,
4447   like `--target`][1.8ct].
4448
4449 Compatibility Notes
4450 -------------------
4451
4452 * [Unstable compiler flags have been further restricted][1.8u]. Since
4453   1.0 `-Z` flags have been considered unstable, and other flags that
4454   were considered unstable additionally required passing `-Z
4455   unstable-options` to access. Unlike unstable language and library
4456   features though, these options have been accessible on the stable
4457   release channel. Going forward, *new unstable flags will not be
4458   available on the stable release channel*, and old unstable flags
4459   will warn about their usage. In the future, all unstable flags will
4460   be unavailable on the stable release channel.
4461 * [It is no longer possible to `match` on empty enum variants using
4462   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4463 * The Unix-specific `MetadataExt` traits, including
4464   `os::unix::fs::MetadataExt`, which expose values such as inode
4465   numbers [no longer return platform-specific types][1.8r], but
4466   instead return widened integers. [RFC 1415].
4467 * [Modules sourced from the filesystem cannot appear within arbitrary
4468   blocks, but only within other modules][1.8mf].
4469 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4470 * On Unix, [stack overflow triggers a runtime abort instead of a
4471   SIGSEGV][1.8so].
4472 * [`Command::spawn` and its equivalents return an error if any of
4473   its command-line arguments contain interior `NUL`s][1.8n].
4474 * [Tuple and unit enum variants from other crates are in the type
4475   namespace][1.8tn].
4476 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4477   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4478   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4479   instead of `foo.lib`.
4480
4481
4482 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4483 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4484 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4485 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4486 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4487 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4488 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4489 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4490 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4491 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4492 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4493 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4494 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4495 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4496 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4497 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4498 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4499 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4500 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4501 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4502 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4503 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4504 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4505 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4506 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4507 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4508 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4509 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4510 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4511 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4512 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4513 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4514 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4515 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4516 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4517 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4518 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4519 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4520 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4521 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4522 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4523 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4524 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4525 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4526 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4527 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4528 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4529 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4530 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4531 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4532 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4533 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4534 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4535 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4536 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4537 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4538 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4539 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4540 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4541 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4542
4543
4544 Version 1.7.0 (2016-03-03)
4545 ==========================
4546
4547 Libraries
4548 ---------
4549
4550 * Stabilized APIs
4551   * `Path`
4552     * [`Path::strip_prefix`][] (renamed from relative_from)
4553     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4554   * `Ipv4Addr`
4555     * [`Ipv4Addr::is_loopback`]
4556     * [`Ipv4Addr::is_private`]
4557     * [`Ipv4Addr::is_link_local`]
4558     * [`Ipv4Addr::is_multicast`]
4559     * [`Ipv4Addr::is_broadcast`]
4560     * [`Ipv4Addr::is_documentation`]
4561   * `Ipv6Addr`
4562     * [`Ipv6Addr::is_unspecified`]
4563     * [`Ipv6Addr::is_loopback`]
4564     * [`Ipv6Addr::is_multicast`]
4565   * `Vec`
4566     * [`Vec::as_slice`]
4567     * [`Vec::as_mut_slice`]
4568   * `String`
4569     * [`String::as_str`]
4570     * [`String::as_mut_str`]
4571   * Slices
4572     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4573     be the same length
4574     * `<[T]>::`[`sort_by_key`]
4575   * checked, saturated, and overflowing operations
4576     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4577     * [`i32::saturating_mul`]
4578     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4579     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4580     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4581     * [`u32::saturating_mul`]
4582     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4583     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4584     * and checked, saturated, and overflowing operations for other primitive types
4585   * FFI
4586     * [`ffi::IntoStringError`]
4587     * [`CString::into_string`]
4588     * [`CString::into_bytes`]
4589     * [`CString::into_bytes_with_nul`]
4590     * `From<CString> for Vec<u8>`
4591   * `IntoStringError`
4592     * [`IntoStringError::into_cstring`]
4593     * [`IntoStringError::utf8_error`]
4594     * `Error for IntoStringError`
4595   * Hashing
4596     * [`std::hash::BuildHasher`]
4597     * [`BuildHasher::Hasher`]
4598     * [`BuildHasher::build_hasher`]
4599     * [`std::hash::BuildHasherDefault`]
4600     * [`HashMap::with_hasher`]
4601     * [`HashMap::with_capacity_and_hasher`]
4602     * [`HashSet::with_hasher`]
4603     * [`HashSet::with_capacity_and_hasher`]
4604     * [`std::collections::hash_map::RandomState`]
4605     * [`RandomState::new`]
4606 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4607   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4608   from bytes is faster.
4609 * [The performance of `LineWriter` (and thus `io::stdout`) was
4610   improved by using `memchr` to search for newlines][1.7m].
4611 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4612   `f64` variants were stabilized previously.
4613 * [`BTreeMap` was rewritten to use less memory and improve the performance
4614   of insertion and iteration, the latter by as much as 5x][1.7bm].
4615 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4616   covariant over their contained type][1.7bt].
4617 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4618   over their contained type][1.7ll].
4619 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4620   searching methods.
4621 * [`Any` is implemented for unsized types][1.7a].
4622 * [`Hash` is implemented for `Duration`][1.7h].
4623
4624 Misc
4625 ----
4626
4627 * [When running tests with `--test`, rustdoc will pass `--cfg`
4628   arguments to the compiler][1.7dt].
4629 * [The compiler is built with RPATH information by default][1.7rpa].
4630   This means that it will be possible to run `rustc` when installed in
4631   unusual configurations without configuring the dynamic linker search
4632   path explicitly.
4633 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4634   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4635   over `LD_LIBRARY_PATH`.
4636
4637 Cargo
4638 -----
4639
4640 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4641   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4642 * [The `rerun-if-changed` build script directive no longer causes the
4643   build script to incorrectly run twice in certain scenarios][1.7rr].
4644
4645 Compatibility Notes
4646 -------------------
4647
4648 * Soundness fixes to the interactions between associated types and
4649   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4650   code that violates the new rules. This is a significant change that
4651   is known to break existing code, so it has emitted warnings for the
4652   new error cases since 1.4 to give crate authors time to adapt. The
4653   details of what is changing are subtle; read the RFC for more.
4654 * [Several bugs in the compiler's visibility calculations were
4655   fixed][1.7v]. Since this was found to break significant amounts of
4656   code, the new errors will be emitted as warnings for several release
4657   cycles, under the `private_in_public` lint.
4658 * Defaulted type parameters were accidentally accepted in positions
4659   that were not intended. In this release, [defaulted type parameters
4660   appearing outside of type definitions will generate a
4661   warning][1.7d], which will become an error in future releases.
4662 * [Parsing "." as a float results in an error instead of 0][1.7p].
4663   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4664 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4665
4666 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4667 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4668 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4669 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4670 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4671 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4672 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4673 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4674 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4675 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4676 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4677 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4678 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4679 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4680 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4681 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4682 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4683 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4684 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4685 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4686 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4687 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4688 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4689 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4690 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4691 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4692 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4693 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4694 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4695 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4696 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4697 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4698 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4699 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4700 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4701 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4702 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4703 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4704 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4705 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4706 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4707 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4708 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4709 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4710 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4711 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4712 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4713 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4714 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4715 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4716 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4717 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4718 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4719 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4720 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4721 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4722 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4723 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4724 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4725 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4726 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4727 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4728 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4729 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4730 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4731 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4732 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4733 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4734 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4735 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4736 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4737 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4738 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4739 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4740 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4741 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4742 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4743 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4744 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4745
4746
4747 Version 1.6.0 (2016-01-21)
4748 ==========================
4749
4750 Language
4751 --------
4752
4753 * The `#![no_std]` attribute causes a crate to not be linked to the
4754   standard library, but only the [core library][1.6co], as described
4755   in [RFC 1184]. The core library defines common types and traits but
4756   has no platform dependencies whatsoever, and is the basis for Rust
4757   software in environments that cannot support a full port of the
4758   standard library, such as operating systems. Most of the core
4759   library is now stable.
4760
4761 Libraries
4762 ---------
4763
4764 * Stabilized APIs:
4765   [`Read::read_exact`],
4766   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4767   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4768   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4769   [`os::unix::fs::DirBuilderExt`],
4770   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4771   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4772   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4773   [`collections::hash_map::Drain`],
4774   [`collections::hash_map::HashMap::drain`],
4775   [`collections::hash_set::Drain`],
4776   [`collections::hash_set::HashSet::drain`],
4777   [`collections::binary_heap::Drain`],
4778   [`collections::binary_heap::BinaryHeap::drain`],
4779   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4780   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4781   [`RwLock::into_inner`],
4782   [`Iterator::min_by_key`][] (renamed from `min_by`),
4783   [`Iterator::max_by_key`][] (renamed from `max_by`).
4784 * The [core library][1.6co] is stable, as are most of its APIs.
4785 * [The `assert_eq!` macro supports arguments that don't implement
4786   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4787   `assert!`.
4788 * Several timer functions that take duration in milliseconds [are
4789   deprecated in favor of those that take `Duration`][1.6ms]. These
4790   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4791   `thread::park_timeout_ms`.
4792 * The algorithm by which `Vec` reserves additional elements was
4793   [tweaked to not allocate excessive space][1.6a] while still growing
4794   exponentially.
4795 * `From` conversions are [implemented from integers to floats][1.6f]
4796   in cases where the conversion is lossless. Thus they are not
4797   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4798   or `f64`. They are also not implemented for `isize` and `usize`
4799   because the implementations would be platform-specific. `From` is
4800   also implemented from `f32` to `f64`.
4801 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4802 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4803 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4804 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4805   improvements.
4806 * Sorting slices that are already sorted [is 50% faster in some
4807   cases][1.6s].
4808
4809 Cargo
4810 -----
4811
4812 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4813 * Cargo build scripts can specify their dependencies by emitting the
4814   [`rerun-if-changed`][1.6rr] key.
4815 * crates.io will reject publication of crates with dependencies that
4816   have a wildcard version constraint. Crates with wildcard
4817   dependencies were seen to cause a variety of problems, as described
4818   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4819   warning.
4820 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4821   release folder.  A variety of artifacts that Cargo failed to clean
4822   are now correctly deleted.
4823
4824 Misc
4825 ----
4826
4827 * The `unreachable_code` lint [warns when a function call's argument
4828   diverges][1.6dv].
4829 * The parser indicates [failures that may be caused by
4830   confusingly-similar Unicode characters][1.6uc]
4831 * Certain macro errors [are reported at definition time][1.6m], not
4832   expansion.
4833
4834 Compatibility Notes
4835 -------------------
4836
4837 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4838   environment variable when locating crates. This was a pre-cargo
4839   feature for integrating with the package manager that was
4840   accidentally never removed.
4841 * [A number of bugs were fixed in the privacy checker][1.6p] that
4842   could cause previously-accepted code to break.
4843 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4844 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4845   struct pattern syntax (`Foo(..)`) can no longer be used to match
4846   unit structs. This is a warning now, but will become an error in
4847   future releases. Patterns that share the same name as a const are
4848   now an error.
4849 * A bug was fixed that causes [rustc not to apply default type
4850   parameters][1.6xc] when resolving certain method implementations of
4851   traits defined in other crates.
4852
4853 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4854 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4855 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4856 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4857 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4858 [1.6co]: http://doc.rust-lang.org/core/index.html
4859 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4860 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4861 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4862 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4863 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4864 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4865 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4866 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4867 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4868 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4869 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4870 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4871 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4872 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4873 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4874 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4875 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4876 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4877 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4878 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4879 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4880 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4881 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4882 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4883 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4884 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4885 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4886 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4887 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4888 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4889 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4890 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4891 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4892 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4893 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4894 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4895 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4896 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4897 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4898 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4899 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4900
4901
4902 Version 1.5.0 (2015-12-10)
4903 ==========================
4904
4905 * ~700 changes, numerous bugfixes
4906
4907 Highlights
4908 ----------
4909
4910 * Stabilized APIs:
4911   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4912   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4913   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4914   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4915   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4916   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4917   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4918   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4919   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4920   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4921   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4922   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4923   [`Path::read_link`], [`Path::symlink_metadata`],
4924   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4925   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4926   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4927   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4928   [`slice::split_first_mut`], [`slice::split_first`],
4929   [`slice::split_last_mut`], [`slice::split_last`],
4930   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4931   [`str::MatchIndices`], [`str::RMatchIndices`],
4932   [`str::match_indices`], [`str::rmatch_indices`],
4933   [`str::slice_mut_unchecked`], [`string::ParseError`].
4934 * Rust applications hosted on crates.io can be installed locally to
4935   `~/.cargo/bin` with the [`cargo install`] command. Among other
4936   things this makes it easier to augment Cargo with new subcommands:
4937   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4938   invoked as `cargo foo`.
4939 * Crates with wildcard (`*`) dependencies will [emit warnings when
4940   published][1.5w]. In 1.6 it will no longer be possible to publish
4941   crates with wildcard dependencies.
4942
4943 Breaking Changes
4944 ----------------
4945
4946 * The rules determining when a particular lifetime must outlive
4947   a particular value (known as '[dropck]') have been [modified
4948   to not rely on parametricity][1.5p].
4949 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4950   and `Arc`][1.5a]. Because these smart pointer types implement
4951   `Deref`, this causes breakage in cases where the interior type
4952   contains methods of the same name.
4953 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4954   that they could drop their content. Soundness fix.
4955 * All method invocations are [properly checked][1.5wf1] for
4956   [well-formedness][1.5wf2]. Soundness fix.
4957 * Traits whose supertraits contain `Self` are [not object
4958   safe][1.5o]. Soundness fix.
4959 * Target specifications support a [`no_default_libraries`][1.5nd]
4960   setting that controls whether `-nodefaultlibs` is passed to the
4961   linker, and in turn the `is_like_windows` setting no longer affects
4962   the `-nodefaultlibs` flag.
4963 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4964 * The `#[inline]` and `#[repr]` attributes [can only appear
4965   in valid locations][1.5at].
4966 * Native libraries linked from the local crate are [passed to
4967   the linker before native libraries from upstream crates][1.5nl].
4968 * Two rarely-used attributes, `#[no_debug]` and
4969   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4970 * Negation of unsigned integers, which has been a warning for
4971   several releases, [is now behind a feature gate and will
4972   generate errors][1.5nu].
4973 * The parser accidentally accepted visibility modifiers on
4974   enum variants, a bug [which has been fixed][1.5ev].
4975 * [A bug was fixed that allowed `use` statements to import unstable
4976   features][1.5use].
4977
4978 Language
4979 --------
4980
4981 * When evaluating expressions at compile-time that are not
4982   compile-time constants (const-evaluating expressions in non-const
4983   contexts), incorrect code such as overlong bitshifts and arithmetic
4984   overflow will [generate a warning instead of an error][1.5ce],
4985   delaying the error until runtime. This will allow the
4986   const-evaluator to be expanded in the future backwards-compatibly.
4987 * The `improper_ctypes` lint [no longer warns about using `isize` and
4988   `usize` in FFI][1.5ict].
4989
4990 Libraries
4991 ---------
4992
4993 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4994   invariant][1.5c].
4995 * `Default` is [implemented for mutable slices][1.5d].
4996 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4997 * There are now `From` conversions [between floating point
4998   types][1.5f] where the conversions are lossless.
4999 * There are now `From` conversions [between integer types][1.5i] where
5000   the conversions are lossless.
5001 * [`fs::Metadata` implements `Clone`][1.5fs].
5002 * The `parse` method [accepts a leading "+" when parsing
5003   integers][1.5pi].
5004 * [`AsMut` is implemented for `Vec`][1.5am].
5005 * The `clone_from` implementations for `String` and `BinaryHeap` [have
5006   been optimized][1.5cf] and no longer rely on the default impl.
5007 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
5008   `unsafe extern "C"` function types now [implement `Clone`,
5009   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
5010   `fmt::Debug` for up to 12 arguments][1.5fp].
5011 * [Dropping `Vec`s is much faster in unoptimized builds when the
5012   element types don't implement `Drop`][1.5dv].
5013 * A bug that caused in incorrect behavior when [combining `VecDeque`
5014   with zero-sized types][1.5vdz] was resolved.
5015 * [`PartialOrd` for slices is faster][1.5po].
5016
5017 Miscellaneous
5018 -------------
5019
5020 * [Crate metadata size was reduced by 20%][1.5md].
5021 * [Improvements to code generation reduced the size of libcore by 3.3
5022   MB and rustc's memory usage by 18MB][1.5m].
5023 * [Improvements to deref translation increased performance in
5024   unoptimized builds][1.5dr].
5025 * Various errors in trait resolution [are deduplicated to only be
5026   reported once][1.5te].
5027 * Rust has preliminary [support for rumprun kernels][1.5rr].
5028 * Rust has preliminary [support for NetBSD on amd64][1.5na].
5029
5030 [1.5use]: https://github.com/rust-lang/rust/pull/28364
5031 [1.5po]: https://github.com/rust-lang/rust/pull/28436
5032 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
5033 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
5034 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
5035 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
5036 [1.5md]: https://github.com/rust-lang/rust/pull/28521
5037 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
5038 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
5039 [1.5na]: https://github.com/rust-lang/rust/pull/28543
5040 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
5041 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
5042 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
5043 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
5044 [1.5te]: https://github.com/rust-lang/rust/pull/28645
5045 [1.5at]: https://github.com/rust-lang/rust/pull/28650
5046 [1.5am]: https://github.com/rust-lang/rust/pull/28663
5047 [1.5m]: https://github.com/rust-lang/rust/pull/28778
5048 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
5049 [1.5a]: https://github.com/rust-lang/rust/pull/28811
5050 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
5051 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
5052 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
5053 [1.5i]: https://github.com/rust-lang/rust/pull/28921
5054 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
5055 [1.5f]: https://github.com/rust-lang/rust/pull/29129
5056 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
5057 [1.5s]: https://github.com/rust-lang/rust/pull/29190
5058 [1.5d]: https://github.com/rust-lang/rust/pull/29245
5059 [1.5o]: https://github.com/rust-lang/rust/pull/29259
5060 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
5061 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5062 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
5063 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
5064 [1.5c]: https://github.com/rust-lang/rust/pull/29110
5065 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5066 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
5067 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
5068 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
5069 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
5070 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
5071 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
5072 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
5073 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
5074 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
5075 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
5076 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
5077 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
5078 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
5079 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
5080 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
5081 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
5082 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
5083 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
5084 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
5085 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
5086 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
5087 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
5088 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
5089 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
5090 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
5091 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
5092 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
5093 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
5094 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
5095 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
5096 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
5097 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
5098 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
5099 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
5100 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
5101 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
5102 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
5103 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
5104 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
5105 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
5106 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
5107 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
5108 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
5109 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
5110 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
5111 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
5112 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
5113 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
5114 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
5115 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
5116 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
5117 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
5118 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
5119
5120 Version 1.4.0 (2015-10-29)
5121 ==========================
5122
5123 * ~1200 changes, numerous bugfixes
5124
5125 Highlights
5126 ----------
5127
5128 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
5129   GNU) are now supported and recommended for use.
5130
5131 Breaking Changes
5132 ----------------
5133
5134 * [Several changes have been made to fix type soundness and improve
5135   the behavior of associated types][sound]. See [RFC 1214]. Although
5136   we have mostly introduced these changes as warnings this release, to
5137   become errors next release, there are still some scenarios that will
5138   see immediate breakage.
5139 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
5140   line breaks in addition to `\n`][crlf].
5141 * [Loans of `'static` lifetime extend to the end of a function][stat].
5142 * [`str::parse` no longer introduces avoidable rounding error when
5143   parsing floating point numbers. Together with earlier changes to
5144   float formatting/output, "round trips" like f.to_string().parse()
5145   now preserve the value of f exactly. Additionally, leading plus
5146   signs are now accepted][fp3].
5147
5148
5149 Language
5150 --------
5151
5152 * `use` statements that import multiple items [can now rename
5153   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
5154 * [Binops work correctly on fat pointers][binfat].
5155 * `pub extern crate`, which does not behave as expected, [issues a
5156   warning][pec] until a better solution is found.
5157
5158 Libraries
5159 ---------
5160
5161 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
5162   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
5163   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
5164   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
5165   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
5166   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
5167   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
5168   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
5169   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
5170   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
5171   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
5172   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
5173   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
5174   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
5175   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
5176   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
5177   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
5178   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
5179   [`thread::sleep`].
5180 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
5181   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
5182   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
5183   `f64::from_str_radix`.
5184 * [Reverse-searching strings is faster with the 'two-way'
5185   algorithm][s].
5186 * [`std::io::copy` allows `?Sized` arguments][cc].
5187 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
5188   [override `count`, `nth` and `last` with an O(1)
5189   implementation][it].
5190 * [`Default` is implemented for arrays up to `[T; 32]`][d].
5191 * [`IntoRawFd` has been added to the Unix-specific prelude,
5192   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
5193   prelude][pr].
5194 * [`Extend<String>` and `FromIterator<String` are both implemented for
5195   `String`][es].
5196 * [`IntoIterator` is implemented for references to `Option` and
5197   `Result`][into2].
5198 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
5199   Copy`][ext] as part of [RFC 839]. This will cause type inference
5200   breakage in rare situations.
5201 * [`BinaryHeap` implements `Debug`][bh2].
5202 * [`Borrow` and `BorrowMut` are implemented for fixed-size
5203   arrays][bm].
5204 * [`extern fn`s with the "Rust" and "C" ABIs implement common
5205   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
5206 * [String comparison is faster][faststr].
5207 * `&mut T` where `T: std::fmt::Write` [also implements
5208   `std::fmt::Write`][mutw].
5209 * [A stable regression in `VecDeque::push_back` and other
5210   capacity-altering methods that caused panics for zero-sized types
5211   was fixed][vd].
5212 * [Function pointers implement traits for up to 12 parameters][fp2].
5213
5214 Miscellaneous
5215 -------------
5216
5217 * The compiler [no longer uses the 'morestack' feature to prevent
5218   stack overflow][mm]. Instead it uses guard pages and stack
5219   probes (though stack probes are not yet implemented on any platform
5220   but Windows).
5221 * [The compiler matches traits faster when projections are involved][p].
5222 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
5223   `usize`][ffi].
5224 * [Cargo now displays useful information about what its doing during
5225   `cargo update`][cu].
5226
5227 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
5228 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
5229 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
5230 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
5231 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
5232 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
5233 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
5234 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
5235 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
5236 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
5237 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
5238 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
5239 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
5240 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
5241 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
5242 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
5243 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
5244 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
5245 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5246 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5247 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5248 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5249 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5250 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5251 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5252 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5253 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
5254 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
5255 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
5256 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
5257 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
5258 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
5259 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
5260 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
5261 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
5262 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
5263 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
5264 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
5265 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
5266 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
5267 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
5268 [bh2]: https://github.com/rust-lang/rust/pull/28156
5269 [binfat]: https://github.com/rust-lang/rust/pull/28270
5270 [bm]: https://github.com/rust-lang/rust/pull/28197
5271 [cc]: https://github.com/rust-lang/rust/pull/27531
5272 [crlf]: https://github.com/rust-lang/rust/pull/28034
5273 [cu]: https://github.com/rust-lang/cargo/pull/1931
5274 [d]: https://github.com/rust-lang/rust/pull/27825
5275 [dep]: https://github.com/rust-lang/rust/pull/28339
5276 [es]: https://github.com/rust-lang/rust/pull/27956
5277 [ext]: https://github.com/rust-lang/rust/pull/28094
5278 [faststr]: https://github.com/rust-lang/rust/pull/28338
5279 [ffi]: https://github.com/rust-lang/rust/pull/28779
5280 [fp]: https://github.com/rust-lang/rust/pull/28268
5281 [fp2]: https://github.com/rust-lang/rust/pull/28560
5282 [fp3]: https://github.com/rust-lang/rust/pull/27307
5283 [i]: https://github.com/rust-lang/rust/pull/27451
5284 [into2]: https://github.com/rust-lang/rust/pull/28039
5285 [it]: https://github.com/rust-lang/rust/pull/27652
5286 [mm]: https://github.com/rust-lang/rust/pull/27338
5287 [mutw]: https://github.com/rust-lang/rust/pull/28368
5288 [sound]: https://github.com/rust-lang/rust/pull/27641
5289 [p]: https://github.com/rust-lang/rust/pull/27866
5290 [pec]: https://github.com/rust-lang/rust/pull/28486
5291 [pr]: https://github.com/rust-lang/rust/pull/27896
5292 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5293 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5294 [s]: https://github.com/rust-lang/rust/pull/27474
5295 [stab]: https://github.com/rust-lang/rust/pull/28339
5296 [stat]: https://github.com/rust-lang/rust/pull/28321
5297 [vd]: https://github.com/rust-lang/rust/pull/28494
5298
5299 Version 1.3.0 (2015-09-17)
5300 ==============================
5301
5302 * ~900 changes, numerous bugfixes
5303
5304 Highlights
5305 ----------
5306
5307 * The [new object lifetime defaults][nold] have been [turned
5308   on][nold2] after a cycle of warnings about the change. Now types
5309   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
5310   being interpreted as `&'a Box<Trait+'a>` to `&'a
5311   Box<Trait+'static>`.
5312 * [The Rustonomicon][nom] is a new book in the official documentation
5313   that dives into writing unsafe Rust.
5314 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
5315   timekeeping is employed by other std APIs, as well as out-of-tree
5316   time crates.
5317
5318 Breaking Changes
5319 ----------------
5320
5321 * The [new object lifetime defaults][nold] have been [turned
5322   on][nold2] after a cycle of warnings about the change.
5323 * There is a known [regression][lr] in how object lifetime elision is
5324   interpreted, the proper solution for which is undetermined.
5325 * The `#[prelude_import]` attribute, an internal implementation
5326   detail, was accidentally stabilized previously. [It has been put
5327   behind the `prelude_import` feature gate][pi]. This change is
5328   believed to break no existing code.
5329 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5330   [more sane for dynamically sized types][dst3]. Code that relied on
5331   the previous behavior is thought to be broken.
5332 * The `dropck` rules, which checks that destructors can't access
5333   destroyed values, [have been updated][dropck] to match the
5334   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
5335   cause some previously-compiling code to no longer build.
5336
5337 Language
5338 --------
5339
5340 * The [new object lifetime defaults][nold] have been [turned
5341   on][nold2] after a cycle of warnings about the change.
5342 * Semicolons may [now follow types and paths in
5343   macros](https://github.com/rust-lang/rust/pull/27000).
5344 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5345   [more sane for dynamically sized types][dst3]. Code that relied on
5346   the previous behavior is not known to exist, and suspected to be
5347   broken.
5348 * `'static` variables [may now be recursive][st].
5349 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
5350   implementations correctly.
5351 * The `dropck` rules, which checks that destructors can't access
5352   destroyed values, [have been updated][dropck] to match the
5353   [RFC][dropckrfc].
5354
5355 Libraries
5356 ---------
5357
5358 * The [`Duration`] API, [has been stabilized][ds], as well as the
5359   `std::time` module, which presently contains only `Duration`.
5360 * `Box<str>` and `Box<[T]>` both implement `Clone`.
5361 * The owned C string, [`CString`], implements [`Borrow`] and the
5362   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
5363   these allow C strings to be borrowed and cloned in generic code.
5364 * [`CStr`] implements [`Debug`].
5365 * [`AtomicPtr`] implements [`Debug`].
5366 * [`Error`] trait objects [can be downcast to their concrete types][e]
5367   in many common configurations, using the [`is`], [`downcast`],
5368   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
5369   [`Any`] trait.
5370 * Searching for substrings now [employs the two-way algorithm][search]
5371   instead of doing a naive search. This gives major speedups to a
5372   number of methods, including [`contains`][sc], [`find`][sf],
5373   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
5374   [`ends_with`][sew] are also faster.
5375 * The performance of `PartialEq` for slices is [much faster][ps].
5376 * The [`Hash`] trait offers the default method, [`hash_slice`], which
5377   is overridden and optimized by the implementations for scalars.
5378 * The [`Hasher`] trait now has a number of specialized `write_*`
5379   methods for primitive types, for efficiency.
5380 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
5381   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
5382   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
5383   of [`std::error::Error::cause`][iec] also delegates to the inner
5384   error.
5385 * [`process::Child`][pc] gained the [`id`] method, which returns a
5386   `u32` representing the platform-specific process identifier.
5387 * The [`connect`] method on slices is deprecated, replaced by the new
5388   [`join`] method (note that both of these are on the *unstable*
5389   [`SliceConcatExt`] trait, but through the magic of the prelude are
5390   available to stable code anyway).
5391 * The [`Div`] operator is implemented for [`Wrapping`] types.
5392 * [`DerefMut` is implemented for `String`][dms].
5393 * Performance of SipHash (the default hasher for `HashMap`) is
5394   [better for long data][sh].
5395 * [`AtomicPtr`] implements [`Send`].
5396 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
5397   are now [specialized to use uninitialized buffers for increased
5398   performance][rte].
5399 * Lifetime parameters of foreign functions [are now resolved
5400   properly][f].
5401
5402 Misc
5403 ----
5404
5405 * Rust can now, with some coercion, [produce programs that run on
5406   Windows XP][xp], though XP is not considered a supported platform.
5407 * Porting Rust on Windows from the GNU toolchain to MSVC continues
5408   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
5409   recommended for use in 1.3, though should be fully-functional
5410   in the [64-bit 1.4 beta][b14].
5411 * On Fedora-based systems installation will [properly configure the
5412   dynamic linker][fl].
5413 * The compiler gained many new extended error descriptions, which can
5414   be accessed with the `--explain` flag.
5415 * The `dropck` pass, which checks that destructors can't access
5416   destroyed values, [has been rewritten][dropck]. This fixes some
5417   soundness holes, and as such will cause some previously-compiling
5418   code to no longer build.
5419 * `rustc` now uses [LLVM to write archive files where possible][ar].
5420   Eventually this will eliminate the compiler's dependency on the ar
5421   utility.
5422 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
5423   supported FreeBSD on x86_64).
5424 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
5425   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
5426   more strict.
5427 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
5428   will kill the process instead of leaking][nlp].
5429
5430 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
5431 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
5432 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
5433 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
5434 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
5435 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5436 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5437 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
5438 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
5439 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
5440 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
5441 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
5442 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5443 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5444 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5445 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5446 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5447 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5448 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5449 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5450 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5451 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5452 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5453 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5454 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5455 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5456 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5457 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5458 [ar]: https://github.com/rust-lang/rust/pull/26926
5459 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5460 [dms]: https://github.com/rust-lang/rust/pull/26241
5461 [dropck]: https://github.com/rust-lang/rust/pull/27261
5462 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5463 [ds]: https://github.com/rust-lang/rust/pull/26818
5464 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5465 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5466 [dst3]: https://github.com/rust-lang/rust/pull/27351
5467 [e]: https://github.com/rust-lang/rust/pull/24793
5468 [f]: https://github.com/rust-lang/rust/pull/26588
5469 [fb]: https://github.com/rust-lang/rust/pull/26959
5470 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5471 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5472 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5473 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5474 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5475 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5476 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5477 [lic]: https://github.com/rust-lang/rust/pull/26583
5478 [lnu]: https://github.com/rust-lang/rust/pull/27026
5479 [lr]: https://github.com/rust-lang/rust/issues/27248
5480 [lum]: https://github.com/rust-lang/rust/pull/26378
5481 [lur]: https://github.com/rust-lang/rust/pull/26783
5482 [nlp]: https://github.com/rust-lang/rust/pull/27176
5483 [nold2]: https://github.com/rust-lang/rust/pull/27045
5484 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5485 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5486 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5487 [pi]: https://github.com/rust-lang/rust/pull/26699
5488 [ps]: https://github.com/rust-lang/rust/pull/26884
5489 [rte]: https://github.com/rust-lang/rust/pull/26950
5490 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5491 [search]: https://github.com/rust-lang/rust/pull/26327
5492 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5493 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5494 [sh]: https://github.com/rust-lang/rust/pull/27280
5495 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5496 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5497 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5498 [st]: https://github.com/rust-lang/rust/pull/26630
5499 [win1]: https://github.com/rust-lang/rust/pull/26569
5500 [win2]: https://github.com/rust-lang/rust/pull/26741
5501 [win3]: https://github.com/rust-lang/rust/pull/26741
5502 [win4]: https://github.com/rust-lang/rust/pull/27210
5503 [xp]: https://github.com/rust-lang/rust/pull/26569
5504
5505 Version 1.2.0 (2015-08-07)
5506 ==========================
5507
5508 * ~1200 changes, numerous bugfixes
5509
5510 Highlights
5511 ----------
5512
5513 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5514   like `Rc` to contain types without a fixed size, arrays and trait
5515   objects, finally enabling use of `Rc<[T]>` and completing the
5516   implementation of DST.
5517 * [Parallel codegen][parcodegen] is now working again, which can
5518   substantially speed up large builds in debug mode; It also gets
5519   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5520   jobs). It's not enabled by default, but will be "in the near
5521   future". It can be activated with the `-C codegen-units=N` flag to
5522   `rustc`.
5523 * This is the first release with [experimental support for linking
5524   with the MSVC linker and lib C on Windows (instead of using the GNU
5525   variants via MinGW)][win]. It is yet recommended only for the most
5526   intrepid Rustaceans.
5527 * Benchmark compilations are showing a 30% improvement in
5528   bootstrapping over 1.1.
5529
5530 Breaking Changes
5531 ----------------
5532
5533 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5534   unicode case mapping, which is a previously-planned change in
5535   behavior and considered a bugfix.
5536 * [`mem::align_of`] now specifies [the *minimum alignment* for
5537   T][align], which is usually the alignment programs are interested
5538   in, and the same value reported by clang's
5539   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5540   break real code.
5541 * [The `#[packed]` attribute is no longer silently accepted by the
5542   compiler][packed]. This attribute did nothing and code that
5543   mentioned it likely did not work as intended.
5544 * Associated type defaults are [now behind the
5545   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5546   defaults *did not work*, but could be mentioned syntactically. As
5547   such this breakage has minimal impact.
5548
5549 Language
5550 --------
5551
5552 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5553   matching against dereferenceable values.
5554
5555 Libraries
5556 ---------
5557
5558 * The [`Extend`] trait, which grows a collection from an iterator, is
5559   implemented over iterators of references, for `String`, `Vec`,
5560   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5561   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5562 * The [`iter::once`] function returns an iterator that yields a single
5563   element, and [`iter::empty`] returns an iterator that yields no
5564   elements.
5565 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5566   over substring matches.
5567 * [`Cell`] and [`RefCell`] both implement `Eq`.
5568 * A number of methods for wrapping arithmetic are added to the
5569   integral types, [`wrapping_div`], [`wrapping_rem`],
5570   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5571   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5572   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5573   type.. It is illegal for the default arithmetic operations in Rust
5574   to overflow; the desire to wrap must be explicit.
5575 * The `{:#?}` formatting specifier [displays the alternate,
5576   pretty-printed][debugfmt] form of the `Debug` formatter. This
5577   feature was actually introduced prior to 1.0 with little
5578   fanfare.
5579 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5580   for writing data to formatted strings, similar to [`io::Write`].
5581 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5582   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5583   are used by code generators to emit implementations of [`Debug`].
5584 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5585   methods that convert case, following Unicode case mapping.
5586 * It is now easier to handle poisoned locks. The [`PoisonError`]
5587   type, returned by failing lock operations, exposes `into_inner`,
5588   `get_ref`, and `get_mut`, which all give access to the inner lock
5589   guard, and allow the poisoned lock to continue to operate. The
5590   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5591   poisoned lock without attempting to take the lock.
5592 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5593   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5594   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5595   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5596   `ChildStderr`.
5597 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5598   malformed input.
5599
5600 Misc
5601 ----
5602
5603 * `rustc` employs smarter heuristics for guessing at [typos].
5604 * `rustc` emits more efficient code for [no-op conversions between
5605   unsafe pointers][nop].
5606 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5607   resulting in faster compile times and smaller code.
5608
5609 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5610 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5611 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5612 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5613 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5614 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5615 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5616 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5617 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5618 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5619 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5620 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5621 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5622 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5623 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5624 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5625 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5626 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5627 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5628 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5629 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5630 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5631 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5632 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5633 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5634 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5635 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5636 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5637 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5638 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5639 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5640 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5641 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5642 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5643 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5644 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5645 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5646 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5647 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5648 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5649 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5650 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5651 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5652 [align]: https://github.com/rust-lang/rust/pull/25646
5653 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5654 [typos]: https://github.com/rust-lang/rust/pull/26087
5655 [nop]: https://github.com/rust-lang/rust/pull/26336
5656 [fat]: https://github.com/rust-lang/rust/pull/26411
5657 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5658 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5659 [packed]: https://github.com/rust-lang/rust/pull/25541
5660 [ad]: https://github.com/rust-lang/rust/pull/27382
5661 [win]: https://github.com/rust-lang/rust/pull/25350
5662
5663 Version 1.1.0 (2015-06-25)
5664 =========================
5665
5666 * ~850 changes, numerous bugfixes
5667
5668 Highlights
5669 ----------
5670
5671 * The [`std::fs` module has been expanded][fs] to expand the set of
5672   functionality exposed:
5673   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5674     don't incur a syscall on some platforms.
5675   * A `symlink_metadata` function has been added.
5676   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5677     access to all underlying information.
5678 * The compiler now contains extended explanations of many errors. When an error
5679   with an explanation occurs the compiler suggests using the `--explain` flag
5680   to read the explanation. Error explanations are also [available online][err-index].
5681 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5682   well as other work, the time to bootstrap the compiler decreased by
5683   32%.
5684
5685 Libraries
5686 ---------
5687
5688 * The [`str::split_whitespace`] method splits a string on unicode
5689   whitespace boundaries.
5690 * On both Windows and Unix, new extension traits provide conversion of
5691   I/O types to and from the underlying system handles. On Unix, these
5692   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5693   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5694   `TcpListener`, and `UpdSocket`. Further implementations for
5695   `std::process` will be stabilized later.
5696 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5697   Windows, symlinks can be created with
5698   `std::os::windows::symlink_dir` and
5699   `std::os::windows::symlink_file`.
5700 * The `mpsc::Receiver` type can now be converted into an iterator with
5701   `into_iter` on the [`IntoIterator`] trait.
5702 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5703   implementation of the [`From`] trait.
5704 * The `Debug` implementation for `RangeFull` [creates output that is
5705   more consistent with other implementations][rf].
5706 * [`Debug` is implemented for `File`][file].
5707 * The `Default` implementation for `Arc` [no longer requires `Sync +
5708   Send`][arc].
5709 * [The `Iterator` methods `count`, `nth`, and `last` have been
5710   overridden for slices to have O(1) performance instead of O(n)][si].
5711 * Incorrect handling of paths on Windows has been improved in both the
5712   compiler and the standard library.
5713 * [`AtomicPtr` gained a `Default` implementation][ap].
5714 * In accordance with Rust's policy on arithmetic overflow `abs` now
5715   [panics on overflow when debug assertions are enabled][abs].
5716 * The [`Cloned`] iterator, which was accidentally left unstable for
5717   1.0 [has been stabilized][c].
5718 * The [`Incoming`] iterator, which iterates over incoming TCP
5719   connections, and which was accidentally unnamable in 1.0, [is now
5720   properly exported][inc].
5721 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5722   `sift_up` or `sift_down` panic][bh].
5723 * The [`split_off`] method of `LinkedList` [no longer corrupts
5724   the list in certain scenarios][ll].
5725
5726 Misc
5727 ----
5728
5729 * Type checking performance [has improved notably][sk] with
5730   [multiple improvements][pre].
5731 * The compiler [suggests code changes][ch] for more errors.
5732 * rustc and it's build system have experimental support for [building
5733   toolchains against MUSL][m] instead of glibc on Linux.
5734 * The compiler defines the `target_env` cfg value, which is used for
5735   distinguishing toolchains that are otherwise for the same
5736   platform. Presently this is set to `gnu` for common GNU Linux
5737   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5738 * The [`cargo rustc`][crc] command invokes a build with custom flags
5739   to rustc.
5740 * [Android executables are always position independent][pie].
5741 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5742   with `Drop`][drop].
5743
5744 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5745 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5746 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5747 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5748 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5749 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5750 [rf]: https://github.com/rust-lang/rust/pull/24491
5751 [err-index]: https://doc.rust-lang.org/error-index.html
5752 [sk]: https://github.com/rust-lang/rust/pull/24615
5753 [pre]: https://github.com/rust-lang/rust/pull/25323
5754 [file]: https://github.com/rust-lang/rust/pull/24598
5755 [ch]: https://github.com/rust-lang/rust/pull/24683
5756 [arc]: https://github.com/rust-lang/rust/pull/24695
5757 [si]: https://github.com/rust-lang/rust/pull/24701
5758 [ap]: https://github.com/rust-lang/rust/pull/24834
5759 [m]: https://github.com/rust-lang/rust/pull/24777
5760 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5761 [crc]: https://github.com/rust-lang/cargo/pull/1568
5762 [pie]: https://github.com/rust-lang/rust/pull/24953
5763 [abs]: https://github.com/rust-lang/rust/pull/25441
5764 [c]: https://github.com/rust-lang/rust/pull/25496
5765 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5766 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5767 [inc]: https://github.com/rust-lang/rust/pull/25522
5768 [bh]: https://github.com/rust-lang/rust/pull/25856
5769 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5770 [ll]: https://github.com/rust-lang/rust/pull/26022
5771 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5772 [drop]: https://github.com/rust-lang/rust/pull/24935
5773
5774 Version 1.0.0 (2015-05-15)
5775 ========================
5776
5777 * ~1500 changes, numerous bugfixes
5778
5779 Highlights
5780 ----------
5781
5782 * The vast majority of the standard library is now `#[stable]`. It is
5783   no longer possible to use unstable features with a stable build of
5784   the compiler.
5785 * Many popular crates on [crates.io] now work on the stable release
5786   channel.
5787 * Arithmetic on basic integer types now [checks for overflow in debug
5788   builds][overflow].
5789
5790 Language
5791 --------
5792
5793 * Several [restrictions have been added to trait coherence][coh] in
5794   order to make it easier for upstream authors to change traits
5795   without breaking downstream code.
5796 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5797   improve error messages and macro behavior. For example, `0b1234` is
5798   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5799 * Trait bounds [are always invariant][inv], eliminating the need for
5800   the `PhantomFn` and `MarkerTrait` lang items, which have been
5801   removed.
5802 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5803   "foo" as bar` syntax has been replaced with `extern crate foo as
5804   bar`, and Cargo now automatically translates "-" in *package* names
5805   to underscore for the crate name.
5806 * [Lifetime shadowing is an error][lt].
5807 * [`Send` no longer implies `'static`][send-rfc].
5808 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5809   `MyType::default()`.
5810 * Primitive types [now have inherent methods][prim-inherent],
5811   obviating the need for extension traits like `SliceExt`.
5812 * Methods with `Self: Sized` in their `where` clause are [considered
5813   object-safe][self-sized], allowing many extension traits like
5814   `IteratorExt` to be merged into the traits they extended.
5815 * You can now [refer to associated types][assoc-where] whose
5816   corresponding trait bounds appear only in a `where` clause.
5817 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5818   like `Send` and `Sync` are now library-defined.
5819 * A [Reflect trait][reflect] was introduced, which means that
5820   downcasting via the `Any` trait is effectively limited to concrete
5821   types. This helps retain the potentially-important "parametricity"
5822   property: generic code cannot behave differently for different type
5823   arguments except in minor ways.
5824 * The `unsafe_destructor` feature is now deprecated in favor of the
5825   [new `dropck`][dropck]. This change is a major reduction in unsafe
5826   code.
5827
5828 Libraries
5829 ---------
5830
5831 * The `thread_local` module [has been renamed to `std::thread`][th].
5832 * The methods of `IteratorExt` [have been moved to the `Iterator`
5833   trait itself][ie].
5834 * Several traits that implement Rust's conventions for type
5835   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5836   [centralized in the `std::convert` module][con].
5837 * The `FromError` trait [was removed in favor of `From`][fe].
5838 * The basic sleep function [has moved to
5839   `std::thread::sleep_ms`][slp].
5840 * The `splitn` function now takes an `n` parameter that represents the
5841   number of items yielded by the returned iterator [instead of the
5842   number of 'splits'][spl].
5843 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5844 * [Derived implementations of `PartialOrd` now order enums according
5845   to their explicitly-assigned discriminants][po].
5846 * [Methods for searching strings are generic over `Pattern`s][pat],
5847   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5848   some others.
5849 * [In method resolution, object methods are resolved before inherent
5850   methods][meth].
5851 * [`String::from_str` has been deprecated in favor of the `From` impl,
5852   `String::from`][sf].
5853 * [`io::Error` implements `Sync`][ios].
5854 * [The `words` method on `&str` has been replaced with
5855   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5856   a word?'
5857 * The new path and IO modules are complete and `#[stable]`. This
5858   was the major library focus for this cycle.
5859 * The path API was [revised][path-normalize] to normalize `.`,
5860   adjusting the tradeoffs in favor of the most common usage.
5861 * A large number of remaining APIs in `std` were also stabilized
5862   during this cycle; about 75% of the non-deprecated API surface
5863   is now stable.
5864 * The new [string pattern API][string-pattern] landed, which makes
5865   the string slice API much more internally consistent and flexible.
5866 * A new set of [generic conversion traits][conversion] replaced
5867   many existing ad hoc traits.
5868 * Generic numeric traits were [completely removed][num-traits]. This
5869   was made possible thanks to inherent methods for primitive types,
5870   and the removal gives maximal flexibility for designing a numeric
5871   hierarchy in the future.
5872 * The `Fn` traits are now related via [inheritance][fn-inherit]
5873   and provide ergonomic [blanket implementations][fn-blanket].
5874 * The `Index` and `IndexMut` traits were changed to
5875   [take the index by value][index-value], enabling code like
5876   `hash_map["string"]` to work.
5877 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5878   `Copy` data is known to be `Clone` as well.
5879
5880 Misc
5881 ----
5882
5883 * Many errors now have extended explanations that can be accessed with
5884   the `--explain` flag to `rustc`.
5885 * Many new examples have been added to the standard library
5886   documentation.
5887 * rustdoc has received a number of improvements focused on completion
5888   and polish.
5889 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5890 * Much headway was made on ecosystem-wide CI, making it possible
5891   to [compare builds for breakage][ci-compare].
5892
5893
5894 [crates.io]: http://crates.io
5895 [clo]: https://github.com/rust-lang/rust/pull/24034
5896 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5897 [con]: https://github.com/rust-lang/rust/pull/23875
5898 [cr]: https://github.com/rust-lang/rust/pull/23419
5899 [fe]: https://github.com/rust-lang/rust/pull/23879
5900 [ie]: https://github.com/rust-lang/rust/pull/23300
5901 [inv]: https://github.com/rust-lang/rust/pull/23938
5902 [ios]: https://github.com/rust-lang/rust/pull/24133
5903 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5904 [lt]: https://github.com/rust-lang/rust/pull/24057
5905 [meth]: https://github.com/rust-lang/rust/pull/24056
5906 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5907 [po]: https://github.com/rust-lang/rust/pull/24270
5908 [sf]: https://github.com/rust-lang/rust/pull/24517
5909 [slp]: https://github.com/rust-lang/rust/pull/23949
5910 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5911 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5912 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5913 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5914 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5915 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5916 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5917 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5918 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5919 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5920 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5921 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5922 [reflect]: https://github.com/rust-lang/rust/pull/23712
5923 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5924 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5925 [index-value]: https://github.com/rust-lang/rust/pull/23601
5926 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5927 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5928 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5929 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5930 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5931 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5932
5933
5934 Version 1.0.0-alpha.2 (2015-02-20)
5935 =====================================
5936
5937 * ~1300 changes, numerous bugfixes
5938
5939 * Highlights
5940
5941     * The various I/O modules were [overhauled][io-rfc] to reduce
5942       unnecessary abstractions and provide better interoperation with
5943       the underlying platform. The old `io` module remains temporarily
5944       at `std::old_io`.
5945     * The standard library now [participates in feature gating][feat],
5946       so use of unstable libraries now requires a `#![feature(...)]`
5947       attribute. The impact of this change is [described on the
5948       forum][feat-forum]. [RFC][feat-rfc].
5949
5950 * Language
5951
5952     * `for` loops [now operate on the `IntoIterator` trait][into],
5953       which eliminates the need to call `.iter()`, etc. to iterate
5954       over collections. There are some new subtleties to remember
5955       though regarding what sort of iterators various types yield, in
5956       particular that `for foo in bar { }` yields values from a move
5957       iterator, destroying the original collection. [RFC][into-rfc].
5958     * Objects now have [default lifetime bounds][obj], so you don't
5959       have to write `Box<Trait+'static>` when you don't care about
5960       storing references. [RFC][obj-rfc].
5961     * In types that implement `Drop`, [lifetimes must outlive the
5962       value][drop]. This will soon make it possible to safely
5963       implement `Drop` for types where `#[unsafe_destructor]` is now
5964       required. Read the [gorgeous RFC][drop-rfc] for details.
5965     * The fully qualified <T as Trait>::X syntax lets you set the Self
5966       type for a trait method or associated type. [RFC][ufcs-rfc].
5967     * References to types that implement `Deref<U>` now [automatically
5968       coerce to references][deref] to the dereferenced type `U`,
5969       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5970       should eliminate many unsightly uses of `&*`, as when converting
5971       from references to vectors into references to
5972       slices. [RFC][deref-rfc].
5973     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5974       `|:|`) is obsolete and closure kind is inferred from context.
5975     * [`Self` is a keyword][Self].
5976
5977 * Libraries
5978
5979     * The `Show` and `String` formatting traits [have been
5980       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5981       their related purposes. Automatically getting a string
5982       conversion to use with `format!("{:?}", something_to_debug)` is
5983       now written `#[derive(Debug)]`.
5984     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5985       OsStr}`, provide strings in platform-specific encodings for easier
5986       interop with system APIs. [RFC][osstr-rfc].
5987     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5988       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5989       creating raw pointers.
5990
5991 * Tooling
5992
5993     * Certain long error messages of the form 'expected foo found bar'
5994       are now [split neatly across multiple
5995       lines][multiline]. Examples in the PR.
5996     * On Unix Rust can be [uninstalled][un] by running
5997       `/usr/local/lib/rustlib/uninstall.sh`.
5998     * The `#[rustc_on_unimplemented]` attribute, requiring the
5999       'on_unimplemented' feature, lets rustc [display custom error
6000       messages when a trait is expected to be implemented for a type
6001       but is not][onun].
6002
6003 * Misc
6004
6005     * Rust is tested against a [LALR grammar][lalr], which parses
6006       almost all the Rust files that rustc does.
6007
6008 [boxraw]: https://github.com/rust-lang/rust/pull/21318
6009 [close]: https://github.com/rust-lang/rust/pull/21843
6010 [deref]: https://github.com/rust-lang/rust/pull/21351
6011 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
6012 [drop]: https://github.com/rust-lang/rust/pull/21972
6013 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6014 [feat]: https://github.com/rust-lang/rust/pull/21248
6015 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
6016 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
6017 [fmt]: https://github.com/rust-lang/rust/pull/21457
6018 [into]: https://github.com/rust-lang/rust/pull/20790
6019 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
6020 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6021 [lalr]: https://github.com/rust-lang/rust/pull/21452
6022 [multiline]: https://github.com/rust-lang/rust/pull/19870
6023 [obj]: https://github.com/rust-lang/rust/pull/22230
6024 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
6025 [onun]: https://github.com/rust-lang/rust/pull/20889
6026 [osstr]: https://github.com/rust-lang/rust/pull/21488
6027 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6028 [Self]: https://github.com/rust-lang/rust/pull/22158
6029 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
6030 [un]: https://github.com/rust-lang/rust/pull/22256
6031
6032
6033 Version 1.0.0-alpha (2015-01-09)
6034 ==================================
6035
6036   * ~2400 changes, numerous bugfixes
6037
6038   * Highlights
6039
6040     * The language itself is considered feature complete for 1.0,
6041       though there will be many usability improvements and bugfixes
6042       before the final release.
6043     * Nearly 50% of the public API surface of the standard library has
6044       been declared 'stable'. Those interfaces are unlikely to change
6045       before 1.0.
6046     * The long-running debate over integer types has been
6047       [settled][ints]: Rust will ship with types named `isize` and
6048       `usize`, rather than `int` and `uint`, for pointer-sized
6049       integers. Guidelines will be rolled out during the alpha cycle.
6050     * Most crates that are not `std` have been moved out of the Rust
6051       distribution into the Cargo ecosystem so they can evolve
6052       separately and don't need to be stabilized as quickly, including
6053       'time', 'getopts', 'num', 'regex', and 'term'.
6054     * Documentation continues to be expanded with more API coverage, more
6055       examples, and more in-depth explanations. The guides have been
6056       consolidated into [The Rust Programming Language][trpl].
6057     * "[Rust By Example][rbe]" is now maintained by the Rust team.
6058     * All official Rust binary installers now come with [Cargo], the
6059       Rust package manager.
6060
6061 * Language
6062
6063     * Closures have been [completely redesigned][unboxed] to be
6064       implemented in terms of traits, can now be used as generic type
6065       bounds and thus monomorphized and inlined, or via an opaque
6066       pointer (boxed) as in the old system. The new system is often
6067       referred to as 'unboxed' closures.
6068     * Traits now support [associated types][assoc], allowing families
6069       of related types to be defined together and used generically in
6070       powerful ways.
6071     * Enum variants are [namespaced by their type names][enum].
6072     * [`where` clauses][where] provide a more versatile and attractive
6073       syntax for specifying generic bounds, though the previous syntax
6074       remains valid.
6075     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
6076       numeric types.
6077     * Rust [no longer has a runtime][rt] of any description, and only
6078       supports OS threads, not green threads.
6079     * At long last, Rust has been overhauled for 'dynamically-sized
6080       types' ([DST]), which integrates 'fat pointers' (object types,
6081       arrays, and `str`) more deeply into the type system, making it
6082       more consistent.
6083     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
6084       `..j` that produce range types and which, when combined with the
6085       `Index` operator and multidispatch, leads to a convenient slice
6086       notation, `[i..j]`.
6087     * The new range syntax revealed an ambiguity in the fixed-length
6088       array syntax, so now fixed length arrays [are written `[T;
6089       N]`][arrays].
6090     * The `Copy` trait is no longer implemented automatically. Unsafe
6091       pointers no longer implement `Sync` and `Send` so types
6092       containing them don't automatically either. `Sync` and `Send`
6093       are now 'unsafe traits' so one can "forcibly" implement them via
6094       `unsafe impl` if a type confirms to the requirements for them
6095       even though the internals do not (e.g. structs containing unsafe
6096       pointers like `Arc`). These changes are intended to prevent some
6097       footguns and are collectively known as [opt-in built-in
6098       traits][oibit] (though `Sync` and `Send` will soon become pure
6099       library types unknown to the compiler).
6100     * Operator traits now take their operands [by value][ops], and
6101       comparison traits can use multidispatch to compare one type
6102       against multiple other types, allowing e.g. `String` to be
6103       compared with `&str`.
6104     * `if let` and `while let` are no longer feature-gated.
6105     * Rust has adopted a more [uniform syntax for escaping unicode
6106       characters][unicode].
6107     * `macro_rules!` [has been declared stable][mac]. Though it is a
6108       flawed system it is sufficiently popular that it must be usable
6109       for 1.0. Effort has gone into [future-proofing][mac-future] it
6110       in ways that will allow other macro systems to be developed in
6111       parallel, and won't otherwise impact the evolution of the
6112       language.
6113     * The prelude has been [pared back significantly][prelude] such
6114       that it is the minimum necessary to support the most pervasive
6115       code patterns, and through [generalized where clauses][where]
6116       many of the prelude extension traits have been consolidated.
6117     * Rust's rudimentary reflection [has been removed][refl], as it
6118       incurred too much code generation for little benefit.
6119     * [Struct variants][structvars] are no longer feature-gated.
6120     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
6121       known as 'higher-ranked trait bounds', this crucially allows
6122       unboxed closures to work.
6123     * Macros invocations surrounded by parens or square brackets and
6124       not terminated by a semicolon are [parsed as
6125       expressions][macros], which makes expressions like `vec![1i32,
6126       2, 3].len()` work as expected.
6127     * Trait objects now implement their traits automatically, and
6128       traits that can be coerced to objects now must be [object
6129       safe][objsafe].
6130     * Automatically deriving traits is now done with `#[derive(...)]`
6131       not `#[deriving(...)]` for [consistency with other naming
6132       conventions][derive].
6133     * Importing the containing module or enum at the same time as
6134       items or variants they contain is [now done with `self` instead
6135       of `mod`][self], as in use `foo::{self, bar}`
6136     * Glob imports are no longer feature-gated.
6137     * The `box` operator and `box` patterns have been feature-gated
6138       pending a redesign. For now unique boxes should be allocated
6139       like other containers, with `Box::new`.
6140
6141 * Libraries
6142
6143     * A [series][coll1] of [efforts][coll2] to establish
6144       [conventions][coll3] for collections types has resulted in API
6145       improvements throughout the standard library.
6146     * New [APIs for error handling][err] provide ergonomic interop
6147       between error types, and [new conventions][err-conv] describe
6148       more clearly the recommended error handling strategies in Rust.
6149     * The `fail!` macro has been renamed to [`panic!`][panic] so that
6150       it is easier to discuss failure in the context of error handling
6151       without making clarifications as to whether you are referring to
6152       the 'fail' macro or failure more generally.
6153     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
6154       syscall when available.
6155     * The 'serialize' crate has been renamed 'rustc-serialize' and
6156       moved out of the distribution to Cargo. Although it is widely
6157       used now, it is expected to be superseded in the near future.
6158     * The `Show` formatter, typically implemented with
6159       `#[derive(Show)]` is [now requested with the `{:?}`
6160       specifier][show] and is intended for use by all types, for uses
6161       such as `println!` debugging. The new `String` formatter must be
6162       implemented by hand, uses the `{}` specifier, and is intended
6163       for full-fidelity conversions of things that can logically be
6164       represented as strings.
6165
6166 * Tooling
6167
6168     * [Flexible target specification][flex] allows rustc's code
6169       generation to be configured to support otherwise-unsupported
6170       platforms.
6171     * Rust comes with rust-gdb and rust-lldb scripts that launch their
6172       respective debuggers with Rust-appropriate pretty-printing.
6173     * The Windows installation of Rust is distributed with the
6174       MinGW components currently required to link binaries on that
6175       platform.
6176
6177 * Misc
6178
6179     * Nullable enum optimizations have been extended to more types so
6180       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
6181       space than the inner types themselves.
6182     * Work has begun on supporting AArch64.
6183
6184 [Cargo]: https://crates.io
6185 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
6186 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
6187 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
6188 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
6189 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
6190 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
6191 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
6192 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
6193 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
6194 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
6195 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
6196 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
6197 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
6198 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
6199 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
6200 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
6201 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
6202 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
6203 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
6204 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
6205 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
6206 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
6207 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
6208 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
6209 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
6210 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
6211 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
6212 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
6213 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
6214 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
6215 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
6216 [trpl]: https://doc.rust-lang.org/book/index.html
6217 [rbe]: http://rustbyexample.com/
6218
6219
6220 Version 0.12.0 (2014-10-09)
6221 =============================
6222
6223   * ~1900 changes, numerous bugfixes
6224
6225   * Highlights
6226
6227     * The introductory documentation (now called The Rust Guide) has
6228       been completely rewritten, as have a number of supplementary
6229       guides.
6230     * Rust's package manager, Cargo, continues to improve and is
6231       sometimes considered to be quite awesome.
6232     * Many API's in `std` have been reviewed and updated for
6233       consistency with the in-development Rust coding
6234       guidelines. The standard library documentation tracks
6235       stabilization progress.
6236     * Minor libraries have been moved out-of-tree to the rust-lang org
6237       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
6238       be installed with Cargo.
6239     * Lifetime elision allows lifetime annotations to be left off of
6240       function declarations in many common scenarios.
6241     * Rust now works on 64-bit Windows.
6242
6243   * Language
6244     * Indexing can be overloaded with the `Index` and `IndexMut`
6245       traits.
6246     * The `if let` construct takes a branch only if the `let` pattern
6247       matches, currently behind the 'if_let' feature gate.
6248     * 'where clauses', a more flexible syntax for specifying trait
6249       bounds that is more aesthetic, have been added for traits and
6250       free functions. Where clauses will in the future make it
6251       possible to constrain associated types, which would be
6252       impossible with the existing syntax.
6253     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
6254       the 'slicing_syntax' feature gate, and can be overloaded with
6255       the `Slice` or `SliceMut` traits.
6256     * The syntax for matching of sub-slices has been changed to use a
6257       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
6258       consistency with other uses of `..` and to future-proof
6259       potential additional uses of the syntax.
6260     * The syntax for matching inclusive ranges in patterns has changed
6261       from `0..3` to `0...4` to be consistent with the exclusive range
6262       syntax for slicing.
6263     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
6264       c]`) has been put behind the 'advanced_slice_patterns' feature
6265       gate and may be removed in the future.
6266     * Components of tuples and tuple structs can be extracted using
6267       the `value.0` syntax, currently behind the `tuple_indexing`
6268       feature gate.
6269     * The `#[crate_id]` attribute is no longer supported; versioning
6270       is handled by the package manager.
6271     * Renaming crate imports are now written `extern crate foo as bar`
6272       instead of `extern crate bar = foo`.
6273     * Renaming use statements are now written `use foo as bar` instead
6274       of `use bar = foo`.
6275     * `let` and `match` bindings and argument names in macros are now
6276       hygienic.
6277     * The new, more efficient, closure types ('unboxed closures') have
6278       been added under a feature gate, 'unboxed_closures'. These will
6279       soon replace the existing closure types, once higher-ranked
6280       trait lifetimes are added to the language.
6281     * `move` has been added as a keyword, for indicating closures
6282       that capture by value.
6283     * Mutation and assignment is no longer allowed in pattern guards.
6284     * Generic structs and enums can now have trait bounds.
6285     * The `Share` trait is now called `Sync` to free up the term
6286       'shared' to refer to 'shared reference' (the default reference
6287       type.
6288     * Dynamically-sized types have been mostly implemented,
6289       unifying the behavior of fat-pointer types with the rest of the
6290       type system.
6291     * As part of dynamically-sized types, the `Sized` trait has been
6292       introduced, which qualifying types implement by default, and
6293       which type parameters expect by default. To specify that a type
6294       parameter does not need to be sized, write `<Sized? T>`. Most
6295       types are `Sized`, notable exceptions being unsized arrays
6296       (`[T]`) and trait types.
6297     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
6298     * Lifetime bounds can now be applied to type parameters and object
6299       types.
6300     * The old, reference counted GC type, `Gc<T>` which was once
6301       denoted by the `@` sigil, has finally been removed. GC will be
6302       revisited in the future.
6303
6304   * Libraries
6305     * Library documentation has been improved for a number of modules.
6306     * Bit-vectors, collections::bitv has been modernized.
6307     * The url crate is deprecated in favor of
6308       http://github.com/servo/rust-url, which can be installed with
6309       Cargo.
6310     * Most I/O stream types can be cloned and subsequently closed from
6311       a different thread.
6312     * A `std::time::Duration` type has been added for use in I/O
6313       methods that rely on timers, as well as in the 'time' crate's
6314       `Timespec` arithmetic.
6315     * The runtime I/O abstraction layer that enabled the green thread
6316       scheduler to do non-thread-blocking I/O has been removed, along
6317       with the libuv-based implementation employed by the green thread
6318       scheduler. This will greatly simplify the future I/O work.
6319     * `collections::btree` has been rewritten to have a more
6320       idiomatic and efficient design.
6321
6322   * Tooling
6323     * rustdoc output now indicates the stability levels of API's.
6324     * The `--crate-name` flag can specify the name of the crate
6325       being compiled, like `#[crate_name]`.
6326     * The `-C metadata` specifies additional metadata to hash into
6327       symbol names, and `-C extra-filename` specifies additional
6328       information to put into the output filename, for use by the
6329       package manager for versioning.
6330     * debug info generation has continued to improve and should be
6331       more reliable under both gdb and lldb.
6332     * rustc has experimental support for compiling in parallel
6333       using the `-C codegen-units` flag.
6334     * rustc no longer encodes rpath information into binaries by
6335       default.
6336
6337   * Misc
6338     * Stack usage has been optimized with LLVM lifetime annotations.
6339     * Official Rust binaries on Linux are more compatible with older
6340       kernels and distributions, built on CentOS 5.10.
6341
6342
6343 Version 0.11.0 (2014-07-02)
6344 ==========================
6345
6346   * ~1700 changes, numerous bugfixes
6347
6348   * Language
6349     * ~[T] has been removed from the language. This type is superseded by
6350       the Vec<T> type.
6351     * ~str has been removed from the language. This type is superseded by
6352       the String type.
6353     * ~T has been removed from the language. This type is superseded by the
6354       Box<T> type.
6355     * @T has been removed from the language. This type is superseded by the
6356       standard library's std::gc::Gc<T> type.
6357     * Struct fields are now all private by default.
6358     * Vector indices and shift amounts are both required to be a `uint`
6359       instead of any integral type.
6360     * Byte character, byte string, and raw byte string literals are now all
6361       supported by prefixing the normal literal with a `b`.
6362     * Multiple ABIs are no longer allowed in an ABI string
6363     * The syntax for lifetimes on closures/procedures has been tweaked
6364       slightly: `<'a>|A, B|: 'b + K -> T`
6365     * Floating point modulus has been removed from the language; however it
6366       is still provided by a library implementation.
6367     * Private enum variants are now disallowed.
6368     * The `priv` keyword has been removed from the language.
6369     * A closure can no longer be invoked through a &-pointer.
6370     * The `use foo, bar, baz;` syntax has been removed from the language.
6371     * The transmute intrinsic no longer works on type parameters.
6372     * Statics now allow blocks/items in their definition.
6373     * Trait bounds are separated from objects with + instead of : now.
6374     * Objects can no longer be read while they are mutably borrowed.
6375     * The address of a static is now marked as insignificant unless the
6376       #[inline(never)] attribute is placed it.
6377     * The #[unsafe_destructor] attribute is now behind a feature gate.
6378     * Struct literals are no longer allowed in ambiguous positions such as
6379       if, while, match, and for..in.
6380     * Declaration of lang items and intrinsics are now feature-gated by
6381       default.
6382     * Integral literals no longer default to `int`, and floating point
6383       literals no longer default to `f64`. Literals must be suffixed with an
6384       appropriate type if inference cannot determine the type of the
6385       literal.
6386     * The Box<T> type is no longer implicitly borrowed to &mut T.
6387     * Procedures are now required to not capture borrowed references.
6388
6389   * Libraries
6390     * The standard library is now a "facade" over a number of underlying
6391       libraries. This means that development on the standard library should
6392       be speedier due to smaller crates, as well as a clearer line between
6393       all dependencies.
6394     * A new library, libcore, lives under the standard library's facade
6395       which is Rust's "0-assumption" library, suitable for embedded and
6396       kernel development for example.
6397     * A regex crate has been added to the standard distribution. This crate
6398       includes statically compiled regular expressions.
6399     * The unwrap/unwrap_err methods on Result require a Show bound for
6400       better error messages.
6401     * The return types of the std::comm primitives have been centralized
6402       around the Result type.
6403     * A number of I/O primitives have gained the ability to time out their
6404       operations.
6405     * A number of I/O primitives have gained the ability to close their
6406       reading/writing halves to cancel pending operations.
6407     * Reverse iterator methods have been removed in favor of `rev()` on
6408       their forward-iteration counterparts.
6409     * A bitflags! macro has been added to enable easy interop with C and
6410       management of bit flags.
6411     * A debug_assert! macro is now provided which is disabled when
6412       `--cfg ndebug` is passed to the compiler.
6413     * A graphviz crate has been added for creating .dot files.
6414     * The std::cast module has been migrated into std::mem.
6415     * The std::local_data api has been migrated from freestanding functions
6416       to being based on methods.
6417     * The Pod trait has been renamed to Copy.
6418     * jemalloc has been added as the default allocator for types.
6419     * The API for allocating memory has been changed to use proper alignment
6420       and sized deallocation
6421     * Connecting a TcpStream or binding a TcpListener is now based on a
6422       string address and a u16 port. This allows connecting to a hostname as
6423       opposed to an IP.
6424     * The Reader trait now contains a core method, read_at_least(), which
6425       correctly handles many repeated 0-length reads.
6426     * The process-spawning API is now centered around a builder-style
6427       Command struct.
6428     * The :? printing qualifier has been moved from the standard library to
6429       an external libdebug crate.
6430     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
6431       have been renamed to Eq/Ord.
6432     * The select/plural methods have been removed from format!. The escapes
6433       for { and } have also changed from \{ and \} to {{ and }},
6434       respectively.
6435     * The TaskBuilder API has been re-worked to be a true builder, and
6436       extension traits for spawning native/green tasks have been added.
6437
6438   * Tooling
6439     * All breaking changes to the language or libraries now have their
6440       commit message annotated with `[breaking-change]` to allow for easy
6441       discovery of breaking changes.
6442     * The compiler will now try to suggest how to annotate lifetimes if a
6443       lifetime-related error occurs.
6444     * Debug info continues to be improved greatly with general bug fixes and
6445       better support for situations like link time optimization (LTO).
6446     * Usage of syntax extensions when cross-compiling has been fixed.
6447     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6448       -fdata-sections and --gc-sections has been enabled by default
6449     * The compiler is now stricter about where it will load module files
6450       from when a module is declared via `mod foo;`.
6451     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6452       Syntax extensions are now discovered via a "plugin registrar" type
6453       which will be extended in the future to other various plugins.
6454     * Lints have been restructured to allow for dynamically loadable lints.
6455     * A number of rustdoc improvements:
6456       * The HTML output has been visually redesigned.
6457       * Markdown is now powered by hoedown instead of sundown.
6458       * Searching heuristics have been greatly improved.
6459       * The search index has been reduced in size by a great amount.
6460       * Cross-crate documentation via `pub use` has been greatly improved.
6461       * Primitive types are now hyperlinked and documented.
6462     * Documentation has been moved from static.rust-lang.org/doc to
6463       doc.rust-lang.org
6464     * A new sandbox, play.rust-lang.org, is available for running and
6465       sharing rust code examples on-line.
6466     * Unused attributes are now more robustly warned about.
6467     * The dead_code lint now warns about unused struct fields.
6468     * Cross-compiling to iOS is now supported.
6469     * Cross-compiling to mipsel is now supported.
6470     * Stability attributes are now inherited by default and no longer apply
6471       to intra-crate usage, only inter-crate usage.
6472     * Error message related to non-exhaustive match expressions have been
6473       greatly improved.
6474
6475
6476 Version 0.10 (2014-04-03)
6477 =========================
6478
6479   * ~1500 changes, numerous bugfixes
6480
6481   * Language
6482     * A new RFC process is now in place for modifying the language.
6483     * Patterns with `@`-pointers have been removed from the language.
6484     * Patterns with unique vectors (`~[T]`) have been removed from the
6485       language.
6486     * Patterns with unique strings (`~str`) have been removed from the
6487       language.
6488     * `@str` has been removed from the language.
6489     * `@[T]` has been removed from the language.
6490     * `@self` has been removed from the language.
6491     * `@Trait` has been removed from the language.
6492     * Headers on `~` allocations which contain `@` boxes inside the type for
6493       reference counting have been removed.
6494     * The semantics around the lifetimes of temporary expressions have changed,
6495       see #3511 and #11585 for more information.
6496     * Cross-crate syntax extensions are now possible, but feature gated. See
6497       #11151 for more information. This includes both `macro_rules!` macros as
6498       well as syntax extensions such as `format!`.
6499     * New lint modes have been added, and older ones have been turned on to be
6500       warn-by-default.
6501       * Unnecessary parentheses
6502       * Uppercase statics
6503       * Camel Case types
6504       * Uppercase variables
6505       * Publicly visible private types
6506       * `#[deriving]` with raw pointers
6507     * Unsafe functions can no longer be coerced to closures.
6508     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6509     * The `#[simd]` attribute is now behind a feature gate.
6510     * Visibility is no longer allowed on `extern crate` statements, and
6511       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6512     * Trailing commas are now allowed in argument lists and tuple patterns.
6513     * The `do` keyword has been removed, it is now a reserved keyword.
6514     * Default type parameters have been implemented, but are feature gated.
6515     * Borrowed variables through captures in closures are now considered soundly.
6516     * `extern mod` is now `extern crate`
6517     * The `Freeze` trait has been removed.
6518     * The `Share` trait has been added for types that can be shared among
6519       threads.
6520     * Labels in macros are now hygienic.
6521     * Expression/statement macro invocations can be delimited with `{}` now.
6522     * Treatment of types allowed in `static mut` locations has been tweaked.
6523     * The `*` and `.` operators are now overloadable through the `Deref` and
6524       `DerefMut` traits.
6525     * `~Trait` and `proc` no longer have `Send` bounds by default.
6526     * Partial type hints are now supported with the `_` type marker.
6527     * An `Unsafe` type was introduced for interior mutability. It is now
6528       considered undefined to transmute from `&T` to `&mut T` without using the
6529       `Unsafe` type.
6530     * The #[linkage] attribute was implemented for extern statics/functions.
6531     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6532     * `Pod` was renamed to `Copy`.
6533
6534   * Libraries
6535     * The `libextra` library has been removed. It has now been decomposed into
6536       component libraries with smaller and more focused nuggets of
6537       functionality. The full list of libraries can be found on the
6538       documentation index page.
6539     * std: `std::condition` has been removed. All I/O errors are now propagated
6540       through the `Result` type. In order to assist with error handling, a
6541       `try!` macro for unwrapping errors with an early return and a lint for
6542       unused results has been added. See #12039 for more information.
6543     * std: The `vec` module has been renamed to `slice`.
6544     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6545       This will become the only growable vector in the future.
6546     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6547       are now found at `std::io::BufferedReader` instead of
6548       `std::io::buffered::BufferedReader`.
6549     * std: `print` and `println` are no longer in the prelude, the `print!` and
6550       `println!` macros are intended to be used instead.
6551     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6552       attempts to statically prevent cycles.
6553     * std: The standard distribution is adopting the policy of pushing failure
6554       to the user rather than failing in libraries. Many functions (such as
6555       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6556     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6557       deriving mode: `#[deriving(Show)]`.
6558     * std: `ToStr` is now implemented for all types implementing `Show`.
6559     * std: The formatting trait methods now take `&self` instead of `&T`
6560     * std: The `invert()` method on iterators has been renamed to `rev()`
6561     * std: `std::num` has seen a reduction in the genericity of its traits,
6562       consolidating functionality into a few core traits.
6563     * std: Backtraces are now printed on task failure if the environment
6564       variable `RUST_BACKTRACE` is present.
6565     * std: Naming conventions for iterators have been standardized. More details
6566       can be found on the wiki's style guide.
6567     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6568       still implement the function.
6569     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6570     * std: `assert_approx_eq!` has been removed
6571     * std: The `e` and `E` formatting specifiers for floats have been added to
6572       print them in exponential notation.
6573     * std: The `Times` trait has been removed
6574     * std: Indications of variance and opting out of builtin bounds is done
6575       through marker types in `std::kinds::marker` now
6576     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6577       `#[deriving(Hash)]` is now possible.
6578     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6579     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6580     * std: `Chan::new` is now `channel()`.
6581     * std: A new synchronous channel type has been implemented.
6582     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6583     * std: `hashmap` and `trie` have been moved to `libcollections`
6584     * std: `run` has been rolled into `io::process`
6585     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6586     * std: The equality and comparison traits have seen some reorganization.
6587     * std: `rand` has moved to `librand`.
6588     * std: `to_{lower,upper}case` has been implemented for `char`.
6589     * std: Logging has been moved to `liblog`.
6590     * collections: `HashMap` has been rewritten for higher performance and less
6591       memory usage.
6592     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6593       it can be booted manually. The runtime guide has more information and
6594       examples.
6595     * native: All I/O functionality except signals has been implemented.
6596     * green: Task spawning with `libgreen` has been optimized with stack caching
6597       and various trimming of code.
6598     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6599     * sync: The `extra::sync` module has been updated to modern rust (and moved
6600       to the `sync` library), tweaking and improving various interfaces while
6601       dropping redundant functionality.
6602     * sync: A new `Barrier` type has been added to the `sync` library.
6603     * sync: An efficient mutex for native and green tasks has been implemented.
6604     * serialize: The `base64` module has seen some improvement. It treats
6605       newlines better, has non-string error values, and has seen general
6606       cleanup.
6607     * fourcc: A `fourcc!` macro was introduced
6608     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6609       hexadecimal literal.
6610
6611   * Tooling
6612     * `rustpkg` has been deprecated and removed from the main repository. Its
6613       replacement, `cargo`, is under development.
6614     * Nightly builds of rust are now available
6615     * The memory usage of rustc has been improved many times throughout this
6616       release cycle.
6617     * The build process supports disabling rpath support for the rustc binary
6618       itself.
6619     * Code generation has improved in some cases, giving more information to the
6620       LLVM optimization passes to enable more extensive optimizations.
6621     * Debuginfo compatibility with lldb on OSX has been restored.
6622     * The master branch is now gated on an android bot, making building for
6623       android much more reliable.
6624     * Output flags have been centralized into one `--emit` flag.
6625     * Crate type flags have been centralized into one `--crate-type` flag.
6626     * Codegen flags have been consolidated behind a `-C` flag.
6627     * Linking against outdated crates now has improved error messages.
6628     * Error messages with lifetimes will often suggest how to annotate the
6629       function to fix the error.
6630     * Many more types are documented in the standard library, and new guides
6631       were written.
6632     * Many `rustdoc` improvements:
6633       * code blocks are syntax highlighted.
6634       * render standalone markdown files.
6635       * the --test flag tests all code blocks by default.
6636       * exported macros are displayed.
6637       * re-exported types have their documentation inlined at the location of the
6638         first re-export.
6639       * search works across crates that have been rendered to the same output
6640         directory.
6641
6642
6643 Version 0.9 (2014-01-09)
6644 ==========================
6645
6646    * ~1800 changes, numerous bugfixes
6647
6648    * Language
6649       * The `float` type has been removed. Use `f32` or `f64` instead.
6650       * A new facility for enabling experimental features (feature gating) has
6651         been added, using the crate-level `#[feature(foo)]` attribute.
6652       * Managed boxes (@) are now behind a feature gate
6653         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6654         standard library's `Gc` or `Rc` types instead.
6655       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6656       * Jumping back to the top of a loop is now done with `continue` instead of
6657         `loop`.
6658       * Strings can no longer be mutated through index assignment.
6659       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6660         hash delimiters, as in `r###"foo"###`.
6661       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6662         called once.
6663       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6664       * `@fn`s have been removed.
6665       * `do` only works with procs in order to make it obvious what the cost
6666         of `do` is.
6667       * Single-element tuple-like structs can no longer be dereferenced to
6668         obtain the inner value. A more comprehensive solution for overloading
6669         the dereference operator will be provided in the future.
6670       * The `#[link(...)]` attribute has been replaced with
6671         `#[crate_id = "name#vers"]`.
6672       * Empty `impl`s must be terminated with empty braces and may not be
6673         terminated with a semicolon.
6674       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6675         no longer has any special meaning.
6676       * The old `fmt!` string formatting macro has been removed.
6677       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6678         `print!` and `println!`.
6679       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6680       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6681         `extern mod foo = "bar"` instead.
6682       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6683       * Macros can have attributes.
6684       * Macros can expand to items with attributes.
6685       * Macros can expand to multiple items.
6686       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6687       * Comments may be nested.
6688       * Values automatically coerce to trait objects they implement, without
6689         an explicit `as`.
6690       * Enum discriminants are no longer an entire word but as small as needed to
6691         contain all the variants. The `repr` attribute can be used to override
6692         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6693         `#[repr(C)]` to match C enums.
6694       * Non-string literals are not allowed in attributes (they never worked).
6695       * The FFI now supports variadic functions.
6696       * Octal numeric literals, as in `0o7777`.
6697       * The `concat!` syntax extension performs compile-time string concatenation.
6698       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6699         removed as Rust no longer uses segmented stacks.
6700       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6701       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6702         not `*`; ignoring remaining fields of a struct is also done with `..`,
6703         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6704       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6705       * `rustc` supports the "system" calling convention, which defaults to the
6706         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6707         "C" elsewhere.
6708       * The `type_overflow` lint (default: warn) checks literals for overflow.
6709       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6710       * The `attribute_usage` lint (default: warn) warns about unknown
6711         attributes.
6712       * The `unknown_features` lint (default: warn) warns about unknown
6713         feature gates.
6714       * The `dead_code` lint (default: warn) checks for dead code.
6715       * Rust libraries can be linked statically to one another
6716       * `#[link_args]` is behind the `link_args` feature gate.
6717       * Native libraries are now linked with `#[link(name = "foo")]`
6718       * Native libraries can be statically linked to a rust crate
6719         (`#[link(name = "foo", kind = "static")]`).
6720       * Native OS X frameworks are now officially supported
6721         (`#[link(name = "foo", kind = "framework")]`).
6722       * The `#[thread_local]` attribute creates thread-local (not task-local)
6723         variables. Currently behind the `thread_local` feature gate.
6724       * The `return` keyword may be used in closures.
6725       * Types that can be copied via a memcpy implement the `Pod` kind.
6726       * The `cfg` attribute can now be used on struct fields and enum variants.
6727
6728    * Libraries
6729       * std: The `option` and `result` API's have been overhauled to make them
6730         simpler, more consistent, and more composable.
6731       * std: The entire `std::io` module has been replaced with one that is
6732         more comprehensive and that properly interfaces with the underlying
6733         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6734         implemented.
6735       * std: `io::util` contains a number of useful implementations of
6736         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6737         `ZeroReader`, `TeeReader`.
6738       * std: The reference counted pointer type `extra::rc` moved into std.
6739       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6740         just a wrapper around it).
6741       * std: The `Either` type has been removed.
6742       * std: `fmt::Default` can be implemented for any type to provide default
6743         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6744       * std: The `rand` API continues to be tweaked.
6745       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6746         on failure in gdb, is now named `rust_fail`.
6747       * std: The `each_key` and `each_value` methods on `HashMap` have been
6748         replaced by the `keys` and `values` iterators.
6749       * std: Functions dealing with type size and alignment have moved from the
6750         `sys` module to the `mem` module.
6751       * std: The `path` module was written and API changed.
6752       * std: `str::from_utf8` has been changed to cast instead of allocate.
6753       * std: `starts_with` and `ends_with` methods added to vectors via the
6754         `ImmutableEqVector` trait, which is in the prelude.
6755       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6756         if the index is out of bounds.
6757       * std: Task failure no longer propagates between tasks, as the model was
6758         complex, expensive, and incompatible with thread-based tasks.
6759       * std: The `Any` type can be used for dynamic typing.
6760       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6761         `task::try`.
6762       * std: Methods that produce iterators generally do not have an `_iter`
6763         suffix now.
6764       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6765         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6766       * std: `util::ignore` renamed to `prelude::drop`.
6767       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6768         trait.
6769       * std: `vec::raw` has seen a lot of cleanup and API changes.
6770       * std: The standard library no longer includes any C++ code, and very
6771         minimal C, eliminating the dependency on libstdc++.
6772       * std: Runtime scheduling and I/O functionality has been factored out into
6773         extensible interfaces and is now implemented by two different crates:
6774         libnative, for native threading and I/O; and libgreen, for green threading
6775         and I/O. This paves the way for using the standard library in more limited
6776         embedded environments.
6777       * std: The `comm` module has been rewritten to be much faster, have a
6778         simpler, more consistent API, and to work for both native and green
6779         threading.
6780       * std: All libuv dependencies have been moved into the rustuv crate.
6781       * native: New implementations of runtime scheduling on top of OS threads.
6782       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6783         and other I/O.
6784       * green: The green thread scheduler and message passing types are almost
6785         entirely lock-free.
6786       * extra: The `flatpipes` module had bitrotted and was removed.
6787       * extra: All crypto functions have been removed and Rust now has a policy of
6788         not reimplementing crypto in the standard library. In the future crypto
6789         will be provided by external crates with bindings to established libraries.
6790       * extra: `c_vec` has been modernized.
6791       * extra: The `sort` module has been removed. Use the `sort` method on
6792         mutable slices.
6793
6794    * Tooling
6795       * The `rust` and `rusti` commands have been removed, due to lack of
6796         maintenance.
6797       * `rustdoc` was completely rewritten.
6798       * `rustdoc` can test code examples in documentation.
6799       * `rustpkg` can test packages with the argument, 'test'.
6800       * `rustpkg` supports arbitrary dependencies, including C libraries.
6801       * `rustc`'s support for generating debug info is improved again.
6802       * `rustc` has better error reporting for unbalanced delimiters.
6803       * `rustc`'s JIT support was removed due to bitrot.
6804       * Executables and static libraries can be built with LTO (-Z lto)
6805       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6806         build tools.
6807
6808
6809 Version 0.8 (2013-09-26)
6810 ============================
6811
6812    * ~2200 changes, numerous bugfixes
6813
6814    * Language
6815       * The `for` loop syntax has changed to work with the `Iterator` trait.
6816       * At long last, unwinding works on Windows.
6817       * Default methods are ready for use.
6818       * Many trait inheritance bugs fixed.
6819       * Owned and borrowed trait objects work more reliably.
6820       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6821       * rustc can omit emission of code for the `debug!` macro if it is passed
6822         `--cfg ndebug`
6823       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6824         for foo.rs, then foo/mod.rs, and will generate an error when both are
6825         present.
6826       * Strings no longer contain trailing nulls. The new `std::c_str` module
6827         provides new mechanisms for converting to C strings.
6828       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6829       * The FFI has been overhauled such that foreign functions are called directly,
6830         instead of through a stack-switching wrapper.
6831       * Calling a foreign function must be done through a Rust function with the
6832         `#[fixed_stack_segment]` attribute.
6833       * The `externfn!` macro can be used to declare both a foreign function and
6834         a `#[fixed_stack_segment]` wrapper at once.
6835       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6836       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6837       * `priv` is disallowed everywhere except for struct fields and enum variants.
6838       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6839       * `ref` bindings in irrefutable patterns work correctly now.
6840       * `char` is now prevented from containing invalid code points.
6841       * Casting to `bool` is no longer allowed.
6842       * `\0` is now accepted as an escape in chars and strings.
6843       * `yield` is a reserved keyword.
6844       * `typeof` is a reserved keyword.
6845       * Crates may be imported by URL with `extern mod foo = "url";`.
6846       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6847       * Static vectors can be initialized with repeating elements,
6848         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6849       * Static structs can be initialized with functional record update,
6850         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6851       * `cfg!` can be used to conditionally execute code based on the crate
6852         configuration, similarly to `#[cfg(...)]`.
6853       * The `unnecessary_qualification` lint detects unneeded module
6854         prefixes (default: allow).
6855       * Arithmetic operations have been implemented on the SIMD types in
6856         `std::unstable::simd`.
6857       * Exchange allocation headers were removed, reducing memory usage.
6858       * `format!` implements a completely new, extensible, and higher-performance
6859         string formatting system. It will replace `fmt!`.
6860       * `print!` and `println!` write formatted strings (using the `format!`
6861         extension) to stdout.
6862       * `write!` and `writeln!` write formatted strings (using the `format!`
6863         extension) to the new Writers in `std::rt::io`.
6864       * The library section in which a function or static is placed may
6865         be specified with `#[link_section = "..."]`.
6866       * The `proto!` syntax extension for defining bounded message protocols
6867         was removed.
6868       * `macro_rules!` is hygienic for `let` declarations.
6869       * The `#[export_name]` attribute specifies the name of a symbol.
6870       * `unreachable!` can be used to indicate unreachable code, and fails
6871         if executed.
6872
6873    * Libraries
6874       * std: Transitioned to the new runtime, written in Rust.
6875       * std: Added an experimental I/O library, `rt::io`, based on the new
6876         runtime.
6877       * std: A new generic `range` function was added to the prelude, replacing
6878         `uint::range` and friends.
6879       * std: `range_rev` no longer exists. Since range is an iterator it can be
6880         reversed with `range(lo, hi).invert()`.
6881       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6882         renamed to `unwrap_or`.
6883       * std: The `iterator` module was renamed to `iter`.
6884       * std: Integral types now support the `checked_add`, `checked_sub`, and
6885         `checked_mul` operations for detecting overflow.
6886       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6887         consistency.
6888       * std: Methods are standardizing on conventions for casting methods:
6889         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6890         and cheap casts.
6891       * std: The `CString` type in `c_str` provides new ways to convert to and
6892         from C strings.
6893       * std: `DoubleEndedIterator` can yield elements in two directions.
6894       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6895         two splices.
6896       * std: `str::from_bytes` renamed to `str::from_utf8`.
6897       * std: `pop_opt` and `shift_opt` methods added to vectors.
6898       * std: The task-local data interface no longer uses @, and keys are
6899         no longer function pointers.
6900       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6901       * std: Added `SharedPort` to `comm`.
6902       * std: `Eq` has a default method for `ne`; only `eq` is required
6903         in implementations.
6904       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6905         is required in implementations.
6906       * std: `is_utf8` performance is improved, impacting many string functions.
6907       * std: `os::MemoryMap` provides cross-platform mmap.
6908       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6909         are not 'in-bounds' are considered undefined.
6910       * std: Many freestanding functions in `vec` removed in favor of methods.
6911       * std: Many freestanding functions on scalar types removed in favor of
6912         methods.
6913       * std: Many options to task builders were removed since they don't make
6914         sense in the new scheduler design.
6915       * std: More containers implement `FromIterator` so can be created by the
6916         `collect` method.
6917       * std: More complete atomic types in `unstable::atomics`.
6918       * std: `comm::PortSet` removed.
6919       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6920         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6921         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6922         default implementations.
6923       * std: Various `from_str` functions were removed in favor of a generic
6924         `from_str` which is available in the prelude.
6925       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6926       * extra: `dlist`, the doubly-linked list was modernized.
6927       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6928       * extra: Added `glob` module, replacing `std::os::glob`.
6929       * extra: `rope` was removed.
6930       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6931       * extra: `net`, and `timer` were removed. The experimental replacements
6932         are `std::rt::io::net` and `std::rt::io::timer`.
6933       * extra: Iterators implemented for `SmallIntMap`.
6934       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6935       * extra: `SmallIntSet` removed. Use `BitvSet`.
6936       * extra: Performance of JSON parsing greatly improved.
6937       * extra: `semver` updated to SemVer 2.0.0.
6938       * extra: `term` handles more terminals correctly.
6939       * extra: `dbg` module removed.
6940       * extra: `par` module removed.
6941       * extra: `future` was cleaned up, with some method renames.
6942       * extra: Most free functions in `getopts` were converted to methods.
6943
6944    * Other
6945       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6946       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6947         similarly to gcc's `--march` flag.
6948       * rustc's performance compiling small crates is much better.
6949       * rustpkg has received many improvements.
6950       * rustpkg supports git tags as package IDs.
6951       * rustpkg builds into target-specific directories so it can be used for
6952         cross-compiling.
6953       * The number of concurrent test tasks is controlled by the environment
6954         variable RUST_TEST_TASKS.
6955       * The test harness can now report metrics for benchmarks.
6956       * All tools have man pages.
6957       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6958       * The runtime uses jemalloc for allocations.
6959       * Segmented stacks are temporarily disabled as part of the transition to
6960         the new runtime. Stack overflows are possible!
6961       * A new documentation backend, rustdoc_ng, is available for use. It is
6962         still invoked through the normal `rustdoc` command.
6963
6964
6965 Version 0.7 (2013-07-03)
6966 =======================
6967
6968    * ~2000 changes, numerous bugfixes
6969
6970    * Language
6971       * `impl`s no longer accept a visibility qualifier. Put them on methods
6972         instead.
6973       * The borrow checker has been rewritten with flow-sensitivity, fixing
6974         many bugs and inconveniences.
6975       * The `self` parameter no longer implicitly means `&'self self`,
6976         and can be explicitly marked with a lifetime.
6977       * Overloadable compound operators (`+=`, etc.) have been temporarily
6978         removed due to bugs.
6979       * The `for` loop protocol now requires `for`-iterators to return `bool`
6980         so they compose better.
6981       * The `Durable` trait is replaced with the `'static` bounds.
6982       * Trait default methods work more often.
6983       * Structs with the `#[packed]` attribute have byte alignment and
6984         no padding between fields.
6985       * Type parameters bound by `Copy` must now be copied explicitly with
6986         the `copy` keyword.
6987       * It is now illegal to move out of a dereferenced unsafe pointer.
6988       * `Option<~T>` is now represented as a nullable pointer.
6989       * `@mut` does dynamic borrow checks correctly.
6990       * The `main` function is only detected at the topmost level of the crate.
6991         The `#[main]` attribute is still valid anywhere.
6992       * Struct fields may no longer be mutable. Use inherited mutability.
6993       * The `#[no_send]` attribute makes a type that would otherwise be
6994         `Send`, not.
6995       * The `#[no_freeze]` attribute makes a type that would otherwise be
6996         `Freeze`, not.
6997       * Unbounded recursion will abort the process after reaching the limit
6998         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6999       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7000         are never implicitly copyable.
7001       * `#[static_assert]` makes compile-time assertions about static bools.
7002       * At long last, 'argument modes' no longer exist.
7003       * The rarely used `use mod` statement no longer exists.
7004
7005    * Syntax extensions
7006       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
7007         argument list.
7008       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
7009         `Rand`, `Zero` and `ToStr` can all be automatically derived with
7010         `#[deriving(...)]`.
7011       * The `bytes!` macro returns a vector of bytes for string, u8, char,
7012         and unsuffixed integer literals.
7013
7014    * Libraries
7015       * The `core` crate was renamed to `std`.
7016       * The `std` crate was renamed to `extra`.
7017       * More and improved documentation.
7018       * std: `iterator` module for external iterator objects.
7019       * Many old-style (internal, higher-order function) iterators replaced by
7020         implementations of `Iterator`.
7021       * std: Many old internal vector and string iterators,
7022         incl. `any`, `all`. removed.
7023       * std: The `finalize` method of `Drop` renamed to `drop`.
7024       * std: The `drop` method now takes `&mut self` instead of `&self`.
7025       * std: The prelude no longer re-exports any modules, only types and traits.
7026       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
7027         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
7028       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
7029         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
7030       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
7031         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
7032       * std: Many types implement `Clone`.
7033       * std: `path` type renamed to `Path`.
7034       * std: `mut` module and `Mut` type removed.
7035       * std: Many standalone functions removed in favor of methods and iterators
7036         in `vec`, `str`. In the future methods will also work as functions.
7037       * std: `reinterpret_cast` removed. Use `transmute`.
7038       * std: ascii string handling in `std::ascii`.
7039       * std: `Rand` is implemented for ~/@.
7040       * std: `run` module for spawning processes overhauled.
7041       * std: Various atomic types added to `unstable::atomic`.
7042       * std: Various types implement `Zero`.
7043       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
7044       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
7045       * std: Added `os::mkdir_recursive`.
7046       * std: Added `os::glob` function performs filesystems globs.
7047       * std: `FuzzyEq` renamed to `ApproxEq`.
7048       * std: `Map` now defines `pop` and `swap` methods.
7049       * std: `Cell` constructors converted to static methods.
7050       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
7051       * extra: `flate` module moved from `std` to `extra`.
7052       * extra: `fileinput` module for iterating over a series of files.
7053       * extra: `Complex` number type and `complex` module.
7054       * extra: `Rational` number type and `rational` module.
7055       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
7056       * extra: `term` uses terminfo now, is more correct.
7057       * extra: `arc` functions converted to methods.
7058       * extra: Implementation of fixed output size variations of SHA-2.
7059
7060    * Tooling
7061       * `unused_variable`  lint mode for unused variables (default: warn).
7062       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
7063         (default: warn).
7064       * `unused_mut` lint mode for identifying unused `mut` qualifiers
7065         (default: warn).
7066       * `dead_assignment` lint mode for unread variables (default: warn).
7067       * `unnecessary_allocation` lint mode detects some heap allocations that are
7068         immediately borrowed so could be written without allocating (default: warn).
7069       * `missing_doc` lint mode (default: allow).
7070       * `unreachable_code` lint mode (default: warn).
7071       * The `rusti` command has been rewritten and a number of bugs addressed.
7072       * rustc outputs in color on more terminals.
7073       * rustc accepts a `--link-args` flag to pass arguments to the linker.
7074       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
7075       * Compiling with `-g` will make the binary record information about
7076         dynamic borrowcheck failures for debugging.
7077       * rustdoc has a nicer stylesheet.
7078       * Various improvements to rustdoc.
7079       * Improvements to rustpkg (see the detailed release notes).
7080
7081
7082 Version 0.6 (2013-04-03)
7083 ========================
7084
7085    * ~2100 changes, numerous bugfixes
7086
7087    * Syntax changes
7088       * The self type parameter in traits is now spelled `Self`
7089       * The `self` parameter in trait and impl methods must now be explicitly
7090         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
7091       * Static methods no longer require the `static` keyword and instead
7092         are distinguished by the lack of a `self` parameter
7093       * Replaced the `Durable` trait with the `'static` lifetime
7094       * The old closure type syntax with the trailing sigil has been
7095         removed in favor of the more consistent leading sigil
7096       * `super` is a keyword, and may be prefixed to paths
7097       * Trait bounds are separated with `+` instead of whitespace
7098       * Traits are implemented with `impl Trait for Type`
7099         instead of `impl Type: Trait`
7100       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
7101       * The `export` keyword has finally been removed
7102       * The `move` keyword has been removed (see "Semantic changes")
7103       * The interior mutability qualifier on vectors, `[mut T]`, has been
7104         removed. Use `&mut [T]`, etc.
7105       * `mut` is no longer valid in `~mut T`. Use inherited mutability
7106       * `fail` is no longer a keyword. Use `fail!()`
7107       * `assert` is no longer a keyword. Use `assert!()`
7108       * `log` is no longer a keyword. use `debug!`, etc.
7109       * 1-tuples may be represented as `(T,)`
7110       * Struct fields may no longer be `mut`. Use inherited mutability,
7111         `@mut T`, `core::mut` or `core::cell`
7112       * `extern mod { ... }` is no longer valid syntax for foreign
7113         function modules. Use extern blocks: `extern { ... }`
7114       * Newtype enums removed. Use tuple-structs.
7115       * Trait implementations no longer support visibility modifiers
7116       * Pattern matching over vectors improved and expanded
7117       * `const` renamed to `static` to correspond to lifetime name,
7118         and make room for future `static mut` unsafe mutable globals.
7119       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
7120       * `Clone` implementations can be automatically generated with
7121         `#[deriving(Clone)]`
7122       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
7123         instead of `foo as Bar`.
7124       * Fixed length vector types are now written as `[int, .. 3]`
7125         instead of `[int * 3]`.
7126       * Fixed length vector types can express the length as a constant
7127         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
7128
7129    * Semantic changes
7130       * Types with owned pointers or custom destructors move by default,
7131         eliminating the `move` keyword
7132       * All foreign functions are considered unsafe
7133       * &mut is now unaliasable
7134       * Writes to borrowed @mut pointers are prevented dynamically
7135       * () has size 0
7136       * The name of the main function can be customized using #[main]
7137       * The default type of an inferred closure is &fn instead of @fn
7138       * `use` statements may no longer be "chained" - they cannot import
7139         identifiers imported by previous `use` statements
7140       * `use` statements are crate relative, importing from the "top"
7141         of the crate by default. Paths may be prefixed with `super::`
7142         or `self::` to change the search behavior.
7143       * Method visibility is inherited from the implementation declaration
7144       * Structural records have been removed
7145       * Many more types can be used in static items, including enums
7146         'static-lifetime pointers and vectors
7147       * Pattern matching over vectors improved and expanded
7148       * Typechecking of closure types has been overhauled to
7149         improve inference and eliminate unsoundness
7150       * Macros leave scope at the end of modules, unless that module is
7151         tagged with #[macro_escape]
7152
7153    * Libraries
7154       * Added big integers to `std::bigint`
7155       * Removed `core::oldcomm` module
7156       * Added pipe-based `core::comm` module
7157       * Numeric traits have been reorganized under `core::num`
7158       * `vec::slice` finally returns a slice
7159       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
7160       * Containers reorganized around traits in `core::container`
7161       * `core::dvec` removed, `~[T]` is a drop-in replacement
7162       * `core::send_map` renamed to `core::hashmap`
7163       * `std::map` removed; replaced with `core::hashmap`
7164       * `std::treemap` reimplemented as an owned balanced tree
7165       * `std::deque` and `std::smallintmap` reimplemented as owned containers
7166       * `core::trie` added as a fast ordered map for integer keys
7167       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
7168       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
7169         overload the comparison operators, whereas `TotalOrd` is used
7170         by certain container types
7171
7172    * Other
7173       * Replaced the 'cargo' package manager with 'rustpkg'
7174       * Added all-purpose 'rust' tool
7175       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
7176       * rustc now *attempts* to offer spelling suggestions
7177       * Improved support for ARM and Android
7178       * Preliminary MIPS backend
7179       * Improved foreign function ABI implementation for x86, x86_64
7180       * Various memory usage improvements
7181       * Rust code may be embedded in foreign code under limited circumstances
7182       * Inline assembler supported by new asm!() syntax extension.
7183
7184
7185 Version 0.5 (2012-12-21)
7186 ===========================
7187
7188    * ~900 changes, numerous bugfixes
7189
7190    * Syntax changes
7191       * Removed `<-` move operator
7192       * Completed the transition from the `#fmt` extension syntax to `fmt!`
7193       * Removed old fixed length vector syntax - `[T]/N`
7194       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
7195       * Macros may now expand to items and statements
7196       * `a.b()` is always parsed as a method call, never as a field projection
7197       * `Eq` and `IterBytes` implementations can be automatically generated
7198         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
7199       * Removed the special crate language for `.rc` files
7200       * Function arguments may consist of any irrefutable pattern
7201
7202    * Semantic changes
7203       * `&` and `~` pointers may point to objects
7204       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
7205       * Enum variants may be structs
7206       * Destructors can be added to all nominal types with the Drop trait
7207       * Structs and nullary enum variants may be constants
7208       * Values that cannot be implicitly copied are now automatically moved
7209         without writing `move` explicitly
7210       * `&T` may now be coerced to `*T`
7211       * Coercions happen in `let` statements as well as function calls
7212       * `use` statements now take crate-relative paths
7213       * The module and type namespaces have been merged so that static
7214         method names can be resolved under the trait in which they are
7215         declared
7216
7217    * Improved support for language features
7218       * Trait inheritance works in many scenarios
7219       * More support for explicit self arguments in methods - `self`, `&self`
7220         `@self`, and `~self` all generally work as expected
7221       * Static methods work in more situations
7222       * Experimental: Traits may declare default methods for the implementations
7223         to use
7224
7225    * Libraries
7226       * New condition handling system in `core::condition`
7227       * Timsort added to `std::sort`
7228       * New priority queue, `std::priority_queue`
7229       * Pipes for serializable types, `std::flatpipes'
7230       * Serialization overhauled to be trait-based
7231       * Expanded `getopts` definitions
7232       * Moved futures to `std`
7233       * More functions are pure now
7234       * `core::comm` renamed to `oldcomm`. Still deprecated
7235       * `rustdoc` and `cargo` are libraries now
7236
7237    * Misc
7238       * Added a preliminary REPL, `rusti`
7239       * License changed from MIT to dual MIT/APL2
7240
7241
7242 Version 0.4 (2012-10-15)
7243 ==========================
7244
7245    * ~2000 changes, numerous bugfixes
7246
7247    * Syntax
7248       * All keywords are now strict and may not be used as identifiers anywhere
7249       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
7250         'of', 'with', 'to', 'class'.
7251       * Classes are replaced with simpler structs
7252       * Explicit method self types
7253       * `ret` became `return` and `alt` became `match`
7254       * `import` is now `use`; `use is now `extern mod`
7255       * `extern mod { ... }` is now `extern { ... }`
7256       * `use mod` is the recommended way to import modules
7257       * `pub` and `priv` replace deprecated export lists
7258       * The syntax of `match` pattern arms now uses fat arrow (=>)
7259       * `main` no longer accepts an args vector; use `os::args` instead
7260
7261    * Semantics
7262       * Trait implementations are now coherent, ala Haskell typeclasses
7263       * Trait methods may be static
7264       * Argument modes are deprecated
7265       * Borrowed pointers are much more mature and recommended for use
7266       * Strings and vectors in the static region are stored in constant memory
7267       * Typestate was removed
7268       * Resolution rewritten to be more reliable
7269       * Support for 'dual-mode' data structures (freezing and thawing)
7270
7271    * Libraries
7272       * Most binary operators can now be overloaded via the traits in
7273         `core::ops'
7274       * `std::net::url` for representing URLs
7275       * Sendable hash maps in `core::send_map`
7276       * `core::task' gained a (currently unsafe) task-local storage API
7277
7278    * Concurrency
7279       * An efficient new intertask communication primitive called the pipe,
7280         along with a number of higher-level channel types, in `core::pipes`
7281       * `std::arc`, an atomically reference counted, immutable, shared memory
7282         type
7283       * `std::sync`, various exotic synchronization tools based on arcs and pipes
7284       * Futures are now based on pipes and sendable
7285       * More robust linked task failure
7286       * Improved task builder API
7287
7288    * Other
7289       * Improved error reporting
7290       * Preliminary JIT support
7291       * Preliminary work on precise GC
7292       * Extensive architectural improvements to rustc
7293       * Begun a transition away from buggy C++-based reflection (shape) code to
7294         Rust-based (visitor) code
7295       * All hash functions and tables converted to secure, randomized SipHash
7296
7297
7298 Version 0.3  (2012-07-12)
7299 ========================
7300
7301    * ~1900 changes, numerous bugfixes
7302
7303    * New coding conveniences
7304       * Integer-literal suffix inference
7305       * Per-item control over warnings, errors
7306       * #[cfg(windows)] and #[cfg(unix)] attributes
7307       * Documentation comments
7308       * More compact closure syntax
7309       * 'do' expressions for treating higher-order functions as
7310         control structures
7311       * *-patterns (wildcard extended to all constructor fields)
7312
7313    * Semantic cleanup
7314       * Name resolution pass and exhaustiveness checker rewritten
7315       * Region pointers and borrow checking supersede alias
7316         analysis
7317       * Init-ness checking is now provided by a region-based liveness
7318         pass instead of the typestate pass; same for last-use analysis
7319       * Extensive work on region pointers
7320
7321    * Experimental new language features
7322       * Slices and fixed-size, interior-allocated vectors
7323       * #!-comments for lang versioning, shell execution
7324       * Destructors and iface implementation for classes;
7325         type-parameterized classes and class methods
7326       * 'const' type kind for types that can be used to implement
7327         shared-memory concurrency patterns
7328
7329    * Type reflection
7330
7331    * Removal of various obsolete features
7332       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
7333                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
7334
7335       * Constructs: do-while loops ('do' repurposed), fn binding,
7336                     resources (replaced by destructors)
7337
7338    * Compiler reorganization
7339       * Syntax-layer of compiler split into separate crate
7340       * Clang (from LLVM project) integrated into build
7341       * Typechecker split into sub-modules
7342
7343    * New library code
7344       * New time functions
7345       * Extension methods for many built-in types
7346       * Arc: atomic-refcount read-only / exclusive-use shared cells
7347       * Par: parallel map and search routines
7348       * Extensive work on libuv interface
7349       * Much vector code moved to libraries
7350       * Syntax extensions: #line, #col, #file, #mod, #stringify,
7351         #include, #include_str, #include_bin
7352
7353    * Tool improvements
7354       * Cargo automatically resolves dependencies
7355
7356
7357 Version 0.2  (2012-03-29)
7358 =========================
7359
7360    * >1500 changes, numerous bugfixes
7361
7362    * New docs and doc tooling
7363
7364    * New port: FreeBSD x86_64
7365
7366    * Compilation model enhancements
7367       * Generics now specialized, multiply instantiated
7368       * Functions now inlined across separate crates
7369
7370    * Scheduling, stack and threading fixes
7371       * Noticeably improved message-passing performance
7372       * Explicit schedulers
7373       * Callbacks from C
7374       * Helgrind clean
7375
7376    * Experimental new language features
7377       * Operator overloading
7378       * Region pointers
7379       * Classes
7380
7381    * Various language extensions
7382       * C-callback function types: 'crust fn ...'
7383       * Infinite-loop construct: 'loop { ... }'
7384       * Shorten 'mutable' to 'mut'
7385       * Required mutable-local qualifier: 'let mut ...'
7386       * Basic glob-exporting: 'export foo::*;'
7387       * Alt now exhaustive, 'alt check' for runtime-checked
7388       * Block-function form of 'for' loop, with 'break' and 'ret'.
7389
7390    * New library code
7391       * AST quasi-quote syntax extension
7392       * Revived libuv interface
7393       * New modules: core::{future, iter}, std::arena
7394       * Merged per-platform std::{os*, fs*} to core::{libc, os}
7395       * Extensive cleanup, regularization in libstd, libcore
7396
7397
7398 Version 0.1  (2012-01-20)
7399 ===============================
7400
7401    * Most language features work, including:
7402       * Unique pointers, unique closures, move semantics
7403       * Interface-constrained generics
7404       * Static interface dispatch
7405       * Stack growth
7406       * Multithread task scheduling
7407       * Typestate predicates
7408       * Failure unwinding, destructors
7409       * Pattern matching and destructuring assignment
7410       * Lightweight block-lambda syntax
7411       * Preliminary macro-by-example
7412
7413    * Compiler works with the following configurations:
7414       * Linux: x86 and x86_64 hosts and targets
7415       * macOS: x86 and x86_64 hosts and targets
7416       * Windows: x86 hosts and targets
7417
7418    * Cross compilation / multi-target configuration supported.
7419
7420    * Preliminary API-documentation and package-management tools included.
7421
7422 Known issues:
7423
7424    * Documentation is incomplete.
7425
7426    * Performance is below intended target.
7427
7428    * Standard library APIs are subject to extensive change, reorganization.
7429
7430    * Language-level versioning is not yet operational - future code will
7431      break unexpectedly.