]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Rollup merge of #40398 - eddyb:struct-hint, r=nikomatsakis
[rust.git] / RELEASES.md
1 Version 1.16.0 (2017-03-16)
2 ===========================
3
4 Language
5 --------
6
7 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
8 * [Uninhabitable enums (those without any variants) no longer permit wildcard
9   match patterns][38069]
10 * [Clean up semantics of `self` in an import list][38313]
11 * [`Self` may appear in `impl` headers][38920]
12 * [`Self` may appear in struct expressions][39282]
13
14 Compiler
15 --------
16
17 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
18   a `.rmeta` file containing only crate metadata][38571]. This can be
19   used by tools like the Rust Language Service to perform
20   metadata-only builds.
21 * [Levenshtein based typo suggestions now work in most places, while
22   previously they worked only for fields and sometimes for local
23   variables][38927]. Together with the overhaul of "no
24   resolution"/"unexpected resolution" errors (#[38154]) they result in
25   large and systematic improvement in resolution diagnostics.
26 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
27   `U`][38670]
28 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
29 * [`rustc` no longer attempts to provide "consider using an explicit
30   lifetime" suggestions][37057]. They were inaccurate.
31
32 Stabilized APIs
33 ---------------
34
35 * [`VecDeque::truncate`]
36 * [`VecDeque::resize`]
37 * [`String::insert_str`]
38 * [`Duration::checked_add`]
39 * [`Duration::checked_sub`]
40 * [`Duration::checked_div`]
41 * [`Duration::checked_mul`]
42 * [`str::replacen`]
43 * [`str::repeat`]
44 * [`SocketAddr::is_ipv4`]
45 * [`SocketAddr::is_ipv6`]
46 * [`IpAddr::is_ipv4`]
47 * [`IpAddr::is_ipv6`]
48 * [`Vec::dedup_by`]
49 * [`Vec::dedup_by_key`]
50 * [`Result::unwrap_or_default`]
51 * [`<*const T>::wrapping_offset`]
52 * [`<*mut T>::wrapping_offset`]
53 * `CommandExt::creation_flags`
54 * [`File::set_permissions`]
55 * [`String::split_off`]
56
57 Libraries
58 ---------
59
60 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
61   their argument by `Borrow` parameter][37761]
62 * [All public types in std implement `Debug`][38006]
63 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
64 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
65 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
66   Windows][38274]
67 * [std: Fix partial writes in `LineWriter`][38062]
68 * [std: Clamp max read/write sizes on Unix][38062]
69 * [Use more specific panic message for `&str` slicing errors][38066]
70 * [`TcpListener::set_only_v6` is deprecated][38304]. This
71   functionality cannot be achieved in std currently.
72 * [`writeln!`, like `println!`, now accepts a form with no string
73   or formatting arguments, to just print a newline][38469]
74 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
75 * [Reduce the size of static data in `std_unicode::tables`][38781]
76 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
77   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
78   `Display`][38909]
79 * [`Duration` implements `Sum`][38712]
80 * [`String` implements `ToSocketAddrs`][39048]
81
82 Cargo
83 -----
84
85 * [The `cargo check` command does a type check of a project without
86   building it][cargo/3296]
87 * [crates.io will display CI badges from Travis and AppVeyor, if
88   specified in Cargo.toml][cargo/3546]
89 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
90 * [Compilation profiles accept integer values for `debug`, in addition
91   to `true` and `false`. These are passed to `rustc` as the value to
92   `-C debuginfo`][cargo/3534]
93 * [Implement `cargo --version --verbose`][cargo/3604]
94 * [All builds now output 'dep-info' build dependencies compatible with
95   make and ninja][cargo/3557]
96 * [Build all workspace members with `build --all`][cargo/3511]
97 * [Document all workspace members with `doc --all`][cargo/3515]
98 * [Path deps outside workspace are not members][cargo/3443]
99
100 Misc
101 ----
102
103 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
104   the path to the Rust implementation][38589]
105 * [The `armv7-linux-androideabi` target no longer enables NEON
106   extensions, per Google's ABI guide][38413]
107 * [The stock standard library can be compiled for Redox OS][38401]
108 * [Rust has initial SPARC support][38726]. Tier 3. No builds
109   available.
110 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
111   builds available.
112 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
113
114 Compatibility Notes
115 -------------------
116
117 * [Uninhabitable enums (those without any variants) no longer permit wildcard
118   match patterns][38069]
119 * In this release, references to uninhabited types can not be
120   pattern-matched. This was accidentally allowed in 1.15.
121 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
122 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
123   Windows][38274]
124 * [Clean up semantics of `self` in an import list][38313]
125
126 [37057]: https://github.com/rust-lang/rust/pull/37057
127 [37761]: https://github.com/rust-lang/rust/pull/37761
128 [38006]: https://github.com/rust-lang/rust/pull/38006
129 [38051]: https://github.com/rust-lang/rust/pull/38051
130 [38062]: https://github.com/rust-lang/rust/pull/38062
131 [38062]: https://github.com/rust-lang/rust/pull/38622
132 [38066]: https://github.com/rust-lang/rust/pull/38066
133 [38069]: https://github.com/rust-lang/rust/pull/38069
134 [38131]: https://github.com/rust-lang/rust/pull/38131
135 [38154]: https://github.com/rust-lang/rust/pull/38154
136 [38274]: https://github.com/rust-lang/rust/pull/38274
137 [38304]: https://github.com/rust-lang/rust/pull/38304
138 [38313]: https://github.com/rust-lang/rust/pull/38313
139 [38314]: https://github.com/rust-lang/rust/pull/38314
140 [38327]: https://github.com/rust-lang/rust/pull/38327
141 [38401]: https://github.com/rust-lang/rust/pull/38401
142 [38413]: https://github.com/rust-lang/rust/pull/38413
143 [38469]: https://github.com/rust-lang/rust/pull/38469
144 [38559]: https://github.com/rust-lang/rust/pull/38559
145 [38571]: https://github.com/rust-lang/rust/pull/38571
146 [38580]: https://github.com/rust-lang/rust/pull/38580
147 [38589]: https://github.com/rust-lang/rust/pull/38589
148 [38670]: https://github.com/rust-lang/rust/pull/38670
149 [38712]: https://github.com/rust-lang/rust/pull/38712
150 [38726]: https://github.com/rust-lang/rust/pull/38726
151 [38781]: https://github.com/rust-lang/rust/pull/38781
152 [38798]: https://github.com/rust-lang/rust/pull/38798
153 [38909]: https://github.com/rust-lang/rust/pull/38909
154 [38920]: https://github.com/rust-lang/rust/pull/38920
155 [38927]: https://github.com/rust-lang/rust/pull/38927
156 [39048]: https://github.com/rust-lang/rust/pull/39048
157 [39282]: https://github.com/rust-lang/rust/pull/39282
158 [39379]: https://github.com/rust-lang/rust/pull/39379
159 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
160 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
161 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
162 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
163 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
164 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
165 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
166 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
167 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
168 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
169 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
170 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
171 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
172 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
173 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
174 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
175 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
176 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
177 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
178 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
179 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
180 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
181 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
182 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
183 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
184 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
185 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
186 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
187 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
188 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
189
190
191 Version 1.15.1 (2017-02-09)
192 ===========================
193
194 * [Fix IntoIter::as_mut_slice's signature][39466]
195 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
196
197 [39466]: https://github.com/rust-lang/rust/pull/39466
198 [39523]: https://github.com/rust-lang/rust/pull/39523
199
200
201 Version 1.15.0 (2017-02-02)
202 ===========================
203
204 Language
205 --------
206
207 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
208   stable. This allows popular code-generating crates like Serde and Diesel to
209   work ergonomically. [RFC 1681].
210 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
211   with curly braces][36868]. Part of [RFC 1506].
212 * [A number of minor changes to name resolution have been activated][37127].
213   They add up to more consistent semantics, allowing for future evolution of
214   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
215   details of what is different. The breaking changes here have been transitioned
216   through the [`legacy_imports`] lint since 1.14, with no known regressions.
217 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
218   bounds][38279]
219 * [`?Sized` can be used in `where` clauses][37791]
220 * [There is now a limit on the size of monomorphized types and it can be
221   modified with the `#![type_size_limit]` crate attribute, similarly to
222   the `#![recursion_limit]` attribute][37789]
223
224 Compiler
225 --------
226
227 * [On Windows, the compiler will apply dllimport attributes when linking to
228   extern functions][37973]. Additional attributes and flags can control which
229   library kind is linked and its name. [RFC 1717].
230 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
231 * [The `--test` flag works with procedural macro crates][38107]
232 * [Fix `extern "aapcs" fn` ABI][37814]
233 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
234 * [The `format!` expander recognizes incorrect `printf` and shell-style
235   formatting directives and suggests the correct format][37613].
236 * [Only report one error for all unused imports in an import list][37456]
237
238 Compiler Performance
239 --------------------
240
241 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
242 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
243 * [Don't clone in `UnificationTable::probe`][37848]
244 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
245 * [Use small vectors in type walker][37760]
246 * [Macro expansion performance was improved][37701]
247 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
248 * [Replace FNV with a faster hash function][37229]
249
250 Stabilized APIs
251 ---------------
252
253 * [`std::iter::Iterator::min_by`]
254 * [`std::iter::Iterator::max_by`]
255 * [`std::os::*::fs::FileExt`]
256 * [`std::sync::atomic::Atomic*::get_mut`]
257 * [`std::sync::atomic::Atomic*::into_inner`]
258 * [`std::vec::IntoIter::as_slice`]
259 * [`std::vec::IntoIter::as_mut_slice`]
260 * [`std::sync::mpsc::Receiver::try_iter`]
261 * [`std::os::unix::process::CommandExt::before_exec`]
262 * [`std::rc::Rc::strong_count`]
263 * [`std::rc::Rc::weak_count`]
264 * [`std::sync::Arc::strong_count`]
265 * [`std::sync::Arc::weak_count`]
266 * [`std::char::encode_utf8`]
267 * [`std::char::encode_utf16`]
268 * [`std::cell::Ref::clone`]
269 * [`std::io::Take::into_inner`]
270
271 Libraries
272 ---------
273
274 * [The standard sorting algorithm has been rewritten for dramatic performance
275   improvements][38192]. It is a hybrid merge sort, drawing influences from
276   Timsort. Previously it was a naive merge sort.
277 * [`Iterator::nth` no longer has a `Sized` bound][38134]
278 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
279   performance.
280 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
281   and `char_indices().last()`][37882]
282 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
283 * [Chinese characters display correctly in `fmt::Debug`][37855]
284 * [Derive `Default` for `Duration`][37699]
285 * [Support creation of anonymous pipes on WinXP/2k][37677]
286 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
287 * [Don't pass overlapped handles to processes][38835]
288
289 Cargo
290 -----
291
292 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
293   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
294   should instead check the variable at runtime with `std::env`. That the value
295   was set at build time was a bug, and incorrect when cross-compiling. This
296   change is known to cause breakage.
297 * [Add `--all` flag to `cargo test`][cargo/3221]
298 * [Compile statically against the MSVC CRT][cargo/3363]
299 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
300 * [Link OpenSSL statically on OSX][cargo/3311]
301 * [Apply new fingerprinting to build dir outputs][cargo/3310]
302 * [Test for bad path overrides with summaries][cargo/3336]
303 * [Require `cargo install --vers` to take a semver version][cargo/3338]
304 * [Fix retrying crate downloads for network errors][cargo/3348]
305 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
306 * [Emit more info on --message-format=json][cargo/3319]
307 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
308 * [Don't ignore errors in workspace manifest][cargo/3409]
309 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
310
311 Tooling
312 -------
313
314 * [Test runners (binaries built with `--test`) now support a `--list` argument
315   that lists the tests it contains][38185]
316 * [Test runners now support a `--exact` argument that makes the test filter
317   match exactly, instead of matching only a substring of the test name][38181]
318 * [rustdoc supports a `--playground-url` flag][37763]
319 * [rustdoc provides more details about `#[should_panic]` errors][37749]
320
321 Misc
322 ----
323
324 * [The Rust build system is now written in Rust][37817]. The Makefiles may
325   continue to be used in this release by passing `--disable-rustbuild` to the
326   configure script, but they will be deleted soon. Note that the new build
327   system uses a different on-disk layout that will likely affect any scripts
328   building Rust.
329 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
330   releases.
331 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
332 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
333   releases.
334
335 Compatibility Notes
336 -------------------
337
338 * [A number of minor changes to name resolution have been activated][37127].
339   They add up to more consistent semantics, allowing for future evolution of
340   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
341   details of what is different. The breaking changes here have been transitioned
342   through the [`legacy_imports`] lint since 1.14, with no known regressions.
343 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
344   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
345   should instead check the variable at runtime with `std::env`. That the value
346   was set at build time was a bug, and incorrect when cross-compiling. This
347   change is known to cause breakage.
348 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
349   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
350   1.10 and is now an error by default. It will become a hard error in the near
351   future.
352 * [The semantics relating modules to file system directories are changing in
353   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
354   lint, which is a warning in this release, and will become a hard error in the
355   future.
356 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
357 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
358   the underlying iterator][37834]
359
360 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
361 [33685]: https://github.com/rust-lang/rust/issues/33685
362 [36868]: https://github.com/rust-lang/rust/pull/36868
363 [37127]: https://github.com/rust-lang/rust/pull/37127
364 [37229]: https://github.com/rust-lang/rust/pull/37229
365 [37456]: https://github.com/rust-lang/rust/pull/37456
366 [37527]: https://github.com/rust-lang/rust/pull/37527
367 [37602]: https://github.com/rust-lang/rust/pull/37602
368 [37613]: https://github.com/rust-lang/rust/pull/37613
369 [37615]: https://github.com/rust-lang/rust/pull/37615
370 [37636]: https://github.com/rust-lang/rust/pull/37636
371 [37627]: https://github.com/rust-lang/rust/pull/37627
372 [37642]: https://github.com/rust-lang/rust/pull/37642
373 [37677]: https://github.com/rust-lang/rust/pull/37677
374 [37699]: https://github.com/rust-lang/rust/pull/37699
375 [37701]: https://github.com/rust-lang/rust/pull/37701
376 [37705]: https://github.com/rust-lang/rust/pull/37705
377 [37749]: https://github.com/rust-lang/rust/pull/37749
378 [37760]: https://github.com/rust-lang/rust/pull/37760
379 [37763]: https://github.com/rust-lang/rust/pull/37763
380 [37764]: https://github.com/rust-lang/rust/pull/37764
381 [37789]: https://github.com/rust-lang/rust/pull/37789
382 [37791]: https://github.com/rust-lang/rust/pull/37791
383 [37814]: https://github.com/rust-lang/rust/pull/37814
384 [37817]: https://github.com/rust-lang/rust/pull/37817
385 [37834]: https://github.com/rust-lang/rust/pull/37834
386 [37848]: https://github.com/rust-lang/rust/pull/37848
387 [37855]: https://github.com/rust-lang/rust/pull/37855
388 [37882]: https://github.com/rust-lang/rust/pull/37882
389 [37888]: https://github.com/rust-lang/rust/pull/37888
390 [37973]: https://github.com/rust-lang/rust/pull/37973
391 [37979]: https://github.com/rust-lang/rust/pull/37979
392 [38086]: https://github.com/rust-lang/rust/pull/38086
393 [38107]: https://github.com/rust-lang/rust/pull/38107
394 [38117]: https://github.com/rust-lang/rust/pull/38117
395 [38134]: https://github.com/rust-lang/rust/pull/38134
396 [38146]: https://github.com/rust-lang/rust/pull/38146
397 [38181]: https://github.com/rust-lang/rust/pull/38181
398 [38182]: https://github.com/rust-lang/rust/pull/38182
399 [38185]: https://github.com/rust-lang/rust/pull/38185
400 [38192]: https://github.com/rust-lang/rust/pull/38192
401 [38279]: https://github.com/rust-lang/rust/pull/38279
402 [38835]: https://github.com/rust-lang/rust/pull/38835
403 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
404 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
405 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
406 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
407 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
408 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
409 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
410 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
411 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
412 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
413 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
414 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
415 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
416 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
417 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
418 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
419 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
420 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
421 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
422 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
423 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
424 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
425 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
426 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
427 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
428 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
429 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
430 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
431 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
432 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
433 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
434 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
435 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
436 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
437 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
438 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
439 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
440 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
441
442
443 Version 1.14.0 (2016-12-22)
444 ===========================
445
446 Language
447 --------
448
449 * [`..` matches multiple tuple fields in enum variants, structs
450   and tuples][36843]. [RFC 1492].
451 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
452 * [`use *` and `use ::*` both glob-import from the crate root][37367]
453 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
454   dereferencing][36822]
455
456 Compiler
457 --------
458
459 * [Mark enums with non-zero discriminant as non-zero][37224]
460 * [Lower-case `static mut` names are linted like other
461   statics and consts][37162]
462 * [Fix ICE on some macros in const integer positions
463    (e.g. `[u8; m!()]`)][36819]
464 * [Improve error message and snippet for "did you mean `x`"][36798]
465 * [Add a panic-strategy field to the target specification][36794]
466 * [Include LLVM version in `--version --verbose`][37200]
467
468 Compile-time Optimizations
469 --------------------------
470
471 * [Improve macro expansion performance][37569]
472 * [Shrink `Expr_::ExprInlineAsm`][37445]
473 * [Replace all uses of SHA-256 with BLAKE2b][37439]
474 * [Reduce the number of bytes hashed by `IchHasher`][37427]
475 * [Avoid more allocations when compiling html5ever][37373]
476 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
477 * [Avoid some allocations in the macro parser][37318]
478 * [Use a faster deflate setting][37298]
479 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
480   during interning of slices][37270]
481 * [Optimize `write_metadata`][37267]
482 * [Don't process obligation forest cycles when stalled][37231]
483 * [Avoid many `CrateConfig` clones][37161]
484 * [Optimize `Substs::super_fold_with`][37108]
485 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
486 * [Speed up `plug_leaks`][36917]
487
488 Libraries
489 ---------
490
491 * [`println!()`, with no arguments, prints newline][36825].
492   Previously, an empty string was required to achieve the same.
493 * [`Wrapping` impls standard binary and unary operators, as well as
494    the `Sum` and `Product` iterators][37356]
495 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
496   Vec<T>`][37326]
497 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
498   `VecDeque` iterators][37315]
499 * [Improve `SipHasher` performance on small values][37312]
500 * [Add Iterator trait TrustedLen to enable better FromIterator /
501   Extend][37306]
502 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
503 * [`ReadDir` implements `Debug`][37221]
504 * [Implement `RefUnwindSafe` for atomic types][37178]
505 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
506 * [Avoid allocations in `Decoder::read_str`][37064]
507 * [`io::Error` implements `From<io::ErrorKind>`][37037]
508 * [Impl `Debug` for raw pointers to unsized data][36880]
509 * [Don't reuse `HashMap` random seeds][37470]
510 * [The internal memory layout of `HashMap` is more cache-friendly, for
511   significant improvements in some operations][36692]
512 * [`HashMap` uses less memory on 32-bit architectures][36595]
513 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
514
515 Cargo
516 -----
517
518 * [Expose rustc cfg values to build scripts][cargo/3243]
519 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
520 * [Fix passing --features when testing multiple packages][cargo/3280]
521 * [Use a single profile set per workspace][cargo/3249]
522 * [Load `replace` sections from lock files][cargo/3220]
523 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
524
525 Tooling
526 -------
527
528 * [rustup is the recommended Rust installation method][1.14rustup]
529 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
530   S390x. These are [tier 2] platforms and may have major defects. Follow the
531   instructions on the website to install, or add the targets to an existing
532   installation with `rustup target add`. The new target triples are:
533   - `mips-unknown-linux-gnu`
534   - `mipsel-unknown-linux-gnu`
535   - `mips64-unknown-linux-gnuabi64`
536   - `mips64el-unknown-linux-gnuabi64 `
537   - `powerpc-unknown-linux-gnu`
538   - `powerpc64-unknown-linux-gnu`
539   - `powerpc64le-unknown-linux-gnu`
540   - `s390x-unknown-linux-gnu `
541 * This release includes target (std) builds for ARM Linux running MUSL
542   libc. These are [tier 2] platforms and may have major defects. Add the
543   following triples to an existing rustup installation with `rustup target add`:
544   - `arm-unknown-linux-musleabi`
545   - `arm-unknown-linux-musleabihf`
546   - `armv7-unknown-linux-musleabihf`
547 * This release includes [experimental support for WebAssembly][1.14wasm], via
548   the `wasm32-unknown-emscripten` target. This target is known to have major
549   defects. Please test, report, and fix.
550 * rustup no longer installs documentation by default. Run `rustup
551   component add rust-docs` to install.
552 * [Fix line stepping in debugger][37310]
553 * [Enable line number debuginfo in releases][37280]
554
555 Misc
556 ----
557
558 * [Disable jemalloc on aarch64/powerpc/mips][37392]
559 * [Add support for Fuchsia OS][37313]
560 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
561
562 Compatibility Notes
563 -------------------
564
565 * [A number of forward-compatibility lints used by the compiler
566   to gradually introduce language changes have been converted
567   to deny by default][36894]:
568   - ["use of inaccessible extern crate erroneously allowed"][36886]
569   - ["type parameter default erroneously allowed in invalid location"][36887]
570   - ["detects super or self keywords at the beginning of global path"][36888]
571   - ["two overlapping inherent impls define an item with the same name
572     were erroneously allowed"][36889]
573   - ["floating-point constants cannot be used in patterns"][36890]
574   - ["constants of struct or enum type can only be used in a pattern if
575      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
576   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
577 * [Prohibit patterns in trait methods without bodies][37378]
578 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
579 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
580 * [The `$crate` macro variable is accepted in fewer locations][37213]
581 * [Impls specifying extra region requirements beyond the trait
582   they implement are rejected][37167]
583 * [Enums may not be unsized][37111]. Unsized enums are intended to
584   work but never have. For now they are forbidden.
585 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
586
587 [tier 2]: https://forge.rust-lang.org/platform-support.html
588 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
589 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
590 [36430]: https://github.com/rust-lang/rust/pull/36430
591 [36595]: https://github.com/rust-lang/rust/pull/36595
592 [36595]: https://github.com/rust-lang/rust/pull/36595
593 [36692]: https://github.com/rust-lang/rust/pull/36692
594 [36767]: https://github.com/rust-lang/rust/pull/36767
595 [36794]: https://github.com/rust-lang/rust/pull/36794
596 [36798]: https://github.com/rust-lang/rust/pull/36798
597 [36819]: https://github.com/rust-lang/rust/pull/36819
598 [36822]: https://github.com/rust-lang/rust/pull/36822
599 [36825]: https://github.com/rust-lang/rust/pull/36825
600 [36843]: https://github.com/rust-lang/rust/pull/36843
601 [36880]: https://github.com/rust-lang/rust/pull/36880
602 [36886]: https://github.com/rust-lang/rust/issues/36886
603 [36887]: https://github.com/rust-lang/rust/issues/36887
604 [36888]: https://github.com/rust-lang/rust/issues/36888
605 [36889]: https://github.com/rust-lang/rust/issues/36889
606 [36890]: https://github.com/rust-lang/rust/issues/36890
607 [36891]: https://github.com/rust-lang/rust/issues/36891
608 [36892]: https://github.com/rust-lang/rust/issues/36892
609 [36894]: https://github.com/rust-lang/rust/pull/36894
610 [36917]: https://github.com/rust-lang/rust/pull/36917
611 [36993]: https://github.com/rust-lang/rust/pull/36993
612 [37037]: https://github.com/rust-lang/rust/pull/37037
613 [37064]: https://github.com/rust-lang/rust/pull/37064
614 [37094]: https://github.com/rust-lang/rust/pull/37094
615 [37108]: https://github.com/rust-lang/rust/pull/37108
616 [37111]: https://github.com/rust-lang/rust/pull/37111
617 [37161]: https://github.com/rust-lang/rust/pull/37161
618 [37162]: https://github.com/rust-lang/rust/pull/37162
619 [37167]: https://github.com/rust-lang/rust/pull/37167
620 [37178]: https://github.com/rust-lang/rust/pull/37178
621 [37200]: https://github.com/rust-lang/rust/pull/37200
622 [37213]: https://github.com/rust-lang/rust/pull/37213
623 [37221]: https://github.com/rust-lang/rust/pull/37221
624 [37224]: https://github.com/rust-lang/rust/pull/37224
625 [37230]: https://github.com/rust-lang/rust/pull/37230
626 [37231]: https://github.com/rust-lang/rust/pull/37231
627 [37247]: https://github.com/rust-lang/rust/pull/37247
628 [37267]: https://github.com/rust-lang/rust/pull/37267
629 [37270]: https://github.com/rust-lang/rust/pull/37270
630 [37273]: https://github.com/rust-lang/rust/pull/37273
631 [37280]: https://github.com/rust-lang/rust/pull/37280
632 [37298]: https://github.com/rust-lang/rust/pull/37298
633 [37306]: https://github.com/rust-lang/rust/pull/37306
634 [37310]: https://github.com/rust-lang/rust/pull/37310
635 [37312]: https://github.com/rust-lang/rust/pull/37312
636 [37313]: https://github.com/rust-lang/rust/pull/37313
637 [37315]: https://github.com/rust-lang/rust/pull/37315
638 [37318]: https://github.com/rust-lang/rust/pull/37318
639 [37322]: https://github.com/rust-lang/rust/pull/37322
640 [37326]: https://github.com/rust-lang/rust/pull/37326
641 [37351]: https://github.com/rust-lang/rust/pull/37351
642 [37356]: https://github.com/rust-lang/rust/pull/37356
643 [37367]: https://github.com/rust-lang/rust/pull/37367
644 [37373]: https://github.com/rust-lang/rust/pull/37373
645 [37378]: https://github.com/rust-lang/rust/pull/37378
646 [37389]: https://github.com/rust-lang/rust/pull/37389
647 [37392]: https://github.com/rust-lang/rust/pull/37392
648 [37427]: https://github.com/rust-lang/rust/pull/37427
649 [37439]: https://github.com/rust-lang/rust/pull/37439
650 [37445]: https://github.com/rust-lang/rust/pull/37445
651 [37470]: https://github.com/rust-lang/rust/pull/37470
652 [37569]: https://github.com/rust-lang/rust/pull/37569
653 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
654 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
655 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
656 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
657 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
658 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
659 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
660
661
662 Version 1.13.0 (2016-11-10)
663 ===========================
664
665 Language
666 --------
667
668 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
669   errors, like the `try!` macro, described in [RFC 0243].
670 * [Stabilize macros in type position][36014]. Described in [RFC 873].
671 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
672 * [Fix `#[derive]` for empty tuple structs/variants][35728]
673 * [Fix lifetime rules for 'if' conditions][36029]
674 * [Avoid loading and parsing unconfigured non-inline modules][36482]
675
676 Compiler
677 --------
678
679 * [Add the `-C link-arg` argument][36574]
680 * [Remove the old AST-based backend from rustc_trans][35764]
681 * [Don't enable NEON by default on armv7 Linux][35814]
682 * [Fix debug line number info for macro expansions][35238]
683 * [Do not emit "class method" debuginfo for types that are not
684   DICompositeType][36008]
685 * [Warn about multiple conflicting #[repr] hints][34623]
686 * [When sizing DST, don't double-count nested struct prefixes][36351]
687 * [Default RUST_MIN_STACK to 16MiB for now][36505]
688 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
689 * [Reject macros with empty repetitions to avoid infinite loop][36721]
690 * [Expand macros without recursing to avoid stack overflows][36214]
691
692 Diagnostics
693 -----------
694
695 * [Replace macro backtraces with labeled local uses][35702]
696 * [Improve error message for missplaced doc comments][33922]
697 * [Buffer unix and lock windows to prevent message interleaving][35975]
698 * [Update lifetime errors to specifically note temporaries][36171]
699 * [Special case a few colors for Windows][36178]
700 * [Suggest `use self` when such an import resolves][36289]
701 * [Be more specific when type parameter shadows primitive type][36338]
702 * Many minor improvements
703
704 Compile-time Optimizations
705 --------------------------
706
707 * [Compute and cache HIR hashes at beginning][35854]
708 * [Don't hash types in loan paths][36004]
709 * [Cache projections in trans][35761]
710 * [Optimize the parser's last token handling][36527]
711 * [Only instantiate #[inline] functions in codegen units referencing
712   them][36524]. This leads to big improvements in cases where crates export
713   define many inline functions without using them directly.
714 * [Lazily allocate TypedArena's first chunk][36592]
715 * [Don't allocate during default HashSet creation][36734]
716
717 Stabilized APIs
718 ---------------
719
720 * [`checked_abs`]
721 * [`wrapping_abs`]
722 * [`overflowing_abs`]
723 * [`RefCell::try_borrow`]
724 * [`RefCell::try_borrow_mut`]
725
726 Libraries
727 ---------
728
729 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
730 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
731   covariant][35354]
732 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
733 * [Implement `Debug` for `std::vec::IntoIter`][35707]
734 * [`CString`: avoid excessive growth just to 0-terminate][35871]
735 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
736 * [Use arc4rand on FreeBSD][35884]
737 * [memrchr: Correct aligned offset computation][35969]
738 * [Improve Demangling of Rust Symbols][36059]
739 * [Use monotonic time in condition variables][35048]
740 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
741 * [Implement conversion traits for `char`][35755]
742 * [Fix illegal instruction caused by overflow in channel cloning][36104]
743 * [Zero first byte of CString on drop][36264]
744 * [Inherit overflow checks for sum and product][36372]
745 * [Add missing Eq implementations][36423]
746 * [Implement `Debug` for `DirEntry`][36631]
747 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
748   `errno`][36754]
749 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
750 * [Implement more traits for `std::io::ErrorKind`][35911]
751 * [Optimize BinaryHeap bounds checking][36072]
752 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
753   `extend_with_element`][36355]
754 * [Fix overflow checking in unsigned pow()][34942]
755
756 Cargo
757 -----
758
759 * This release includes security fixes to both curl and OpenSSL.
760 * [Fix transitive doctests when panic=abort][cargo/3021]
761 * [Add --all-features flag to cargo][cargo/3038]
762 * [Reject path-based dependencies in `cargo package`][cargo/3060]
763 * [Don't parse the home directory more than once][cargo/3078]
764 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
765 * [Update OpenSSL to 1.0.2j][cargo/3121]
766 * [Add license and license_file to cargo metadata output][cargo/3110]
767 * [Make crates-io registry URL optional in config; ignore all changes to
768   source.crates-io][cargo/3089]
769 * [Don't download dependencies from other platforms][cargo/3123]
770 * [Build transitive dev-dependencies when needed][cargo/3125]
771 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
772 * [Avoid updating registry when adding existing deps][cargo/3144]
773 * [Warn about path overrides that won't work][cargo/3136]
774 * [Use workspaces during `cargo install`][cargo/3146]
775 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
776 * [Add --message-format flag][cargo/3000]
777 * [Pass target environment for rustdoc][cargo/3205]
778 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
779 * [Update curl and curl-sys][cargo/3241]
780 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
781
782 Tooling
783 -------
784
785 * [rustdoc: Add the `--sysroot` argument][36586]
786 * [rustdoc: Fix a couple of issues with the search results][35655]
787 * [rustdoc: remove the `!` from macro URLs and titles][35234]
788 * [gdb: Fix pretty-printing special-cased Rust types][35585]
789 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
790
791 Misc
792 ----
793
794 * [Remove unmaintained style guide][35124]
795 * [Add s390x support][36369]
796 * [Initial work at Haiku OS support][36727]
797 * [Add mips-uclibc targets][35734]
798 * [Crate-ify compiler-rt into compiler-builtins][35021]
799 * [Add rustc version info (git hash + date) to dist tarball][36213]
800 * Many documentation improvements
801
802 Compatibility Notes
803 -------------------
804
805 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
806 * [Deny (by default) transmuting from fn item types to pointer-sized
807   types][34923]. Continuing the long transition to zero-sized fn items,
808   per [RFC 401].
809 * [Fix `#[derive]` for empty tuple structs/variants][35728].
810   Part of [RFC 1506].
811 * [Issue deprecation warnings for safe accesses to extern statics][36173]
812 * [Fix lifetime rules for 'if' conditions][36029].
813 * [Inherit overflow checks for sum and product][36372].
814 * [Forbid user-defined macros named "macro_rules"][36730].
815
816 [33922]: https://github.com/rust-lang/rust/pull/33922
817 [34623]: https://github.com/rust-lang/rust/pull/34623
818 [34923]: https://github.com/rust-lang/rust/pull/34923
819 [34942]: https://github.com/rust-lang/rust/pull/34942
820 [34982]: https://github.com/rust-lang/rust/pull/34982
821 [35021]: https://github.com/rust-lang/rust/pull/35021
822 [35048]: https://github.com/rust-lang/rust/pull/35048
823 [35074]: https://github.com/rust-lang/rust/pull/35074
824 [35124]: https://github.com/rust-lang/rust/pull/35124
825 [35234]: https://github.com/rust-lang/rust/pull/35234
826 [35238]: https://github.com/rust-lang/rust/pull/35238
827 [35354]: https://github.com/rust-lang/rust/pull/35354
828 [35559]: https://github.com/rust-lang/rust/pull/35559
829 [35585]: https://github.com/rust-lang/rust/pull/35585
830 [35627]: https://github.com/rust-lang/rust/pull/35627
831 [35655]: https://github.com/rust-lang/rust/pull/35655
832 [35702]: https://github.com/rust-lang/rust/pull/35702
833 [35707]: https://github.com/rust-lang/rust/pull/35707
834 [35728]: https://github.com/rust-lang/rust/pull/35728
835 [35734]: https://github.com/rust-lang/rust/pull/35734
836 [35755]: https://github.com/rust-lang/rust/pull/35755
837 [35761]: https://github.com/rust-lang/rust/pull/35761
838 [35764]: https://github.com/rust-lang/rust/pull/35764
839 [35814]: https://github.com/rust-lang/rust/pull/35814
840 [35854]: https://github.com/rust-lang/rust/pull/35854
841 [35871]: https://github.com/rust-lang/rust/pull/35871
842 [35884]: https://github.com/rust-lang/rust/pull/35884
843 [35911]: https://github.com/rust-lang/rust/pull/35911
844 [35969]: https://github.com/rust-lang/rust/pull/35969
845 [35975]: https://github.com/rust-lang/rust/pull/35975
846 [36004]: https://github.com/rust-lang/rust/pull/36004
847 [36008]: https://github.com/rust-lang/rust/pull/36008
848 [36014]: https://github.com/rust-lang/rust/pull/36014
849 [36029]: https://github.com/rust-lang/rust/pull/36029
850 [36059]: https://github.com/rust-lang/rust/pull/36059
851 [36072]: https://github.com/rust-lang/rust/pull/36072
852 [36101]: https://github.com/rust-lang/rust/pull/36101
853 [36104]: https://github.com/rust-lang/rust/pull/36104
854 [36171]: https://github.com/rust-lang/rust/pull/36171
855 [36173]: https://github.com/rust-lang/rust/pull/36173
856 [36178]: https://github.com/rust-lang/rust/pull/36178
857 [36213]: https://github.com/rust-lang/rust/pull/36213
858 [36214]: https://github.com/rust-lang/rust/pull/36214
859 [36264]: https://github.com/rust-lang/rust/pull/36264
860 [36266]: https://github.com/rust-lang/rust/pull/36266
861 [36289]: https://github.com/rust-lang/rust/pull/36289
862 [36338]: https://github.com/rust-lang/rust/pull/36338
863 [36351]: https://github.com/rust-lang/rust/pull/36351
864 [36355]: https://github.com/rust-lang/rust/pull/36355
865 [36369]: https://github.com/rust-lang/rust/pull/36369
866 [36372]: https://github.com/rust-lang/rust/pull/36372
867 [36423]: https://github.com/rust-lang/rust/pull/36423
868 [36482]: https://github.com/rust-lang/rust/pull/36482
869 [36505]: https://github.com/rust-lang/rust/pull/36505
870 [36524]: https://github.com/rust-lang/rust/pull/36524
871 [36527]: https://github.com/rust-lang/rust/pull/36527
872 [36551]: https://github.com/rust-lang/rust/pull/36551
873 [36574]: https://github.com/rust-lang/rust/pull/36574
874 [36586]: https://github.com/rust-lang/rust/pull/36586
875 [36592]: https://github.com/rust-lang/rust/pull/36592
876 [36631]: https://github.com/rust-lang/rust/pull/36631
877 [36639]: https://github.com/rust-lang/rust/pull/36639
878 [36721]: https://github.com/rust-lang/rust/pull/36721
879 [36727]: https://github.com/rust-lang/rust/pull/36727
880 [36730]: https://github.com/rust-lang/rust/pull/36730
881 [36734]: https://github.com/rust-lang/rust/pull/36734
882 [36754]: https://github.com/rust-lang/rust/pull/36754
883 [36995]: https://github.com/rust-lang/rust/pull/36995
884 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
885 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
886 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
887 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
888 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
889 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
890 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
891 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
892 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
893 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
894 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
895 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
896 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
897 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
898 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
899 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
900 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
901 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
902 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
903 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
904 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
905 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
906 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
907 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
908 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
909 [rustup]: https://www.rustup.rs
910 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
911 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
912 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
913 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
914 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
915 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
916 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
917
918
919 Version 1.12.1 (2016-10-20)
920 ===========================
921
922 Regression Fixes
923 ----------------
924
925 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
926 * [Confusion with double negation and booleans][36856]
927 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
928 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
929 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
930 * [Corrupted memory after updated to 1.12][36936]
931 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
932 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
933 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
934
935 [36381]: https://github.com/rust-lang/rust/issues/36381
936 [36856]: https://github.com/rust-lang/rust/issues/36856
937 [36875]: https://github.com/rust-lang/rust/issues/36875
938 [36924]: https://github.com/rust-lang/rust/issues/36924
939 [36926]: https://github.com/rust-lang/rust/issues/36926
940 [36936]: https://github.com/rust-lang/rust/issues/36936
941 [37026]: https://github.com/rust-lang/rust/issues/37026
942 [37112]: https://github.com/rust-lang/rust/issues/37112
943 [37153]: https://github.com/rust-lang/rust/issues/37153
944
945
946 Version 1.12.0 (2016-09-29)
947 ===========================
948
949 Highlights
950 ----------
951
952 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)]
953   (https://github.com/rust-lang/rust/pull/34096).
954   This translation pass is far simpler than the previous AST->LLVM pass, and
955   creates opportunities to perform new optimizations directly on the MIR. It
956   was previously described [on the Rust blog]
957   (https://blog.rust-lang.org/2016/04/19/MIR.html).
958 * [`rustc` presents a new, more readable error format, along with
959   machine-readable JSON error output for use by IDEs]
960   (https://github.com/rust-lang/rust/pull/35401).
961   Most common editors supporting Rust have been updated to work with it. It was
962   previously described [on the Rust blog]
963   (https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
964
965 Compiler
966 --------
967
968 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)]
969   (https://github.com/rust-lang/rust/pull/34096).
970   This translation pass is far simpler than the previous AST->LLVM pass, and
971   creates opportunities to perform new optimizations directly on the MIR. It
972   was previously described [on the Rust blog]
973   (https://blog.rust-lang.org/2016/04/19/MIR.html).
974 * [Print the Rust target name, not the LLVM target name, with
975   `--print target-list`]
976   (https://github.com/rust-lang/rust/pull/35489)
977 * [The computation of `TypeId` is correct in some cases where it was previously
978   producing inconsistent results]
979   (https://github.com/rust-lang/rust/pull/35267)
980 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default]
981   (https://github.com/rust-lang/rust/pull/34910)
982 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
983   `--print relocation-models`, and `--print code-models` print the available
984   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
985   `-C code-model` code generation arguments]
986   (https://github.com/rust-lang/rust/pull/34845)
987 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
988   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`]
989   (https://github.com/rust-lang/rust/pull/35060).
990   These targets produce statically-linked binaries. There are no binary release
991   builds yet though.
992
993 Diagnostics
994 -----------
995
996 * [`rustc` presents a new, more readable error format, along with
997   machine-readable JSON error output for use by IDEs]
998   (https://github.com/rust-lang/rust/pull/35401).
999   Most common editors supporting Rust have been updated to work with it. It was
1000   previously described [on the Rust blog]
1001   (https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
1002 * [In error descriptions, references are now described in plain English,
1003   instead of as "&-ptr"]
1004   (https://github.com/rust-lang/rust/pull/35611)
1005 * [In error type descriptions, unknown numeric types are named `{integer}` or
1006   `{float}` instead of `_`]
1007   (https://github.com/rust-lang/rust/pull/35080)
1008 * [`rustc` emits a clearer error when inner attributes follow a doc comment]
1009   (https://github.com/rust-lang/rust/pull/34676)
1010
1011 Language
1012 --------
1013
1014 * [`macro_rules!` invocations can be made within `macro_rules!` invocations]
1015   (https://github.com/rust-lang/rust/pull/34925)
1016 * [`macro_rules!` meta-variables are hygienic]
1017   (https://github.com/rust-lang/rust/pull/35453)
1018 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
1019   useful]
1020   (https://github.com/rust-lang/rust/pull/34908)
1021 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
1022   inside non-braces invocations]
1023   (https://github.com/rust-lang/rust/pull/34886)
1024 * [Semicolons are properly required as statement delimeters inside
1025   `macro_rules!` invocations]
1026   (https://github.com/rust-lang/rust/pull/34660)
1027 * [`cfg_attr` works on `path` attributes]
1028   (https://github.com/rust-lang/rust/pull/34546)
1029
1030 Stabilized APIs
1031 ---------------
1032
1033 * [`Cell::as_ptr`]
1034   (https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
1035 * [`RefCell::as_ptr`]
1036   (https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
1037 * [`IpAddr::is_unspecified`]
1038   (https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
1039 * [`IpAddr::is_loopback`]
1040   (https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
1041 * [`IpAddr::is_multicast`]
1042   (https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
1043 * [`Ipv4Addr::is_unspecified`]
1044   (https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
1045 * [`Ipv6Addr::octets`]
1046   (https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
1047 * [`LinkedList::contains`]
1048   (https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
1049 * [`VecDeque::contains`]
1050   (https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
1051 * [`ExitStatusExt::from_raw`]
1052   (https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
1053   Both on Unix and Windows.
1054 * [`Receiver::recv_timeout`]
1055   (https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
1056 * [`RecvTimeoutError`]
1057   (https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
1058 * [`BinaryHeap::peek_mut`]
1059   (https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
1060 * [`PeekMut`]
1061   (https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
1062 * [`iter::Product`]
1063   (https://doc.rust-lang.org/std/iter/trait.Product.html)
1064 * [`iter::Sum`]
1065   (https://doc.rust-lang.org/std/iter/trait.Sum.html)
1066 * [`OccupiedEntry::remove_entry`]
1067   (https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
1068 * [`VacantEntry::into_key`]
1069   (https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
1070
1071 Libraries
1072 ---------
1073
1074 * [The `format!` macro and friends now allow a single argument to be formatted
1075   in multiple styles]
1076   (https://github.com/rust-lang/rust/pull/33642)
1077 * [The lifetime bounds on `[T]::binary_search_by` and
1078   `[T]::binary_search_by_key` have been adjusted to be more flexible]
1079   (https://github.com/rust-lang/rust/pull/34762)
1080 * [`Option` implements `From` for its contained type]
1081   (https://github.com/rust-lang/rust/pull/34828)
1082 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type]
1083   (https://github.com/rust-lang/rust/pull/35392)
1084 * [`RwLock` panics if the reader count overflows]
1085   (https://github.com/rust-lang/rust/pull/35378)
1086 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant]
1087   (https://github.com/rust-lang/rust/pull/35354)
1088 * [`vec::Drain` and `binary_heap::Drain` are covariant]
1089   (https://github.com/rust-lang/rust/pull/34951)
1090 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`]
1091   (https://github.com/rust-lang/rust/pull/35064)
1092 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`]
1093   (https://github.com/rust-lang/rust/pull/34946)
1094 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
1095   implement `Debug`]
1096   (https://github.com/rust-lang/rust/pull/34937)
1097 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
1098   implement `Debug`]
1099   (https://github.com/rust-lang/rust/pull/34885)
1100 * [`String` implements `AddAssign`]
1101   (https://github.com/rust-lang/rust/pull/34890)
1102 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
1103   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits]
1104   (https://github.com/rust-lang/rust/pull/34879)
1105 * [`FileType` implements `Debug`]
1106   (https://github.com/rust-lang/rust/pull/34757)
1107 * [References to `Mutex` and `RwLock` are unwind-safe]
1108   (https://github.com/rust-lang/rust/pull/34756)
1109 * [`mpsc::sync_channel` `Receiver`s return any available message before
1110   reporting a disconnect]
1111   (https://github.com/rust-lang/rust/pull/34731)
1112 * [Unicode definitions have been updated to 9.0]
1113   (https://github.com/rust-lang/rust/pull/34599)
1114 * [`env` iterators implement `DoubleEndedIterator`]
1115   (https://github.com/rust-lang/rust/pull/33312)
1116
1117 Cargo
1118 -----
1119
1120 * [Support local mirrors of registries]
1121   (https://github.com/rust-lang/cargo/pull/2857)
1122 * [Add support for command aliases]
1123   (https://github.com/rust-lang/cargo/pull/2679)
1124 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides]
1125   (https://github.com/rust-lang/cargo/pull/3007)
1126 * [Make `cargo doc --open --target` work as expected]
1127   (https://github.com/rust-lang/cargo/pull/2988)
1128 * [Speed up noop registry updates]
1129   (https://github.com/rust-lang/cargo/pull/2974)
1130 * [Update OpenSSL]
1131   (https://github.com/rust-lang/cargo/pull/2971)
1132 * [Fix `--panic=abort` with plugins]
1133   (https://github.com/rust-lang/cargo/pull/2954)
1134 * [Always pass `-C metadata` to the compiler]
1135   (https://github.com/rust-lang/cargo/pull/2946)
1136 * [Fix depending on git repos with workspaces]
1137   (https://github.com/rust-lang/cargo/pull/2938)
1138 * [Add a `--lib` flag to `cargo new`]
1139   (https://github.com/rust-lang/cargo/pull/2921)
1140 * [Add `http.cainfo` for custom certs]
1141   (https://github.com/rust-lang/cargo/pull/2917)
1142 * [Indicate the compilation profile after compiling]
1143   (https://github.com/rust-lang/cargo/pull/2909)
1144 * [Allow enabling features for dependencies with `--features`]
1145   (https://github.com/rust-lang/cargo/pull/2876)
1146 * [Add `--jobs` flag to `cargo package`]
1147   (https://github.com/rust-lang/cargo/pull/2867)
1148 * [Add `--dry-run` to `cargo publish`]
1149   (https://github.com/rust-lang/cargo/pull/2849)
1150 * [Add support for `RUSTDOCFLAGS`]
1151   (https://github.com/rust-lang/cargo/pull/2794)
1152
1153 Performance
1154 -----------
1155
1156 * [`panic::catch_unwind` is more optimized]
1157   (https://github.com/rust-lang/rust/pull/35444)
1158 * [`panic::catch_unwind` no longer accesses thread-local storage on entry]
1159   (https://github.com/rust-lang/rust/pull/34866)
1160
1161 Tooling
1162 -------
1163
1164 * [Test binaries now support a `--test-threads` argument to specify the number
1165   of threads used to run tests, and which acts the same as the
1166   `RUST_TEST_THREADS` environment variable]
1167   (https://github.com/rust-lang/rust/pull/35414)  
1168 * [The test runner now emits a warning when tests run over 60 seconds]
1169   (https://github.com/rust-lang/rust/pull/35405)
1170 * [rustdoc: Fix methods in search results]
1171   (https://github.com/rust-lang/rust/pull/34752)
1172 * [`rust-lldb` warns about unsupported versions of LLDB]
1173   (https://github.com/rust-lang/rust/pull/34646)
1174 * [Rust releases now come with source packages that can be installed by rustup
1175   via `rustup component add rust-src`]
1176   (https://github.com/rust-lang/rust/pull/34366).
1177   The resulting source code can be used by tools and IDES, located in the
1178   sysroot under `lib/rustlib/src`.
1179
1180 Misc
1181 ----
1182
1183 * [The compiler can now be built against LLVM 3.9]
1184   (https://github.com/rust-lang/rust/pull/35594)
1185 * Many minor improvements to the documentation.
1186 * [The Rust exception handling "personality" routine is now written in Rust]
1187   (https://github.com/rust-lang/rust/pull/34832)
1188
1189 Compatibility Notes
1190 -------------------
1191
1192 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
1193   with the lowercase format instead of the uppercase]
1194   (https://github.com/rust-lang/rust/pull/35084)
1195 * [When formatting strings, if "precision" is specified, the "fill",
1196   "align" and "width" specifiers are no longer ignored]
1197   (https://github.com/rust-lang/rust/pull/34544)
1198 * [The `Debug` impl for strings no longer escapes all non-ASCII characters]
1199   (https://github.com/rust-lang/rust/pull/34485)
1200
1201
1202 Version 1.11.0 (2016-08-18)
1203 ===========================
1204
1205 Language
1206 --------
1207
1208 * [`cfg_attr` works on `path` attributes]
1209   (https://github.com/rust-lang/rust/pull/34546)
1210 * [Support nested `cfg_attr` attributes]
1211   (https://github.com/rust-lang/rust/pull/34216)
1212 * [Allow statement-generating braced macro invocations at the end of blocks]
1213   (https://github.com/rust-lang/rust/pull/34436)
1214 * [Macros can be expanded inside of trait definitions]
1215   (https://github.com/rust-lang/rust/pull/34213)
1216 * [`#[macro_use]` works properly when it is itself expanded from a macro]
1217   (https://github.com/rust-lang/rust/pull/34032)
1218
1219 Stabilized APIs
1220 ---------------
1221
1222 * [`BinaryHeap::append`]
1223   (https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
1224 * [`BTreeMap::append`]
1225   (https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
1226 * [`BTreeMap::split_off`]
1227   (https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
1228 * [`BTreeSet::append`]
1229   (https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
1230 * [`BTreeSet::split_off`]
1231   (https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
1232 * [`f32::to_degrees`]
1233   (https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
1234   (in libcore - previously stabilized in libstd)
1235 * [`f32::to_radians`]
1236   (https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
1237   (in libcore - previously stabilized in libstd)
1238 * [`f64::to_degrees`]
1239   (https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
1240   (in libcore - previously stabilized in libstd)
1241 * [`f64::to_radians`]
1242   (https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
1243   (in libcore - previously stabilized in libstd)
1244 * [`Iterator::sum`]
1245   (https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
1246 * [`Iterator::product`]
1247   (https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
1248 * [`Cell::get_mut`]
1249   (https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
1250 * [`RefCell::get_mut`]
1251   (https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
1252
1253 Libraries
1254 ---------
1255
1256 * [The `thread_local!` macro supports multiple definitions in a single
1257    invocation, and can apply attributes]
1258   (https://github.com/rust-lang/rust/pull/34077)
1259 * [`Cow` implements `Default`]
1260   (https://github.com/rust-lang/rust/pull/34305)
1261 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
1262   `Display` formatting]
1263   (https://github.com/rust-lang/rust/pull/34190)
1264 * [The range types implement `Hash`]
1265   (https://github.com/rust-lang/rust/pull/34180)
1266 * [`lookup_host` ignores unknown address types]
1267   (https://github.com/rust-lang/rust/pull/34067)
1268 * [`assert_eq!` accepts a custom error message, like `assert!` does]
1269   (https://github.com/rust-lang/rust/pull/33976)
1270 * [The main thread is now called "main" instead of "&lt;main&gt;"]
1271   (https://github.com/rust-lang/rust/pull/33803)
1272
1273 Cargo
1274 -----
1275
1276 * [Disallow specifying features of transitive deps]
1277   (https://github.com/rust-lang/cargo/pull/2821)
1278 * [Add color support for Windows consoles]
1279   (https://github.com/rust-lang/cargo/pull/2804)
1280 * [Fix `harness = false` on `[lib]` sections]
1281   (https://github.com/rust-lang/cargo/pull/2795)
1282 * [Don't panic when `links` contains a '.']
1283   (https://github.com/rust-lang/cargo/pull/2787)
1284 * [Build scripts can emit warnings]
1285   (https://github.com/rust-lang/cargo/pull/2630),
1286   and `-vv` prints warnings for all crates.
1287 * [Ignore file locks on OS X NFS mounts]
1288   (https://github.com/rust-lang/cargo/pull/2720)
1289 * [Don't warn about `package.metadata` keys]
1290   (https://github.com/rust-lang/cargo/pull/2668).
1291   This provides room for expansion by arbitrary tools.
1292 * [Add support for cdylib crate types]
1293   (https://github.com/rust-lang/cargo/pull/2741)
1294 * [Prevent publishing crates when files are dirty]
1295   (https://github.com/rust-lang/cargo/pull/2781)
1296 * [Don't fetch all crates on clean]
1297   (https://github.com/rust-lang/cargo/pull/2704)
1298 * [Propagate --color option to rustc]
1299   (https://github.com/rust-lang/cargo/pull/2779)
1300 * [Fix `cargo doc --open` on Windows]
1301   (https://github.com/rust-lang/cargo/pull/2780)
1302 * [Improve autocompletion]
1303   (https://github.com/rust-lang/cargo/pull/2772)
1304 * [Configure colors of stderr as well as stdout]
1305   (https://github.com/rust-lang/cargo/pull/2739)
1306
1307 Performance
1308 -----------
1309
1310 * [Caching projections speeds up type check dramatically for some
1311   workloads]
1312   (https://github.com/rust-lang/rust/pull/33816)
1313 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4]
1314   (https://github.com/rust-lang/rust/pull/33940)
1315   This hasher is faster, but is believed to provide sufficient
1316   protection from collision attacks.
1317 * [Comparison of `Ipv4Addr` is 10x faster]
1318   (https://github.com/rust-lang/rust/pull/33891)
1319
1320 Rustdoc
1321 -------
1322
1323 * [Fix empty implementation section on some module pages]
1324   (https://github.com/rust-lang/rust/pull/34536)
1325 * [Fix inlined renamed reexports in import lists]
1326   (https://github.com/rust-lang/rust/pull/34479)
1327 * [Fix search result layout for enum variants and struct fields]
1328   (https://github.com/rust-lang/rust/pull/34477)
1329 * [Fix issues with source links to external crates]
1330   (https://github.com/rust-lang/rust/pull/34387)
1331 * [Fix redirect pages for renamed reexports]
1332   (https://github.com/rust-lang/rust/pull/34245)
1333
1334 Tooling
1335 -------
1336
1337 * [rustc is better at finding the MSVC toolchain]
1338   (https://github.com/rust-lang/rust/pull/34492)
1339 * [When emitting debug info, rustc emits frame pointers for closures,
1340   shims and glue, as it does for all other functions]
1341   (https://github.com/rust-lang/rust/pull/33909)
1342 * [rust-lldb warns about unsupported versions of LLDB]
1343   (https://github.com/rust-lang/rust/pull/34646)
1344 * Many more errors have been given error codes and extended
1345   explanations
1346 * API documentation continues to be improved, with many new examples
1347
1348 Misc
1349 ----
1350
1351 * [rustc no longer hangs when dependencies recursively re-export
1352   submodules]
1353   (https://github.com/rust-lang/rust/pull/34542)
1354 * [rustc requires LLVM 3.7+]
1355   (https://github.com/rust-lang/rust/pull/34104)
1356 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
1357   rewritten]
1358   (https://github.com/rust-lang/rust/pull/33895)
1359 * [rustc support 16-bit pointer sizes]
1360   (https://github.com/rust-lang/rust/pull/33460).
1361   No targets use this yet, but it works toward AVR support.
1362
1363 Compatibility Notes
1364 -------------------
1365
1366 * [`const`s and `static`s may not have unsized types]
1367   (https://github.com/rust-lang/rust/pull/34443)
1368 * [The new follow-set rules that place restrictions on `macro_rules!`
1369   in order to ensure syntax forward-compatibility have been enabled]
1370   (https://github.com/rust-lang/rust/pull/33982)
1371   This was an [ammendment to RFC 550]
1372   (https://github.com/rust-lang/rfcs/pull/1384),
1373   and has been a warning since 1.10.
1374 * [`cfg` attribute process has been refactored to fix various bugs]
1375   (https://github.com/rust-lang/rust/pull/33706).
1376   This causes breakage in some corner cases.
1377
1378
1379 Version 1.10.0 (2016-07-07)
1380 ===========================
1381
1382 Language
1383 --------
1384
1385 * [Allow `concat_idents!` in type positions as well as in expression
1386   positions]
1387   (https://github.com/rust-lang/rust/pull/33735).
1388 * [`Copy` types are required to have a trivial implementation of `Clone`]
1389   (https://github.com/rust-lang/rust/pull/33420).
1390   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
1391 * [Single-variant enums support the `#[repr(..)]` attribute]
1392   (https://github.com/rust-lang/rust/pull/33355).
1393 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods]
1394   (https://github.com/rust-lang/rust/pull/32908).
1395 * [`panic!` can be converted to a runtime abort with the
1396   `-C panic=abort` flag]
1397   (https://github.com/rust-lang/rust/pull/32900).
1398   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
1399 * [Add a new crate type, 'cdylib']
1400   (https://github.com/rust-lang/rust/pull/33553).
1401   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
1402   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-rdylib.md).
1403   Note that Cargo does not yet directly support cdylibs.
1404
1405 Stabilized APIs
1406 ---------------
1407
1408 * `os::windows::fs::OpenOptionsExt::access_mode`
1409 * `os::windows::fs::OpenOptionsExt::share_mode`
1410 * `os::windows::fs::OpenOptionsExt::custom_flags`
1411 * `os::windows::fs::OpenOptionsExt::attributes`
1412 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
1413 * `os::unix::fs::OpenOptionsExt::custom_flags`
1414 * [`sync::Weak::new`]
1415   (http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
1416 * `Default for sync::Weak`
1417 * [`panic::set_hook`]
1418   (http://doc.rust-lang.org/std/panic/fn.set_hook.html)
1419 * [`panic::take_hook`]
1420   (http://doc.rust-lang.org/std/panic/fn.take_hook.html)
1421 * [`panic::PanicInfo`]
1422   (http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
1423 * [`panic::PanicInfo::payload`]
1424   (http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
1425 * [`panic::PanicInfo::location`]
1426   (http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
1427 * [`panic::Location`]
1428   (http://doc.rust-lang.org/std/panic/struct.Location.html)
1429 * [`panic::Location::file`]
1430   (http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
1431 * [`panic::Location::line`]
1432   (http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
1433 * [`ffi::CStr::from_bytes_with_nul`]
1434   (http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
1435 * [`ffi::CStr::from_bytes_with_nul_unchecked`]
1436   (http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
1437 * [`ffi::FromBytesWithNulError`]
1438   (http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
1439 * [`fs::Metadata::modified`]
1440   (http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
1441 * [`fs::Metadata::accessed`]
1442   (http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
1443 * [`fs::Metadata::created`]
1444   (http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
1445 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
1446 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
1447 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
1448 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
1449 * [`SocketAddr::is_unnamed`]
1450   (http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
1451 * [`SocketAddr::as_pathname`]
1452   (http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
1453 * [`UnixStream::connect`]
1454   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
1455 * [`UnixStream::pair`]
1456   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
1457 * [`UnixStream::try_clone`]
1458   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
1459 * [`UnixStream::local_addr`]
1460   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
1461 * [`UnixStream::peer_addr`]
1462   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
1463 * [`UnixStream::set_read_timeout`]
1464   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
1465 * [`UnixStream::set_write_timeout`]
1466   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
1467 * [`UnixStream::read_timeout`]
1468   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
1469 * [`UnixStream::write_timeout`]
1470   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
1471 * [`UnixStream::set_nonblocking`]
1472   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
1473 * [`UnixStream::take_error`]
1474   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
1475 * [`UnixStream::shutdown`]
1476   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
1477 * Read/Write/RawFd impls for `UnixStream`
1478 * [`UnixListener::bind`]
1479   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
1480 * [`UnixListener::accept`]
1481   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
1482 * [`UnixListener::try_clone`]
1483   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
1484 * [`UnixListener::local_addr`]
1485   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
1486 * [`UnixListener::set_nonblocking`]
1487   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
1488 * [`UnixListener::take_error`]
1489   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
1490 * [`UnixListener::incoming`]
1491   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
1492 * RawFd impls for `UnixListener`
1493 * [`UnixDatagram::bind`]
1494   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
1495 * [`UnixDatagram::unbound`]
1496   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
1497 * [`UnixDatagram::pair`]
1498   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
1499 * [`UnixDatagram::connect`]
1500   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
1501 * [`UnixDatagram::try_clone`]
1502   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
1503 * [`UnixDatagram::local_addr`]
1504   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
1505 * [`UnixDatagram::peer_addr`]
1506   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
1507 * [`UnixDatagram::recv_from`]
1508   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
1509 * [`UnixDatagram::recv`]
1510   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
1511 * [`UnixDatagram::send_to`]
1512   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
1513 * [`UnixDatagram::send`]
1514   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
1515 * [`UnixDatagram::set_read_timeout`]
1516   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
1517 * [`UnixDatagram::set_write_timeout`]
1518   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
1519 * [`UnixDatagram::read_timeout`]
1520   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
1521 * [`UnixDatagram::write_timeout`]
1522   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
1523 * [`UnixDatagram::set_nonblocking`]
1524   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
1525 * [`UnixDatagram::take_error`]
1526   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
1527 * [`UnixDatagram::shutdown`]
1528   (http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
1529 * RawFd impls for `UnixDatagram`
1530 * `{BTree,Hash}Map::values_mut`
1531 * [`<[_]>::binary_search_by_key`]
1532   (http://doc.rust-lang.org/beta/std/primitive.slice.html#method.binary_search_by_key)
1533
1534 Libraries
1535 ---------
1536
1537 * [The `abs_sub` method of floats is deprecated]
1538   (https://github.com/rust-lang/rust/pull/33664).
1539   The semantics of this minor method are subtle and probably not what
1540   most people want.
1541 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord]
1542   (https://github.com/rust-lang/rust/pull/33306).
1543 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
1544   will fall back to `/dev/urandom` temporarily to avoid blocking
1545   during early boot]
1546   (https://github.com/rust-lang/rust/pull/33086).
1547 * [Implemented negation for wrapping numerals]
1548   (https://github.com/rust-lang/rust/pull/33067).
1549 * [Implement `Clone` for `binary_heap::IntoIter`]
1550   (https://github.com/rust-lang/rust/pull/33050).
1551 * [Implement `Display` and `Hash` for `std::num::Wrapping`]
1552   (https://github.com/rust-lang/rust/pull/33023).
1553 * [Add `Default` implementation for `&CStr`, `CString`]
1554   (https://github.com/rust-lang/rust/pull/32990).
1555 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`]
1556   (https://github.com/rust-lang/rust/pull/32866).
1557 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
1558   `Mutex`, `RwLock`]
1559   (https://github.com/rust-lang/rust/pull/32785).
1560
1561 Cargo
1562 -----
1563 * [Cargo.toml supports the `profile.*.panic` option]
1564   (https://github.com/rust-lang/cargo/pull/2687).
1565   This controls the runtime behavior of the `panic!` macro
1566   and can be either "unwind" (the default), or "abort".
1567   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
1568 * [Don't throw away errors with `-p` arguments]
1569   (https://github.com/rust-lang/cargo/pull/2723).
1570 * [Report status to stderr instead of stdout]
1571   (https://github.com/rust-lang/cargo/pull/2693).
1572 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
1573   variable that corresponds to the `links` field of the manifest]
1574   (https://github.com/rust-lang/cargo/pull/2710).
1575 * [Ban keywords from crate names]
1576   (https://github.com/rust-lang/cargo/pull/2707).
1577 * [Canonicalize `CARGO_HOME` on Windows]
1578   (https://github.com/rust-lang/cargo/pull/2604).
1579 * [Retry network requests]
1580   (https://github.com/rust-lang/cargo/pull/2396).
1581   By default they are retried twice, which can be customized with the
1582   `net.retry` value in `.cargo/config`.
1583 * [Don't print extra error info for failing subcommands]
1584   (https://github.com/rust-lang/cargo/pull/2674).
1585 * [Add `--force` flag to `cargo install`]
1586   (https://github.com/rust-lang/cargo/pull/2405).
1587 * [Don't use `flock` on NFS mounts]
1588   (https://github.com/rust-lang/cargo/pull/2623).
1589 * [Prefer building `cargo install` artifacts in temporary directories]
1590   (https://github.com/rust-lang/cargo/pull/2610).
1591   Makes it possible to install multiple crates in parallel.
1592 * [Add `cargo test --doc`]
1593   (https://github.com/rust-lang/cargo/pull/2578).
1594 * [Add `cargo --explain`]
1595   (https://github.com/rust-lang/cargo/pull/2551).
1596 * [Don't print warnings when `-q` is passed]
1597   (https://github.com/rust-lang/cargo/pull/2576).
1598 * [Add `cargo doc --lib` and `--bin`]
1599   (https://github.com/rust-lang/cargo/pull/2577).
1600 * [Don't require build script output to be UTF-8]
1601   (https://github.com/rust-lang/cargo/pull/2560).
1602 * [Correctly attempt multiple git usernames]
1603   (https://github.com/rust-lang/cargo/pull/2584).
1604
1605 Performance
1606 -----------
1607
1608 * [rustc memory usage was reduced by refactoring the context used for
1609   type checking]
1610   (https://github.com/rust-lang/rust/pull/33425).
1611 * [Speed up creation of `HashMap`s by caching the random keys used
1612   to initialize the hash state]
1613   (https://github.com/rust-lang/rust/pull/33318).
1614 * [The `find` implementation for `Chain` iterators is 2x faster]
1615   (https://github.com/rust-lang/rust/pull/33289).
1616 * [Trait selection optimizations speed up type checking by 15%]
1617   (https://github.com/rust-lang/rust/pull/33138).
1618 * [Efficient trie lookup for boolean Unicode properties]
1619   (https://github.com/rust-lang/rust/pull/33098).
1620   10x faster than the previous lookup tables.
1621 * [Special case `#[derive(Copy, Clone)]` to avoid bloat]
1622   (https://github.com/rust-lang/rust/pull/31414).
1623
1624 Usability
1625 ---------
1626
1627 * Many incremental improvements to documentation and rustdoc.
1628 * [rustdoc: List blanket trait impls]
1629   (https://github.com/rust-lang/rust/pull/33514).
1630 * [rustdoc: Clean up ABI rendering]
1631   (https://github.com/rust-lang/rust/pull/33151).
1632 * [Indexing with the wrong type produces a more informative error]
1633   (https://github.com/rust-lang/rust/pull/33401).
1634 * [Improve diagnostics for constants being used in irrefutable patterns]
1635   (https://github.com/rust-lang/rust/pull/33406).
1636 * [When many method candidates are in scope limit the suggestions to 10]
1637   (https://github.com/rust-lang/rust/pull/33338).
1638 * [Remove confusing suggestion when calling a `fn` type]
1639   (https://github.com/rust-lang/rust/pull/33325).
1640 * [Do not suggest changing `&mut self` to `&mut mut self`]
1641   (https://github.com/rust-lang/rust/pull/33319).
1642
1643 Misc
1644 ----
1645
1646 * [Update i686-linux-android features to match Android ABI]
1647   (https://github.com/rust-lang/rust/pull/33651).
1648 * [Update aarch64-linux-android features to match Android ABI]
1649   (https://github.com/rust-lang/rust/pull/33500).
1650 * [`std` no longer prints backtraces on platforms where the running
1651   module must be loaded with `env::current_exe`, which can't be relied
1652   on](https://github.com/rust-lang/rust/pull/33554).
1653 * This release includes std binaries for the i586-unknown-linux-gnu,
1654   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
1655   i586 target is for old x86 hardware without SSE2, and the armv7
1656   target is for Android running on modern ARM architectures.
1657 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
1658   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
1659 * [On Unix the runtime aborts by calling `libc::abort` instead of
1660   generating an illegal instruction]
1661   (https://github.com/rust-lang/rust/pull/31457).
1662 * [Rust is now bootstrapped from the previous release of Rust,
1663   instead of a snapshot from an arbitrary commit]
1664   (https://github.com/rust-lang/rust/pull/32942).
1665
1666 Compatibility Notes
1667 -------------------
1668
1669 * [`AtomicBool` is now bool-sized, not word-sized]
1670   (https://github.com/rust-lang/rust/pull/33579).
1671 * [`target_env` for Linux ARM targets is just `gnu`, not
1672   `gnueabihf`, `gnueabi`, etc]
1673   (https://github.com/rust-lang/rust/pull/33403).
1674 * [Consistently panic on overflow in `Duration::new`]
1675   (https://github.com/rust-lang/rust/pull/33072).
1676 * [Change `String::truncate` to panic less]
1677   (https://github.com/rust-lang/rust/pull/32977).
1678 * [Add `:block` to the follow set for `:ty` and `:path`]
1679   (https://github.com/rust-lang/rust/pull/32945).
1680   Affects how macros are parsed.
1681 * [Fix macro hygiene bug]
1682   (https://github.com/rust-lang/rust/pull/32923).
1683 * [Feature-gated attributes on macro-generated macro invocations are
1684   now rejected]
1685   (https://github.com/rust-lang/rust/pull/32791).
1686 * [Suppress fallback and ambiguity errors during type inference]
1687   (https://github.com/rust-lang/rust/pull/32258).
1688   This caused some minor changes to type inference.
1689
1690
1691 Version 1.9.0 (2016-05-26)
1692 ==========================
1693
1694 Language
1695 --------
1696
1697 * The `#[deprecated]` attribute when applied to an API will generate
1698   warnings when used. The warnings may be suppressed with
1699   `#[allow(deprecated)]`. [RFC 1270].
1700 * [`fn` item types are zero sized, and each `fn` names a unique
1701   type][1.9fn]. This will break code that transmutes `fn`s, so calling
1702   `transmute` on a `fn` type will generate a warning for a few cycles,
1703   then will be converted to an error.
1704 * [Field and method resolution understand visibility, so private
1705   fields and methods cannot prevent the proper use of public fields
1706   and methods][1.9fv].
1707 * [The parser considers unicode codepoints in the
1708   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
1709
1710 Stabilized APIs
1711 ---------------
1712
1713 * [`std::panic`]
1714 * [`std::panic::catch_unwind`][] (renamed from `recover`)
1715 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
1716 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
1717 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
1718 * [`str::is_char_boundary`]
1719 * [`<*const T>::as_ref`]
1720 * [`<*mut T>::as_ref`]
1721 * [`<*mut T>::as_mut`]
1722 * [`AsciiExt::make_ascii_uppercase`]
1723 * [`AsciiExt::make_ascii_lowercase`]
1724 * [`char::decode_utf16`]
1725 * [`char::DecodeUtf16`]
1726 * [`char::DecodeUtf16Error`]
1727 * [`char::DecodeUtf16Error::unpaired_surrogate`]
1728 * [`BTreeSet::take`]
1729 * [`BTreeSet::replace`]
1730 * [`BTreeSet::get`]
1731 * [`HashSet::take`]
1732 * [`HashSet::replace`]
1733 * [`HashSet::get`]
1734 * [`OsString::with_capacity`]
1735 * [`OsString::clear`]
1736 * [`OsString::capacity`]
1737 * [`OsString::reserve`]
1738 * [`OsString::reserve_exact`]
1739 * [`OsStr::is_empty`]
1740 * [`OsStr::len`]
1741 * [`std::os::unix::thread`]
1742 * [`RawPthread`]
1743 * [`JoinHandleExt`]
1744 * [`JoinHandleExt::as_pthread_t`]
1745 * [`JoinHandleExt::into_pthread_t`]
1746 * [`HashSet::hasher`]
1747 * [`HashMap::hasher`]
1748 * [`CommandExt::exec`]
1749 * [`File::try_clone`]
1750 * [`SocketAddr::set_ip`]
1751 * [`SocketAddr::set_port`]
1752 * [`SocketAddrV4::set_ip`]
1753 * [`SocketAddrV4::set_port`]
1754 * [`SocketAddrV6::set_ip`]
1755 * [`SocketAddrV6::set_port`]
1756 * [`SocketAddrV6::set_flowinfo`]
1757 * [`SocketAddrV6::set_scope_id`]
1758 * [`slice::copy_from_slice`]
1759 * [`ptr::read_volatile`]
1760 * [`ptr::write_volatile`]
1761 * [`OpenOptions::create_new`]
1762 * [`TcpStream::set_nodelay`]
1763 * [`TcpStream::nodelay`]
1764 * [`TcpStream::set_ttl`]
1765 * [`TcpStream::ttl`]
1766 * [`TcpStream::set_only_v6`]
1767 * [`TcpStream::only_v6`]
1768 * [`TcpStream::take_error`]
1769 * [`TcpStream::set_nonblocking`]
1770 * [`TcpListener::set_ttl`]
1771 * [`TcpListener::ttl`]
1772 * [`TcpListener::set_only_v6`]
1773 * [`TcpListener::only_v6`]
1774 * [`TcpListener::take_error`]
1775 * [`TcpListener::set_nonblocking`]
1776 * [`UdpSocket::set_broadcast`]
1777 * [`UdpSocket::broadcast`]
1778 * [`UdpSocket::set_multicast_loop_v4`]
1779 * [`UdpSocket::multicast_loop_v4`]
1780 * [`UdpSocket::set_multicast_ttl_v4`]
1781 * [`UdpSocket::multicast_ttl_v4`]
1782 * [`UdpSocket::set_multicast_loop_v6`]
1783 * [`UdpSocket::multicast_loop_v6`]
1784 * [`UdpSocket::set_multicast_ttl_v6`]
1785 * [`UdpSocket::multicast_ttl_v6`]
1786 * [`UdpSocket::set_ttl`]
1787 * [`UdpSocket::ttl`]
1788 * [`UdpSocket::set_only_v6`]
1789 * [`UdpSocket::only_v6`]
1790 * [`UdpSocket::join_multicast_v4`]
1791 * [`UdpSocket::join_multicast_v6`]
1792 * [`UdpSocket::leave_multicast_v4`]
1793 * [`UdpSocket::leave_multicast_v6`]
1794 * [`UdpSocket::take_error`]
1795 * [`UdpSocket::connect`]
1796 * [`UdpSocket::send`]
1797 * [`UdpSocket::recv`]
1798 * [`UdpSocket::set_nonblocking`]
1799
1800 Libraries
1801 ---------
1802
1803 * [`std::sync::Once` is poisoned if its initialization function
1804   fails][1.9o].
1805 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
1806 * [Most types implement `fmt::Debug`][1.9db].
1807 * [The default buffer size used by `BufReader` and `BufWriter` was
1808   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
1809   used by other languages.
1810 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
1811   `Duration` additionally implements `*=` and `/=`][1.9ta].
1812 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
1813 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
1814 * [`Chain` implements `BufRead`][1.9ch].
1815 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
1816
1817 Cargo
1818 -----
1819
1820 * [Cargo can now run concurrently][1.9cc].
1821 * [Top-level overrides allow specific revisions of crates to be
1822   overridden through the entire crate graph][1.9ct].  This is intended
1823   to make upgrades easier for large projects, by allowing crates to be
1824   forked temporarily until they've been upgraded and republished.
1825 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
1826 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
1827   on the commandline][1.9cf]. `rustc` arguments can also be specified
1828   in the `build.rustflags` configuration key.
1829
1830 Performance
1831 -----------
1832
1833 * [The time complexity of comparing variables for equivalence during type
1834   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
1835   to major compilation time improvement in some scenarios.
1836 * [`ToString` is specialized for `str`, giving it the same performance
1837   as `to_owned`][1.9ts].
1838 * [Spawning processes with `Command::output` no longer creates extra
1839   threads][1.9sp].
1840 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
1841   for C-like enums][1.9cl].
1842
1843 Misc
1844 ----
1845
1846 * [Passing the `--quiet` flag to a test runner will produce
1847   much-abbreviated output][1.9q].
1848 * The Rust Project now publishes std binaries for the
1849   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
1850   `i586-pc-windows-msvc` targets.
1851
1852 Compatibility Notes
1853 -------------------
1854
1855 * [`std::sync::Once` is poisoned if its initialization function
1856   fails][1.9o].
1857 * [It is illegal to define methods with the same name in overlapping
1858   inherent `impl` blocks][1.9sn].
1859 * [`fn` item types are zero sized, and each `fn` names a unique
1860   type][1.9fn]. This will break code that transmutes `fn`s, so calling
1861   `transmute` on a `fn` type will generate a warning for a few cycles,
1862   then will be converted to an error.
1863 * [Improvements to const evaluation may trigger new errors when integer
1864   literals are out of range][1.9ce].
1865
1866
1867 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
1868 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
1869 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
1870 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
1871 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
1872 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
1873 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
1874 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
1875 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
1876 [1.9db]: https://github.com/rust-lang/rust/pull/32054
1877 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
1878 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
1879 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
1880 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
1881 [1.9o]: https://github.com/rust-lang/rust/pull/32325
1882 [1.9q]: https://github.com/rust-lang/rust/pull/31887
1883 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
1884 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
1885 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
1886 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
1887 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
1888 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
1889 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
1890 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
1891 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
1892 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
1893 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
1894 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
1895 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
1896 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
1897 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
1898 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
1899 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
1900 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
1901 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
1902 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
1903 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
1904 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
1905 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
1906 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
1907 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
1908 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
1909 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
1910 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
1911 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
1912 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
1913 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
1914 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
1915 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
1916 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
1917 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
1918 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
1919 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
1920 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
1921 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
1922 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
1923 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
1924 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
1925 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
1926 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
1927 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
1928 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
1929 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
1930 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
1931 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
1932 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
1933 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
1934 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
1935 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
1936 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
1937 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
1938 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
1939 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
1940 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
1941 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
1942 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
1943 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
1944 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
1945 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
1946 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
1947 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
1948 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
1949 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
1950 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
1951 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
1952 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
1953 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
1954 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
1955 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
1956 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
1957 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
1958 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
1959 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
1960 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
1961 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
1962 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
1963 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
1964 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
1965 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
1966 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
1967 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
1968 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
1969 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
1970 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
1971 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
1972 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
1973 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
1974 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
1975 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
1976 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
1977
1978
1979 Version 1.8.0 (2016-04-14)
1980 ==========================
1981
1982 Language
1983 --------
1984
1985 * Rust supports overloading of compound assignment statements like
1986   `+=` by implementing the [`AddAssign`], [`SubAssign`],
1987   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
1988   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
1989   traits. [RFC 953].
1990 * Empty structs can be defined with braces, as in `struct Foo { }`, in
1991   addition to the non-braced form, `struct Foo;`. [RFC 218].
1992
1993 Libraries
1994 ---------
1995
1996 * Stabilized APIs:
1997   * [`str::encode_utf16`][] (renamed from `utf16_units`)
1998   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
1999   * [`Ref::map`]
2000   * [`RefMut::map`]
2001   * [`ptr::drop_in_place`]
2002   * [`time::Instant`]
2003   * [`time::SystemTime`]
2004   * [`Instant::now`]
2005   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
2006   * [`Instant::elapsed`]
2007   * [`SystemTime::now`]
2008   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
2009   * [`SystemTime::elapsed`]
2010   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
2011   * [`SystemTimeError`]
2012   * [`SystemTimeError::duration`]
2013   * Various impls for `SystemTimeError`
2014   * [`UNIX_EPOCH`]
2015   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
2016     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
2017     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
2018 * [The `write!` and `writeln!` macros correctly emit errors if any of
2019   their arguments can't be formatted][1.8w].
2020 * [Various I/O functions support large files on 32-bit Linux][1.8l].
2021 * [The Unix-specific `raw` modules, which contain a number of
2022   redefined C types are deprecated][1.8r], including `os::raw::unix`,
2023   `os::raw::macos`, and `os::raw::linux`. These modules defined types
2024   such as `ino_t` and `dev_t`. The inconsistency of these definitions
2025   across platforms was making it difficult to implement `std`
2026   correctly. Those that need these definitions should use the `libc`
2027   crate. [RFC 1415].
2028 * The Unix-specific `MetadataExt` traits, including
2029   `os::unix::fs::MetadataExt`, which expose values such as inode
2030   numbers [no longer return platform-specific types][1.8r], but
2031   instead return widened integers. [RFC 1415].
2032 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
2033 * [Atomic loads and stores are not volatile][1.8a].
2034 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
2035
2036 Performance
2037 -----------
2038
2039 * [Inlining hash functions lead to a 3% compile-time improvement in
2040   some workloads][1.8h].
2041 * When using jemalloc, its symbols are [unprefixed so that it
2042   overrides the libc malloc implementation][1.8h]. This means that for
2043   rustc, LLVM is now using jemalloc, which results in a 6%
2044   compile-time improvement on a specific workload.
2045 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
2046
2047 Misc
2048 ----
2049
2050 * [32-bit MSVC builds finally implement unwinding][1.8ms].
2051   i686-pc-windows-msvc is now considered a tier-1 platform.
2052 * [The `--print targets` flag prints a list of supported targets][1.8t].
2053 * [The `--print cfg` flag prints the `cfg`s defined for the current
2054   target][1.8cf].
2055 * [`rustc` can be built with an new Cargo-based build system, written
2056   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
2057   build system. To enable it configure with `configure --rustbuild`.
2058 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
2059   variants while also indicating the total number of missing variants
2060   if more than 3][1.8m].
2061 * [Executable stacks are disabled on Linux and BSD][1.8nx].
2062 * The Rust Project now publishes binary releases of the standard
2063   library for a number of tier-2 targets:
2064   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
2065   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
2066   `x86_64-rumprun-netbsd`. These can be installed with
2067   tools such as [multirust][1.8mr].
2068
2069 Cargo
2070 -----
2071
2072 * [`cargo init` creates a new Cargo project in the current
2073   directory][1.8ci].  It is otherwise like `cargo new`.
2074 * [Cargo has configuration keys for `-v` and
2075   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
2076   `[term]` section of `.cargo/config`.
2077 * [Configuration keys that evaluate to strings or integers can be set
2078   via environment variables][1.8ce]. For example the `build.jobs` key
2079   can be set via `CARGO_BUILD_JOBS`. Environment variables take
2080   precedence over config files.
2081 * [Target-specific dependencies support Rust `cfg` syntax for
2082   describing targets][1.8cfg] so that dependencies for multiple
2083   targets can be specified together. [RFC 1361].
2084 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
2085   `RUSTDOC` take precedence over the `build.target-dir`,
2086   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
2087 * [The child process tree is killed on Windows when Cargo is
2088   killed][1.8ck].
2089 * [The `build.target` configuration value sets the target platform,
2090   like `--target`][1.8ct].
2091
2092 Compatibility Notes
2093 -------------------
2094
2095 * [Unstable compiler flags have been further restricted][1.8u]. Since
2096   1.0 `-Z` flags have been considered unstable, and other flags that
2097   were considered unstable additionally required passing `-Z
2098   unstable-options` to access. Unlike unstable language and library
2099   features though, these options have been accessible on the stable
2100   release channel. Going forward, *new unstable flags will not be
2101   available on the stable release channel*, and old unstable flags
2102   will warn about their usage. In the future, all unstable flags will
2103   be unavailable on the stable release channel.
2104 * [It is no longer possible to `match` on empty enum variants using
2105   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
2106 * The Unix-specific `MetadataExt` traits, including
2107   `os::unix::fs::MetadataExt`, which expose values such as inode
2108   numbers [no longer return platform-specific types][1.8r], but
2109   instead return widened integers. [RFC 1415].
2110 * [Modules sourced from the filesystem cannot appear within arbitrary
2111   blocks, but only within other modules][1.8mf].
2112 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
2113 * On Unix, [stack overflow triggers a runtime abort instead of a
2114   SIGSEGV][1.8so].
2115 * [`Command::spawn` and its equivalents return an error if any of
2116   its command-line arguments contain interior `NUL`s][1.8n].
2117 * [Tuple and unit enum variants from other crates are in the type
2118   namespace][1.8tn].
2119 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
2120   type instead of `.a` files][1.8st]. Additionally, for the MSVC
2121   toolchain, `rustc` emits import libraries named `foo.dll.lib`
2122   instead of `foo.lib`.
2123
2124
2125 [1.8a]: https://github.com/rust-lang/rust/pull/30962
2126 [1.8b]: https://github.com/rust-lang/rust/pull/31123
2127 [1.8c]: https://github.com/rust-lang/rust/pull/31530
2128 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
2129 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
2130 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
2131 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
2132 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
2133 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
2134 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
2135 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
2136 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
2137 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
2138 [1.8h]: https://github.com/rust-lang/rust/pull/31460
2139 [1.8l]: https://github.com/rust-lang/rust/pull/31668
2140 [1.8m]: https://github.com/rust-lang/rust/pull/31020
2141 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
2142 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
2143 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
2144 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
2145 [1.8n]: https://github.com/rust-lang/rust/pull/31056
2146 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
2147 [1.8r]: https://github.com/rust-lang/rust/pull/31551
2148 [1.8so]: https://github.com/rust-lang/rust/pull/31333
2149 [1.8st]: https://github.com/rust-lang/rust/pull/29520
2150 [1.8t]: https://github.com/rust-lang/rust/pull/31358
2151 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
2152 [1.8u]: https://github.com/rust-lang/rust/pull/31793
2153 [1.8v]: https://github.com/rust-lang/rust/pull/31757
2154 [1.8w]: https://github.com/rust-lang/rust/pull/31904
2155 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
2156 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
2157 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
2158 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
2159 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
2160 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
2161 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
2162 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
2163 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
2164 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
2165 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
2166 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
2167 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
2168 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
2169 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
2170 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
2171 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
2172 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
2173 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
2174 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
2175 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
2176 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
2177 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
2178 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
2179 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
2180 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
2181 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
2182 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
2183 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
2184 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
2185
2186
2187 Version 1.7.0 (2016-03-03)
2188 ==========================
2189
2190 Libraries
2191 ---------
2192
2193 * Stabilized APIs
2194   * `Path`
2195     * [`Path::strip_prefix`][] (renamed from relative_from)
2196     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
2197   * `Ipv4Addr`
2198     * [`Ipv4Addr::is_loopback`]
2199     * [`Ipv4Addr::is_private`]
2200     * [`Ipv4Addr::is_link_local`]
2201     * [`Ipv4Addr::is_multicast`]
2202     * [`Ipv4Addr::is_broadcast`]
2203     * [`Ipv4Addr::is_documentation`]
2204   * `Ipv6Addr`
2205     * [`Ipv6Addr::is_unspecified`]
2206     * [`Ipv6Addr::is_loopback`]
2207     * [`Ipv6Addr::is_multicast`]
2208   * `Vec`
2209     * [`Vec::as_slice`]
2210     * [`Vec::as_mut_slice`]
2211   * `String`
2212     * [`String::as_str`]
2213     * [`String::as_mut_str`]
2214   * Slices
2215     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
2216     be the same length
2217     * `<[T]>::`[`sort_by_key`]
2218   * checked, saturated, and overflowing operations
2219     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
2220     * [`i32::saturating_mul`]
2221     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
2222     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
2223     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
2224     * [`u32::saturating_mul`]
2225     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
2226     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
2227     * and checked, saturated, and overflowing operations for other primitive types
2228   * FFI
2229     * [`ffi::IntoStringError`]
2230     * [`CString::into_string`]
2231     * [`CString::into_bytes`]
2232     * [`CString::into_bytes_with_nul`]
2233     * `From<CString> for Vec<u8>`
2234   * `IntoStringError`
2235     * [`IntoStringError::into_cstring`]
2236     * [`IntoStringError::utf8_error`]
2237     * `Error for IntoStringError`
2238   * Hashing
2239     * [`std::hash::BuildHasher`]
2240     * [`BuildHasher::Hasher`]
2241     * [`BuildHasher::build_hasher`]
2242     * [`std::hash::BuildHasherDefault`]
2243     * [`HashMap::with_hasher`]
2244     * [`HashMap::with_capacity_and_hasher`]
2245     * [`HashSet::with_hasher`]
2246     * [`HashSet::with_capacity_and_hasher`]
2247     * [`std::collections::hash_map::RandomState`]
2248     * [`RandomState::new`]
2249 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
2250   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
2251   from bytes is faster.
2252 * [The performance of `LineWriter` (and thus `io::stdout`) was
2253   improved by using `memchr` to search for newlines][1.7m].
2254 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
2255   `f64` variants were stabilized previously.
2256 * [`BTreeMap` was rewritten to use less memory and improve the performance
2257   of insertion and iteration, the latter by as much as 5x][1.7bm].
2258 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
2259   covariant over their contained type][1.7bt].
2260 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
2261   over their contained type][1.7ll].
2262 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
2263   searching methods.
2264 * [`Any` is implemented for unsized types][1.7a].
2265 * [`Hash` is implemented for `Duration`][1.7h].
2266
2267 Misc
2268 ----
2269
2270 * [When running tests with `--test`, rustdoc will pass `--cfg`
2271   arguments to the compiler][1.7dt].
2272 * [The compiler is built with RPATH information by default][1.7rpa].
2273   This means that it will be possible to run `rustc` when installed in
2274   unusual configurations without configuring the dynamic linker search
2275   path explicitly.
2276 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
2277   any RPATH entries (emitted with `-C rpath`) *not* take precedence
2278   over `LD_LIBRARY_PATH`.
2279
2280 Cargo
2281 -----
2282
2283 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
2284   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
2285 * [The `rerun-if-changed` build script directive no longer causes the
2286   build script to incorrectly run twice in certain scenarios][1.7rr].
2287
2288 Compatibility Notes
2289 -------------------
2290
2291 * Soundness fixes to the interactions between associated types and
2292   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
2293   code that violates the new rules. This is a significant change that
2294   is known to break existing code, so it has emitted warnings for the
2295   new error cases since 1.4 to give crate authors time to adapt. The
2296   details of what is changing are subtle; read the RFC for more.
2297 * [Several bugs in the compiler's visibility calculations were
2298   fixed][1.7v]. Since this was found to break significant amounts of
2299   code, the new errors will be emitted as warnings for several release
2300   cycles, under the `private_in_public` lint.
2301 * Defaulted type parameters were accidentally accepted in positions
2302   that were not intended. In this release, [defaulted type parameters
2303   appearing outside of type definitions will generate a
2304   warning][1.7d], which will become an error in future releases.
2305 * [Parsing "." as a float results in an error instead of 0][1.7p].
2306   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
2307 * [Borrows of closure parameters may not outlive the closure][1.7bc].
2308
2309 [1.7a]: https://github.com/rust-lang/rust/pull/30928
2310 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
2311 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
2312 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
2313 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
2314 [1.7d]: https://github.com/rust-lang/rust/pull/30724
2315 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
2316 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
2317 [1.7f]: https://github.com/rust-lang/rust/pull/30672
2318 [1.7h]: https://github.com/rust-lang/rust/pull/30818
2319 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
2320 [1.7m]: https://github.com/rust-lang/rust/pull/30381
2321 [1.7p]: https://github.com/rust-lang/rust/pull/30681
2322 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
2323 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
2324 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
2325 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
2326 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
2327 [1.7v]: https://github.com/rust-lang/rust/pull/29973
2328 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
2329 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
2330 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
2331 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
2332 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
2333 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
2334 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
2335 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
2336 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
2337 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
2338 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
2339 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
2340 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
2341 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
2342 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
2343 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
2344 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
2345 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
2346 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
2347 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
2348 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
2349 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
2350 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
2351 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
2352 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
2353 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
2354 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
2355 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
2356 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
2357 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
2358 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
2359 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
2360 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
2361 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
2362 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
2363 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
2364 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
2365 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
2366 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
2367 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
2368 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
2369 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
2370 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
2371 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
2372 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
2373 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
2374 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
2375 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
2376 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
2377 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
2378 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
2379 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
2380 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
2381 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
2382 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
2383 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
2384 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
2385 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
2386 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
2387 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
2388
2389
2390 Version 1.6.0 (2016-01-21)
2391 ==========================
2392
2393 Language
2394 --------
2395
2396 * The `#![no_std]` attribute causes a crate to not be linked to the
2397   standard library, but only the [core library][1.6co], as described
2398   in [RFC 1184]. The core library defines common types and traits but
2399   has no platform dependencies whatsoever, and is the basis for Rust
2400   software in environments that cannot support a full port of the
2401   standard library, such as operating systems. Most of the core
2402   library is now stable.
2403
2404 Libraries
2405 ---------
2406
2407 * Stabilized APIs:
2408   [`Read::read_exact`],
2409   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
2410   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
2411   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
2412   [`os::unix::fs::DirBuilderExt`],
2413   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
2414   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
2415   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
2416   [`collections::hash_map::Drain`],
2417   [`collections::hash_map::HashMap::drain`],
2418   [`collections::hash_set::Drain`],
2419   [`collections::hash_set::HashSet::drain`],
2420   [`collections::binary_heap::Drain`],
2421   [`collections::binary_heap::BinaryHeap::drain`],
2422   [`Vec::extend_from_slice`][] (renamed from `push_all`),
2423   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
2424   [`RwLock::into_inner`],
2425   [`Iterator::min_by_key`][] (renamed from `min_by`),
2426   [`Iterator::max_by_key`][] (renamed from `max_by`).
2427 * The [core library][1.6co] is stable, as are most of its APIs.
2428 * [The `assert_eq!` macro supports arguments that don't implement
2429   `Sized`][1.6ae], such as arrays. In this way it behaves more like
2430   `assert!`.
2431 * Several timer functions that take duration in milliseconds [are
2432   deprecated in favor of those that take `Duration`][1.6ms]. These
2433   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
2434   `thread::park_timeout_ms`.
2435 * The algorithm by which `Vec` reserves additional elements was
2436   [tweaked to not allocate excessive space][1.6a] while still growing
2437   exponentially.
2438 * `From` conversions are [implemented from integers to floats][1.6f]
2439   in cases where the conversion is lossless. Thus they are not
2440   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
2441   or `f64`. They are also not implemented for `isize` and `usize`
2442   because the implementations would be platform-specific. `From` is
2443   also implemented from `f32` to `f64`.
2444 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
2445 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
2446 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
2447 * [`BinaryHeap` was refactored][1.6bh] for modest performance
2448   improvements.
2449 * Sorting slices that are already sorted [is 50% faster in some
2450   cases][1.6s].
2451
2452 Cargo
2453 -----
2454
2455 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
2456 * Cargo build scripts can specify their dependencies by emitting the
2457   [`rerun-if-changed`][1.6rr] key.
2458 * crates.io will reject publication of crates with dependencies that
2459   have a wildcard version constraint. Crates with wildcard
2460   dependencies were seen to cause a variety of problems, as described
2461   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
2462   warning.
2463 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
2464   release folder.  A variety of artifacts that Cargo failed to clean
2465   are now correctly deleted.
2466
2467 Misc
2468 ----
2469
2470 * The `unreachable_code` lint [warns when a function call's argument
2471   diverges][1.6dv].
2472 * The parser indicates [failures that may be caused by
2473   confusingly-similar Unicode characters][1.6uc]
2474 * Certain macro errors [are reported at definition time][1.6m], not
2475   expansion.
2476
2477 Compatibility Notes
2478 -------------------
2479
2480 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
2481   environment variable when locating crates. This was a pre-cargo
2482   feature for integrating with the package manager that was
2483   accidentally never removed.
2484 * [A number of bugs were fixed in the privacy checker][1.6p] that
2485   could cause previously-accepted code to break.
2486 * [Modules and unit/tuple structs may not share the same name][1.6ts].
2487 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
2488   struct pattern syntax (`Foo(..)`) can no longer be used to match
2489   unit structs. This is a warning now, but will become an error in
2490   future releases. Patterns that share the same name as a const are
2491   now an error.
2492 * A bug was fixed that causes [rustc not to apply default type
2493   parameters][1.6xc] when resolving certain method implementations of
2494   traits defined in other crates.
2495
2496 [1.6a]: https://github.com/rust-lang/rust/pull/29454
2497 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
2498 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
2499 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
2500 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
2501 [1.6co]: http://doc.rust-lang.org/beta/core/index.html
2502 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
2503 [1.6f]: https://github.com/rust-lang/rust/pull/29129
2504 [1.6m]: https://github.com/rust-lang/rust/pull/29828
2505 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
2506 [1.6p]: https://github.com/rust-lang/rust/pull/29726
2507 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
2508 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
2509 [1.6s]: https://github.com/rust-lang/rust/pull/29675
2510 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
2511 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
2512 [1.6us]: https://github.com/rust-lang/rust/pull/29383
2513 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
2514 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
2515 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
2516 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
2517 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
2518 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
2519 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
2520 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
2521 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
2522 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
2523 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
2524 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
2525 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
2526 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
2527 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
2528 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
2529 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
2530 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
2531 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
2532 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
2533 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
2534 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
2535 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
2536 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
2537 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
2538 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
2539 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
2540 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
2541 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
2542 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
2543
2544
2545 Version 1.5.0 (2015-12-10)
2546 ==========================
2547
2548 * ~700 changes, numerous bugfixes
2549
2550 Highlights
2551 ----------
2552
2553 * Stabilized APIs:
2554   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
2555   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
2556   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
2557   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
2558   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
2559   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
2560   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
2561   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
2562   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
2563   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
2564   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
2565   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
2566   [`Path::read_link`], [`Path::symlink_metadata`],
2567   [`Utf8Error::valid_up_to`], [`Vec::resize`],
2568   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
2569   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
2570   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
2571   [`slice::split_first_mut`], [`slice::split_first`],
2572   [`slice::split_last_mut`], [`slice::split_last`],
2573   [`char::from_u32_unchecked`], [`fs::canonicalize`],
2574   [`str::MatchIndices`], [`str::RMatchIndices`],
2575   [`str::match_indices`], [`str::rmatch_indices`],
2576   [`str::slice_mut_unchecked`], [`string::ParseError`].
2577 * Rust applications hosted on crates.io can be installed locally to
2578   `~/.cargo/bin` with the [`cargo install`] command. Among other
2579   things this makes it easier to augment Cargo with new subcommands:
2580   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
2581   invoked as `cargo foo`.
2582 * Crates with wildcard (`*`) dependencies will [emit warnings when
2583   published][1.5w]. In 1.6 it will no longer be possible to publish
2584   crates with wildcard dependencies.
2585
2586 Breaking Changes
2587 ----------------
2588
2589 * The rules determining when a particular lifetime must outlive
2590   a particular value (known as '[dropck]') have been [modified
2591   to not rely on parametricity][1.5p].
2592 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
2593   and `Arc`][1.5a]. Because these smart pointer types implement
2594   `Deref`, this causes breakage in cases where the interior type
2595   contains methods of the same name.
2596 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
2597   that they could drop their content. Soundness fix.
2598 * All method invocations are [properly checked][1.5wf1] for
2599   [well-formedness][1.5wf2]. Soundness fix.
2600 * Traits whose supertraits contain `Self` are [not object
2601   safe][1.5o]. Soundness fix.
2602 * Target specifications support a [`no_default_libraries`][1.5nd]
2603   setting that controls whether `-nodefaultlibs` is passed to the
2604   linker, and in turn the `is_like_windows` setting no longer affects
2605   the `-nodefaultlibs` flag.
2606 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
2607 * The `#[inline]` and `#[repr]` attributes [can only appear
2608   in valid locations][1.5at].
2609 * Native libraries linked from the local crate are [passed to
2610   the linker before native libraries from upstream crates][1.5nl].
2611 * Two rarely-used attributes, `#[no_debug]` and
2612   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
2613 * Negation of unsigned integers, which has been a warning for
2614   several releases, [is now behind a feature gate and will
2615   generate errors][1.5nu].
2616 * The parser accidentally accepted visibility modifiers on
2617   enum variants, a bug [which has been fixed][1.5ev].
2618 * [A bug was fixed that allowed `use` statements to import unstable
2619   features][1.5use].
2620
2621 Language
2622 --------
2623
2624 * When evaluating expressions at compile-time that are not
2625   compile-time constants (const-evaluating expressions in non-const
2626   contexts), incorrect code such as overlong bitshifts and arithmetic
2627   overflow will [generate a warning instead of an error][1.5ce],
2628   delaying the error until runtime. This will allow the
2629   const-evaluator to be expanded in the future backwards-compatibly.
2630 * The `improper_ctypes` lint [no longer warns about using `isize` and
2631   `usize` in FFI][1.5ict].
2632
2633 Libraries
2634 ---------
2635
2636 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
2637   invariant][1.5c].
2638 * `Default` is [implemented for mutable slices][1.5d].
2639 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
2640 * There are now `From` conversions [between floating point
2641   types][1.5f] where the conversions are lossless.
2642 * Thera are now `From` conversions [between integer types][1.5i] where
2643   the conversions are lossless.
2644 * [`fs::Metadata` implements `Clone`][1.5fs].
2645 * The `parse` method [accepts a leading "+" when parsing
2646   integers][1.5pi].
2647 * [`AsMut` is implemented for `Vec`][1.5am].
2648 * The `clone_from` implementations for `String` and `BinaryHeap` [have
2649   been optimized][1.5cf] and no longer rely on the default impl.
2650 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
2651   `unsafe extern "C"` function types now [implement `Clone`,
2652   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
2653   `fmt::Debug` for up to 12 arguments][1.5fp].
2654 * [Dropping `Vec`s is much faster in unoptimized builds when the
2655   element types don't implement `Drop`][1.5dv].
2656 * A bug that caused in incorrect behavior when [combining `VecDeque`
2657   with zero-sized types][1.5vdz] was resolved.
2658 * [`PartialOrd` for slices is faster][1.5po].
2659
2660 Miscellaneous
2661 -------------
2662
2663 * [Crate metadata size was reduced by 20%][1.5md].
2664 * [Improvements to code generation reduced the size of libcore by 3.3
2665   MB and rustc's memory usage by 18MB][1.5m].
2666 * [Improvements to deref translation increased performance in
2667   unoptimized builds][1.5dr].
2668 * Various errors in trait resolution [are deduplicated to only be
2669   reported once][1.5te].
2670 * Rust has preliminary [support for rumprun kernels][1.5rr].
2671 * Rust has preliminary [support for NetBSD on amd64][1.5na].
2672
2673 [1.5use]: https://github.com/rust-lang/rust/pull/28364
2674 [1.5po]: https://github.com/rust-lang/rust/pull/28436
2675 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
2676 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
2677 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
2678 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
2679 [1.5md]: https://github.com/rust-lang/rust/pull/28521
2680 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
2681 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
2682 [1.5na]: https://github.com/rust-lang/rust/pull/28543
2683 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
2684 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
2685 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
2686 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
2687 [1.5te]: https://github.com/rust-lang/rust/pull/28645
2688 [1.5at]: https://github.com/rust-lang/rust/pull/28650
2689 [1.5am]: https://github.com/rust-lang/rust/pull/28663
2690 [1.5m]: https://github.com/rust-lang/rust/pull/28778
2691 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
2692 [1.5a]: https://github.com/rust-lang/rust/pull/28811
2693 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
2694 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
2695 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
2696 [1.5i]: https://github.com/rust-lang/rust/pull/28921
2697 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
2698 [1.5f]: https://github.com/rust-lang/rust/pull/29129
2699 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
2700 [1.5s]: https://github.com/rust-lang/rust/pull/29190
2701 [1.5d]: https://github.com/rust-lang/rust/pull/29245
2702 [1.5o]: https://github.com/rust-lang/rust/pull/29259
2703 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
2704 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
2705 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
2706 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
2707 [1.5c]: https://github.com/rust-lang/rust/pull/29110
2708 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
2709 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
2710 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
2711 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
2712 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
2713 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
2714 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
2715 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
2716 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
2717 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
2718 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
2719 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
2720 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
2721 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
2722 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
2723 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
2724 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
2725 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
2726 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
2727 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
2728 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
2729 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
2730 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
2731 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
2732 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
2733 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
2734 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
2735 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
2736 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
2737 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
2738 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
2739 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
2740 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
2741 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
2742 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
2743 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
2744 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
2745 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
2746 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
2747 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
2748 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
2749 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
2750 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
2751 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
2752 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
2753 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
2754 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
2755 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
2756 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
2757 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
2758 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
2759 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
2760 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
2761 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
2762
2763 Version 1.4.0 (2015-10-29)
2764 ==========================
2765
2766 * ~1200 changes, numerous bugfixes
2767
2768 Highlights
2769 ----------
2770
2771 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
2772   GNU) are now supported and recommended for use.
2773
2774 Breaking Changes
2775 ----------------
2776
2777 * [Several changes have been made to fix type soundness and improve
2778   the behavior of associated types][sound]. See [RFC 1214]. Although
2779   we have mostly introduced these changes as warnings this release, to
2780   become errors next release, there are still some scenarios that will
2781   see immediate breakage.
2782 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
2783   line breaks in addition to `\n`][crlf].
2784 * [Loans of `'static` lifetime extend to the end of a function][stat].
2785 * [`str::parse` no longer introduces avoidable rounding error when
2786   parsing floating point numbers. Together with earlier changes to
2787   float formatting/output, "round trips" like f.to_string().parse()
2788   now preserve the value of f exactly. Additionally, leading plus
2789   signs are now accepted][fp3].
2790
2791
2792 Language
2793 --------
2794
2795 * `use` statements that import multiple items [can now rename
2796   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
2797 * [Binops work correctly on fat pointers][binfat].
2798 * `pub extern crate`, which does not behave as expected, [issues a
2799   warning][pec] until a better solution is found.
2800
2801 Libraries
2802 ---------
2803
2804 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
2805   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
2806   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
2807   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
2808   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
2809   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
2810   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
2811   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
2812   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
2813   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
2814   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
2815   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
2816   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
2817   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
2818   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
2819   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
2820   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
2821   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
2822   [`thread::sleep`].
2823 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
2824   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
2825   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
2826   `f64::from_str_radix`.
2827 * [Reverse-searching strings is faster with the 'two-way'
2828   algorithm][s].
2829 * [`std::io::copy` allows `?Sized` arguments][cc].
2830 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
2831   [override `count`, `nth` and `last` with an O(1)
2832   implementation][it].
2833 * [`Default` is implemented for arrays up to `[T; 32]`][d].
2834 * [`IntoRawFd` has been added to the Unix-specific prelude,
2835   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
2836   prelude][pr].
2837 * [`Extend<String>` and `FromIterator<String` are both implemented for
2838   `String`][es].
2839 * [`IntoIterator` is implemented for references to `Option` and
2840   `Result`][into2].
2841 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
2842   Copy`][ext] as part of [RFC 839]. This will cause type inferance
2843   breakage in rare situations.
2844 * [`BinaryHeap` implements `Debug`][bh2].
2845 * [`Borrow` and `BorrowMut` are implemented for fixed-size
2846   arrays][bm].
2847 * [`extern fn`s with the "Rust" and "C" ABIs implement common
2848   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
2849 * [String comparison is faster][faststr].
2850 * `&mut T` where `T: std::fmt::Write` [also implements
2851   `std::fmt::Write`][mutw].
2852 * [A stable regression in `VecDeque::push_back` and other
2853   capicity-altering methods that caused panics for zero-sized types
2854   was fixed][vd].
2855 * [Function pointers implement traits for up to 12 parameters][fp2].
2856
2857 Miscellaneous
2858 -------------
2859
2860 * The compiler [no longer uses the 'morestack' feature to prevent
2861   stack overflow][mm]. Instead it uses guard pages and stack
2862   probes (though stack probes are not yet implemented on any platform
2863   but Windows).
2864 * [The compiler matches traits faster when projections are involved][p].
2865 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
2866   `usize`][ffi].
2867 * [Cargo now displays useful information about what its doing during
2868   `cargo update`][cu].
2869
2870 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
2871 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
2872 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
2873 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
2874 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
2875 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
2876 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
2877 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
2878 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
2879 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
2880 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
2881 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
2882 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
2883 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
2884 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
2885 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
2886 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
2887 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
2888 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
2889 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
2890 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
2891 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
2892 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
2893 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
2894 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
2895 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
2896 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
2897 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
2898 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
2899 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
2900 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
2901 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
2902 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
2903 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
2904 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
2905 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
2906 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
2907 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
2908 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
2909 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
2910 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
2911 [bh2]: https://github.com/rust-lang/rust/pull/28156
2912 [binfat]: https://github.com/rust-lang/rust/pull/28270
2913 [bm]: https://github.com/rust-lang/rust/pull/28197
2914 [cc]: https://github.com/rust-lang/rust/pull/27531
2915 [crlf]: https://github.com/rust-lang/rust/pull/28034
2916 [cu]: https://github.com/rust-lang/cargo/pull/1931
2917 [d]: https://github.com/rust-lang/rust/pull/27825
2918 [dep]: https://github.com/rust-lang/rust/pull/28339
2919 [es]: https://github.com/rust-lang/rust/pull/27956
2920 [ext]: https://github.com/rust-lang/rust/pull/28094
2921 [faststr]: https://github.com/rust-lang/rust/pull/28338
2922 [ffi]: https://github.com/rust-lang/rust/pull/28779
2923 [fp]: https://github.com/rust-lang/rust/pull/28268
2924 [fp2]: https://github.com/rust-lang/rust/pull/28560
2925 [fp3]: https://github.com/rust-lang/rust/pull/27307
2926 [i]: https://github.com/rust-lang/rust/pull/27451
2927 [into2]: https://github.com/rust-lang/rust/pull/28039
2928 [it]: https://github.com/rust-lang/rust/pull/27652
2929 [mm]: https://github.com/rust-lang/rust/pull/27338
2930 [mutw]: https://github.com/rust-lang/rust/pull/28368
2931 [sound]: https://github.com/rust-lang/rust/pull/27641
2932 [p]: https://github.com/rust-lang/rust/pull/27866
2933 [pec]: https://github.com/rust-lang/rust/pull/28486
2934 [pr]: https://github.com/rust-lang/rust/pull/27896
2935 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
2936 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
2937 [s]: https://github.com/rust-lang/rust/pull/27474
2938 [stab]: https://github.com/rust-lang/rust/pull/28339
2939 [stat]: https://github.com/rust-lang/rust/pull/28321
2940 [vd]: https://github.com/rust-lang/rust/pull/28494
2941
2942 Version 1.3.0 (2015-09-17)
2943 ==============================
2944
2945 * ~900 changes, numerous bugfixes
2946
2947 Highlights
2948 ----------
2949
2950 * The [new object lifetime defaults][nold] have been [turned
2951   on][nold2] after a cycle of warnings about the change. Now types
2952   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
2953   being interpreted as `&'a Box<Trait+'a>` to `&'a
2954   Box<Trait+'static>`.
2955 * [The Rustonomicon][nom] is a new book in the official documentation
2956   that dives into writing unsafe Rust.
2957 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
2958   timekeeping is employed by other std APIs, as well as out-of-tree
2959   time crates.
2960
2961 Breaking Changes
2962 ----------------
2963
2964 * The [new object lifetime defaults][nold] have been [turned
2965   on][nold2] after a cycle of warnings about the change.
2966 * There is a known [regression][lr] in how object lifetime elision is
2967   interpreted, the proper solution for which is undetermined.
2968 * The `#[prelude_import]` attribute, an internal implementation
2969   detail, was accidentally stabilized previously. [It has been put
2970   behind the `prelude_import` feature gate][pi]. This change is
2971   believed to break no existing code.
2972 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
2973   [more sane for dynamically sized types][dst3]. Code that relied on
2974   the previous behavior is thought to be broken.
2975 * The `dropck` rules, which checks that destructors can't access
2976   destroyed values, [have been updated][dropck] to match the
2977   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
2978   cause some previously-compiling code to no longer build.
2979
2980 Language
2981 --------
2982
2983 * The [new object lifetime defaults][nold] have been [turned
2984   on][nold2] after a cycle of warnings about the change.
2985 * Semicolons may [now follow types and paths in
2986   macros](https://github.com/rust-lang/rust/pull/27000).
2987 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
2988   [more sane for dynamically sized types][dst3]. Code that relied on
2989   the previous behavior is not known to exist, and suspected to be
2990   broken.
2991 * `'static` variables [may now be recursive][st].
2992 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
2993   implementations correctly.
2994 * The `dropck` rules, which checks that destructors can't access
2995   destroyed values, [have been updated][dropck] to match the
2996   [RFC][dropckrfc].
2997
2998 Libraries
2999 ---------
3000
3001 * The [`Duration`] API, [has been stabilized][ds], as well as the
3002   `std::time` module, which presently contains only `Duration`.
3003 * `Box<str>` and `Box<[T]>` both implement `Clone`.
3004 * The owned C string, [`CString`], implements [`Borrow`] and the
3005   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
3006   these allow C strings to be borrowed and cloned in generic code.
3007 * [`CStr`] implements [`Debug`].
3008 * [`AtomicPtr`] implements [`Debug`].
3009 * [`Error`] trait objects [can be downcast to their concrete types][e]
3010   in many common configurations, using the [`is`], [`downcast`],
3011   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
3012   [`Any`] trait.
3013 * Searching for substrings now [employs the two-way algorithm][search]
3014   instead of doing a naive search. This gives major speedups to a
3015   number of methods, including [`contains`][sc], [`find`][sf],
3016   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
3017   [`ends_with`][sew] are also faster.
3018 * The performance of `PartialEq` for slices is [much faster][ps].
3019 * The [`Hash`] trait offers the default method, [`hash_slice`], which
3020   is overridden and optimized by the implementations for scalars.
3021 * The [`Hasher`] trait now has a number of specialized `write_*`
3022   methods for primitive types, for efficiency.
3023 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
3024   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
3025   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
3026   of [`std::error::Error::cause`][iec] also delegates to the inner
3027   error.
3028 * [`process::Child`][pc] gained the [`id`] method, which returns a
3029   `u32` representing the platform-specific process identifier.
3030 * The [`connect`] method on slices is deprecated, replaced by the new
3031   [`join`] method (note that both of these are on the *unstable*
3032   [`SliceConcatExt`] trait, but through the magic of the prelude are
3033   available to stable code anyway).
3034 * The [`Div`] operator is implemented for [`Wrapping`] types.
3035 * [`DerefMut` is implemented for `String`][dms].
3036 * Performance of SipHash (the default hasher for `HashMap`) is
3037   [better for long data][sh].
3038 * [`AtomicPtr`] implements [`Send`].
3039 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
3040   are now [specialized to use uninitalized buffers for increased
3041   performance][rte].
3042 * Lifetime parameters of foreign functions [are now resolved
3043   properly][f].
3044
3045 Misc
3046 ----
3047
3048 * Rust can now, with some coercion, [produce programs that run on
3049   Windows XP][xp], though XP is not considered a supported platform.
3050 * Porting Rust on Windows from the GNU toolchain to MSVC continues
3051   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
3052   recommended for use in 1.3, though should be fully-functional
3053   in the [64-bit 1.4 beta][b14].
3054 * On Fedora-based systems installation will [properly configure the
3055   dynamic linker][fl].
3056 * The compiler gained many new extended error descriptions, which can
3057   be accessed with the `--explain` flag.
3058 * The `dropck` pass, which checks that destructors can't access
3059   destroyed values, [has been rewritten][dropck]. This fixes some
3060   soundness holes, and as such will cause some previously-compiling
3061   code to no longer build.
3062 * `rustc` now uses [LLVM to write archive files where possible][ar].
3063   Eventually this will eliminate the compiler's dependency on the ar
3064   utility.
3065 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
3066   supported FreeBSD on x86_64).
3067 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
3068   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
3069   more strict.
3070 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
3071   will kill the process instead of leaking][nlp].
3072
3073 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
3074 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
3075 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
3076 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
3077 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
3078 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
3079 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
3080 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
3081 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
3082 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
3083 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
3084 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
3085 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
3086 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
3087 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
3088 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
3089 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
3090 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
3091 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
3092 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
3093 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
3094 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
3095 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
3096 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
3097 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
3098 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
3099 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
3100 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
3101 [ar]: https://github.com/rust-lang/rust/pull/26926
3102 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
3103 [dms]: https://github.com/rust-lang/rust/pull/26241
3104 [dropck]: https://github.com/rust-lang/rust/pull/27261
3105 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
3106 [ds]: https://github.com/rust-lang/rust/pull/26818
3107 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
3108 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
3109 [dst3]: https://github.com/rust-lang/rust/pull/27351
3110 [e]: https://github.com/rust-lang/rust/pull/24793
3111 [f]: https://github.com/rust-lang/rust/pull/26588
3112 [fb]: https://github.com/rust-lang/rust/pull/26959
3113 [fl]: https://github.com/rust-lang/rust-installer/pull/41
3114 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
3115 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
3116 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
3117 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
3118 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
3119 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
3120 [lic]: https://github.com/rust-lang/rust/pull/26583
3121 [lnu]: https://github.com/rust-lang/rust/pull/27026
3122 [lr]: https://github.com/rust-lang/rust/issues/27248
3123 [lum]: https://github.com/rust-lang/rust/pull/26378
3124 [lur]: https://github.com/rust-lang/rust/pull/26783
3125 [nlp]: https://github.com/rust-lang/rust/pull/27176
3126 [nold2]: https://github.com/rust-lang/rust/pull/27045
3127 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
3128 [nom]: http://doc.rust-lang.org/nightly/nomicon/
3129 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
3130 [pi]: https://github.com/rust-lang/rust/pull/26699
3131 [ps]: https://github.com/rust-lang/rust/pull/26884
3132 [rte]: https://github.com/rust-lang/rust/pull/26950
3133 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
3134 [search]: https://github.com/rust-lang/rust/pull/26327
3135 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
3136 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
3137 [sh]: https://github.com/rust-lang/rust/pull/27280
3138 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
3139 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
3140 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
3141 [st]: https://github.com/rust-lang/rust/pull/26630
3142 [win1]: https://github.com/rust-lang/rust/pull/26569
3143 [win2]: https://github.com/rust-lang/rust/pull/26741
3144 [win3]: https://github.com/rust-lang/rust/pull/26741
3145 [win4]: https://github.com/rust-lang/rust/pull/27210
3146 [xp]: https://github.com/rust-lang/rust/pull/26569
3147
3148 Version 1.2.0 (2015-08-07)
3149 ==========================
3150
3151 * ~1200 changes, numerous bugfixes
3152
3153 Highlights
3154 ----------
3155
3156 * [Dynamically-sized-type coercions][dst] allow smart pointer types
3157   like `Rc` to contain types without a fixed size, arrays and trait
3158   objects, finally enabling use of `Rc<[T]>` and completing the
3159   implementation of DST.
3160 * [Parallel codegen][parcodegen] is now working again, which can
3161   substantially speed up large builds in debug mode; It also gets
3162   another ~33% speedup when bootstrapping on a 4 core machine (using 8
3163   jobs). It's not enabled by default, but will be "in the near
3164   future". It can be activated with the `-C codegen-units=N` flag to
3165   `rustc`.
3166 * This is the first release with [experimental support for linking
3167   with the MSVC linker and lib C on Windows (instead of using the GNU
3168   variants via MinGW)][win]. It is yet recommended only for the most
3169   intrepid Rusticians.
3170 * Benchmark compilations are showing a 30% improvement in
3171   bootstrapping over 1.1.
3172
3173 Breaking Changes
3174 ----------------
3175
3176 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
3177   unicode case mapping, which is a previously-planned change in
3178   behavior and considered a bugfix.
3179 * [`mem::align_of`] now specifies [the *minimum alignment* for
3180   T][align], which is usually the alignment programs are interested
3181   in, and the same value reported by clang's
3182   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
3183   break real code.
3184 * [The `#[packed]` attribute is no longer silently accepted by the
3185   compiler][packed]. This attribute did nothing and code that
3186   mentioned it likely did not work as intended.
3187 * Associated type defaults are [now behind the
3188   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
3189   defaults *did not work*, but could be mentioned syntactically. As
3190   such this breakage has minimal impact.
3191
3192 Language
3193 --------
3194
3195 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
3196   matching against dereferencable values.
3197
3198 Libraries
3199 ---------
3200
3201 * The [`Extend`] trait, which grows a collection from an iterator, is
3202   implemented over iterators of references, for `String`, `Vec`,
3203   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
3204   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
3205 * The [`iter::once`] function returns an iterator that yields a single
3206   element, and [`iter::empty`] returns an iterator that yields no
3207   elements.
3208 * The [`matches`] and [`rmatches`] methods on `str` return iterators
3209   over substring matches.
3210 * [`Cell`] and [`RefCell`] both implement `Eq`.
3211 * A number of methods for wrapping arithmetic are added to the
3212   integral types, [`wrapping_div`], [`wrapping_rem`],
3213   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
3214   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
3215   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
3216   type.. It is illegal for the default arithmetic operations in Rust
3217   to overflow; the desire to wrap must be explicit.
3218 * The `{:#?}` formatting specifier [displays the alternate,
3219   pretty-printed][debugfmt] form of the `Debug` formatter. This
3220   feature was actually introduced prior to 1.0 with little
3221   fanfare.
3222 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
3223   for writing data to formatted strings, similar to [`io::Write`].
3224 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
3225   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
3226   are used by code generators to emit implementations of [`Debug`].
3227 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
3228   methods that convert case, following Unicode case mapping.
3229 * It is now easier to handle poisoned locks. The [`PoisonError`]
3230   type, returned by failing lock operations, exposes `into_inner`,
3231   `get_ref`, and `get_mut`, which all give access to the inner lock
3232   guard, and allow the poisoned lock to continue to operate. The
3233   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
3234   poisoned lock without attempting to take the lock.
3235 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
3236   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
3237   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
3238   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
3239   `ChildStderr`.
3240 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
3241   malformed input.
3242
3243 Misc
3244 ----
3245
3246 * `rustc` employs smarter heuristics for guessing at [typos].
3247 * `rustc` emits more efficient code for [no-op conversions between
3248   unsafe pointers][nop].
3249 * Fat pointers are now [passed in pairs of immediate arguments][fat],
3250   resulting in faster compile times and smaller code.
3251
3252 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
3253 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
3254 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
3255 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
3256 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
3257 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
3258 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
3259 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
3260 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
3261 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
3262 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
3263 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
3264 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
3265 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
3266 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
3267 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
3268 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
3269 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
3270 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
3271 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
3272 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
3273 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
3274 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
3275 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
3276 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
3277 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
3278 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
3279 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
3280 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
3281 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
3282 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
3283 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
3284 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
3285 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
3286 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
3287 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
3288 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
3289 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
3290 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
3291 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
3292 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
3293 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
3294 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
3295 [align]: https://github.com/rust-lang/rust/pull/25646
3296 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
3297 [typos]: https://github.com/rust-lang/rust/pull/26087
3298 [nop]: https://github.com/rust-lang/rust/pull/26336
3299 [fat]: https://github.com/rust-lang/rust/pull/26411
3300 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
3301 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
3302 [packed]: https://github.com/rust-lang/rust/pull/25541
3303 [ad]: https://github.com/rust-lang/rust/pull/27382
3304 [win]: https://github.com/rust-lang/rust/pull/25350
3305
3306 Version 1.1.0 (2015-06-25)
3307 =========================
3308
3309 * ~850 changes, numerous bugfixes
3310
3311 Highlights
3312 ----------
3313
3314 * The [`std::fs` module has been expanded][fs] to expand the set of
3315   functionality exposed:
3316   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
3317     don't incur a syscall on some platforms.
3318   * A `symlink_metadata` function has been added.
3319   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
3320     access to all underlying information.
3321 * The compiler now contains extended explanations of many errors. When an error
3322   with an explanation occurs the compiler suggests using the `--explain` flag
3323   to read the explanation. Error explanations are also [available online][err-index].
3324 * Thanks to multiple [improvements][sk] to [type checking][pre], as
3325   well as other work, the time to bootstrap the compiler decreased by
3326   32%.
3327
3328 Libraries
3329 ---------
3330
3331 * The [`str::split_whitespace`] method splits a string on unicode
3332   whitespace boundaries.
3333 * On both Windows and Unix, new extension traits provide conversion of
3334   I/O types to and from the underlying system handles. On Unix, these
3335   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
3336   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
3337   `TcpListener`, and `UpdSocket`. Further implementations for
3338   `std::process` will be stabilized later.
3339 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
3340   Windows, symlinks can be created with
3341   `std::os::windows::symlink_dir` and
3342   `std::os::windows::symlink_file`.
3343 * The `mpsc::Receiver` type can now be converted into an iterator with
3344   `into_iter` on the [`IntoIterator`] trait.
3345 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
3346   implementation of the [`From`] trait.
3347 * The `Debug` implementation for `RangeFull` [creates output that is
3348   more consistent with other implementations][rf].
3349 * [`Debug` is implemented for `File`][file].
3350 * The `Default` implementation for `Arc` [no longer requires `Sync +
3351   Send`][arc].
3352 * [The `Iterator` methods `count`, `nth`, and `last` have been
3353   overridden for slices to have O(1) performance instead of O(n)][si].
3354 * Incorrect handling of paths on Windows has been improved in both the
3355   compiler and the standard library.
3356 * [`AtomicPtr` gained a `Default` implementation][ap].
3357 * In accordance with Rust's policy on arithmetic overflow `abs` now
3358   [panics on overflow when debug assertions are enabled][abs].
3359 * The [`Cloned`] iterator, which was accidentally left unstable for
3360   1.0 [has been stabilized][c].
3361 * The [`Incoming`] iterator, which iterates over incoming TCP
3362   connections, and which was accidentally unnamable in 1.0, [is now
3363   properly exported][inc].
3364 * [`BinaryHeap`] no longer corrupts itself [when functions called by
3365   `sift_up` or `sift_down` panic][bh].
3366 * The [`split_off`] method of `LinkedList` [no longer corrupts
3367   the list in certain scenarios][ll].
3368
3369 Misc
3370 ----
3371
3372 * Type checking performance [has improved notably][sk] with
3373   [multiple improvements][pre].
3374 * The compiler [suggests code changes][ch] for more errors.
3375 * rustc and it's build system have experimental support for [building
3376   toolchains against MUSL][m] instead of glibc on Linux.
3377 * The compiler defines the `target_env` cfg value, which is used for
3378   distinguishing toolchains that are otherwise for the same
3379   platform. Presently this is set to `gnu` for common GNU Linux
3380   targets and for MinGW targets, and `musl` for MUSL Linux targets.
3381 * The [`cargo rustc`][crc] command invokes a build with custom flags
3382   to rustc.
3383 * [Android executables are always position independent][pie].
3384 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
3385   with `Drop`][drop].
3386
3387 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
3388 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
3389 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
3390 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
3391 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
3392 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
3393 [rf]: https://github.com/rust-lang/rust/pull/24491
3394 [err-index]: https://doc.rust-lang.org/error-index.html
3395 [sk]: https://github.com/rust-lang/rust/pull/24615
3396 [pre]: https://github.com/rust-lang/rust/pull/25323
3397 [file]: https://github.com/rust-lang/rust/pull/24598
3398 [ch]: https://github.com/rust-lang/rust/pull/24683
3399 [arc]: https://github.com/rust-lang/rust/pull/24695
3400 [si]: https://github.com/rust-lang/rust/pull/24701
3401 [ap]: https://github.com/rust-lang/rust/pull/24834
3402 [m]: https://github.com/rust-lang/rust/pull/24777
3403 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
3404 [crc]: https://github.com/rust-lang/cargo/pull/1568
3405 [pie]: https://github.com/rust-lang/rust/pull/24953
3406 [abs]: https://github.com/rust-lang/rust/pull/25441
3407 [c]: https://github.com/rust-lang/rust/pull/25496
3408 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
3409 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
3410 [inc]: https://github.com/rust-lang/rust/pull/25522
3411 [bh]: https://github.com/rust-lang/rust/pull/25856
3412 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
3413 [ll]: https://github.com/rust-lang/rust/pull/26022
3414 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
3415 [drop]: https://github.com/rust-lang/rust/pull/24935
3416
3417 Version 1.0.0 (2015-05-15)
3418 ========================
3419
3420 * ~1500 changes, numerous bugfixes
3421
3422 Highlights
3423 ----------
3424
3425 * The vast majority of the standard library is now `#[stable]`. It is
3426   no longer possible to use unstable features with a stable build of
3427   the compiler.
3428 * Many popular crates on [crates.io] now work on the stable release
3429   channel.
3430 * Arithmetic on basic integer types now [checks for overflow in debug
3431   builds][overflow].
3432
3433 Language
3434 --------
3435
3436 * Several [restrictions have been added to trait coherence][coh] in
3437   order to make it easier for upstream authors to change traits
3438   without breaking downstream code.
3439 * Digits of binary and octal literals are [lexed more eagerly][lex] to
3440   improve error messages and macro behavior. For example, `0b1234` is
3441   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
3442 * Trait bounds [are always invariant][inv], eliminating the need for
3443   the `PhantomFn` and `MarkerTrait` lang items, which have been
3444   removed.
3445 * ["-" is no longer a valid character in crate names][cr], the `extern crate
3446   "foo" as bar` syntax has been replaced with `extern crate foo as
3447   bar`, and Cargo now automatically translates "-" in *package* names
3448   to underscore for the crate name.
3449 * [Lifetime shadowing is an error][lt].
3450 * [`Send` no longer implies `'static`][send-rfc].
3451 * [UFCS now supports trait-less associated paths][moar-ufcs] like
3452   `MyType::default()`.
3453 * Primitive types [now have inherent methods][prim-inherent],
3454   obviating the need for extension traits like `SliceExt`.
3455 * Methods with `Self: Sized` in their `where` clause are [considered
3456   object-safe][self-sized], allowing many extension traits like
3457   `IteratorExt` to be merged into the traits they extended.
3458 * You can now [refer to associated types][assoc-where] whose
3459   corresponding trait bounds appear only in a `where` clause.
3460 * The final bits of [OIBIT landed][oibit-final], meaning that traits
3461   like `Send` and `Sync` are now library-defined.
3462 * A [Reflect trait][reflect] was introduced, which means that
3463   downcasting via the `Any` trait is effectively limited to concrete
3464   types. This helps retain the potentially-important "parametricity"
3465   property: generic code cannot behave differently for different type
3466   arguments except in minor ways.
3467 * The `unsafe_destructor` feature is now deprecated in favor of the
3468   [new `dropck`][dropck]. This change is a major reduction in unsafe
3469   code.
3470
3471 Libraries
3472 ---------
3473
3474 * The `thread_local` module [has been renamed to `std::thread`][th].
3475 * The methods of `IteratorExt` [have been moved to the `Iterator`
3476   trait itself][ie].
3477 * Several traits that implement Rust's conventions for type
3478   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
3479   [centralized in the `std::convert` module][con].
3480 * The `FromError` trait [was removed in favor of `From`][fe].
3481 * The basic sleep function [has moved to
3482   `std::thread::sleep_ms`][slp].
3483 * The `splitn` function now takes an `n` parameter that represents the
3484   number of items yielded by the returned iterator [instead of the
3485   number of 'splits'][spl].
3486 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
3487 * [Derived implementations of `PartialOrd` now order enums according
3488   to their explicitly-assigned discriminants][po].
3489 * [Methods for searching strings are generic over `Pattern`s][pat],
3490   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
3491   some others.
3492 * [In method resolution, object methods are resolved before inherent
3493   methods][meth].
3494 * [`String::from_str` has been deprecated in favor of the `From` impl,
3495   `String::from`][sf].
3496 * [`io::Error` implements `Sync`][ios].
3497 * [The `words` method on `&str` has been replaced with
3498   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
3499   a word?'
3500 * The new path and IO modules are complete and `#[stable]`. This
3501   was the major library focus for this cycle.
3502 * The path API was [revised][path-normalize] to normalize `.`,
3503   adjusting the tradeoffs in favor of the most common usage.
3504 * A large number of remaining APIs in `std` were also stabilized
3505   during this cycle; about 75% of the non-deprecated API surface
3506   is now stable.
3507 * The new [string pattern API][string-pattern] landed, which makes
3508   the string slice API much more internally consistent and flexible.
3509 * A new set of [generic conversion traits][conversion] replaced
3510   many existing ad hoc traits.
3511 * Generic numeric traits were [completely removed][num-traits]. This
3512   was made possible thanks to inherent methods for primitive types,
3513   and the removal gives maximal flexibility for designing a numeric
3514   hierarchy in the future.
3515 * The `Fn` traits are now related via [inheritance][fn-inherit]
3516   and provide ergonomic [blanket implementations][fn-blanket].
3517 * The `Index` and `IndexMut` traits were changed to
3518   [take the index by value][index-value], enabling code like
3519   `hash_map["string"]` to work.
3520 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
3521   `Copy` data is known to be `Clone` as well.
3522
3523 Misc
3524 ----
3525
3526 * Many errors now have extended explanations that can be accessed with
3527   the `--explain` flag to `rustc`.
3528 * Many new examples have been added to the standard library
3529   documentation.
3530 * rustdoc has received a number of improvements focused on completion
3531   and polish.
3532 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
3533 * Much headway was made on ecosystem-wide CI, making it possible
3534   to [compare builds for breakage][ci-compare].
3535
3536
3537 [crates.io]: http://crates.io
3538 [clo]: https://github.com/rust-lang/rust/pull/24034
3539 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
3540 [con]: https://github.com/rust-lang/rust/pull/23875
3541 [cr]: https://github.com/rust-lang/rust/pull/23419
3542 [fe]: https://github.com/rust-lang/rust/pull/23879
3543 [ie]: https://github.com/rust-lang/rust/pull/23300
3544 [inv]: https://github.com/rust-lang/rust/pull/23938
3545 [ios]: https://github.com/rust-lang/rust/pull/24133
3546 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
3547 [lt]: https://github.com/rust-lang/rust/pull/24057
3548 [meth]: https://github.com/rust-lang/rust/pull/24056
3549 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
3550 [po]: https://github.com/rust-lang/rust/pull/24270
3551 [sf]: https://github.com/rust-lang/rust/pull/24517
3552 [slp]: https://github.com/rust-lang/rust/pull/23949
3553 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
3554 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
3555 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
3556 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
3557 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
3558 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
3559 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
3560 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
3561 [self-sized]: https://github.com/rust-lang/rust/pull/22301
3562 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
3563 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
3564 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
3565 [reflect]: https://github.com/rust-lang/rust/pull/23712
3566 [conversion]: https://github.com/rust-lang/rfcs/pull/529
3567 [num-traits]: https://github.com/rust-lang/rust/pull/23549
3568 [index-value]: https://github.com/rust-lang/rust/pull/23601
3569 [dropck]: https://github.com/rust-lang/rfcs/pull/769
3570 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
3571 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
3572 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
3573 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
3574 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
3575
3576
3577 Version 1.0.0-alpha.2 (2015-02-20)
3578 =====================================
3579
3580 * ~1300 changes, numerous bugfixes
3581
3582 * Highlights
3583
3584     * The various I/O modules were [overhauled][io-rfc] to reduce
3585       unnecessary abstractions and provide better interoperation with
3586       the underlying platform. The old `io` module remains temporarily
3587       at `std::old_io`.
3588     * The standard library now [participates in feature gating][feat],
3589       so use of unstable libraries now requires a `#![feature(...)]`
3590       attribute. The impact of this change is [described on the
3591       forum][feat-forum]. [RFC][feat-rfc].
3592
3593 * Language
3594
3595     * `for` loops [now operate on the `IntoIterator` trait][into],
3596       which eliminates the need to call `.iter()`, etc. to iterate
3597       over collections. There are some new subtleties to remember
3598       though regarding what sort of iterators various types yield, in
3599       particular that `for foo in bar { }` yields values from a move
3600       iterator, destroying the original collection. [RFC][into-rfc].
3601     * Objects now have [default lifetime bounds][obj], so you don't
3602       have to write `Box<Trait+'static>` when you don't care about
3603       storing references. [RFC][obj-rfc].
3604     * In types that implement `Drop`, [lifetimes must outlive the
3605       value][drop]. This will soon make it possible to safely
3606       implement `Drop` for types where `#[unsafe_destructor]` is now
3607       required. Read the [gorgeous RFC][drop-rfc] for details.
3608     * The fully qualified <T as Trait>::X syntax lets you set the Self
3609       type for a trait method or associated type. [RFC][ufcs-rfc].
3610     * References to types that implement `Deref<U>` now [automatically
3611       coerce to references][deref] to the dereferenced type `U`,
3612       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
3613       should eliminate many unsightly uses of `&*`, as when converting
3614       from references to vectors into references to
3615       slices. [RFC][deref-rfc].
3616     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
3617       `|:|`) is obsolete and closure kind is inferred from context.
3618     * [`Self` is a keyword][Self].
3619
3620 * Libraries
3621
3622     * The `Show` and `String` formatting traits [have been
3623       renamed][fmt] to `Debug` and `Display` to more clearly reflect
3624       their related purposes. Automatically getting a string
3625       conversion to use with `format!("{:?}", something_to_debug)` is
3626       now written `#[derive(Debug)]`.
3627     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
3628       OsStr}`, provide strings in platform-specific encodings for easier
3629       interop with system APIs. [RFC][osstr-rfc].
3630     * The `boxed::into_raw` and `Box::from_raw` functions [convert
3631       between `Box<T>` and `*mut T`][boxraw], a common pattern for
3632       creating raw pointers.
3633
3634 * Tooling
3635
3636     * Certain long error messages of the form 'expected foo found bar'
3637       are now [split neatly across multiple
3638       lines][multiline]. Examples in the PR.
3639     * On Unix Rust can be [uninstalled][un] by running
3640       `/usr/local/lib/rustlib/uninstall.sh`.
3641     * The `#[rustc_on_unimplemented]` attribute, requiring the
3642       'on_unimplemented' feature, lets rustc [display custom error
3643       messages when a trait is expected to be implemented for a type
3644       but is not][onun].
3645
3646 * Misc
3647
3648     * Rust is tested against a [LALR grammar][lalr], which parses
3649       almost all the Rust files that rustc does.
3650
3651 [boxraw]: https://github.com/rust-lang/rust/pull/21318
3652 [close]: https://github.com/rust-lang/rust/pull/21843
3653 [deref]: https://github.com/rust-lang/rust/pull/21351
3654 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
3655 [drop]: https://github.com/rust-lang/rust/pull/21972
3656 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
3657 [feat]: https://github.com/rust-lang/rust/pull/21248
3658 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
3659 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
3660 [fmt]: https://github.com/rust-lang/rust/pull/21457
3661 [into]: https://github.com/rust-lang/rust/pull/20790
3662 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
3663 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
3664 [lalr]: https://github.com/rust-lang/rust/pull/21452
3665 [multiline]: https://github.com/rust-lang/rust/pull/19870
3666 [obj]: https://github.com/rust-lang/rust/pull/22230
3667 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
3668 [onun]: https://github.com/rust-lang/rust/pull/20889
3669 [osstr]: https://github.com/rust-lang/rust/pull/21488
3670 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
3671 [Self]: https://github.com/rust-lang/rust/pull/22158
3672 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
3673 [un]: https://github.com/rust-lang/rust/pull/22256
3674
3675
3676 Version 1.0.0-alpha (2015-01-09)
3677 ==================================
3678
3679   * ~2400 changes, numerous bugfixes
3680
3681   * Highlights
3682
3683     * The language itself is considered feature complete for 1.0,
3684       though there will be many usability improvements and bugfixes
3685       before the final release.
3686     * Nearly 50% of the public API surface of the standard library has
3687       been declared 'stable'. Those interfaces are unlikely to change
3688       before 1.0.
3689     * The long-running debate over integer types has been
3690       [settled][ints]: Rust will ship with types named `isize` and
3691       `usize`, rather than `int` and `uint`, for pointer-sized
3692       integers. Guidelines will be rolled out during the alpha cycle.
3693     * Most crates that are not `std` have been moved out of the Rust
3694       distribution into the Cargo ecosystem so they can evolve
3695       separately and don't need to be stabilized as quickly, including
3696       'time', 'getopts', 'num', 'regex', and 'term'.
3697     * Documentation continues to be expanded with more API coverage, more
3698       examples, and more in-depth explanations. The guides have been
3699       consolidated into [The Rust Programming Language][trpl].
3700     * "[Rust By Example][rbe]" is now maintained by the Rust team.
3701     * All official Rust binary installers now come with [Cargo], the
3702       Rust package manager.
3703
3704 * Language
3705
3706     * Closures have been [completely redesigned][unboxed] to be
3707       implemented in terms of traits, can now be used as generic type
3708       bounds and thus monomorphized and inlined, or via an opaque
3709       pointer (boxed) as in the old system. The new system is often
3710       referred to as 'unboxed' closures.
3711     * Traits now support [associated types][assoc], allowing families
3712       of related types to be defined together and used generically in
3713       powerful ways.
3714     * Enum variants are [namespaced by their type names][enum].
3715     * [`where` clauses][where] provide a more versatile and attractive
3716       syntax for specifying generic bounds, though the previous syntax
3717       remains valid.
3718     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
3719       numeric types.
3720     * Rust [no longer has a runtime][rt] of any description, and only
3721       supports OS threads, not green threads.
3722     * At long last, Rust has been overhauled for 'dynamically-sized
3723       types' ([DST]), which integrates 'fat pointers' (object types,
3724       arrays, and `str`) more deeply into the type system, making it
3725       more consistent.
3726     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
3727       `..j` that produce range types and which, when combined with the
3728       `Index` operator and multidispatch, leads to a convenient slice
3729       notation, `[i..j]`.
3730     * The new range syntax revealed an ambiguity in the fixed-length
3731       array syntax, so now fixed length arrays [are written `[T;
3732       N]`][arrays].
3733     * The `Copy` trait is no longer implemented automatically. Unsafe
3734       pointers no longer implement `Sync` and `Send` so types
3735       containing them don't automatically either. `Sync` and `Send`
3736       are now 'unsafe traits' so one can "forcibly" implement them via
3737       `unsafe impl` if a type confirms to the requirements for them
3738       even though the internals do not (e.g. structs containing unsafe
3739       pointers like `Arc`). These changes are intended to prevent some
3740       footguns and are collectively known as [opt-in built-in
3741       traits][oibit] (though `Sync` and `Send` will soon become pure
3742       library types unknown to the compiler).
3743     * Operator traits now take their operands [by value][ops], and
3744       comparison traits can use multidispatch to compare one type
3745       against multiple other types, allowing e.g. `String` to be
3746       compared with `&str`.
3747     * `if let` and `while let` are no longer feature-gated.
3748     * Rust has adopted a more [uniform syntax for escaping unicode
3749       characters][unicode].
3750     * `macro_rules!` [has been declared stable][mac]. Though it is a
3751       flawed system it is sufficiently popular that it must be usable
3752       for 1.0. Effort has gone into [future-proofing][mac-future] it
3753       in ways that will allow other macro systems to be developed in
3754       parallel, and won't otherwise impact the evolution of the
3755       language.
3756     * The prelude has been [pared back significantly][prelude] such
3757       that it is the minimum necessary to support the most pervasive
3758       code patterns, and through [generalized where clauses][where]
3759       many of the prelude extension traits have been consolidated.
3760     * Rust's rudimentary reflection [has been removed][refl], as it
3761       incurred too much code generation for little benefit.
3762     * [Struct variants][structvars] are no longer feature-gated.
3763     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
3764       known as 'higher-ranked trait bounds', this crucially allows
3765       unboxed closures to work.
3766     * Macros invocations surrounded by parens or square brackets and
3767       not terminated by a semicolon are [parsed as
3768       expressions][macros], which makes expressions like `vec![1i32,
3769       2, 3].len()` work as expected.
3770     * Trait objects now implement their traits automatically, and
3771       traits that can be coerced to objects now must be [object
3772       safe][objsafe].
3773     * Automatically deriving traits is now done with `#[derive(...)]`
3774       not `#[deriving(...)]` for [consistency with other naming
3775       conventions][derive].
3776     * Importing the containing module or enum at the same time as
3777       items or variants they contain is [now done with `self` instead
3778       of `mod`][self], as in use `foo::{self, bar}`
3779     * Glob imports are no longer feature-gated.
3780     * The `box` operator and `box` patterns have been feature-gated
3781       pending a redesign. For now unique boxes should be allocated
3782       like other containers, with `Box::new`.
3783
3784 * Libraries
3785
3786     * A [series][coll1] of [efforts][coll2] to establish
3787       [conventions][coll3] for collections types has resulted in API
3788       improvements throughout the standard library.
3789     * New [APIs for error handling][err] provide ergonomic interop
3790       between error types, and [new conventions][err-conv] describe
3791       more clearly the recommended error handling strategies in Rust.
3792     * The `fail!` macro has been renamed to [`panic!`][panic] so that
3793       it is easier to discuss failure in the context of error handling
3794       without making clarifications as to whether you are referring to
3795       the 'fail' macro or failure more generally.
3796     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
3797       syscall when available.
3798     * The 'serialize' crate has been renamed 'rustc-serialize' and
3799       moved out of the distribution to Cargo. Although it is widely
3800       used now, it is expected to be superseded in the near future.
3801     * The `Show` formatter, typically implemented with
3802       `#[derive(Show)]` is [now requested with the `{:?}`
3803       specifier][show] and is intended for use by all types, for uses
3804       such as `println!` debugging. The new `String` formatter must be
3805       implemented by hand, uses the `{}` specifier, and is intended
3806       for full-fidelity conversions of things that can logically be
3807       represented as strings.
3808
3809 * Tooling
3810
3811     * [Flexible target specification][flex] allows rustc's code
3812       generation to be configured to support otherwise-unsupported
3813       platforms.
3814     * Rust comes with rust-gdb and rust-lldb scripts that launch their
3815       respective debuggers with Rust-appropriate pretty-printing.
3816     * The Windows installation of Rust is distributed with the
3817       MinGW components currently required to link binaries on that
3818       platform.
3819
3820 * Misc
3821
3822     * Nullable enum optimizations have been extended to more types so
3823       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
3824       space than the inner types themselves.
3825     * Work has begun on supporting AArch64.
3826
3827 [Cargo]: https://crates.io
3828 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
3829 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
3830 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
3831 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
3832 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
3833 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
3834 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
3835 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
3836 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
3837 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
3838 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
3839 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
3840 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
3841 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
3842 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
3843 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
3844 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
3845 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
3846 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
3847 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
3848 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
3849 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
3850 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
3851 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
3852 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
3853 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
3854 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
3855 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
3856 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
3857 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
3858 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
3859 [trpl]: https://doc.rust-lang.org/book/index.html
3860 [rbe]: http://rustbyexample.com/
3861
3862
3863 Version 0.12.0 (2014-10-09)
3864 =============================
3865
3866   * ~1900 changes, numerous bugfixes
3867
3868   * Highlights
3869
3870     * The introductory documentation (now called The Rust Guide) has
3871       been completely rewritten, as have a number of supplementary
3872       guides.
3873     * Rust's package manager, Cargo, continues to improve and is
3874       sometimes considered to be quite awesome.
3875     * Many API's in `std` have been reviewed and updated for
3876       consistency with the in-development Rust coding
3877       guidelines. The standard library documentation tracks
3878       stabilization progress.
3879     * Minor libraries have been moved out-of-tree to the rust-lang org
3880       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
3881       be installed with Cargo.
3882     * Lifetime elision allows lifetime annotations to be left off of
3883       function declarations in many common scenarios.
3884     * Rust now works on 64-bit Windows.
3885
3886   * Language
3887     * Indexing can be overloaded with the `Index` and `IndexMut`
3888       traits.
3889     * The `if let` construct takes a branch only if the `let` pattern
3890       matches, currently behind the 'if_let' feature gate.
3891     * 'where clauses', a more flexible syntax for specifying trait
3892       bounds that is more aesthetic, have been added for traits and
3893       free functions. Where clauses will in the future make it
3894       possible to constrain associated types, which would be
3895       impossible with the existing syntax.
3896     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
3897       the 'slicing_syntax' feature gate, and can be overloaded with
3898       the `Slice` or `SliceMut` traits.
3899     * The syntax for matching of sub-slices has been changed to use a
3900       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
3901       consistency with other uses of `..` and to future-proof
3902       potential additional uses of the syntax.
3903     * The syntax for matching inclusive ranges in patterns has changed
3904       from `0..3` to `0...4` to be consistent with the exclusive range
3905       syntax for slicing.
3906     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
3907       c]`) has been put behind the 'advanced_slice_patterns' feature
3908       gate and may be removed in the future.
3909     * Components of tuples and tuple structs can be extracted using
3910       the `value.0` syntax, currently behind the `tuple_indexing`
3911       feature gate.
3912     * The `#[crate_id]` attribute is no longer supported; versioning
3913       is handled by the package manager.
3914     * Renaming crate imports are now written `extern crate foo as bar`
3915       instead of `extern crate bar = foo`.
3916     * Renaming use statements are now written `use foo as bar` instead
3917       of `use bar = foo`.
3918     * `let` and `match` bindings and argument names in macros are now
3919       hygienic.
3920     * The new, more efficient, closure types ('unboxed closures') have
3921       been added under a feature gate, 'unboxed_closures'. These will
3922       soon replace the existing closure types, once higher-ranked
3923       trait lifetimes are added to the language.
3924     * `move` has been added as a keyword, for indicating closures
3925       that capture by value.
3926     * Mutation and assignment is no longer allowed in pattern guards.
3927     * Generic structs and enums can now have trait bounds.
3928     * The `Share` trait is now called `Sync` to free up the term
3929       'shared' to refer to 'shared reference' (the default reference
3930       type.
3931     * Dynamically-sized types have been mostly implemented,
3932       unifying the behavior of fat-pointer types with the rest of the
3933       type system.
3934     * As part of dynamically-sized types, the `Sized` trait has been
3935       introduced, which qualifying types implement by default, and
3936       which type parameters expect by default. To specify that a type
3937       parameter does not need to be sized, write `<Sized? T>`. Most
3938       types are `Sized`, notable exceptions being unsized arrays
3939       (`[T]`) and trait types.
3940     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
3941     * Lifetime bounds can now be applied to type parameters and object
3942       types.
3943     * The old, reference counted GC type, `Gc<T>` which was once
3944       denoted by the `@` sigil, has finally been removed. GC will be
3945       revisited in the future.
3946
3947   * Libraries
3948     * Library documentation has been improved for a number of modules.
3949     * Bit-vectors, collections::bitv has been modernized.
3950     * The url crate is deprecated in favor of
3951       http://github.com/servo/rust-url, which can be installed with
3952       Cargo.
3953     * Most I/O stream types can be cloned and subsequently closed from
3954       a different thread.
3955     * A `std::time::Duration` type has been added for use in I/O
3956       methods that rely on timers, as well as in the 'time' crate's
3957       `Timespec` arithmetic.
3958     * The runtime I/O abstraction layer that enabled the green thread
3959       scheduler to do non-thread-blocking I/O has been removed, along
3960       with the libuv-based implementation employed by the green thread
3961       scheduler. This will greatly simplify the future I/O work.
3962     * `collections::btree` has been rewritten to have a more
3963       idiomatic and efficient design.
3964
3965   * Tooling
3966     * rustdoc output now indicates the stability levels of API's.
3967     * The `--crate-name` flag can specify the name of the crate
3968       being compiled, like `#[crate_name]`.
3969     * The `-C metadata` specifies additional metadata to hash into
3970       symbol names, and `-C extra-filename` specifies additional
3971       information to put into the output filename, for use by the
3972       package manager for versioning.
3973     * debug info generation has continued to improve and should be
3974       more reliable under both gdb and lldb.
3975     * rustc has experimental support for compiling in parallel
3976       using the `-C codegen-units` flag.
3977     * rustc no longer encodes rpath information into binaries by
3978       default.
3979
3980   * Misc
3981     * Stack usage has been optimized with LLVM lifetime annotations.
3982     * Official Rust binaries on Linux are more compatible with older
3983       kernels and distributions, built on CentOS 5.10.
3984
3985
3986 Version 0.11.0 (2014-07-02)
3987 ==========================
3988
3989   * ~1700 changes, numerous bugfixes
3990
3991   * Language
3992     * ~[T] has been removed from the language. This type is superseded by
3993       the Vec<T> type.
3994     * ~str has been removed from the language. This type is superseded by
3995       the String type.
3996     * ~T has been removed from the language. This type is superseded by the
3997       Box<T> type.
3998     * @T has been removed from the language. This type is superseded by the
3999       standard library's std::gc::Gc<T> type.
4000     * Struct fields are now all private by default.
4001     * Vector indices and shift amounts are both required to be a `uint`
4002       instead of any integral type.
4003     * Byte character, byte string, and raw byte string literals are now all
4004       supported by prefixing the normal literal with a `b`.
4005     * Multiple ABIs are no longer allowed in an ABI string
4006     * The syntax for lifetimes on closures/procedures has been tweaked
4007       slightly: `<'a>|A, B|: 'b + K -> T`
4008     * Floating point modulus has been removed from the language; however it
4009       is still provided by a library implementation.
4010     * Private enum variants are now disallowed.
4011     * The `priv` keyword has been removed from the language.
4012     * A closure can no longer be invoked through a &-pointer.
4013     * The `use foo, bar, baz;` syntax has been removed from the language.
4014     * The transmute intrinsic no longer works on type parameters.
4015     * Statics now allow blocks/items in their definition.
4016     * Trait bounds are separated from objects with + instead of : now.
4017     * Objects can no longer be read while they are mutably borrowed.
4018     * The address of a static is now marked as insignificant unless the
4019       #[inline(never)] attribute is placed it.
4020     * The #[unsafe_destructor] attribute is now behind a feature gate.
4021     * Struct literals are no longer allowed in ambiguous positions such as
4022       if, while, match, and for..in.
4023     * Declaration of lang items and intrinsics are now feature-gated by
4024       default.
4025     * Integral literals no longer default to `int`, and floating point
4026       literals no longer default to `f64`. Literals must be suffixed with an
4027       appropriate type if inference cannot determine the type of the
4028       literal.
4029     * The Box<T> type is no longer implicitly borrowed to &mut T.
4030     * Procedures are now required to not capture borrowed references.
4031
4032   * Libraries
4033     * The standard library is now a "facade" over a number of underlying
4034       libraries. This means that development on the standard library should
4035       be speeder due to smaller crates, as well as a clearer line between
4036       all dependencies.
4037     * A new library, libcore, lives under the standard library's facade
4038       which is Rust's "0-assumption" library, suitable for embedded and
4039       kernel development for example.
4040     * A regex crate has been added to the standard distribution. This crate
4041       includes statically compiled regular expressions.
4042     * The unwrap/unwrap_err methods on Result require a Show bound for
4043       better error messages.
4044     * The return types of the std::comm primitives have been centralized
4045       around the Result type.
4046     * A number of I/O primitives have gained the ability to time out their
4047       operations.
4048     * A number of I/O primitives have gained the ability to close their
4049       reading/writing halves to cancel pending operations.
4050     * Reverse iterator methods have been removed in favor of `rev()` on
4051       their forward-iteration counterparts.
4052     * A bitflags! macro has been added to enable easy interop with C and
4053       management of bit flags.
4054     * A debug_assert! macro is now provided which is disabled when
4055       `--cfg ndebug` is passed to the compiler.
4056     * A graphviz crate has been added for creating .dot files.
4057     * The std::cast module has been migrated into std::mem.
4058     * The std::local_data api has been migrated from freestanding functions
4059       to being based on methods.
4060     * The Pod trait has been renamed to Copy.
4061     * jemalloc has been added as the default allocator for types.
4062     * The API for allocating memory has been changed to use proper alignment
4063       and sized deallocation
4064     * Connecting a TcpStream or binding a TcpListener is now based on a
4065       string address and a u16 port. This allows connecting to a hostname as
4066       opposed to an IP.
4067     * The Reader trait now contains a core method, read_at_least(), which
4068       correctly handles many repeated 0-length reads.
4069     * The process-spawning API is now centered around a builder-style
4070       Command struct.
4071     * The :? printing qualifier has been moved from the standard library to
4072       an external libdebug crate.
4073     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
4074       have been renamed to Eq/Ord.
4075     * The select/plural methods have been removed from format!. The escapes
4076       for { and } have also changed from \{ and \} to {{ and }},
4077       respectively.
4078     * The TaskBuilder API has been re-worked to be a true builder, and
4079       extension traits for spawning native/green tasks have been added.
4080
4081   * Tooling
4082     * All breaking changes to the language or libraries now have their
4083       commit message annotated with `[breaking-change]` to allow for easy
4084       discovery of breaking changes.
4085     * The compiler will now try to suggest how to annotate lifetimes if a
4086       lifetime-related error occurs.
4087     * Debug info continues to be improved greatly with general bug fixes and
4088       better support for situations like link time optimization (LTO).
4089     * Usage of syntax extensions when cross-compiling has been fixed.
4090     * Functionality equivalent to GCC & Clang's -ffunction-sections,
4091       -fdata-sections and --gc-sections has been enabled by default
4092     * The compiler is now stricter about where it will load module files
4093       from when a module is declared via `mod foo;`.
4094     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
4095       Syntax extensions are now discovered via a "plugin registrar" type
4096       which will be extended in the future to other various plugins.
4097     * Lints have been restructured to allow for dynamically loadable lints.
4098     * A number of rustdoc improvements:
4099       * The HTML output has been visually redesigned.
4100       * Markdown is now powered by hoedown instead of sundown.
4101       * Searching heuristics have been greatly improved.
4102       * The search index has been reduced in size by a great amount.
4103       * Cross-crate documentation via `pub use` has been greatly improved.
4104       * Primitive types are now hyperlinked and documented.
4105     * Documentation has been moved from static.rust-lang.org/doc to
4106       doc.rust-lang.org
4107     * A new sandbox, play.rust-lang.org, is available for running and
4108       sharing rust code examples on-line.
4109     * Unused attributes are now more robustly warned about.
4110     * The dead_code lint now warns about unused struct fields.
4111     * Cross-compiling to iOS is now supported.
4112     * Cross-compiling to mipsel is now supported.
4113     * Stability attributes are now inherited by default and no longer apply
4114       to intra-crate usage, only inter-crate usage.
4115     * Error message related to non-exhaustive match expressions have been
4116       greatly improved.
4117
4118
4119 Version 0.10 (2014-04-03)
4120 =========================
4121
4122   * ~1500 changes, numerous bugfixes
4123
4124   * Language
4125     * A new RFC process is now in place for modifying the language.
4126     * Patterns with `@`-pointers have been removed from the language.
4127     * Patterns with unique vectors (`~[T]`) have been removed from the
4128       language.
4129     * Patterns with unique strings (`~str`) have been removed from the
4130       language.
4131     * `@str` has been removed from the language.
4132     * `@[T]` has been removed from the language.
4133     * `@self` has been removed from the language.
4134     * `@Trait` has been removed from the language.
4135     * Headers on `~` allocations which contain `@` boxes inside the type for
4136       reference counting have been removed.
4137     * The semantics around the lifetimes of temporary expressions have changed,
4138       see #3511 and #11585 for more information.
4139     * Cross-crate syntax extensions are now possible, but feature gated. See
4140       #11151 for more information. This includes both `macro_rules!` macros as
4141       well as syntax extensions such as `format!`.
4142     * New lint modes have been added, and older ones have been turned on to be
4143       warn-by-default.
4144       * Unnecessary parentheses
4145       * Uppercase statics
4146       * Camel Case types
4147       * Uppercase variables
4148       * Publicly visible private types
4149       * `#[deriving]` with raw pointers
4150     * Unsafe functions can no longer be coerced to closures.
4151     * Various obscure macros such as `log_syntax!` are now behind feature gates.
4152     * The `#[simd]` attribute is now behind a feature gate.
4153     * Visibility is no longer allowed on `extern crate` statements, and
4154       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
4155     * Trailing commas are now allowed in argument lists and tuple patterns.
4156     * The `do` keyword has been removed, it is now a reserved keyword.
4157     * Default type parameters have been implemented, but are feature gated.
4158     * Borrowed variables through captures in closures are now considered soundly.
4159     * `extern mod` is now `extern crate`
4160     * The `Freeze` trait has been removed.
4161     * The `Share` trait has been added for types that can be shared among
4162       threads.
4163     * Labels in macros are now hygienic.
4164     * Expression/statement macro invocations can be delimited with `{}` now.
4165     * Treatment of types allowed in `static mut` locations has been tweaked.
4166     * The `*` and `.` operators are now overloadable through the `Deref` and
4167       `DerefMut` traits.
4168     * `~Trait` and `proc` no longer have `Send` bounds by default.
4169     * Partial type hints are now supported with the `_` type marker.
4170     * An `Unsafe` type was introduced for interior mutability. It is now
4171       considered undefined to transmute from `&T` to `&mut T` without using the
4172       `Unsafe` type.
4173     * The #[linkage] attribute was implemented for extern statics/functions.
4174     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
4175     * `Pod` was renamed to `Copy`.
4176
4177   * Libraries
4178     * The `libextra` library has been removed. It has now been decomposed into
4179       component libraries with smaller and more focused nuggets of
4180       functionality. The full list of libraries can be found on the
4181       documentation index page.
4182     * std: `std::condition` has been removed. All I/O errors are now propagated
4183       through the `Result` type. In order to assist with error handling, a
4184       `try!` macro for unwrapping errors with an early return and a lint for
4185       unused results has been added. See #12039 for more information.
4186     * std: The `vec` module has been renamed to `slice`.
4187     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
4188       This will become the only growable vector in the future.
4189     * std: `std::io` now has more public-reexports. Types such as `BufferedReader`
4190       are now found at `std::io::BufferedReader` instead of
4191       `std::io::buffered::BufferedReader`.
4192     * std: `print` and `println` are no longer in the prelude, the `print!` and
4193       `println!` macros are intended to be used instead.
4194     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
4195       attempts to statically prevent cycles.
4196     * std: The standard distribution is adopting the policy of pushing failure
4197       to the user rather than failing in libraries. Many functions (such as
4198       `slice::last()`) now return `Option<T>` instead of `T` + failing.
4199     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
4200       deriving mode: `#[deriving(Show)]`.
4201     * std: `ToStr` is now implemented for all types implementing `Show`.
4202     * std: The formatting trait methods now take `&self` instead of `&T`
4203     * std: The `invert()` method on iterators has been renamed to `rev()`
4204     * std: `std::num` has seen a reduction in the genericity of its traits,
4205       consolidating functionality into a few core traits.
4206     * std: Backtraces are now printed on task failure if the environment
4207       variable `RUST_BACKTRACE` is present.
4208     * std: Naming conventions for iterators have been standardized. More details
4209       can be found on the wiki's style guide.
4210     * std: `eof()` has been removed from the `Reader` trait. Specific types may
4211       still implement the function.
4212     * std: Networking types are now cloneable to allow simultaneous reads/writes.
4213     * std: `assert_approx_eq!` has been removed
4214     * std: The `e` and `E` formatting specifiers for floats have been added to
4215       print them in exponential notation.
4216     * std: The `Times` trait has been removed
4217     * std: Indications of variance and opting out of builtin bounds is done
4218       through marker types in `std::kinds::marker` now
4219     * std: `hash` has been rewritten, `IterBytes` has been removed, and
4220       `#[deriving(Hash)]` is now possible.
4221     * std: `SharedChan` has been removed, `Sender` is now cloneable.
4222     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
4223     * std: `Chan::new` is now `channel()`.
4224     * std: A new synchronous channel type has been implemented.
4225     * std: A `select!` macro is now provided for selecting over `Receiver`s.
4226     * std: `hashmap` and `trie` have been moved to `libcollections`
4227     * std: `run` has been rolled into `io::process`
4228     * std: `assert_eq!` now uses `{}` instead of `{:?}`
4229     * std: The equality and comparison traits have seen some reorganization.
4230     * std: `rand` has moved to `librand`.
4231     * std: `to_{lower,upper}case` has been implemented for `char`.
4232     * std: Logging has been moved to `liblog`.
4233     * collections: `HashMap` has been rewritten for higher performance and less
4234       memory usage.
4235     * native: The default runtime is now `libnative`. If `libgreen` is desired,
4236       it can be booted manually. The runtime guide has more information and
4237       examples.
4238     * native: All I/O functionality except signals has been implemented.
4239     * green: Task spawning with `libgreen` has been optimized with stack caching
4240       and various trimming of code.
4241     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
4242     * sync: The `extra::sync` module has been updated to modern rust (and moved
4243       to the `sync` library), tweaking and improving various interfaces while
4244       dropping redundant functionality.
4245     * sync: A new `Barrier` type has been added to the `sync` library.
4246     * sync: An efficient mutex for native and green tasks has been implemented.
4247     * serialize: The `base64` module has seen some improvement. It treats
4248       newlines better, has non-string error values, and has seen general
4249       cleanup.
4250     * fourcc: A `fourcc!` macro was introduced
4251     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
4252       hexadecimal literal.
4253
4254   * Tooling
4255     * `rustpkg` has been deprecated and removed from the main repository. Its
4256       replacement, `cargo`, is under development.
4257     * Nightly builds of rust are now available
4258     * The memory usage of rustc has been improved many times throughout this
4259       release cycle.
4260     * The build process supports disabling rpath support for the rustc binary
4261       itself.
4262     * Code generation has improved in some cases, giving more information to the
4263       LLVM optimization passes to enable more extensive optimizations.
4264     * Debuginfo compatibility with lldb on OSX has been restored.
4265     * The master branch is now gated on an android bot, making building for
4266       android much more reliable.
4267     * Output flags have been centralized into one `--emit` flag.
4268     * Crate type flags have been centralized into one `--crate-type` flag.
4269     * Codegen flags have been consolidated behind a `-C` flag.
4270     * Linking against outdated crates now has improved error messages.
4271     * Error messages with lifetimes will often suggest how to annotate the
4272       function to fix the error.
4273     * Many more types are documented in the standard library, and new guides
4274       were written.
4275     * Many `rustdoc` improvements:
4276       * code blocks are syntax highlighted.
4277       * render standalone markdown files.
4278       * the --test flag tests all code blocks by default.
4279       * exported macros are displayed.
4280       * reexported types have their documentation inlined at the location of the
4281         first reexport.
4282       * search works across crates that have been rendered to the same output
4283         directory.
4284
4285
4286 Version 0.9 (2014-01-09)
4287 ==========================
4288
4289    * ~1800 changes, numerous bugfixes
4290
4291    * Language
4292       * The `float` type has been removed. Use `f32` or `f64` instead.
4293       * A new facility for enabling experimental features (feature gating) has
4294         been added, using the crate-level `#[feature(foo)]` attribute.
4295       * Managed boxes (@) are now behind a feature gate
4296         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
4297         standard library's `Gc` or `Rc` types instead.
4298       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
4299       * Jumping back to the top of a loop is now done with `continue` instead of
4300         `loop`.
4301       * Strings can no longer be mutated through index assignment.
4302       * Raw strings can be created via the basic `r"foo"` syntax or with matched
4303         hash delimiters, as in `r###"foo"###`.
4304       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
4305         called once.
4306       * The `&fn` type is now written `|args| -> ret` to match the literal form.
4307       * `@fn`s have been removed.
4308       * `do` only works with procs in order to make it obvious what the cost
4309         of `do` is.
4310       * Single-element tuple-like structs can no longer be dereferenced to
4311         obtain the inner value. A more comprehensive solution for overloading
4312         the dereference operator will be provided in the future.
4313       * The `#[link(...)]` attribute has been replaced with
4314         `#[crate_id = "name#vers"]`.
4315       * Empty `impl`s must be terminated with empty braces and may not be
4316         terminated with a semicolon.
4317       * Keywords are no longer allowed as lifetime names; the `self` lifetime
4318         no longer has any special meaning.
4319       * The old `fmt!` string formatting macro has been removed.
4320       * `printf!` and `printfln!` (old-style formatting) removed in favor of
4321         `print!` and `println!`.
4322       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
4323       * The `extern mod foo (name = "bar")` syntax has been removed. Use
4324         `extern mod foo = "bar"` instead.
4325       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
4326       * Macros can have attributes.
4327       * Macros can expand to items with attributes.
4328       * Macros can expand to multiple items.
4329       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
4330       * Comments may be nested.
4331       * Values automatically coerce to trait objects they implement, without
4332         an explicit `as`.
4333       * Enum discriminants are no longer an entire word but as small as needed to
4334         contain all the variants. The `repr` attribute can be used to override
4335         the discriminant size, as in `#[repr(int)]` for integer-sized, and
4336         `#[repr(C)]` to match C enums.
4337       * Non-string literals are not allowed in attributes (they never worked).
4338       * The FFI now supports variadic functions.
4339       * Octal numeric literals, as in `0o7777`.
4340       * The `concat!` syntax extension performs compile-time string concatenation.
4341       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
4342         removed as Rust no longer uses segmented stacks.
4343       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
4344       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
4345         not `*`; ignoring remaining fields of a struct is also done with `..`,
4346         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
4347       * `rustc` supports the "win64" calling convention via `extern "win64"`.
4348       * `rustc` supports the "system" calling convention, which defaults to the
4349         preferred convention for the target platform, "stdcall" on 32-bit Windows,
4350         "C" elsewhere.
4351       * The `type_overflow` lint (default: warn) checks literals for overflow.
4352       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
4353       * The `attribute_usage` lint (default: warn) warns about unknown
4354         attributes.
4355       * The `unknown_features` lint (default: warn) warns about unknown
4356         feature gates.
4357       * The `dead_code` lint (default: warn) checks for dead code.
4358       * Rust libraries can be linked statically to one another
4359       * `#[link_args]` is behind the `link_args` feature gate.
4360       * Native libraries are now linked with `#[link(name = "foo")]`
4361       * Native libraries can be statically linked to a rust crate
4362         (`#[link(name = "foo", kind = "static")]`).
4363       * Native OS X frameworks are now officially supported
4364         (`#[link(name = "foo", kind = "framework")]`).
4365       * The `#[thread_local]` attribute creates thread-local (not task-local)
4366         variables. Currently behind the `thread_local` feature gate.
4367       * The `return` keyword may be used in closures.
4368       * Types that can be copied via a memcpy implement the `Pod` kind.
4369       * The `cfg` attribute can now be used on struct fields and enum variants.
4370
4371    * Libraries
4372       * std: The `option` and `result` API's have been overhauled to make them
4373         simpler, more consistent, and more composable.
4374       * std: The entire `std::io` module has been replaced with one that is
4375         more comprehensive and that properly interfaces with the underlying
4376         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
4377         implemented.
4378       * std: `io::util` contains a number of useful implementations of
4379         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
4380         `ZeroReader`, `TeeReader`.
4381       * std: The reference counted pointer type `extra::rc` moved into std.
4382       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
4383         just a wrapper around it).
4384       * std: The `Either` type has been removed.
4385       * std: `fmt::Default` can be implemented for any type to provide default
4386         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
4387       * std: The `rand` API continues to be tweaked.
4388       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
4389         on failure in gdb, is now named `rust_fail`.
4390       * std: The `each_key` and `each_value` methods on `HashMap` have been
4391         replaced by the `keys` and `values` iterators.
4392       * std: Functions dealing with type size and alignment have moved from the
4393         `sys` module to the `mem` module.
4394       * std: The `path` module was written and API changed.
4395       * std: `str::from_utf8` has been changed to cast instead of allocate.
4396       * std: `starts_with` and `ends_with` methods added to vectors via the
4397         `ImmutableEqVector` trait, which is in the prelude.
4398       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
4399         if the index is out of bounds.
4400       * std: Task failure no longer propagates between tasks, as the model was
4401         complex, expensive, and incompatible with thread-based tasks.
4402       * std: The `Any` type can be used for dynamic typing.
4403       * std: `~Any` can be passed to the `fail!` macro and retrieved via
4404         `task::try`.
4405       * std: Methods that produce iterators generally do not have an `_iter`
4406         suffix now.
4407       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
4408         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
4409       * std: `util::ignore` renamed to `prelude::drop`.
4410       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
4411         trait.
4412       * std: `vec::raw` has seen a lot of cleanup and API changes.
4413       * std: The standard library no longer includes any C++ code, and very
4414         minimal C, eliminating the dependency on libstdc++.
4415       * std: Runtime scheduling and I/O functionality has been factored out into
4416         extensible interfaces and is now implemented by two different crates:
4417         libnative, for native threading and I/O; and libgreen, for green threading
4418         and I/O. This paves the way for using the standard library in more limited
4419         embedded environments.
4420       * std: The `comm` module has been rewritten to be much faster, have a
4421         simpler, more consistent API, and to work for both native and green
4422         threading.
4423       * std: All libuv dependencies have been moved into the rustuv crate.
4424       * native: New implementations of runtime scheduling on top of OS threads.
4425       * native: New native implementations of TCP, UDP, file I/O, process spawning,
4426         and other I/O.
4427       * green: The green thread scheduler and message passing types are almost
4428         entirely lock-free.
4429       * extra: The `flatpipes` module had bitrotted and was removed.
4430       * extra: All crypto functions have been removed and Rust now has a policy of
4431         not reimplementing crypto in the standard library. In the future crypto
4432         will be provided by external crates with bindings to established libraries.
4433       * extra: `c_vec` has been modernized.
4434       * extra: The `sort` module has been removed. Use the `sort` method on
4435         mutable slices.
4436
4437    * Tooling
4438       * The `rust` and `rusti` commands have been removed, due to lack of
4439         maintenance.
4440       * `rustdoc` was completely rewritten.
4441       * `rustdoc` can test code examples in documentation.
4442       * `rustpkg` can test packages with the argument, 'test'.
4443       * `rustpkg` supports arbitrary dependencies, including C libraries.
4444       * `rustc`'s support for generating debug info is improved again.
4445       * `rustc` has better error reporting for unbalanced delimiters.
4446       * `rustc`'s JIT support was removed due to bitrot.
4447       * Executables and static libraries can be built with LTO (-Z lto)
4448       * `rustc` adds a `--dep-info` flag for communicating dependencies to
4449         build tools.
4450
4451
4452 Version 0.8 (2013-09-26)
4453 ============================
4454
4455    * ~2200 changes, numerous bugfixes
4456
4457    * Language
4458       * The `for` loop syntax has changed to work with the `Iterator` trait.
4459       * At long last, unwinding works on Windows.
4460       * Default methods are ready for use.
4461       * Many trait inheritance bugs fixed.
4462       * Owned and borrowed trait objects work more reliably.
4463       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
4464       * rustc can omit emission of code for the `debug!` macro if it is passed
4465         `--cfg ndebug`
4466       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
4467         for foo.rs, then foo/mod.rs, and will generate an error when both are
4468         present.
4469       * Strings no longer contain trailing nulls. The new `std::c_str` module
4470         provides new mechanisms for converting to C strings.
4471       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
4472       * The FFI has been overhauled such that foreign functions are called directly,
4473         instead of through a stack-switching wrapper.
4474       * Calling a foreign function must be done through a Rust function with the
4475         `#[fixed_stack_segment]` attribute.
4476       * The `externfn!` macro can be used to declare both a foreign function and
4477         a `#[fixed_stack_segment]` wrapper at once.
4478       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
4479       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
4480       * `priv` is disallowed everywhere except for struct fields and enum variants.
4481       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
4482       * `ref` bindings in irrefutable patterns work correctly now.
4483       * `char` is now prevented from containing invalid code points.
4484       * Casting to `bool` is no longer allowed.
4485       * `\0` is now accepted as an escape in chars and strings.
4486       * `yield` is a reserved keyword.
4487       * `typeof` is a reserved keyword.
4488       * Crates may be imported by URL with `extern mod foo = "url";`.
4489       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
4490       * Static vectors can be initialized with repeating elements,
4491         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
4492       * Static structs can be initialized with functional record update,
4493         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
4494       * `cfg!` can be used to conditionally execute code based on the crate
4495         configuration, similarly to `#[cfg(...)]`.
4496       * The `unnecessary_qualification` lint detects unneeded module
4497         prefixes (default: allow).
4498       * Arithmetic operations have been implemented on the SIMD types in
4499         `std::unstable::simd`.
4500       * Exchange allocation headers were removed, reducing memory usage.
4501       * `format!` implements a completely new, extensible, and higher-performance
4502         string formatting system. It will replace `fmt!`.
4503       * `print!` and `println!` write formatted strings (using the `format!`
4504         extension) to stdout.
4505       * `write!` and `writeln!` write formatted strings (using the `format!`
4506         extension) to the new Writers in `std::rt::io`.
4507       * The library section in which a function or static is placed may
4508         be specified with `#[link_section = "..."]`.
4509       * The `proto!` syntax extension for defining bounded message protocols
4510         was removed.
4511       * `macro_rules!` is hygienic for `let` declarations.
4512       * The `#[export_name]` attribute specifies the name of a symbol.
4513       * `unreachable!` can be used to indicate unreachable code, and fails
4514         if executed.
4515
4516    * Libraries
4517       * std: Transitioned to the new runtime, written in Rust.
4518       * std: Added an experimental I/O library, `rt::io`, based on the new
4519         runtime.
4520       * std: A new generic `range` function was added to the prelude, replacing
4521         `uint::range` and friends.
4522       * std: `range_rev` no longer exists. Since range is an iterator it can be
4523         reversed with `range(lo, hi).invert()`.
4524       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
4525         renamed to `unwrap_or`.
4526       * std: The `iterator` module was renamed to `iter`.
4527       * std: Integral types now support the `checked_add`, `checked_sub`, and
4528         `checked_mul` operations for detecting overflow.
4529       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
4530         consistency.
4531       * std: Methods are standardizing on conventions for casting methods:
4532         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
4533         and cheap casts.
4534       * std: The `CString` type in `c_str` provides new ways to convert to and
4535         from C strings.
4536       * std: `DoubleEndedIterator` can yield elements in two directions.
4537       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
4538         two splices.
4539       * std: `str::from_bytes` renamed to `str::from_utf8`.
4540       * std: `pop_opt` and `shift_opt` methods added to vectors.
4541       * std: The task-local data interface no longer uses @, and keys are
4542         no longer function pointers.
4543       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
4544       * std: Added `SharedPort` to `comm`.
4545       * std: `Eq` has a default method for `ne`; only `eq` is required
4546         in implementations.
4547       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
4548         is required in implementations.
4549       * std: `is_utf8` performance is improved, impacting many string functions.
4550       * std: `os::MemoryMap` provides cross-platform mmap.
4551       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
4552         are not 'in-bounds' are considered undefined.
4553       * std: Many freestanding functions in `vec` removed in favor of methods.
4554       * std: Many freestanding functions on scalar types removed in favor of
4555         methods.
4556       * std: Many options to task builders were removed since they don't make
4557         sense in the new scheduler design.
4558       * std: More containers implement `FromIterator` so can be created by the
4559         `collect` method.
4560       * std: More complete atomic types in `unstable::atomics`.
4561       * std: `comm::PortSet` removed.
4562       * std: Mutating methods in the `Set` and `Map` traits have been moved into
4563         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
4564         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
4565         default implementations.
4566       * std: Various `from_str` functions were removed in favor of a generic
4567         `from_str` which is available in the prelude.
4568       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
4569       * extra: `dlist`, the doubly-linked list was modernized.
4570       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
4571       * extra: Added `glob` module, replacing `std::os::glob`.
4572       * extra: `rope` was removed.
4573       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
4574       * extra: `net`, and `timer` were removed. The experimental replacements
4575         are `std::rt::io::net` and `std::rt::io::timer`.
4576       * extra: Iterators implemented for `SmallIntMap`.
4577       * extra: Iterators implemented for `Bitv` and `BitvSet`.
4578       * extra: `SmallIntSet` removed. Use `BitvSet`.
4579       * extra: Performance of JSON parsing greatly improved.
4580       * extra: `semver` updated to SemVer 2.0.0.
4581       * extra: `term` handles more terminals correctly.
4582       * extra: `dbg` module removed.
4583       * extra: `par` module removed.
4584       * extra: `future` was cleaned up, with some method renames.
4585       * extra: Most free functions in `getopts` were converted to methods.
4586
4587    * Other
4588       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
4589       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
4590         similarly to gcc's `--march` flag.
4591       * rustc's performance compiling small crates is much better.
4592       * rustpkg has received many improvements.
4593       * rustpkg supports git tags as package IDs.
4594       * rustpkg builds into target-specific directories so it can be used for
4595         cross-compiling.
4596       * The number of concurrent test tasks is controlled by the environment
4597         variable RUST_TEST_TASKS.
4598       * The test harness can now report metrics for benchmarks.
4599       * All tools have man pages.
4600       * Programs compiled with `--test` now support the `-h` and `--help` flags.
4601       * The runtime uses jemalloc for allocations.
4602       * Segmented stacks are temporarily disabled as part of the transition to
4603         the new runtime. Stack overflows are possible!
4604       * A new documentation backend, rustdoc_ng, is available for use. It is
4605         still invoked through the normal `rustdoc` command.
4606
4607
4608 Version 0.7 (2013-07-03)
4609 =======================
4610
4611    * ~2000 changes, numerous bugfixes
4612
4613    * Language
4614       * `impl`s no longer accept a visibility qualifier. Put them on methods
4615         instead.
4616       * The borrow checker has been rewritten with flow-sensitivity, fixing
4617         many bugs and inconveniences.
4618       * The `self` parameter no longer implicitly means `&'self self`,
4619         and can be explicitly marked with a lifetime.
4620       * Overloadable compound operators (`+=`, etc.) have been temporarily
4621         removed due to bugs.
4622       * The `for` loop protocol now requires `for`-iterators to return `bool`
4623         so they compose better.
4624       * The `Durable` trait is replaced with the `'static` bounds.
4625       * Trait default methods work more often.
4626       * Structs with the `#[packed]` attribute have byte alignment and
4627         no padding between fields.
4628       * Type parameters bound by `Copy` must now be copied explicitly with
4629         the `copy` keyword.
4630       * It is now illegal to move out of a dereferenced unsafe pointer.
4631       * `Option<~T>` is now represented as a nullable pointer.
4632       * `@mut` does dynamic borrow checks correctly.
4633       * The `main` function is only detected at the topmost level of the crate.
4634         The `#[main]` attribute is still valid anywhere.
4635       * Struct fields may no longer be mutable. Use inherited mutability.
4636       * The `#[no_send]` attribute makes a type that would otherwise be
4637         `Send`, not.
4638       * The `#[no_freeze]` attribute makes a type that would otherwise be
4639         `Freeze`, not.
4640       * Unbounded recursion will abort the process after reaching the limit
4641         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
4642       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
4643         are never implicitly copyable.
4644       * `#[static_assert]` makes compile-time assertions about static bools.
4645       * At long last, 'argument modes' no longer exist.
4646       * The rarely used `use mod` statement no longer exists.
4647
4648    * Syntax extensions
4649       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
4650         argument list.
4651       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
4652         `Rand`, `Zero` and `ToStr` can all be automatically derived with
4653         `#[deriving(...)]`.
4654       * The `bytes!` macro returns a vector of bytes for string, u8, char,
4655         and unsuffixed integer literals.
4656
4657    * Libraries
4658       * The `core` crate was renamed to `std`.
4659       * The `std` crate was renamed to `extra`.
4660       * More and improved documentation.
4661       * std: `iterator` module for external iterator objects.
4662       * Many old-style (internal, higher-order function) iterators replaced by
4663         implementations of `Iterator`.
4664       * std: Many old internal vector and string iterators,
4665         incl. `any`, `all`. removed.
4666       * std: The `finalize` method of `Drop` renamed to `drop`.
4667       * std: The `drop` method now takes `&mut self` instead of `&self`.
4668       * std: The prelude no longer reexports any modules, only types and traits.
4669       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
4670         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
4671       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
4672         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
4673       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
4674         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
4675       * std: Many types implement `Clone`.
4676       * std: `path` type renamed to `Path`.
4677       * std: `mut` module and `Mut` type removed.
4678       * std: Many standalone functions removed in favor of methods and iterators
4679         in `vec`, `str`. In the future methods will also work as functions.
4680       * std: `reinterpret_cast` removed. Use `transmute`.
4681       * std: ascii string handling in `std::ascii`.
4682       * std: `Rand` is implemented for ~/@.
4683       * std: `run` module for spawning processes overhauled.
4684       * std: Various atomic types added to `unstable::atomic`.
4685       * std: Various types implement `Zero`.
4686       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
4687       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
4688       * std: Added `os::mkdir_recursive`.
4689       * std: Added `os::glob` function performs filesystems globs.
4690       * std: `FuzzyEq` renamed to `ApproxEq`.
4691       * std: `Map` now defines `pop` and `swap` methods.
4692       * std: `Cell` constructors converted to static methods.
4693       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
4694       * extra: `flate` module moved from `std` to `extra`.
4695       * extra: `fileinput` module for iterating over a series of files.
4696       * extra: `Complex` number type and `complex` module.
4697       * extra: `Rational` number type and `rational` module.
4698       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
4699       * extra: `term` uses terminfo now, is more correct.
4700       * extra: `arc` functions converted to methods.
4701       * extra: Implementation of fixed output size variations of SHA-2.
4702
4703    * Tooling
4704       * `unused_variable`  lint mode for unused variables (default: warn).
4705       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
4706         (default: warn).
4707       * `unused_mut` lint mode for identifying unused `mut` qualifiers
4708         (default: warn).
4709       * `dead_assignment` lint mode for unread variables (default: warn).
4710       * `unnecessary_allocation` lint mode detects some heap allocations that are
4711         immediately borrowed so could be written without allocating (default: warn).
4712       * `missing_doc` lint mode (default: allow).
4713       * `unreachable_code` lint mode (default: warn).
4714       * The `rusti` command has been rewritten and a number of bugs addressed.
4715       * rustc outputs in color on more terminals.
4716       * rustc accepts a `--link-args` flag to pass arguments to the linker.
4717       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
4718       * Compiling with `-g` will make the binary record information about
4719         dynamic borrowcheck failures for debugging.
4720       * rustdoc has a nicer stylesheet.
4721       * Various improvements to rustdoc.
4722       * Improvements to rustpkg (see the detailed release notes).
4723
4724
4725 Version 0.6 (2013-04-03)
4726 ========================
4727
4728    * ~2100 changes, numerous bugfixes
4729
4730    * Syntax changes
4731       * The self type parameter in traits is now spelled `Self`
4732       * The `self` parameter in trait and impl methods must now be explicitly
4733         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
4734       * Static methods no longer require the `static` keyword and instead
4735         are distinguished by the lack of a `self` parameter
4736       * Replaced the `Durable` trait with the `'static` lifetime
4737       * The old closure type syntax with the trailing sigil has been
4738         removed in favor of the more consistent leading sigil
4739       * `super` is a keyword, and may be prefixed to paths
4740       * Trait bounds are separated with `+` instead of whitespace
4741       * Traits are implemented with `impl Trait for Type`
4742         instead of `impl Type: Trait`
4743       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
4744       * The `export` keyword has finally been removed
4745       * The `move` keyword has been removed (see "Semantic changes")
4746       * The interior mutability qualifier on vectors, `[mut T]`, has been
4747         removed. Use `&mut [T]`, etc.
4748       * `mut` is no longer valid in `~mut T`. Use inherited mutability
4749       * `fail` is no longer a keyword. Use `fail!()`
4750       * `assert` is no longer a keyword. Use `assert!()`
4751       * `log` is no longer a keyword. use `debug!`, etc.
4752       * 1-tuples may be represented as `(T,)`
4753       * Struct fields may no longer be `mut`. Use inherited mutability,
4754         `@mut T`, `core::mut` or `core::cell`
4755       * `extern mod { ... }` is no longer valid syntax for foreign
4756         function modules. Use extern blocks: `extern { ... }`
4757       * Newtype enums removed. Use tuple-structs.
4758       * Trait implementations no longer support visibility modifiers
4759       * Pattern matching over vectors improved and expanded
4760       * `const` renamed to `static` to correspond to lifetime name,
4761         and make room for future `static mut` unsafe mutable globals.
4762       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
4763       * `Clone` implementations can be automatically generated with
4764         `#[deriving(Clone)]`
4765       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
4766         instead of `foo as Bar`.
4767       * Fixed length vector types are now written as `[int, .. 3]`
4768         instead of `[int * 3]`.
4769       * Fixed length vector types can express the length as a constant
4770         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
4771
4772    * Semantic changes
4773       * Types with owned pointers or custom destructors move by default,
4774         eliminating the `move` keyword
4775       * All foreign functions are considered unsafe
4776       * &mut is now unaliasable
4777       * Writes to borrowed @mut pointers are prevented dynamically
4778       * () has size 0
4779       * The name of the main function can be customized using #[main]
4780       * The default type of an inferred closure is &fn instead of @fn
4781       * `use` statements may no longer be "chained" - they cannot import
4782         identifiers imported by previous `use` statements
4783       * `use` statements are crate relative, importing from the "top"
4784         of the crate by default. Paths may be prefixed with `super::`
4785         or `self::` to change the search behavior.
4786       * Method visibility is inherited from the implementation declaration
4787       * Structural records have been removed
4788       * Many more types can be used in static items, including enums
4789         'static-lifetime pointers and vectors
4790       * Pattern matching over vectors improved and expanded
4791       * Typechecking of closure types has been overhauled to
4792         improve inference and eliminate unsoundness
4793       * Macros leave scope at the end of modules, unless that module is
4794         tagged with #[macro_escape]
4795
4796    * Libraries
4797       * Added big integers to `std::bigint`
4798       * Removed `core::oldcomm` module
4799       * Added pipe-based `core::comm` module
4800       * Numeric traits have been reorganized under `core::num`
4801       * `vec::slice` finally returns a slice
4802       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
4803       * Containers reorganized around traits in `core::container`
4804       * `core::dvec` removed, `~[T]` is a drop-in replacement
4805       * `core::send_map` renamed to `core::hashmap`
4806       * `std::map` removed; replaced with `core::hashmap`
4807       * `std::treemap` reimplemented as an owned balanced tree
4808       * `std::deque` and `std::smallintmap` reimplemented as owned containers
4809       * `core::trie` added as a fast ordered map for integer keys
4810       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
4811       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
4812         overload the comparison operators, whereas `TotalOrd` is used
4813         by certain container types
4814
4815    * Other
4816       * Replaced the 'cargo' package manager with 'rustpkg'
4817       * Added all-purpose 'rust' tool
4818       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
4819       * rustc now *attempts* to offer spelling suggestions
4820       * Improved support for ARM and Android
4821       * Preliminary MIPS backend
4822       * Improved foreign function ABI implementation for x86, x86_64
4823       * Various memory usage improvements
4824       * Rust code may be embedded in foreign code under limited circumstances
4825       * Inline assembler supported by new asm!() syntax extension.
4826
4827
4828 Version 0.5 (2012-12-21)
4829 ===========================
4830
4831    * ~900 changes, numerous bugfixes
4832
4833    * Syntax changes
4834       * Removed `<-` move operator
4835       * Completed the transition from the `#fmt` extension syntax to `fmt!`
4836       * Removed old fixed length vector syntax - `[T]/N`
4837       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
4838       * Macros may now expand to items and statements
4839       * `a.b()` is always parsed as a method call, never as a field projection
4840       * `Eq` and `IterBytes` implementations can be automatically generated
4841         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
4842       * Removed the special crate language for `.rc` files
4843       * Function arguments may consist of any irrefutable pattern
4844
4845    * Semantic changes
4846       * `&` and `~` pointers may point to objects
4847       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
4848       * Enum variants may be structs
4849       * Destructors can be added to all nominal types with the Drop trait
4850       * Structs and nullary enum variants may be constants
4851       * Values that cannot be implicitly copied are now automatically moved
4852         without writing `move` explicitly
4853       * `&T` may now be coerced to `*T`
4854       * Coercions happen in `let` statements as well as function calls
4855       * `use` statements now take crate-relative paths
4856       * The module and type namespaces have been merged so that static
4857         method names can be resolved under the trait in which they are
4858         declared
4859
4860    * Improved support for language features
4861       * Trait inheritance works in many scenarios
4862       * More support for explicit self arguments in methods - `self`, `&self`
4863         `@self`, and `~self` all generally work as expected
4864       * Static methods work in more situations
4865       * Experimental: Traits may declare default methods for the implementations
4866         to use
4867
4868    * Libraries
4869       * New condition handling system in `core::condition`
4870       * Timsort added to `std::sort`
4871       * New priority queue, `std::priority_queue`
4872       * Pipes for serializable types, `std::flatpipes'
4873       * Serialization overhauled to be trait-based
4874       * Expanded `getopts` definitions
4875       * Moved futures to `std`
4876       * More functions are pure now
4877       * `core::comm` renamed to `oldcomm`. Still deprecated
4878       * `rustdoc` and `cargo` are libraries now
4879
4880    * Misc
4881       * Added a preliminary REPL, `rusti`
4882       * License changed from MIT to dual MIT/APL2
4883
4884
4885 Version 0.4 (2012-10-15)
4886 ==========================
4887
4888    * ~2000 changes, numerous bugfixes
4889
4890    * Syntax
4891       * All keywords are now strict and may not be used as identifiers anywhere
4892       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
4893         'of', 'with', 'to', 'class'.
4894       * Classes are replaced with simpler structs
4895       * Explicit method self types
4896       * `ret` became `return` and `alt` became `match`
4897       * `import` is now `use`; `use is now `extern mod`
4898       * `extern mod { ... }` is now `extern { ... }`
4899       * `use mod` is the recommended way to import modules
4900       * `pub` and `priv` replace deprecated export lists
4901       * The syntax of `match` pattern arms now uses fat arrow (=>)
4902       * `main` no longer accepts an args vector; use `os::args` instead
4903
4904    * Semantics
4905       * Trait implementations are now coherent, ala Haskell typeclasses
4906       * Trait methods may be static
4907       * Argument modes are deprecated
4908       * Borrowed pointers are much more mature and recommended for use
4909       * Strings and vectors in the static region are stored in constant memory
4910       * Typestate was removed
4911       * Resolution rewritten to be more reliable
4912       * Support for 'dual-mode' data structures (freezing and thawing)
4913
4914    * Libraries
4915       * Most binary operators can now be overloaded via the traits in
4916         `core::ops'
4917       * `std::net::url` for representing URLs
4918       * Sendable hash maps in `core::send_map`
4919       * `core::task' gained a (currently unsafe) task-local storage API
4920
4921    * Concurrency
4922       * An efficient new intertask communication primitive called the pipe,
4923         along with a number of higher-level channel types, in `core::pipes`
4924       * `std::arc`, an atomically reference counted, immutable, shared memory
4925         type
4926       * `std::sync`, various exotic synchronization tools based on arcs and pipes
4927       * Futures are now based on pipes and sendable
4928       * More robust linked task failure
4929       * Improved task builder API
4930
4931    * Other
4932       * Improved error reporting
4933       * Preliminary JIT support
4934       * Preliminary work on precise GC
4935       * Extensive architectural improvements to rustc
4936       * Begun a transition away from buggy C++-based reflection (shape) code to
4937         Rust-based (visitor) code
4938       * All hash functions and tables converted to secure, randomized SipHash
4939
4940
4941 Version 0.3  (2012-07-12)
4942 ========================
4943
4944    * ~1900 changes, numerous bugfixes
4945
4946    * New coding conveniences
4947       * Integer-literal suffix inference
4948       * Per-item control over warnings, errors
4949       * #[cfg(windows)] and #[cfg(unix)] attributes
4950       * Documentation comments
4951       * More compact closure syntax
4952       * 'do' expressions for treating higher-order functions as
4953         control structures
4954       * *-patterns (wildcard extended to all constructor fields)
4955
4956    * Semantic cleanup
4957       * Name resolution pass and exhaustiveness checker rewritten
4958       * Region pointers and borrow checking supersede alias
4959         analysis
4960       * Init-ness checking is now provided by a region-based liveness
4961         pass instead of the typestate pass; same for last-use analysis
4962       * Extensive work on region pointers
4963
4964    * Experimental new language features
4965       * Slices and fixed-size, interior-allocated vectors
4966       * #!-comments for lang versioning, shell execution
4967       * Destructors and iface implementation for classes;
4968         type-parameterized classes and class methods
4969       * 'const' type kind for types that can be used to implement
4970         shared-memory concurrency patterns
4971
4972    * Type reflection
4973
4974    * Removal of various obsolete features
4975       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
4976                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
4977
4978       * Constructs: do-while loops ('do' repurposed), fn binding,
4979                     resources (replaced by destructors)
4980
4981    * Compiler reorganization
4982       * Syntax-layer of compiler split into separate crate
4983       * Clang (from LLVM project) integrated into build
4984       * Typechecker split into sub-modules
4985
4986    * New library code
4987       * New time functions
4988       * Extension methods for many built-in types
4989       * Arc: atomic-refcount read-only / exclusive-use shared cells
4990       * Par: parallel map and search routines
4991       * Extensive work on libuv interface
4992       * Much vector code moved to libraries
4993       * Syntax extensions: #line, #col, #file, #mod, #stringify,
4994         #include, #include_str, #include_bin
4995
4996    * Tool improvements
4997       * Cargo automatically resolves dependencies
4998
4999
5000 Version 0.2  (2012-03-29)
5001 =========================
5002
5003    * >1500 changes, numerous bugfixes
5004
5005    * New docs and doc tooling
5006
5007    * New port: FreeBSD x86_64
5008
5009    * Compilation model enhancements
5010       * Generics now specialized, multiply instantiated
5011       * Functions now inlined across separate crates
5012
5013    * Scheduling, stack and threading fixes
5014       * Noticeably improved message-passing performance
5015       * Explicit schedulers
5016       * Callbacks from C
5017       * Helgrind clean
5018
5019    * Experimental new language features
5020       * Operator overloading
5021       * Region pointers
5022       * Classes
5023
5024    * Various language extensions
5025       * C-callback function types: 'crust fn ...'
5026       * Infinite-loop construct: 'loop { ... }'
5027       * Shorten 'mutable' to 'mut'
5028       * Required mutable-local qualifier: 'let mut ...'
5029       * Basic glob-exporting: 'export foo::*;'
5030       * Alt now exhaustive, 'alt check' for runtime-checked
5031       * Block-function form of 'for' loop, with 'break' and 'ret'.
5032
5033    * New library code
5034       * AST quasi-quote syntax extension
5035       * Revived libuv interface
5036       * New modules: core::{future, iter}, std::arena
5037       * Merged per-platform std::{os*, fs*} to core::{libc, os}
5038       * Extensive cleanup, regularization in libstd, libcore
5039
5040
5041 Version 0.1  (2012-01-20)
5042 ===============================
5043
5044    * Most language features work, including:
5045       * Unique pointers, unique closures, move semantics
5046       * Interface-constrained generics
5047       * Static interface dispatch
5048       * Stack growth
5049       * Multithread task scheduling
5050       * Typestate predicates
5051       * Failure unwinding, destructors
5052       * Pattern matching and destructuring assignment
5053       * Lightweight block-lambda syntax
5054       * Preliminary macro-by-example
5055
5056    * Compiler works with the following configurations:
5057       * Linux: x86 and x86_64 hosts and targets
5058       * macOS: x86 and x86_64 hosts and targets
5059       * Windows: x86 hosts and targets
5060
5061    * Cross compilation / multi-target configuration supported.
5062
5063    * Preliminary API-documentation and package-management tools included.
5064
5065 Known issues:
5066
5067    * Documentation is incomplete.
5068
5069    * Performance is below intended target.
5070
5071    * Standard library APIs are subject to extensive change, reorganization.
5072
5073    * Language-level versioning is not yet operational - future code will
5074      break unexpectedly.