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