]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Adjust overlap-related tests to account for cosmetic changes to error reporting behavior
[rust.git] / RELEASES.md
1 Version 1.7.0 (2016-03-03)
2 ==========================
3
4 Libraries
5 ---------
6
7 * Stabilized APIs
8   * `Path`
9     * [`Path::strip_prefix`][] (renamed from relative_from)
10     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
11   * `Ipv4Addr`
12     * [`Ipv4Addr::is_loopback`]
13     * [`Ipv4Addr::is_private`]
14     * [`Ipv4Addr::is_link_local`]
15     * [`Ipv4Addr::is_multicast`]
16     * [`Ipv4Addr::is_broadcast`]
17     * [`Ipv4Addr::is_documentation`]
18   * `Ipv6Addr`
19     * [`Ipv6Addr::is_unspecified`]
20     * [`Ipv6Addr::is_loopback`]
21     * [`Ipv6Addr::is_multicast`]
22   * `Vec`
23     * [`Vec::as_slice`]
24     * [`Vec::as_mut_slice`]
25   * `String`
26     * [`String::as_str`]
27     * [`String::as_mut_str`]
28   * Slices
29     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
30     be the same length
31     * `<[T]>::`[`sort_by_key`]
32   * checked, saturated, and overflowing operations
33     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
34     * [`i32::saturating_mul`]
35     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
36     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
37     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
38     * [`u32::saturating_mul`]
39     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
40     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
41     * and checked, saturated, and overflowing operations for other primitive types
42   * FFI
43     * [`ffi::IntoStringError`]
44     * [`CString::into_string`]
45     * [`CString::into_bytes`]
46     * [`CString::into_bytes_with_nul`]
47     * `From<CString> for Vec<u8>`
48   * `IntoStringError`
49     * [`IntoStringError::into_cstring`]
50     * [`IntoStringError::utf8_error`]
51     * `Error for IntoStringError`
52   * Hashing
53     * [`std::hash::BuildHasher`]
54     * [`BuildHasher::Hasher`]
55     * [`BuildHasher::build_hasher`]
56     * [`std::hash::BuildHasherDefault`]
57     * [`HashMap::with_hasher`]
58     * [`HashMap::with_capacity_and_hasher`]
59     * [`HashSet::with_hasher`]
60     * [`HashSet::with_capacity_and_hasher`]
61     * [`std::collections::hash_map::RandomState`]
62     * [`RandomState::new`]
63 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
64   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
65   from bytes is faster.
66 * [The performance of `LineWriter` (and thus `io::stdout`) was
67   improved by using `memchr` to search for newlines][1.7m].
68 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
69   `f64` variants were stabilized previously.
70 * [`BTreeMap` was rewritten to use less memory and improve the performance
71   of insertion and iteration, the latter by as much as 5x][1.7bm].
72 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
73   covariant over their contained type][1.7bt].
74 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
75   over their contained type][1.7ll].
76 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
77   searching methods.
78 * [`Any` is implemented for unsized types][1.7a].
79 * [`Hash` is implemented for `Duration`][1.7h].
80
81 Misc
82 ----
83
84 * [When running tests with `--test`, rustdoc will pass `--cfg`
85   arguments to the compiler][1.7dt].
86 * [The compiler is built with RPATH information by default][1.7rpa].
87   This means that it will be possible to run `rustc` when installed in
88   unusual configurations without configuring the dynamic linker search
89   path explicitly.
90 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
91   any RPATH entries (emitted with `-C rpath`) *not* take precedence
92   over `LD_LIBRARY_PATH`.
93
94 Cargo
95 -----
96
97 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
98   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
99 * [The `rerun-if-changed` build script directive no longer causes the
100   build script to incorrectly run twice in certain scenarios][1.7rr].
101
102 Compatibility Notes
103 -------------------
104
105 * Soundness fixes to the interactions between associated types and
106   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
107   code that violates the new rules. This is a significant change that
108   is known to break existing code, so it has emitted warnings for the
109   new error cases since 1.4 to give crate authors time to adapt. The
110   details of what is changing are subtle; read the RFC for more.
111 * [Several bugs in the compiler's visibility calculations were
112   fixed][1.7v]. Since this was found to break significant amounts of
113   code, the new errors will be emitted as warnings for several release
114   cycles, under the `private_in_public` lint.
115 * Defaulted type parameters were accidentally accepted in positions
116   that were not intended. In this release, [defaulted type parameters
117   appearing outside of type definitions will generate a
118   warning][1.7d], which will become an error in future releases.
119 * [Parsing "." as a float results in an error instead of
120   0][1.7p]. That is, `".".parse::<f32>()` returns `Err`, not `Ok(0)`.
121 * [Borrows of closure parameters may not outlive the closure][1.7bc].
122
123 [1.7a]: https://github.com/rust-lang/rust/pull/30928
124 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
125 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
126 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
127 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
128 [1.7d]: https://github.com/rust-lang/rust/pull/30724
129 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
130 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
131 [1.7f]: https://github.com/rust-lang/rust/pull/30672
132 [1.7h]: https://github.com/rust-lang/rust/pull/30818
133 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
134 [1.7m]: https://github.com/rust-lang/rust/pull/30381
135 [1.7p]: https://github.com/rust-lang/rust/pull/30681
136 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
137 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
138 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
139 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
140 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
141 [1.7v]: https://github.com/rust-lang/rust/pull/29973
142 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
143 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
144 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
145 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
146 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
147 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
148 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
149 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
150 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
151 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
152 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
153 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
154 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
155 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
156 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
157 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
158 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
159 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
160 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
161 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
162 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
163 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
164 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
165 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
166 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
167 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
168 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
169 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
170 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
171 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
172 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
173 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
174 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
175 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
176 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
177 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
178 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
179 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
180 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
181 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
182 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
183 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
184 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
185 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
186 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
187 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
188 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
189 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
190 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
191 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
192 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
193 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
194 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
195 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
196 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
197 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
198 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
199 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
200 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
201 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
202
203
204 Version 1.6.0 (2016-01-21)
205 ==========================
206
207 Language
208 --------
209
210 * The `#![no_std]` attribute causes a crate to not be linked to the
211   standard library, but only the [core library][1.6co], as described
212   in [RFC 1184]. The core library defines common types and traits but
213   has no platform dependencies whatsoever, and is the basis for Rust
214   software in environments that cannot support a full port of the
215   standard library, such as operating systems. Most of the core
216   library is now stable.
217
218 Libraries
219 ---------
220
221 * Stabilized APIs:
222   [`Read::read_exact`],
223   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
224   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
225   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
226   [`os::unix::fs::DirBuilderExt`],
227   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
228   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
229   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
230   [`collections::hash_map::Drain`],
231   [`collections::hash_map::HashMap::drain`],
232   [`collections::hash_set::Drain`],
233   [`collections::hash_set::HashSet::drain`],
234   [`collections::binary_heap::Drain`],
235   [`collections::binary_heap::BinaryHeap::drain`],
236   [`Vec::extend_from_slice`][] (renamed from `push_all`),
237   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
238   [`RwLock::into_inner`],
239   [`Iterator::min_by_key`][] (renamed from `min_by`),
240   [`Iterator::max_by_key`][] (renamed from `max_by`).
241 * The [core library][1.6co] is stable, as are most of its APIs.
242 * [The `assert_eq!` macro supports arguments that don't implement
243   `Sized`][1.6ae], such as arrays. In this way it behaves more like
244   `assert!`.
245 * Several timer functions that take duration in milliseconds [are
246   deprecated in favor of those that take `Duration`][1.6ms]. These
247   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
248   `thread::park_timeout_ms`.
249 * The algorithm by which `Vec` reserves additional elements was
250   [tweaked to not allocate excessive space][1.6a] while still growing
251   exponentially.
252 * `From` conversions are [implemented from integers to floats][1.6f]
253   in cases where the conversion is lossless. Thus they are not
254   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
255   or `f64`. They are also not implemented for `isize` and `usize`
256   because the implementations would be platform-specific. `From` is
257   also implemented from `f32` to `f64`.
258 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
259 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
260 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
261 * [`BinaryHeap` was refactored][1.6bh] for modest performance
262   improvements.
263 * Sorting slices that are already sorted [is 50% faster in some
264   cases][1.6s].
265
266 Cargo
267 -----
268
269 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
270 * Cargo build scripts can specify their dependencies by emitting the
271   [`rerun-if-changed`][1.6rr] key.
272 * crates.io will reject publication of crates with dependencies that
273   have a wildcard version constraint. Crates with wildcard
274   dependencies were seen to cause a variety of problems, as described
275   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
276   warning.
277 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
278   release folder.  A variety of artifacts that Cargo failed to clean
279   are now correctly deleted.
280
281 Misc
282 ----
283
284 * The `unreachable_code` lint [warns when a function call's argument
285   diverges][1.6dv].
286 * The parser indicates [failures that may be caused by
287   confusingly-similar Unicode characters][1.6uc]
288 * Certain macro errors [are reported at definition time][1.6m], not
289   expansion.
290
291 Compatibility Notes
292 -------------------
293
294 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
295   environment variable when locating crates. This was a pre-cargo
296   feature for integrating with the package manager that was
297   accidentally never removed.
298 * [A number of bugs were fixed in the privacy checker][1.6p] that
299   could cause previously-accepted code to break.
300 * [Modules and unit/tuple structs may not share the same name][1.6ts].
301 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
302   struct pattern syntax (`Foo(..)`) can no longer be used to match
303   unit structs. This is a warning now, but will become an error in
304   future releases. Patterns that share the same name as a const are
305   now an error.
306 * A bug was fixed that causes [rustc not to apply default type
307   parameters][1.6xc] when resolving certain method implementations of
308   traits defined in other crates.
309
310 [1.6a]: https://github.com/rust-lang/rust/pull/29454
311 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
312 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
313 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
314 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
315 [1.6co]: http://doc.rust-lang.org/beta/core/index.html
316 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
317 [1.6f]: https://github.com/rust-lang/rust/pull/29129
318 [1.6m]: https://github.com/rust-lang/rust/pull/29828
319 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
320 [1.6p]: https://github.com/rust-lang/rust/pull/29726
321 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
322 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
323 [1.6s]: https://github.com/rust-lang/rust/pull/29675
324 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
325 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
326 [1.6us]: https://github.com/rust-lang/rust/pull/29383
327 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
328 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
329 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
330 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
331 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
332 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
333 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
334 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
335 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
336 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
337 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
338 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
339 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
340 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
341 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
342 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
343 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
344 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
345 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
346 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
347 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
348 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
349 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
350 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
351 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
352 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
353 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
354 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
355 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
356 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
357
358
359 Version 1.5.0 (2015-12-10)
360 ==========================
361
362 * ~700 changes, numerous bugfixes
363
364 Highlights
365 ----------
366
367 * Stabilized APIs:
368   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
369   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
370   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
371   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
372   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
373   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
374   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
375   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
376   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
377   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
378   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
379   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
380   [`Path::read_link`], [`Path::symlink_metadata`],
381   [`Utf8Error::valid_up_to`], [`Vec::resize`],
382   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
383   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
384   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
385   [`slice::split_first_mut`], [`slice::split_first`],
386   [`slice::split_last_mut`], [`slice::split_last`],
387   [`char::from_u32_unchecked`], [`fs::canonicalize`],
388   [`str::MatchIndices`], [`str::RMatchIndices`],
389   [`str::match_indices`], [`str::rmatch_indices`],
390   [`str::slice_mut_unchecked`], [`string::ParseError`].
391 * Rust applications hosted on crates.io can be installed locally to
392   `~/.cargo/bin` with the [`cargo install`] command. Among other
393   things this makes it easier to augment Cargo with new subcommands:
394   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
395   invoked as `cargo foo`.
396 * Crates with wildcard (`*`) dependencies will [emit warnings when
397   published][1.5w]. In 1.6 it will no longer be possible to publish
398   crates with wildcard dependencies.
399
400 Breaking Changes
401 ----------------
402
403 * The rules determining when a particular lifetime must outlive
404   a particular value (known as '[dropck]') have been [modified
405   to not rely on parametricity][1.5p].
406 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
407   and `Arc`][1.5a]. Because these smart pointer types implement
408   `Deref`, this causes breakage in cases where the interior type
409   contains methods of the same name.
410 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
411   that they could drop their content. Soundness fix.
412 * All method invocations are [properly checked][1.5wf1] for
413   [well-formedness][1.5wf2]. Soundness fix.
414 * Traits whose supertraits contain `Self` are [not object
415   safe][1.5o]. Soundness fix.
416 * Target specifications support a [`no_default_libraries`][1.5nd]
417   setting that controls whether `-nodefaultlibs` is passed to the
418   linker, and in turn the `is_like_windows` setting no longer affects
419   the `-nodefaultlibs` flag.
420 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
421 * The `#[inline]` and `#[repr]` attributes [can only appear
422   in valid locations][1.5at].
423 * Native libraries linked from the local crate are [passed to
424   the linker before native libraries from upstream crates][1.5nl].
425 * Two rarely-used attributes, `#[no_debug]` and
426   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
427 * Negation of unsigned integers, which has been a warning for
428   several releases, [is now behind a feature gate and will
429   generate errors][1.5nu].
430 * The parser accidentally accepted visibility modifiers on
431   enum variants, a bug [which has been fixed][1.5ev].
432 * [A bug was fixed that allowed `use` statements to import unstable
433   features][1.5use].
434
435 Language
436 --------
437
438 * When evaluating expressions at compile-time that are not
439   compile-time constants (const-evaluating expressions in non-const
440   contexts), incorrect code such as overlong bitshifts and arithmetic
441   overflow will [generate a warning instead of an error][1.5ce],
442   delaying the error until runtime. This will allow the
443   const-evaluator to be expanded in the future backwards-compatibly.
444 * The `improper_ctypes` lint [no longer warns about using `isize` and
445   `usize` in FFI][1.5ict].
446
447 Libraries
448 ---------
449
450 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
451   invariant][1.5c].
452 * `Default` is [implemented for mutable slices][1.5d].
453 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
454 * There are now `From` conversions [between floating point
455   types][1.5f] where the conversions are lossless.
456 * Thera are now `From` conversions [between integer types][1.5i] where
457   the conversions are lossless.
458 * [`fs::Metadata` implements `Clone`][1.5fs].
459 * The `parse` method [accepts a leading "+" when parsing
460   integers][1.5pi].
461 * [`AsMut` is implemented for `Vec`][1.5am].
462 * The `clone_from` implementations for `String` and `BinaryHeap` [have
463   been optimized][1.5cf] and no longer rely on the default impl.
464 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
465   `unsafe extern "C"` function types now [implement `Clone`,
466   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
467   `fmt::Debug` for up to 12 arguments][1.5fp].
468 * [Dropping `Vec`s is much faster in unoptimized builds when the
469   element types don't implement `Drop`][1.5dv].
470 * A bug that caused in incorrect behavior when [combining `VecDeque`
471   with zero-sized types][1.5vdz] was resolved.
472 * [`PartialOrd` for slices is faster][1.5po].
473
474 Miscellaneous
475 -------------
476
477 * [Crate metadata size was reduced by 20%][1.5md].
478 * [Improvements to code generation reduced the size of libcore by 3.3
479   MB and rustc's memory usage by 18MB][1.5m].
480 * [Improvements to deref translation increased performance in
481   unoptimized builds][1.5dr].
482 * Various errors in trait resolution [are deduplicated to only be
483   reported once][1.5te].
484 * Rust has preliminary [support for rumprun kernels][1.5rr].
485 * Rust has preliminary [support for NetBSD on amd64][1.5na].
486
487 [1.5use]: https://github.com/rust-lang/rust/pull/28364
488 [1.5po]: https://github.com/rust-lang/rust/pull/28436
489 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
490 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
491 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
492 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
493 [1.5md]: https://github.com/rust-lang/rust/pull/28521
494 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
495 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
496 [1.5na]: https://github.com/rust-lang/rust/pull/28543
497 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
498 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
499 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
500 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
501 [1.5te]: https://github.com/rust-lang/rust/pull/28645
502 [1.5at]: https://github.com/rust-lang/rust/pull/28650
503 [1.5am]: https://github.com/rust-lang/rust/pull/28663
504 [1.5m]: https://github.com/rust-lang/rust/pull/28778
505 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
506 [1.5a]: https://github.com/rust-lang/rust/pull/28811
507 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
508 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
509 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
510 [1.5i]: https://github.com/rust-lang/rust/pull/28921
511 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
512 [1.5f]: https://github.com/rust-lang/rust/pull/29129
513 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
514 [1.5s]: https://github.com/rust-lang/rust/pull/29190
515 [1.5d]: https://github.com/rust-lang/rust/pull/29245
516 [1.5o]: https://github.com/rust-lang/rust/pull/29259
517 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
518 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
519 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
520 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
521 [1.5c]: https://github.com/rust-lang/rust/pull/29110
522 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
523 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
524 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
525 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
526 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
527 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
528 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
529 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
530 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
531 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
532 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
533 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
534 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
535 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
536 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
537 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
538 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
539 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
540 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
541 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
542 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
543 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
544 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
545 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
546 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
547 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
548 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
549 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
550 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
551 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
552 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
553 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
554 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
555 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
556 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
557 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
558 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
559 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
560 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
561 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
562 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
563 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
564 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
565 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
566 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
567 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
568 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
569 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
570 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
571 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
572 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
573 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
574 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
575 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
576
577 Version 1.4.0 (2015-10-29)
578 ==========================
579
580 * ~1200 changes, numerous bugfixes
581
582 Highlights
583 ----------
584
585 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
586   GNU) are now supported and recommended for use.
587
588 Breaking Changes
589 ----------------
590
591 * [Several changes have been made to fix type soundness and improve
592   the behavior of associated types][sound]. See [RFC 1214]. Although
593   we have mostly introduced these changes as warnings this release, to
594   become errors next release, there are still some scenarios that will
595   see immediate breakage.
596 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
597   line breaks in addition to `\n`][crlf].
598 * [Loans of `'static` lifetime extend to the end of a function][stat].
599 * [`str::parse` no longer introduces avoidable rounding error when
600   parsing floating point numbers. Together with earlier changes to
601   float formatting/output, "round trips" like f.to_string().parse()
602   now preserve the value of f exactly. Additionally, leading plus
603   signs are now accepted][fp3].
604
605
606 Language
607 --------
608
609 * `use` statements that import multiple items [can now rename
610   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
611 * [Binops work correctly on fat pointers][binfat].
612 * `pub extern crate`, which does not behave as expected, [issues a
613   warning][pec] until a better solution is found.
614
615 Libraries
616 ---------
617
618 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
619   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
620   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
621   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
622   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
623   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
624   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
625   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
626   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
627   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
628   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
629   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
630   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
631   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
632   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
633   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
634   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
635   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
636   [`thread::sleep`].
637 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
638   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
639   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
640   `f64::from_str_radix`.
641 * [Reverse-searching strings is faster with the 'two-way'
642   algorithm][s].
643 * [`std::io::copy` allows `?Sized` arguments][cc].
644 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
645   [override `count`, `nth` and `last` with an O(1)
646   implementation][it].
647 * [`Default` is implemented for arrays up to `[T; 32]`][d].
648 * [`IntoRawFd` has been added to the Unix-specific prelude,
649   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
650   prelude][pr].
651 * [`Extend<String>` and `FromIterator<String` are both implemented for
652   `String`][es].
653 * [`IntoIterator` is implemented for references to `Option` and
654   `Result`][into2].
655 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
656   Copy`][ext] as part of [RFC 839]. This will cause type inferance
657   breakage in rare situations.
658 * [`BinaryHeap` implements `Debug`][bh2].
659 * [`Borrow` and `BorrowMut` are implemented for fixed-size
660   arrays][bm].
661 * [`extern fn`s with the "Rust" and "C" ABIs implement common
662   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
663 * [String comparison is faster][faststr].
664 * `&mut T` where `T: std::fmt::Write` [also implements
665   `std::fmt::Write`][mutw].
666 * [A stable regression in `VecDeque::push_back` and other
667   capicity-altering methods that caused panics for zero-sized types
668   was fixed][vd].
669 * [Function pointers implement traits for up to 12 parameters][fp2].
670
671 Miscellaneous
672 -------------
673
674 * The compiler [no longer uses the 'morestack' feature to prevent
675   stack overflow][mm]. Instead it uses guard pages and stack
676   probes (though stack probes are not yet implemented on any platform
677   but Windows).
678 * [The compiler matches traits faster when projections are involved][p].
679 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
680   `usize`][ffi].
681 * [Cargo now displays useful information about what its doing during
682   `cargo update`][cu].
683
684 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
685 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
686 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
687 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
688 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
689 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
690 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
691 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
692 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
693 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
694 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
695 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
696 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
697 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
698 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
699 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
700 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
701 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
702 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
703 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
704 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
705 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
706 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
707 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
708 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
709 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
710 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
711 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
712 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
713 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
714 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
715 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
716 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
717 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
718 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
719 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
720 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
721 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
722 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
723 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
724 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
725 [bh2]: https://github.com/rust-lang/rust/pull/28156
726 [binfat]: https://github.com/rust-lang/rust/pull/28270
727 [bm]: https://github.com/rust-lang/rust/pull/28197
728 [cc]: https://github.com/rust-lang/rust/pull/27531
729 [crlf]: https://github.com/rust-lang/rust/pull/28034
730 [cu]: https://github.com/rust-lang/cargo/pull/1931
731 [d]: https://github.com/rust-lang/rust/pull/27825
732 [dep]: https://github.com/rust-lang/rust/pull/28339
733 [es]: https://github.com/rust-lang/rust/pull/27956
734 [ext]: https://github.com/rust-lang/rust/pull/28094
735 [faststr]: https://github.com/rust-lang/rust/pull/28338
736 [ffi]: https://github.com/rust-lang/rust/pull/28779
737 [fp]: https://github.com/rust-lang/rust/pull/28268
738 [fp2]: https://github.com/rust-lang/rust/pull/28560
739 [fp3]: https://github.com/rust-lang/rust/pull/27307
740 [i]: https://github.com/rust-lang/rust/pull/27451
741 [into2]: https://github.com/rust-lang/rust/pull/28039
742 [it]: https://github.com/rust-lang/rust/pull/27652
743 [mm]: https://github.com/rust-lang/rust/pull/27338
744 [mutw]: https://github.com/rust-lang/rust/pull/28368
745 [sound]: https://github.com/rust-lang/rust/pull/27641
746 [p]: https://github.com/rust-lang/rust/pull/27866
747 [pec]: https://github.com/rust-lang/rust/pull/28486
748 [pr]: https://github.com/rust-lang/rust/pull/27896
749 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
750 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
751 [s]: https://github.com/rust-lang/rust/pull/27474
752 [stab]: https://github.com/rust-lang/rust/pull/28339
753 [stat]: https://github.com/rust-lang/rust/pull/28321
754 [vd]: https://github.com/rust-lang/rust/pull/28494
755
756 Version 1.3.0 (2015-09-17)
757 ==============================
758
759 * ~900 changes, numerous bugfixes
760
761 Highlights
762 ----------
763
764 * The [new object lifetime defaults][nold] have been [turned
765   on][nold2] after a cycle of warnings about the change. Now types
766   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
767   being interpreted as `&'a Box<Trait+'a>` to `&'a
768   Box<Trait+'static>`.
769 * [The Rustonomicon][nom] is a new book in the official documentation
770   that dives into writing unsafe Rust.
771 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
772   timekeeping is employed by other std APIs, as well as out-of-tree
773   time crates.
774
775 Breaking Changes
776 ----------------
777
778 * The [new object lifetime defaults][nold] have been [turned
779   on][nold2] after a cycle of warnings about the change.
780 * There is a known [regression][lr] in how object lifetime elision is
781   interpreted, the proper solution for which is undetermined.
782 * The `#[prelude_import]` attribute, an internal implementation
783   detail, was accidentally stabilized previously. [It has been put
784   behind the `prelude_import` feature gate][pi]. This change is
785   believed to break no existing code.
786 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
787   [more sane for dynamically sized types][dst3]. Code that relied on
788   the previous behavior is thought to be broken.
789 * The `dropck` rules, which checks that destructors can't access
790   destroyed values, [have been updated][dropck] to match the
791   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
792   cause some previously-compiling code to no longer build.
793
794 Language
795 --------
796
797 * The [new object lifetime defaults][nold] have been [turned
798   on][nold2] after a cycle of warnings about the change.
799 * Semicolons may [now follow types and paths in
800   macros](https://github.com/rust-lang/rust/pull/27000).
801 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
802   [more sane for dynamically sized types][dst3]. Code that relied on
803   the previous behavior is not known to exist, and suspected to be
804   broken.
805 * `'static` variables [may now be recursive][st].
806 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
807   implementations correctly.
808 * The `dropck` rules, which checks that destructors can't access
809   destroyed values, [have been updated][dropck] to match the
810   [RFC][dropckrfc].
811
812 Libraries
813 ---------
814
815 * The [`Duration`] API, [has been stabilized][ds], as well as the
816   `std::time` module, which presently contains only `Duration`.
817 * `Box<str>` and `Box<[T]>` both implement `Clone`.
818 * The owned C string, [`CString`], implements [`Borrow`] and the
819   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
820   these allow C strings to be borrowed and cloned in generic code.
821 * [`CStr`] implements [`Debug`].
822 * [`AtomicPtr`] implements [`Debug`].
823 * [`Error`] trait objects [can be downcast to their concrete types][e]
824   in many common configurations, using the [`is`], [`downcast`],
825   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
826   [`Any`] trait.
827 * Searching for substrings now [employs the two-way algorithm][search]
828   instead of doing a naive search. This gives major speedups to a
829   number of methods, including [`contains`][sc], [`find`][sf],
830   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
831   [`ends_with`][sew] are also faster.
832 * The performance of `PartialEq` for slices is [much faster][ps].
833 * The [`Hash`] trait offers the default method, [`hash_slice`], which
834   is overridden and optimized by the implementations for scalars.
835 * The [`Hasher`] trait now has a number of specialized `write_*`
836   methods for primitive types, for efficiency.
837 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
838   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
839   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
840   of [`std::error::Error::cause`][iec] also delegates to the inner
841   error.
842 * [`process::Child`][pc] gained the [`id`] method, which returns a
843   `u32` representing the platform-specific process identifier.
844 * The [`connect`] method on slices is deprecated, replaced by the new
845   [`join`] method (note that both of these are on the *unstable*
846   [`SliceConcatExt`] trait, but through the magic of the prelude are
847   available to stable code anyway).
848 * The [`Div`] operator is implemented for [`Wrapping`] types.
849 * [`DerefMut` is implemented for `String`][dms].
850 * Performance of SipHash (the default hasher for `HashMap`) is
851   [better for long data][sh].
852 * [`AtomicPtr`] implements [`Send`].
853 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
854   are now [specialized to use uninitalized buffers for increased
855   performance][rte].
856 * Lifetime parameters of foreign functions [are now resolved
857   properly][f].
858
859 Misc
860 ----
861
862 * Rust can now, with some coercion, [produce programs that run on
863   Windows XP][xp], though XP is not considered a supported platform.
864 * Porting Rust on Windows from the GNU toolchain to MSVC continues
865   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
866   recommended for use in 1.3, though should be fully-functional
867   in the [64-bit 1.4 beta][b14].
868 * On Fedora-based systems installation will [properly configure the
869   dynamic linker][fl].
870 * The compiler gained many new extended error descriptions, which can
871   be accessed with the `--explain` flag.
872 * The `dropck` pass, which checks that destructors can't access
873   destroyed values, [has been rewritten][dropck]. This fixes some
874   soundness holes, and as such will cause some previously-compiling
875   code to no longer build.
876 * `rustc` now uses [LLVM to write archive files where possible][ar].
877   Eventually this will eliminate the compiler's dependency on the ar
878   utility.
879 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
880   supported FreeBSD on x86_64).
881 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
882   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
883   more strict.
884 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
885   will kill the process instead of leaking][nlp].
886
887 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
888 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
889 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
890 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
891 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
892 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
893 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
894 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
895 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
896 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
897 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
898 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
899 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
900 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
901 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
902 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
903 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
904 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
905 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
906 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
907 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
908 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
909 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
910 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
911 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
912 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
913 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
914 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
915 [ar]: https://github.com/rust-lang/rust/pull/26926
916 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
917 [dms]: https://github.com/rust-lang/rust/pull/26241
918 [dropck]: https://github.com/rust-lang/rust/pull/27261
919 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
920 [ds]: https://github.com/rust-lang/rust/pull/26818
921 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
922 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
923 [dst3]: https://github.com/rust-lang/rust/pull/27351
924 [e]: https://github.com/rust-lang/rust/pull/24793
925 [f]: https://github.com/rust-lang/rust/pull/26588
926 [fb]: https://github.com/rust-lang/rust/pull/26959
927 [fl]: https://github.com/rust-lang/rust-installer/pull/41
928 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
929 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
930 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
931 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
932 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
933 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
934 [lic]: https://github.com/rust-lang/rust/pull/26583
935 [lnu]: https://github.com/rust-lang/rust/pull/27026
936 [lr]: https://github.com/rust-lang/rust/issues/27248
937 [lum]: https://github.com/rust-lang/rust/pull/26378
938 [lur]: https://github.com/rust-lang/rust/pull/26783
939 [nlp]: https://github.com/rust-lang/rust/pull/27176
940 [nold2]: https://github.com/rust-lang/rust/pull/27045
941 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
942 [nom]: http://doc.rust-lang.org/nightly/nomicon/
943 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
944 [pi]: https://github.com/rust-lang/rust/pull/26699
945 [ps]: https://github.com/rust-lang/rust/pull/26884
946 [rte]: https://github.com/rust-lang/rust/pull/26950
947 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
948 [search]: https://github.com/rust-lang/rust/pull/26327
949 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
950 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
951 [sh]: https://github.com/rust-lang/rust/pull/27280
952 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
953 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
954 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
955 [st]: https://github.com/rust-lang/rust/pull/26630
956 [win1]: https://github.com/rust-lang/rust/pull/26569
957 [win2]: https://github.com/rust-lang/rust/pull/26741
958 [win3]: https://github.com/rust-lang/rust/pull/26741
959 [win4]: https://github.com/rust-lang/rust/pull/27210
960 [xp]: https://github.com/rust-lang/rust/pull/26569
961
962 Version 1.2.0 (2015-08-07)
963 ==========================
964
965 * ~1200 changes, numerous bugfixes
966
967 Highlights
968 ----------
969
970 * [Dynamically-sized-type coercions][dst] allow smart pointer types
971   like `Rc` to contain types without a fixed size, arrays and trait
972   objects, finally enabling use of `Rc<[T]>` and completing the
973   implementation of DST.
974 * [Parallel codegen][parcodegen] is now working again, which can
975   substantially speed up large builds in debug mode; It also gets
976   another ~33% speedup when bootstrapping on a 4 core machine (using 8
977   jobs). It's not enabled by default, but will be "in the near
978   future". It can be activated with the `-C codegen-units=N` flag to
979   `rustc`.
980 * This is the first release with [experimental support for linking
981   with the MSVC linker and lib C on Windows (instead of using the GNU
982   variants via MinGW)][win]. It is yet recommended only for the most
983   intrepid Rusticians.
984 * Benchmark compilations are showing a 30% improvement in
985   bootstrapping over 1.1.
986
987 Breaking Changes
988 ----------------
989
990 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
991   unicode case mapping, which is a previously-planned change in
992   behavior and considered a bugfix.
993 * [`mem::align_of`] now specifies [the *minimum alignment* for
994   T][align], which is usually the alignment programs are interested
995   in, and the same value reported by clang's
996   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
997   break real code.
998 * [The `#[packed]` attribute is no longer silently accepted by the
999   compiler][packed]. This attribute did nothing and code that
1000   mentioned it likely did not work as intended.
1001 * Associated type defaults are [now behind the
1002   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
1003   defaults *did not work*, but could be mentioned syntactically. As
1004   such this breakage has minimal impact.
1005
1006 Language
1007 --------
1008
1009 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
1010   matching against dereferencable values.
1011
1012 Libraries
1013 ---------
1014
1015 * The [`Extend`] trait, which grows a collection from an iterator, is
1016   implemented over iterators of references, for `String`, `Vec`,
1017   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
1018   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
1019 * The [`iter::once`] function returns an iterator that yields a single
1020   element, and [`iter::empty`] returns an iterator that yields no
1021   elements.
1022 * The [`matches`] and [`rmatches`] methods on `str` return iterators
1023   over substring matches.
1024 * [`Cell`] and [`RefCell`] both implement `Eq`.
1025 * A number of methods for wrapping arithmetic are added to the
1026   integral types, [`wrapping_div`], [`wrapping_rem`],
1027   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
1028   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
1029   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
1030   type.. It is illegal for the default arithmetic operations in Rust
1031   to overflow; the desire to wrap must be explicit.
1032 * The `{:#?}` formatting specifier [displays the alternate,
1033   pretty-printed][debugfmt] form of the `Debug` formatter. This
1034   feature was actually introduced prior to 1.0 with little
1035   fanfare.
1036 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
1037   for writing data to formatted strings, similar to [`io::Write`].
1038 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
1039   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
1040   are used by code generators to emit implementations of [`Debug`].
1041 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
1042   methods that convert case, following Unicode case mapping.
1043 * It is now easier to handle poisoned locks. The [`PoisonError`]
1044   type, returned by failing lock operations, exposes `into_inner`,
1045   `get_ref`, and `get_mut`, which all give access to the inner lock
1046   guard, and allow the poisoned lock to continue to operate. The
1047   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
1048   poisoned lock without attempting to take the lock.
1049 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
1050   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
1051   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
1052   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
1053   `ChildStderr`.
1054 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
1055   malformed input.
1056
1057 Misc
1058 ----
1059
1060 * `rustc` employs smarter heuristics for guessing at [typos].
1061 * `rustc` emits more efficient code for [no-op conversions between
1062   unsafe pointers][nop].
1063 * Fat pointers are now [passed in pairs of immediate arguments][fat],
1064   resulting in faster compile times and smaller code.
1065
1066 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
1067 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
1068 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
1069 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
1070 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
1071 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
1072 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
1073 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
1074 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
1075 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
1076 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
1077 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
1078 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
1079 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
1080 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
1081 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
1082 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
1083 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
1084 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
1085 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
1086 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
1087 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
1088 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
1089 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
1090 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
1091 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
1092 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
1093 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
1094 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
1095 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
1096 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
1097 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
1098 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
1099 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
1100 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
1101 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
1102 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
1103 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
1104 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
1105 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
1106 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
1107 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
1108 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
1109 [align]: https://github.com/rust-lang/rust/pull/25646
1110 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
1111 [typos]: https://github.com/rust-lang/rust/pull/26087
1112 [nop]: https://github.com/rust-lang/rust/pull/26336
1113 [fat]: https://github.com/rust-lang/rust/pull/26411
1114 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
1115 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
1116 [packed]: https://github.com/rust-lang/rust/pull/25541
1117 [ad]: https://github.com/rust-lang/rust/pull/27382
1118 [win]: https://github.com/rust-lang/rust/pull/25350
1119
1120 Version 1.1.0 (2015-06-25)
1121 =========================
1122
1123 * ~850 changes, numerous bugfixes
1124
1125 Highlights
1126 ----------
1127
1128 * The [`std::fs` module has been expanded][fs] to expand the set of
1129   functionality exposed:
1130   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
1131     don't incur a syscall on some platforms.
1132   * A `symlink_metadata` function has been added.
1133   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
1134     access to all underlying information.
1135 * The compiler now contains extended explanations of many errors. When an error
1136   with an explanation occurs the compiler suggests using the `--explain` flag
1137   to read the explanation. Error explanations are also [available online][err-index].
1138 * Thanks to multiple [improvements][sk] to [type checking][pre], as
1139   well as other work, the time to bootstrap the compiler decreased by
1140   32%.
1141
1142 Libraries
1143 ---------
1144
1145 * The [`str::split_whitespace`] method splits a string on unicode
1146   whitespace boundaries.
1147 * On both Windows and Unix, new extension traits provide conversion of
1148   I/O types to and from the underlying system handles. On Unix, these
1149   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
1150   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
1151   `TcpListener`, and `UpdSocket`. Further implementations for
1152   `std::process` will be stabilized later.
1153 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
1154   Windows, symlinks can be created with
1155   `std::os::windows::symlink_dir` and
1156   `std::os::windows::symlink_file`.
1157 * The `mpsc::Receiver` type can now be converted into an iterator with
1158   `into_iter` on the [`IntoIterator`] trait.
1159 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
1160   implementation of the [`From`] trait.
1161 * The `Debug` implementation for `RangeFull` [creates output that is
1162   more consistent with other implementations][rf].
1163 * [`Debug` is implemented for `File`][file].
1164 * The `Default` implementation for `Arc` [no longer requires `Sync +
1165   Send`][arc].
1166 * [The `Iterator` methods `count`, `nth`, and `last` have been
1167   overridden for slices to have O(1) performance instead of O(n)][si].
1168 * Incorrect handling of paths on Windows has been improved in both the
1169   compiler and the standard library.
1170 * [`AtomicPtr` gained a `Default` implementation][ap].
1171 * In accordance with Rust's policy on arithmetic overflow `abs` now
1172   [panics on overflow when debug assertions are enabled][abs].
1173 * The [`Cloned`] iterator, which was accidentally left unstable for
1174   1.0 [has been stabilized][c].
1175 * The [`Incoming`] iterator, which iterates over incoming TCP
1176   connections, and which was accidentally unnamable in 1.0, [is now
1177   properly exported][inc].
1178 * [`BinaryHeap`] no longer corrupts itself [when functions called by
1179   `sift_up` or `sift_down` panic][bh].
1180 * The [`split_off`] method of `LinkedList` [no longer corrupts
1181   the list in certain scenarios][ll].
1182
1183 Misc
1184 ----
1185
1186 * Type checking performance [has improved notably][sk] with
1187   [multiple improvements][pre].
1188 * The compiler [suggests code changes][ch] for more errors.
1189 * rustc and it's build system have experimental support for [building
1190   toolchains against MUSL][m] instead of glibc on Linux.
1191 * The compiler defines the `target_env` cfg value, which is used for
1192   distinguishing toolchains that are otherwise for the same
1193   platform. Presently this is set to `gnu` for common GNU Linux
1194   targets and for MinGW targets, and `musl` for MUSL Linux targets.
1195 * The [`cargo rustc`][crc] command invokes a build with custom flags
1196   to rustc.
1197 * [Android executables are always position independent][pie].
1198 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
1199   with `Drop`][drop].
1200
1201 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
1202 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
1203 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
1204 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
1205 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
1206 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
1207 [rf]: https://github.com/rust-lang/rust/pull/24491
1208 [err-index]: https://doc.rust-lang.org/error-index.html
1209 [sk]: https://github.com/rust-lang/rust/pull/24615
1210 [pre]: https://github.com/rust-lang/rust/pull/25323
1211 [file]: https://github.com/rust-lang/rust/pull/24598
1212 [ch]: https://github.com/rust-lang/rust/pull/24683
1213 [arc]: https://github.com/rust-lang/rust/pull/24695
1214 [si]: https://github.com/rust-lang/rust/pull/24701
1215 [ap]: https://github.com/rust-lang/rust/pull/24834
1216 [m]: https://github.com/rust-lang/rust/pull/24777
1217 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
1218 [crc]: https://github.com/rust-lang/cargo/pull/1568
1219 [pie]: https://github.com/rust-lang/rust/pull/24953
1220 [abs]: https://github.com/rust-lang/rust/pull/25441
1221 [c]: https://github.com/rust-lang/rust/pull/25496
1222 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
1223 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
1224 [inc]: https://github.com/rust-lang/rust/pull/25522
1225 [bh]: https://github.com/rust-lang/rust/pull/25856
1226 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
1227 [ll]: https://github.com/rust-lang/rust/pull/26022
1228 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
1229 [drop]: https://github.com/rust-lang/rust/pull/24935
1230
1231 Version 1.0.0 (2015-05-15)
1232 ========================
1233
1234 * ~1500 changes, numerous bugfixes
1235
1236 Highlights
1237 ----------
1238
1239 * The vast majority of the standard library is now `#[stable]`. It is
1240   no longer possible to use unstable features with a stable build of
1241   the compiler.
1242 * Many popular crates on [crates.io] now work on the stable release
1243   channel.
1244 * Arithmetic on basic integer types now [checks for overflow in debug
1245   builds][overflow].
1246
1247 Language
1248 --------
1249
1250 * Several [restrictions have been added to trait coherence][coh] in
1251   order to make it easier for upstream authors to change traits
1252   without breaking downstream code.
1253 * Digits of binary and octal literals are [lexed more eagerly][lex] to
1254   improve error messages and macro behavior. For example, `0b1234` is
1255   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
1256 * Trait bounds [are always invariant][inv], eliminating the need for
1257   the `PhantomFn` and `MarkerTrait` lang items, which have been
1258   removed.
1259 * ["-" is no longer a valid character in crate names][cr], the `extern crate
1260   "foo" as bar` syntax has been replaced with `extern crate foo as
1261   bar`, and Cargo now automatically translates "-" in *package* names
1262   to underscore for the crate name.
1263 * [Lifetime shadowing is an error][lt].
1264 * [`Send` no longer implies `'static`][send-rfc].
1265 * [UFCS now supports trait-less associated paths][moar-ufcs] like
1266   `MyType::default()`.
1267 * Primitive types [now have inherent methods][prim-inherent],
1268   obviating the need for extension traits like `SliceExt`.
1269 * Methods with `Self: Sized` in their `where` clause are [considered
1270   object-safe][self-sized], allowing many extension traits like
1271   `IteratorExt` to be merged into the traits they extended.
1272 * You can now [refer to associated types][assoc-where] whose
1273   corresponding trait bounds appear only in a `where` clause.
1274 * The final bits of [OIBIT landed][oibit-final], meaning that traits
1275   like `Send` and `Sync` are now library-defined.
1276 * A [Reflect trait][reflect] was introduced, which means that
1277   downcasting via the `Any` trait is effectively limited to concrete
1278   types. This helps retain the potentially-important "parametricity"
1279   property: generic code cannot behave differently for different type
1280   arguments except in minor ways.
1281 * The `unsafe_destructor` feature is now deprecated in favor of the
1282   [new `dropck`][dropck]. This change is a major reduction in unsafe
1283   code.
1284
1285 Libraries
1286 ---------
1287
1288 * The `thread_local` module [has been renamed to `std::thread`][th].
1289 * The methods of `IteratorExt` [have been moved to the `Iterator`
1290   trait itself][ie].
1291 * Several traits that implement Rust's conventions for type
1292   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
1293   [centralized in the `std::convert` module][con].
1294 * The `FromError` trait [was removed in favor of `From`][fe].
1295 * The basic sleep function [has moved to
1296   `std::thread::sleep_ms`][slp].
1297 * The `splitn` function now takes an `n` parameter that represents the
1298   number of items yielded by the returned iterator [instead of the
1299   number of 'splits'][spl].
1300 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
1301 * [Derived implementations of `PartialOrd` now order enums according
1302   to their explicitly-assigned discriminants][po].
1303 * [Methods for searching strings are generic over `Pattern`s][pat],
1304   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
1305   some others.
1306 * [In method resolution, object methods are resolved before inherent
1307   methods][meth].
1308 * [`String::from_str` has been deprecated in favor of the `From` impl,
1309   `String::from`][sf].
1310 * [`io::Error` implements `Sync`][ios].
1311 * [The `words` method on `&str` has been replaced with
1312   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
1313   a word?'
1314 * The new path and IO modules are complete and `#[stable]`. This
1315   was the major library focus for this cycle.
1316 * The path API was [revised][path-normalize] to normalize `.`,
1317   adjusting the tradeoffs in favor of the most common usage.
1318 * A large number of remaining APIs in `std` were also stabilized
1319   during this cycle; about 75% of the non-deprecated API surface
1320   is now stable.
1321 * The new [string pattern API][string-pattern] landed, which makes
1322   the string slice API much more internally consistent and flexible.
1323 * A new set of [generic conversion traits][conversion] replaced
1324   many existing ad hoc traits.
1325 * Generic numeric traits were [completely removed][num-traits]. This
1326   was made possible thanks to inherent methods for primitive types,
1327   and the removal gives maximal flexibility for designing a numeric
1328   hierarchy in the future.
1329 * The `Fn` traits are now related via [inheritance][fn-inherit]
1330   and provide ergonomic [blanket implementations][fn-blanket].
1331 * The `Index` and `IndexMut` traits were changed to
1332   [take the index by value][index-value], enabling code like
1333   `hash_map["string"]` to work.
1334 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
1335   `Copy` data is known to be `Clone` as well.
1336
1337 Misc
1338 ----
1339
1340 * Many errors now have extended explanations that can be accessed with
1341   the `--explain` flag to `rustc`.
1342 * Many new examples have been added to the standard library
1343   documentation.
1344 * rustdoc has received a number of improvements focused on completion
1345   and polish.
1346 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
1347 * Much headway was made on ecosystem-wide CI, making it possible
1348   to [compare builds for breakage][ci-compare].
1349
1350
1351 [crates.io]: http://crates.io
1352 [clo]: https://github.com/rust-lang/rust/pull/24034
1353 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
1354 [con]: https://github.com/rust-lang/rust/pull/23875
1355 [cr]: https://github.com/rust-lang/rust/pull/23419
1356 [fe]: https://github.com/rust-lang/rust/pull/23879
1357 [ie]: https://github.com/rust-lang/rust/pull/23300
1358 [inv]: https://github.com/rust-lang/rust/pull/23938
1359 [ios]: https://github.com/rust-lang/rust/pull/24133
1360 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
1361 [lt]: https://github.com/rust-lang/rust/pull/24057
1362 [meth]: https://github.com/rust-lang/rust/pull/24056
1363 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
1364 [po]: https://github.com/rust-lang/rust/pull/24270
1365 [sf]: https://github.com/rust-lang/rust/pull/24517
1366 [slp]: https://github.com/rust-lang/rust/pull/23949
1367 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
1368 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
1369 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
1370 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
1371 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
1372 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
1373 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
1374 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
1375 [self-sized]: https://github.com/rust-lang/rust/pull/22301
1376 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
1377 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
1378 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
1379 [reflect]: https://github.com/rust-lang/rust/pull/23712
1380 [conversion]: https://github.com/rust-lang/rfcs/pull/529
1381 [num-traits]: https://github.com/rust-lang/rust/pull/23549
1382 [index-value]: https://github.com/rust-lang/rust/pull/23601
1383 [dropck]: https://github.com/rust-lang/rfcs/pull/769
1384 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
1385 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
1386 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
1387 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
1388 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
1389
1390
1391 Version 1.0.0-alpha.2 (2015-02-20)
1392 =====================================
1393
1394 * ~1300 changes, numerous bugfixes
1395
1396 * Highlights
1397
1398     * The various I/O modules were [overhauled][io-rfc] to reduce
1399       unnecessary abstractions and provide better interoperation with
1400       the underlying platform. The old `io` module remains temporarily
1401       at `std::old_io`.
1402     * The standard library now [participates in feature gating][feat],
1403       so use of unstable libraries now requires a `#![feature(...)]`
1404       attribute. The impact of this change is [described on the
1405       forum][feat-forum]. [RFC][feat-rfc].
1406
1407 * Language
1408
1409     * `for` loops [now operate on the `IntoIterator` trait][into],
1410       which eliminates the need to call `.iter()`, etc. to iterate
1411       over collections. There are some new subtleties to remember
1412       though regarding what sort of iterators various types yield, in
1413       particular that `for foo in bar { }` yields values from a move
1414       iterator, destroying the original collection. [RFC][into-rfc].
1415     * Objects now have [default lifetime bounds][obj], so you don't
1416       have to write `Box<Trait+'static>` when you don't care about
1417       storing references. [RFC][obj-rfc].
1418     * In types that implement `Drop`, [lifetimes must outlive the
1419       value][drop]. This will soon make it possible to safely
1420       implement `Drop` for types where `#[unsafe_destructor]` is now
1421       required. Read the [gorgeous RFC][drop-rfc] for details.
1422     * The fully qualified <T as Trait>::X syntax lets you set the Self
1423       type for a trait method or associated type. [RFC][ufcs-rfc].
1424     * References to types that implement `Deref<U>` now [automatically
1425       coerce to references][deref] to the dereferenced type `U`,
1426       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
1427       should eliminate many unsightly uses of `&*`, as when converting
1428       from references to vectors into references to
1429       slices. [RFC][deref-rfc].
1430     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
1431       `|:|`) is obsolete and closure kind is inferred from context.
1432     * [`Self` is a keyword][Self].
1433
1434 * Libraries
1435
1436     * The `Show` and `String` formatting traits [have been
1437       renamed][fmt] to `Debug` and `Display` to more clearly reflect
1438       their related purposes. Automatically getting a string
1439       conversion to use with `format!("{:?}", something_to_debug)` is
1440       now written `#[derive(Debug)]`.
1441     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
1442       OsStr}`, provide strings in platform-specific encodings for easier
1443       interop with system APIs. [RFC][osstr-rfc].
1444     * The `boxed::into_raw` and `Box::from_raw` functions [convert
1445       between `Box<T>` and `*mut T`][boxraw], a common pattern for
1446       creating raw pointers.
1447
1448 * Tooling
1449
1450     * Certain long error messages of the form 'expected foo found bar'
1451       are now [split neatly across multiple
1452       lines][multiline]. Examples in the PR.
1453     * On Unix Rust can be [uninstalled][un] by running
1454       `/usr/local/lib/rustlib/uninstall.sh`.
1455     * The `#[rustc_on_unimplemented]` attribute, requiring the
1456       'on_unimplemented' feature, lets rustc [display custom error
1457       messages when a trait is expected to be implemented for a type
1458       but is not][onun].
1459
1460 * Misc
1461
1462     * Rust is tested against a [LALR grammar][lalr], which parses
1463       almost all the Rust files that rustc does.
1464
1465 [boxraw]: https://github.com/rust-lang/rust/pull/21318
1466 [close]: https://github.com/rust-lang/rust/pull/21843
1467 [deref]: https://github.com/rust-lang/rust/pull/21351
1468 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
1469 [drop]: https://github.com/rust-lang/rust/pull/21972
1470 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
1471 [feat]: https://github.com/rust-lang/rust/pull/21248
1472 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
1473 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
1474 [fmt]: https://github.com/rust-lang/rust/pull/21457
1475 [into]: https://github.com/rust-lang/rust/pull/20790
1476 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
1477 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
1478 [lalr]: https://github.com/rust-lang/rust/pull/21452
1479 [multiline]: https://github.com/rust-lang/rust/pull/19870
1480 [obj]: https://github.com/rust-lang/rust/pull/22230
1481 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
1482 [onun]: https://github.com/rust-lang/rust/pull/20889
1483 [osstr]: https://github.com/rust-lang/rust/pull/21488
1484 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
1485 [Self]: https://github.com/rust-lang/rust/pull/22158
1486 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
1487 [un]: https://github.com/rust-lang/rust/pull/22256
1488
1489
1490 Version 1.0.0-alpha (2015-01-09)
1491 ==================================
1492
1493   * ~2400 changes, numerous bugfixes
1494
1495   * Highlights
1496
1497     * The language itself is considered feature complete for 1.0,
1498       though there will be many usability improvements and bugfixes
1499       before the final release.
1500     * Nearly 50% of the public API surface of the standard library has
1501       been declared 'stable'. Those interfaces are unlikely to change
1502       before 1.0.
1503     * The long-running debate over integer types has been
1504       [settled][ints]: Rust will ship with types named `isize` and
1505       `usize`, rather than `int` and `uint`, for pointer-sized
1506       integers. Guidelines will be rolled out during the alpha cycle.
1507     * Most crates that are not `std` have been moved out of the Rust
1508       distribution into the Cargo ecosystem so they can evolve
1509       separately and don't need to be stabilized as quickly, including
1510       'time', 'getopts', 'num', 'regex', and 'term'.
1511     * Documentation continues to be expanded with more API coverage, more
1512       examples, and more in-depth explanations. The guides have been
1513       consolidated into [The Rust Programming Language][trpl].
1514     * "[Rust By Example][rbe]" is now maintained by the Rust team.
1515     * All official Rust binary installers now come with [Cargo], the
1516       Rust package manager.
1517
1518 * Language
1519
1520     * Closures have been [completely redesigned][unboxed] to be
1521       implemented in terms of traits, can now be used as generic type
1522       bounds and thus monomorphized and inlined, or via an opaque
1523       pointer (boxed) as in the old system. The new system is often
1524       referred to as 'unboxed' closures.
1525     * Traits now support [associated types][assoc], allowing families
1526       of related types to be defined together and used generically in
1527       powerful ways.
1528     * Enum variants are [namespaced by their type names][enum].
1529     * [`where` clauses][where] provide a more versatile and attractive
1530       syntax for specifying generic bounds, though the previous syntax
1531       remains valid.
1532     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
1533       numeric types.
1534     * Rust [no longer has a runtime][rt] of any description, and only
1535       supports OS threads, not green threads.
1536     * At long last, Rust has been overhauled for 'dynamically-sized
1537       types' ([DST]), which integrates 'fat pointers' (object types,
1538       arrays, and `str`) more deeply into the type system, making it
1539       more consistent.
1540     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
1541       `..j` that produce range types and which, when combined with the
1542       `Index` operator and multidispatch, leads to a convenient slice
1543       notation, `[i..j]`.
1544     * The new range syntax revealed an ambiguity in the fixed-length
1545       array syntax, so now fixed length arrays [are written `[T;
1546       N]`][arrays].
1547     * The `Copy` trait is no longer implemented automatically. Unsafe
1548       pointers no longer implement `Sync` and `Send` so types
1549       containing them don't automatically either. `Sync` and `Send`
1550       are now 'unsafe traits' so one can "forcibly" implement them via
1551       `unsafe impl` if a type confirms to the requirements for them
1552       even though the internals do not (e.g. structs containing unsafe
1553       pointers like `Arc`). These changes are intended to prevent some
1554       footguns and are collectively known as [opt-in built-in
1555       traits][oibit] (though `Sync` and `Send` will soon become pure
1556       library types unknown to the compiler).
1557     * Operator traits now take their operands [by value][ops], and
1558       comparison traits can use multidispatch to compare one type
1559       against multiple other types, allowing e.g. `String` to be
1560       compared with `&str`.
1561     * `if let` and `while let` are no longer feature-gated.
1562     * Rust has adopted a more [uniform syntax for escaping unicode
1563       characters][unicode].
1564     * `macro_rules!` [has been declared stable][mac]. Though it is a
1565       flawed system it is sufficiently popular that it must be usable
1566       for 1.0. Effort has gone into [future-proofing][mac-future] it
1567       in ways that will allow other macro systems to be developed in
1568       parallel, and won't otherwise impact the evolution of the
1569       language.
1570     * The prelude has been [pared back significantly][prelude] such
1571       that it is the minimum necessary to support the most pervasive
1572       code patterns, and through [generalized where clauses][where]
1573       many of the prelude extension traits have been consolidated.
1574     * Rust's rudimentary reflection [has been removed][refl], as it
1575       incurred too much code generation for little benefit.
1576     * [Struct variants][structvars] are no longer feature-gated.
1577     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
1578       known as 'higher-ranked trait bounds', this crucially allows
1579       unboxed closures to work.
1580     * Macros invocations surrounded by parens or square brackets and
1581       not terminated by a semicolon are [parsed as
1582       expressions][macros], which makes expressions like `vec![1i32,
1583       2, 3].len()` work as expected.
1584     * Trait objects now implement their traits automatically, and
1585       traits that can be coerced to objects now must be [object
1586       safe][objsafe].
1587     * Automatically deriving traits is now done with `#[derive(...)]`
1588       not `#[deriving(...)]` for [consistency with other naming
1589       conventions][derive].
1590     * Importing the containing module or enum at the same time as
1591       items or variants they contain is [now done with `self` instead
1592       of `mod`][self], as in use `foo::{self, bar}`
1593     * Glob imports are no longer feature-gated.
1594     * The `box` operator and `box` patterns have been feature-gated
1595       pending a redesign. For now unique boxes should be allocated
1596       like other containers, with `Box::new`.
1597
1598 * Libraries
1599
1600     * A [series][coll1] of [efforts][coll2] to establish
1601       [conventions][coll3] for collections types has resulted in API
1602       improvements throughout the standard library.
1603     * New [APIs for error handling][err] provide ergonomic interop
1604       between error types, and [new conventions][err-conv] describe
1605       more clearly the recommended error handling strategies in Rust.
1606     * The `fail!` macro has been renamed to [`panic!`][panic] so that
1607       it is easier to discuss failure in the context of error handling
1608       without making clarifications as to whether you are referring to
1609       the 'fail' macro or failure more generally.
1610     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
1611       syscall when available.
1612     * The 'serialize' crate has been renamed 'rustc-serialize' and
1613       moved out of the distribution to Cargo. Although it is widely
1614       used now, it is expected to be superseded in the near future.
1615     * The `Show` formatter, typically implemented with
1616       `#[derive(Show)]` is [now requested with the `{:?}`
1617       specifier][show] and is intended for use by all types, for uses
1618       such as `println!` debugging. The new `String` formatter must be
1619       implemented by hand, uses the `{}` specifier, and is intended
1620       for full-fidelity conversions of things that can logically be
1621       represented as strings.
1622
1623 * Tooling
1624
1625     * [Flexible target specification][flex] allows rustc's code
1626       generation to be configured to support otherwise-unsupported
1627       platforms.
1628     * Rust comes with rust-gdb and rust-lldb scripts that launch their
1629       respective debuggers with Rust-appropriate pretty-printing.
1630     * The Windows installation of Rust is distributed with the the
1631       MinGW components currently required to link binaries on that
1632       platform.
1633
1634 * Misc
1635
1636     * Nullable enum optimizations have been extended to more types so
1637       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
1638       space than the inner types themselves.
1639     * Work has begun on supporting AArch64.
1640
1641 [Cargo]: https://crates.io
1642 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
1643 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
1644 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
1645 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
1646 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
1647 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
1648 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
1649 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
1650 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
1651 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
1652 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
1653 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
1654 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
1655 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
1656 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
1657 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
1658 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
1659 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
1660 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
1661 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
1662 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
1663 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
1664 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
1665 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
1666 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
1667 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
1668 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
1669 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
1670 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
1671 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
1672 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
1673 [trpl]: https://doc.rust-lang.org/book/index.html
1674 [rbe]: http://rustbyexample.com/
1675
1676
1677 Version 0.12.0 (2014-10-09)
1678 =============================
1679
1680   * ~1900 changes, numerous bugfixes
1681
1682   * Highlights
1683
1684     * The introductory documentation (now called The Rust Guide) has
1685       been completely rewritten, as have a number of supplementary
1686       guides.
1687     * Rust's package manager, Cargo, continues to improve and is
1688       sometimes considered to be quite awesome.
1689     * Many API's in `std` have been reviewed and updated for
1690       consistency with the in-development Rust coding
1691       guidelines. The standard library documentation tracks
1692       stabilization progress.
1693     * Minor libraries have been moved out-of-tree to the rust-lang org
1694       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
1695       be installed with Cargo.
1696     * Lifetime elision allows lifetime annotations to be left off of
1697       function declarations in many common scenarios.
1698     * Rust now works on 64-bit Windows.
1699
1700   * Language
1701     * Indexing can be overloaded with the `Index` and `IndexMut`
1702       traits.
1703     * The `if let` construct takes a branch only if the `let` pattern
1704       matches, currently behind the 'if_let' feature gate.
1705     * 'where clauses', a more flexible syntax for specifying trait
1706       bounds that is more aesthetic, have been added for traits and
1707       free functions. Where clauses will in the future make it
1708       possible to constrain associated types, which would be
1709       impossible with the existing syntax.
1710     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
1711       the 'slicing_syntax' feature gate, and can be overloaded with
1712       the `Slice` or `SliceMut` traits.
1713     * The syntax for matching of sub-slices has been changed to use a
1714       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
1715       consistency with other uses of `..` and to future-proof
1716       potential additional uses of the syntax.
1717     * The syntax for matching inclusive ranges in patterns has changed
1718       from `0..3` to `0...4` to be consistent with the exclusive range
1719       syntax for slicing.
1720     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
1721       c]`) has been put behind the 'advanced_slice_patterns' feature
1722       gate and may be removed in the future.
1723     * Components of tuples and tuple structs can be extracted using
1724       the `value.0` syntax, currently behind the `tuple_indexing`
1725       feature gate.
1726     * The `#[crate_id]` attribute is no longer supported; versioning
1727       is handled by the package manager.
1728     * Renaming crate imports are now written `extern crate foo as bar`
1729       instead of `extern crate bar = foo`.
1730     * Renaming use statements are now written `use foo as bar` instead
1731       of `use bar = foo`.
1732     * `let` and `match` bindings and argument names in macros are now
1733       hygienic.
1734     * The new, more efficient, closure types ('unboxed closures') have
1735       been added under a feature gate, 'unboxed_closures'. These will
1736       soon replace the existing closure types, once higher-ranked
1737       trait lifetimes are added to the language.
1738     * `move` has been added as a keyword, for indicating closures
1739       that capture by value.
1740     * Mutation and assignment is no longer allowed in pattern guards.
1741     * Generic structs and enums can now have trait bounds.
1742     * The `Share` trait is now called `Sync` to free up the term
1743       'shared' to refer to 'shared reference' (the default reference
1744       type.
1745     * Dynamically-sized types have been mostly implemented,
1746       unifying the behavior of fat-pointer types with the rest of the
1747       type system.
1748     * As part of dynamically-sized types, the `Sized` trait has been
1749       introduced, which qualifying types implement by default, and
1750       which type parameters expect by default. To specify that a type
1751       parameter does not need to be sized, write `<Sized? T>`. Most
1752       types are `Sized`, notable exceptions being unsized arrays
1753       (`[T]`) and trait types.
1754     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
1755     * Lifetime bounds can now be applied to type parameters and object
1756       types.
1757     * The old, reference counted GC type, `Gc<T>` which was once
1758       denoted by the `@` sigil, has finally been removed. GC will be
1759       revisited in the future.
1760
1761   * Libraries
1762     * Library documentation has been improved for a number of modules.
1763     * Bit-vectors, collections::bitv has been modernized.
1764     * The url crate is deprecated in favor of
1765       http://github.com/servo/rust-url, which can be installed with
1766       Cargo.
1767     * Most I/O stream types can be cloned and subsequently closed from
1768       a different thread.
1769     * A `std::time::Duration` type has been added for use in I/O
1770       methods that rely on timers, as well as in the 'time' crate's
1771       `Timespec` arithmetic.
1772     * The runtime I/O abstraction layer that enabled the green thread
1773       scheduler to do non-thread-blocking I/O has been removed, along
1774       with the libuv-based implementation employed by the green thread
1775       scheduler. This will greatly simplify the future I/O work.
1776     * `collections::btree` has been rewritten to have a more
1777       idiomatic and efficient design.
1778
1779   * Tooling
1780     * rustdoc output now indicates the stability levels of API's.
1781     * The `--crate-name` flag can specify the name of the crate
1782       being compiled, like `#[crate_name]`.
1783     * The `-C metadata` specifies additional metadata to hash into
1784       symbol names, and `-C extra-filename` specifies additional
1785       information to put into the output filename, for use by the
1786       package manager for versioning.
1787     * debug info generation has continued to improve and should be
1788       more reliable under both gdb and lldb.
1789     * rustc has experimental support for compiling in parallel
1790       using the `-C codegen-units` flag.
1791     * rustc no longer encodes rpath information into binaries by
1792       default.
1793
1794   * Misc
1795     * Stack usage has been optimized with LLVM lifetime annotations.
1796     * Official Rust binaries on Linux are more compatible with older
1797       kernels and distributions, built on CentOS 5.10.
1798
1799
1800 Version 0.11.0 (2014-07-02)
1801 ==========================
1802
1803   * ~1700 changes, numerous bugfixes
1804
1805   * Language
1806     * ~[T] has been removed from the language. This type is superseded by
1807       the Vec<T> type.
1808     * ~str has been removed from the language. This type is superseded by
1809       the String type.
1810     * ~T has been removed from the language. This type is superseded by the
1811       Box<T> type.
1812     * @T has been removed from the language. This type is superseded by the
1813       standard library's std::gc::Gc<T> type.
1814     * Struct fields are now all private by default.
1815     * Vector indices and shift amounts are both required to be a `uint`
1816       instead of any integral type.
1817     * Byte character, byte string, and raw byte string literals are now all
1818       supported by prefixing the normal literal with a `b`.
1819     * Multiple ABIs are no longer allowed in an ABI string
1820     * The syntax for lifetimes on closures/procedures has been tweaked
1821       slightly: `<'a>|A, B|: 'b + K -> T`
1822     * Floating point modulus has been removed from the language; however it
1823       is still provided by a library implementation.
1824     * Private enum variants are now disallowed.
1825     * The `priv` keyword has been removed from the language.
1826     * A closure can no longer be invoked through a &-pointer.
1827     * The `use foo, bar, baz;` syntax has been removed from the language.
1828     * The transmute intrinsic no longer works on type parameters.
1829     * Statics now allow blocks/items in their definition.
1830     * Trait bounds are separated from objects with + instead of : now.
1831     * Objects can no longer be read while they are mutably borrowed.
1832     * The address of a static is now marked as insignificant unless the
1833       #[inline(never)] attribute is placed it.
1834     * The #[unsafe_destructor] attribute is now behind a feature gate.
1835     * Struct literals are no longer allowed in ambiguous positions such as
1836       if, while, match, and for..in.
1837     * Declaration of lang items and intrinsics are now feature-gated by
1838       default.
1839     * Integral literals no longer default to `int`, and floating point
1840       literals no longer default to `f64`. Literals must be suffixed with an
1841       appropriate type if inference cannot determine the type of the
1842       literal.
1843     * The Box<T> type is no longer implicitly borrowed to &mut T.
1844     * Procedures are now required to not capture borrowed references.
1845
1846   * Libraries
1847     * The standard library is now a "facade" over a number of underlying
1848       libraries. This means that development on the standard library should
1849       be speeder due to smaller crates, as well as a clearer line between
1850       all dependencies.
1851     * A new library, libcore, lives under the standard library's facade
1852       which is Rust's "0-assumption" library, suitable for embedded and
1853       kernel development for example.
1854     * A regex crate has been added to the standard distribution. This crate
1855       includes statically compiled regular expressions.
1856     * The unwrap/unwrap_err methods on Result require a Show bound for
1857       better error messages.
1858     * The return types of the std::comm primitives have been centralized
1859       around the Result type.
1860     * A number of I/O primitives have gained the ability to time out their
1861       operations.
1862     * A number of I/O primitives have gained the ability to close their
1863       reading/writing halves to cancel pending operations.
1864     * Reverse iterator methods have been removed in favor of `rev()` on
1865       their forward-iteration counterparts.
1866     * A bitflags! macro has been added to enable easy interop with C and
1867       management of bit flags.
1868     * A debug_assert! macro is now provided which is disabled when
1869       `--cfg ndebug` is passed to the compiler.
1870     * A graphviz crate has been added for creating .dot files.
1871     * The std::cast module has been migrated into std::mem.
1872     * The std::local_data api has been migrated from freestanding functions
1873       to being based on methods.
1874     * The Pod trait has been renamed to Copy.
1875     * jemalloc has been added as the default allocator for types.
1876     * The API for allocating memory has been changed to use proper alignment
1877       and sized deallocation
1878     * Connecting a TcpStream or binding a TcpListener is now based on a
1879       string address and a u16 port. This allows connecting to a hostname as
1880       opposed to an IP.
1881     * The Reader trait now contains a core method, read_at_least(), which
1882       correctly handles many repeated 0-length reads.
1883     * The process-spawning API is now centered around a builder-style
1884       Command struct.
1885     * The :? printing qualifier has been moved from the standard library to
1886       an external libdebug crate.
1887     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
1888       have been renamed to Eq/Ord.
1889     * The select/plural methods have been removed from format!. The escapes
1890       for { and } have also changed from \{ and \} to {{ and }},
1891       respectively.
1892     * The TaskBuilder API has been re-worked to be a true builder, and
1893       extension traits for spawning native/green tasks have been added.
1894
1895   * Tooling
1896     * All breaking changes to the language or libraries now have their
1897       commit message annotated with `[breaking-change]` to allow for easy
1898       discovery of breaking changes.
1899     * The compiler will now try to suggest how to annotate lifetimes if a
1900       lifetime-related error occurs.
1901     * Debug info continues to be improved greatly with general bug fixes and
1902       better support for situations like link time optimization (LTO).
1903     * Usage of syntax extensions when cross-compiling has been fixed.
1904     * Functionality equivalent to GCC & Clang's -ffunction-sections,
1905       -fdata-sections and --gc-sections has been enabled by default
1906     * The compiler is now stricter about where it will load module files
1907       from when a module is declared via `mod foo;`.
1908     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
1909       Syntax extensions are now discovered via a "plugin registrar" type
1910       which will be extended in the future to other various plugins.
1911     * Lints have been restructured to allow for dynamically loadable lints.
1912     * A number of rustdoc improvements:
1913       * The HTML output has been visually redesigned.
1914       * Markdown is now powered by hoedown instead of sundown.
1915       * Searching heuristics have been greatly improved.
1916       * The search index has been reduced in size by a great amount.
1917       * Cross-crate documentation via `pub use` has been greatly improved.
1918       * Primitive types are now hyperlinked and documented.
1919     * Documentation has been moved from static.rust-lang.org/doc to
1920       doc.rust-lang.org
1921     * A new sandbox, play.rust-lang.org, is available for running and
1922       sharing rust code examples on-line.
1923     * Unused attributes are now more robustly warned about.
1924     * The dead_code lint now warns about unused struct fields.
1925     * Cross-compiling to iOS is now supported.
1926     * Cross-compiling to mipsel is now supported.
1927     * Stability attributes are now inherited by default and no longer apply
1928       to intra-crate usage, only inter-crate usage.
1929     * Error message related to non-exhaustive match expressions have been
1930       greatly improved.
1931
1932
1933 Version 0.10 (2014-04-03)
1934 =========================
1935
1936   * ~1500 changes, numerous bugfixes
1937
1938   * Language
1939     * A new RFC process is now in place for modifying the language.
1940     * Patterns with `@`-pointers have been removed from the language.
1941     * Patterns with unique vectors (`~[T]`) have been removed from the
1942       language.
1943     * Patterns with unique strings (`~str`) have been removed from the
1944       language.
1945     * `@str` has been removed from the language.
1946     * `@[T]` has been removed from the language.
1947     * `@self` has been removed from the language.
1948     * `@Trait` has been removed from the language.
1949     * Headers on `~` allocations which contain `@` boxes inside the type for
1950       reference counting have been removed.
1951     * The semantics around the lifetimes of temporary expressions have changed,
1952       see #3511 and #11585 for more information.
1953     * Cross-crate syntax extensions are now possible, but feature gated. See
1954       #11151 for more information. This includes both `macro_rules!` macros as
1955       well as syntax extensions such as `format!`.
1956     * New lint modes have been added, and older ones have been turned on to be
1957       warn-by-default.
1958       * Unnecessary parentheses
1959       * Uppercase statics
1960       * Camel Case types
1961       * Uppercase variables
1962       * Publicly visible private types
1963       * `#[deriving]` with raw pointers
1964     * Unsafe functions can no longer be coerced to closures.
1965     * Various obscure macros such as `log_syntax!` are now behind feature gates.
1966     * The `#[simd]` attribute is now behind a feature gate.
1967     * Visibility is no longer allowed on `extern crate` statements, and
1968       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
1969     * Trailing commas are now allowed in argument lists and tuple patterns.
1970     * The `do` keyword has been removed, it is now a reserved keyword.
1971     * Default type parameters have been implemented, but are feature gated.
1972     * Borrowed variables through captures in closures are now considered soundly.
1973     * `extern mod` is now `extern crate`
1974     * The `Freeze` trait has been removed.
1975     * The `Share` trait has been added for types that can be shared among
1976       threads.
1977     * Labels in macros are now hygienic.
1978     * Expression/statement macro invocations can be delimited with `{}` now.
1979     * Treatment of types allowed in `static mut` locations has been tweaked.
1980     * The `*` and `.` operators are now overloadable through the `Deref` and
1981       `DerefMut` traits.
1982     * `~Trait` and `proc` no longer have `Send` bounds by default.
1983     * Partial type hints are now supported with the `_` type marker.
1984     * An `Unsafe` type was introduced for interior mutability. It is now
1985       considered undefined to transmute from `&T` to `&mut T` without using the
1986       `Unsafe` type.
1987     * The #[linkage] attribute was implemented for extern statics/functions.
1988     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
1989     * `Pod` was renamed to `Copy`.
1990
1991   * Libraries
1992     * The `libextra` library has been removed. It has now been decomposed into
1993       component libraries with smaller and more focused nuggets of
1994       functionality. The full list of libraries can be found on the
1995       documentation index page.
1996     * std: `std::condition` has been removed. All I/O errors are now propagated
1997       through the `Result` type. In order to assist with error handling, a
1998       `try!` macro for unwrapping errors with an early return and a lint for
1999       unused results has been added. See #12039 for more information.
2000     * std: The `vec` module has been renamed to `slice`.
2001     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
2002       This will become the only growable vector in the future.
2003     * std: `std::io` now has more public-reexports. Types such as `BufferedReader`
2004       are now found at `std::io::BufferedReader` instead of
2005       `std::io::buffered::BufferedReader`.
2006     * std: `print` and `println` are no longer in the prelude, the `print!` and
2007       `println!` macros are intended to be used instead.
2008     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
2009       attempts to statically prevent cycles.
2010     * std: The standard distribution is adopting the policy of pushing failure
2011       to the user rather than failing in libraries. Many functions (such as
2012       `slice::last()`) now return `Option<T>` instead of `T` + failing.
2013     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
2014       deriving mode: `#[deriving(Show)]`.
2015     * std: `ToStr` is now implemented for all types implementing `Show`.
2016     * std: The formatting trait methods now take `&self` instead of `&T`
2017     * std: The `invert()` method on iterators has been renamed to `rev()`
2018     * std: `std::num` has seen a reduction in the genericity of its traits,
2019       consolidating functionality into a few core traits.
2020     * std: Backtraces are now printed on task failure if the environment
2021       variable `RUST_BACKTRACE` is present.
2022     * std: Naming conventions for iterators have been standardized. More details
2023       can be found on the wiki's style guide.
2024     * std: `eof()` has been removed from the `Reader` trait. Specific types may
2025       still implement the function.
2026     * std: Networking types are now cloneable to allow simultaneous reads/writes.
2027     * std: `assert_approx_eq!` has been removed
2028     * std: The `e` and `E` formatting specifiers for floats have been added to
2029       print them in exponential notation.
2030     * std: The `Times` trait has been removed
2031     * std: Indications of variance and opting out of builtin bounds is done
2032       through marker types in `std::kinds::marker` now
2033     * std: `hash` has been rewritten, `IterBytes` has been removed, and
2034       `#[deriving(Hash)]` is now possible.
2035     * std: `SharedChan` has been removed, `Sender` is now cloneable.
2036     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
2037     * std: `Chan::new` is now `channel()`.
2038     * std: A new synchronous channel type has been implemented.
2039     * std: A `select!` macro is now provided for selecting over `Receiver`s.
2040     * std: `hashmap` and `trie` have been moved to `libcollections`
2041     * std: `run` has been rolled into `io::process`
2042     * std: `assert_eq!` now uses `{}` instead of `{:?}`
2043     * std: The equality and comparison traits have seen some reorganization.
2044     * std: `rand` has moved to `librand`.
2045     * std: `to_{lower,upper}case` has been implemented for `char`.
2046     * std: Logging has been moved to `liblog`.
2047     * collections: `HashMap` has been rewritten for higher performance and less
2048       memory usage.
2049     * native: The default runtime is now `libnative`. If `libgreen` is desired,
2050       it can be booted manually. The runtime guide has more information and
2051       examples.
2052     * native: All I/O functionality except signals has been implemented.
2053     * green: Task spawning with `libgreen` has been optimized with stack caching
2054       and various trimming of code.
2055     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
2056     * sync: The `extra::sync` module has been updated to modern rust (and moved
2057       to the `sync` library), tweaking and improving various interfaces while
2058       dropping redundant functionality.
2059     * sync: A new `Barrier` type has been added to the `sync` library.
2060     * sync: An efficient mutex for native and green tasks has been implemented.
2061     * serialize: The `base64` module has seen some improvement. It treats
2062       newlines better, has non-string error values, and has seen general
2063       cleanup.
2064     * fourcc: A `fourcc!` macro was introduced
2065     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
2066       hexadecimal literal.
2067
2068   * Tooling
2069     * `rustpkg` has been deprecated and removed from the main repository. Its
2070       replacement, `cargo`, is under development.
2071     * Nightly builds of rust are now available
2072     * The memory usage of rustc has been improved many times throughout this
2073       release cycle.
2074     * The build process supports disabling rpath support for the rustc binary
2075       itself.
2076     * Code generation has improved in some cases, giving more information to the
2077       LLVM optimization passes to enable more extensive optimizations.
2078     * Debuginfo compatibility with lldb on OSX has been restored.
2079     * The master branch is now gated on an android bot, making building for
2080       android much more reliable.
2081     * Output flags have been centralized into one `--emit` flag.
2082     * Crate type flags have been centralized into one `--crate-type` flag.
2083     * Codegen flags have been consolidated behind a `-C` flag.
2084     * Linking against outdated crates now has improved error messages.
2085     * Error messages with lifetimes will often suggest how to annotate the
2086       function to fix the error.
2087     * Many more types are documented in the standard library, and new guides
2088       were written.
2089     * Many `rustdoc` improvements:
2090       * code blocks are syntax highlighted.
2091       * render standalone markdown files.
2092       * the --test flag tests all code blocks by default.
2093       * exported macros are displayed.
2094       * reexported types have their documentation inlined at the location of the
2095         first reexport.
2096       * search works across crates that have been rendered to the same output
2097         directory.
2098
2099
2100 Version 0.9 (2014-01-09)
2101 ==========================
2102
2103    * ~1800 changes, numerous bugfixes
2104
2105    * Language
2106       * The `float` type has been removed. Use `f32` or `f64` instead.
2107       * A new facility for enabling experimental features (feature gating) has
2108         been added, using the crate-level `#[feature(foo)]` attribute.
2109       * Managed boxes (@) are now behind a feature gate
2110         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
2111         standard library's `Gc` or `Rc` types instead.
2112       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
2113       * Jumping back to the top of a loop is now done with `continue` instead of
2114         `loop`.
2115       * Strings can no longer be mutated through index assignment.
2116       * Raw strings can be created via the basic `r"foo"` syntax or with matched
2117         hash delimiters, as in `r###"foo"###`.
2118       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
2119         called once.
2120       * The `&fn` type is now written `|args| -> ret` to match the literal form.
2121       * `@fn`s have been removed.
2122       * `do` only works with procs in order to make it obvious what the cost
2123         of `do` is.
2124       * Single-element tuple-like structs can no longer be dereferenced to
2125         obtain the inner value. A more comprehensive solution for overloading
2126         the dereference operator will be provided in the future.
2127       * The `#[link(...)]` attribute has been replaced with
2128         `#[crate_id = "name#vers"]`.
2129       * Empty `impl`s must be terminated with empty braces and may not be
2130         terminated with a semicolon.
2131       * Keywords are no longer allowed as lifetime names; the `self` lifetime
2132         no longer has any special meaning.
2133       * The old `fmt!` string formatting macro has been removed.
2134       * `printf!` and `printfln!` (old-style formatting) removed in favor of
2135         `print!` and `println!`.
2136       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
2137       * The `extern mod foo (name = "bar")` syntax has been removed. Use
2138         `extern mod foo = "bar"` instead.
2139       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
2140       * Macros can have attributes.
2141       * Macros can expand to items with attributes.
2142       * Macros can expand to multiple items.
2143       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
2144       * Comments may be nested.
2145       * Values automatically coerce to trait objects they implement, without
2146         an explicit `as`.
2147       * Enum discriminants are no longer an entire word but as small as needed to
2148         contain all the variants. The `repr` attribute can be used to override
2149         the discriminant size, as in `#[repr(int)]` for integer-sized, and
2150         `#[repr(C)]` to match C enums.
2151       * Non-string literals are not allowed in attributes (they never worked).
2152       * The FFI now supports variadic functions.
2153       * Octal numeric literals, as in `0o7777`.
2154       * The `concat!` syntax extension performs compile-time string concatenation.
2155       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
2156         removed as Rust no longer uses segmented stacks.
2157       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
2158       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
2159         not `*`; ignoring remaining fields of a struct is also done with `..`,
2160         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
2161       * `rustc` supports the "win64" calling convention via `extern "win64"`.
2162       * `rustc` supports the "system" calling convention, which defaults to the
2163         preferred convention for the target platform, "stdcall" on 32-bit Windows,
2164         "C" elsewhere.
2165       * The `type_overflow` lint (default: warn) checks literals for overflow.
2166       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
2167       * The `attribute_usage` lint (default: warn) warns about unknown
2168         attributes.
2169       * The `unknown_features` lint (default: warn) warns about unknown
2170         feature gates.
2171       * The `dead_code` lint (default: warn) checks for dead code.
2172       * Rust libraries can be linked statically to one another
2173       * `#[link_args]` is behind the `link_args` feature gate.
2174       * Native libraries are now linked with `#[link(name = "foo")]`
2175       * Native libraries can be statically linked to a rust crate
2176         (`#[link(name = "foo", kind = "static")]`).
2177       * Native OS X frameworks are now officially supported
2178         (`#[link(name = "foo", kind = "framework")]`).
2179       * The `#[thread_local]` attribute creates thread-local (not task-local)
2180         variables. Currently behind the `thread_local` feature gate.
2181       * The `return` keyword may be used in closures.
2182       * Types that can be copied via a memcpy implement the `Pod` kind.
2183       * The `cfg` attribute can now be used on struct fields and enum variants.
2184
2185    * Libraries
2186       * std: The `option` and `result` API's have been overhauled to make them
2187         simpler, more consistent, and more composable.
2188       * std: The entire `std::io` module has been replaced with one that is
2189         more comprehensive and that properly interfaces with the underlying
2190         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
2191         implemented.
2192       * std: `io::util` contains a number of useful implementations of
2193         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
2194         `ZeroReader`, `TeeReader`.
2195       * std: The reference counted pointer type `extra::rc` moved into std.
2196       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
2197         just a wrapper around it).
2198       * std: The `Either` type has been removed.
2199       * std: `fmt::Default` can be implemented for any type to provide default
2200         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
2201       * std: The `rand` API continues to be tweaked.
2202       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
2203         on failure in gdb, is now named `rust_fail`.
2204       * std: The `each_key` and `each_value` methods on `HashMap` have been
2205         replaced by the `keys` and `values` iterators.
2206       * std: Functions dealing with type size and alignment have moved from the
2207         `sys` module to the `mem` module.
2208       * std: The `path` module was written and API changed.
2209       * std: `str::from_utf8` has been changed to cast instead of allocate.
2210       * std: `starts_with` and `ends_with` methods added to vectors via the
2211         `ImmutableEqVector` trait, which is in the prelude.
2212       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
2213         if the index is out of bounds.
2214       * std: Task failure no longer propagates between tasks, as the model was
2215         complex, expensive, and incompatible with thread-based tasks.
2216       * std: The `Any` type can be used for dynamic typing.
2217       * std: `~Any` can be passed to the `fail!` macro and retrieved via
2218         `task::try`.
2219       * std: Methods that produce iterators generally do not have an `_iter`
2220         suffix now.
2221       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
2222         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
2223       * std: `util::ignore` renamed to `prelude::drop`.
2224       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
2225         trait.
2226       * std: `vec::raw` has seen a lot of cleanup and API changes.
2227       * std: The standard library no longer includes any C++ code, and very
2228         minimal C, eliminating the dependency on libstdc++.
2229       * std: Runtime scheduling and I/O functionality has been factored out into
2230         extensible interfaces and is now implemented by two different crates:
2231         libnative, for native threading and I/O; and libgreen, for green threading
2232         and I/O. This paves the way for using the standard library in more limited
2233         embedded environments.
2234       * std: The `comm` module has been rewritten to be much faster, have a
2235         simpler, more consistent API, and to work for both native and green
2236         threading.
2237       * std: All libuv dependencies have been moved into the rustuv crate.
2238       * native: New implementations of runtime scheduling on top of OS threads.
2239       * native: New native implementations of TCP, UDP, file I/O, process spawning,
2240         and other I/O.
2241       * green: The green thread scheduler and message passing types are almost
2242         entirely lock-free.
2243       * extra: The `flatpipes` module had bitrotted and was removed.
2244       * extra: All crypto functions have been removed and Rust now has a policy of
2245         not reimplementing crypto in the standard library. In the future crypto
2246         will be provided by external crates with bindings to established libraries.
2247       * extra: `c_vec` has been modernized.
2248       * extra: The `sort` module has been removed. Use the `sort` method on
2249         mutable slices.
2250
2251    * Tooling
2252       * The `rust` and `rusti` commands have been removed, due to lack of
2253         maintenance.
2254       * `rustdoc` was completely rewritten.
2255       * `rustdoc` can test code examples in documentation.
2256       * `rustpkg` can test packages with the argument, 'test'.
2257       * `rustpkg` supports arbitrary dependencies, including C libraries.
2258       * `rustc`'s support for generating debug info is improved again.
2259       * `rustc` has better error reporting for unbalanced delimiters.
2260       * `rustc`'s JIT support was removed due to bitrot.
2261       * Executables and static libraries can be built with LTO (-Z lto)
2262       * `rustc` adds a `--dep-info` flag for communicating dependencies to
2263         build tools.
2264
2265
2266 Version 0.8 (2013-09-26)
2267 ============================
2268
2269    * ~2200 changes, numerous bugfixes
2270
2271    * Language
2272       * The `for` loop syntax has changed to work with the `Iterator` trait.
2273       * At long last, unwinding works on Windows.
2274       * Default methods are ready for use.
2275       * Many trait inheritance bugs fixed.
2276       * Owned and borrowed trait objects work more reliably.
2277       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
2278       * rustc can omit emission of code for the `debug!` macro if it is passed
2279         `--cfg ndebug`
2280       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
2281         for foo.rs, then foo/mod.rs, and will generate an error when both are
2282         present.
2283       * Strings no longer contain trailing nulls. The new `std::c_str` module
2284         provides new mechanisms for converting to C strings.
2285       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
2286       * The FFI has been overhauled such that foreign functions are called directly,
2287         instead of through a stack-switching wrapper.
2288       * Calling a foreign function must be done through a Rust function with the
2289         `#[fixed_stack_segment]` attribute.
2290       * The `externfn!` macro can be used to declare both a foreign function and
2291         a `#[fixed_stack_segment]` wrapper at once.
2292       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
2293       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
2294       * `priv` is disallowed everywhere except for struct fields and enum variants.
2295       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
2296       * `ref` bindings in irrefutable patterns work correctly now.
2297       * `char` is now prevented from containing invalid code points.
2298       * Casting to `bool` is no longer allowed.
2299       * `\0` is now accepted as an escape in chars and strings.
2300       * `yield` is a reserved keyword.
2301       * `typeof` is a reserved keyword.
2302       * Crates may be imported by URL with `extern mod foo = "url";`.
2303       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
2304       * Static vectors can be initialized with repeating elements,
2305         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
2306       * Static structs can be initialized with functional record update,
2307         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
2308       * `cfg!` can be used to conditionally execute code based on the crate
2309         configuration, similarly to `#[cfg(...)]`.
2310       * The `unnecessary_qualification` lint detects unneeded module
2311         prefixes (default: allow).
2312       * Arithmetic operations have been implemented on the SIMD types in
2313         `std::unstable::simd`.
2314       * Exchange allocation headers were removed, reducing memory usage.
2315       * `format!` implements a completely new, extensible, and higher-performance
2316         string formatting system. It will replace `fmt!`.
2317       * `print!` and `println!` write formatted strings (using the `format!`
2318         extension) to stdout.
2319       * `write!` and `writeln!` write formatted strings (using the `format!`
2320         extension) to the new Writers in `std::rt::io`.
2321       * The library section in which a function or static is placed may
2322         be specified with `#[link_section = "..."]`.
2323       * The `proto!` syntax extension for defining bounded message protocols
2324         was removed.
2325       * `macro_rules!` is hygienic for `let` declarations.
2326       * The `#[export_name]` attribute specifies the name of a symbol.
2327       * `unreachable!` can be used to indicate unreachable code, and fails
2328         if executed.
2329
2330    * Libraries
2331       * std: Transitioned to the new runtime, written in Rust.
2332       * std: Added an experimental I/O library, `rt::io`, based on the new
2333         runtime.
2334       * std: A new generic `range` function was added to the prelude, replacing
2335         `uint::range` and friends.
2336       * std: `range_rev` no longer exists. Since range is an iterator it can be
2337         reversed with `range(lo, hi).invert()`.
2338       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
2339         renamed to `unwrap_or`.
2340       * std: The `iterator` module was renamed to `iter`.
2341       * std: Integral types now support the `checked_add`, `checked_sub`, and
2342         `checked_mul` operations for detecting overflow.
2343       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
2344         consistency.
2345       * std: Methods are standardizing on conventions for casting methods:
2346         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
2347         and cheap casts.
2348       * std: The `CString` type in `c_str` provides new ways to convert to and
2349         from C strings.
2350       * std: `DoubleEndedIterator` can yield elements in two directions.
2351       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
2352         two splices.
2353       * std: `str::from_bytes` renamed to `str::from_utf8`.
2354       * std: `pop_opt` and `shift_opt` methods added to vectors.
2355       * std: The task-local data interface no longer uses @, and keys are
2356         no longer function pointers.
2357       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
2358       * std: Added `SharedPort` to `comm`.
2359       * std: `Eq` has a default method for `ne`; only `eq` is required
2360         in implementations.
2361       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
2362         is required in implementations.
2363       * std: `is_utf8` performance is improved, impacting many string functions.
2364       * std: `os::MemoryMap` provides cross-platform mmap.
2365       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
2366         are not 'in-bounds' are considered undefined.
2367       * std: Many freestanding functions in `vec` removed in favor of methods.
2368       * std: Many freestanding functions on scalar types removed in favor of
2369         methods.
2370       * std: Many options to task builders were removed since they don't make
2371         sense in the new scheduler design.
2372       * std: More containers implement `FromIterator` so can be created by the
2373         `collect` method.
2374       * std: More complete atomic types in `unstable::atomics`.
2375       * std: `comm::PortSet` removed.
2376       * std: Mutating methods in the `Set` and `Map` traits have been moved into
2377         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
2378         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
2379         default implementations.
2380       * std: Various `from_str` functions were removed in favor of a generic
2381         `from_str` which is available in the prelude.
2382       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
2383       * extra: `dlist`, the doubly-linked list was modernized.
2384       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
2385       * extra: Added `glob` module, replacing `std::os::glob`.
2386       * extra: `rope` was removed.
2387       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
2388       * extra: `net`, and `timer` were removed. The experimental replacements
2389         are `std::rt::io::net` and `std::rt::io::timer`.
2390       * extra: Iterators implemented for `SmallIntMap`.
2391       * extra: Iterators implemented for `Bitv` and `BitvSet`.
2392       * extra: `SmallIntSet` removed. Use `BitvSet`.
2393       * extra: Performance of JSON parsing greatly improved.
2394       * extra: `semver` updated to SemVer 2.0.0.
2395       * extra: `term` handles more terminals correctly.
2396       * extra: `dbg` module removed.
2397       * extra: `par` module removed.
2398       * extra: `future` was cleaned up, with some method renames.
2399       * extra: Most free functions in `getopts` were converted to methods.
2400
2401    * Other
2402       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
2403       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
2404         similarly to gcc's `--march` flag.
2405       * rustc's performance compiling small crates is much better.
2406       * rustpkg has received many improvements.
2407       * rustpkg supports git tags as package IDs.
2408       * rustpkg builds into target-specific directories so it can be used for
2409         cross-compiling.
2410       * The number of concurrent test tasks is controlled by the environment
2411         variable RUST_TEST_TASKS.
2412       * The test harness can now report metrics for benchmarks.
2413       * All tools have man pages.
2414       * Programs compiled with `--test` now support the `-h` and `--help` flags.
2415       * The runtime uses jemalloc for allocations.
2416       * Segmented stacks are temporarily disabled as part of the transition to
2417         the new runtime. Stack overflows are possible!
2418       * A new documentation backend, rustdoc_ng, is available for use. It is
2419         still invoked through the normal `rustdoc` command.
2420
2421
2422 Version 0.7 (2013-07-03)
2423 =======================
2424
2425    * ~2000 changes, numerous bugfixes
2426
2427    * Language
2428       * `impl`s no longer accept a visibility qualifier. Put them on methods
2429         instead.
2430       * The borrow checker has been rewritten with flow-sensitivity, fixing
2431         many bugs and inconveniences.
2432       * The `self` parameter no longer implicitly means `&'self self`,
2433         and can be explicitly marked with a lifetime.
2434       * Overloadable compound operators (`+=`, etc.) have been temporarily
2435         removed due to bugs.
2436       * The `for` loop protocol now requires `for`-iterators to return `bool`
2437         so they compose better.
2438       * The `Durable` trait is replaced with the `'static` bounds.
2439       * Trait default methods work more often.
2440       * Structs with the `#[packed]` attribute have byte alignment and
2441         no padding between fields.
2442       * Type parameters bound by `Copy` must now be copied explicitly with
2443         the `copy` keyword.
2444       * It is now illegal to move out of a dereferenced unsafe pointer.
2445       * `Option<~T>` is now represented as a nullable pointer.
2446       * `@mut` does dynamic borrow checks correctly.
2447       * The `main` function is only detected at the topmost level of the crate.
2448         The `#[main]` attribute is still valid anywhere.
2449       * Struct fields may no longer be mutable. Use inherited mutability.
2450       * The `#[no_send]` attribute makes a type that would otherwise be
2451         `Send`, not.
2452       * The `#[no_freeze]` attribute makes a type that would otherwise be
2453         `Freeze`, not.
2454       * Unbounded recursion will abort the process after reaching the limit
2455         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
2456       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
2457         are never implicitly copyable.
2458       * `#[static_assert]` makes compile-time assertions about static bools.
2459       * At long last, 'argument modes' no longer exist.
2460       * The rarely used `use mod` statement no longer exists.
2461
2462    * Syntax extensions
2463       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
2464         argument list.
2465       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
2466         `Rand`, `Zero` and `ToStr` can all be automatically derived with
2467         `#[deriving(...)]`.
2468       * The `bytes!` macro returns a vector of bytes for string, u8, char,
2469         and unsuffixed integer literals.
2470
2471    * Libraries
2472       * The `core` crate was renamed to `std`.
2473       * The `std` crate was renamed to `extra`.
2474       * More and improved documentation.
2475       * std: `iterator` module for external iterator objects.
2476       * Many old-style (internal, higher-order function) iterators replaced by
2477         implementations of `Iterator`.
2478       * std: Many old internal vector and string iterators,
2479         incl. `any`, `all`. removed.
2480       * std: The `finalize` method of `Drop` renamed to `drop`.
2481       * std: The `drop` method now takes `&mut self` instead of `&self`.
2482       * std: The prelude no longer reexports any modules, only types and traits.
2483       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
2484         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
2485       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
2486         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
2487       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
2488         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
2489       * std: Many types implement `Clone`.
2490       * std: `path` type renamed to `Path`.
2491       * std: `mut` module and `Mut` type removed.
2492       * std: Many standalone functions removed in favor of methods and iterators
2493         in `vec`, `str`. In the future methods will also work as functions.
2494       * std: `reinterpret_cast` removed. Use `transmute`.
2495       * std: ascii string handling in `std::ascii`.
2496       * std: `Rand` is implemented for ~/@.
2497       * std: `run` module for spawning processes overhauled.
2498       * std: Various atomic types added to `unstable::atomic`.
2499       * std: Various types implement `Zero`.
2500       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
2501       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
2502       * std: Added `os::mkdir_recursive`.
2503       * std: Added `os::glob` function performs filesystems globs.
2504       * std: `FuzzyEq` renamed to `ApproxEq`.
2505       * std: `Map` now defines `pop` and `swap` methods.
2506       * std: `Cell` constructors converted to static methods.
2507       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
2508       * extra: `flate` module moved from `std` to `extra`.
2509       * extra: `fileinput` module for iterating over a series of files.
2510       * extra: `Complex` number type and `complex` module.
2511       * extra: `Rational` number type and `rational` module.
2512       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
2513       * extra: `term` uses terminfo now, is more correct.
2514       * extra: `arc` functions converted to methods.
2515       * extra: Implementation of fixed output size variations of SHA-2.
2516
2517    * Tooling
2518       * `unused_variable`  lint mode for unused variables (default: warn).
2519       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
2520         (default: warn).
2521       * `unused_mut` lint mode for identifying unused `mut` qualifiers
2522         (default: warn).
2523       * `dead_assignment` lint mode for unread variables (default: warn).
2524       * `unnecessary_allocation` lint mode detects some heap allocations that are
2525         immediately borrowed so could be written without allocating (default: warn).
2526       * `missing_doc` lint mode (default: allow).
2527       * `unreachable_code` lint mode (default: warn).
2528       * The `rusti` command has been rewritten and a number of bugs addressed.
2529       * rustc outputs in color on more terminals.
2530       * rustc accepts a `--link-args` flag to pass arguments to the linker.
2531       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
2532       * Compiling with `-g` will make the binary record information about
2533         dynamic borrowcheck failures for debugging.
2534       * rustdoc has a nicer stylesheet.
2535       * Various improvements to rustdoc.
2536       * Improvements to rustpkg (see the detailed release notes).
2537
2538
2539 Version 0.6 (2013-04-03)
2540 ========================
2541
2542    * ~2100 changes, numerous bugfixes
2543
2544    * Syntax changes
2545       * The self type parameter in traits is now spelled `Self`
2546       * The `self` parameter in trait and impl methods must now be explicitly
2547         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
2548       * Static methods no longer require the `static` keyword and instead
2549         are distinguished by the lack of a `self` parameter
2550       * Replaced the `Durable` trait with the `'static` lifetime
2551       * The old closure type syntax with the trailing sigil has been
2552         removed in favor of the more consistent leading sigil
2553       * `super` is a keyword, and may be prefixed to paths
2554       * Trait bounds are separated with `+` instead of whitespace
2555       * Traits are implemented with `impl Trait for Type`
2556         instead of `impl Type: Trait`
2557       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
2558       * The `export` keyword has finally been removed
2559       * The `move` keyword has been removed (see "Semantic changes")
2560       * The interior mutability qualifier on vectors, `[mut T]`, has been
2561         removed. Use `&mut [T]`, etc.
2562       * `mut` is no longer valid in `~mut T`. Use inherited mutability
2563       * `fail` is no longer a keyword. Use `fail!()`
2564       * `assert` is no longer a keyword. Use `assert!()`
2565       * `log` is no longer a keyword. use `debug!`, etc.
2566       * 1-tuples may be represented as `(T,)`
2567       * Struct fields may no longer be `mut`. Use inherited mutability,
2568         `@mut T`, `core::mut` or `core::cell`
2569       * `extern mod { ... }` is no longer valid syntax for foreign
2570         function modules. Use extern blocks: `extern { ... }`
2571       * Newtype enums removed. Use tuple-structs.
2572       * Trait implementations no longer support visibility modifiers
2573       * Pattern matching over vectors improved and expanded
2574       * `const` renamed to `static` to correspond to lifetime name,
2575         and make room for future `static mut` unsafe mutable globals.
2576       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
2577       * `Clone` implementations can be automatically generated with
2578         `#[deriving(Clone)]`
2579       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
2580         instead of `foo as Bar`.
2581       * Fixed length vector types are now written as `[int, .. 3]`
2582         instead of `[int * 3]`.
2583       * Fixed length vector types can express the length as a constant
2584         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
2585
2586    * Semantic changes
2587       * Types with owned pointers or custom destructors move by default,
2588         eliminating the `move` keyword
2589       * All foreign functions are considered unsafe
2590       * &mut is now unaliasable
2591       * Writes to borrowed @mut pointers are prevented dynamically
2592       * () has size 0
2593       * The name of the main function can be customized using #[main]
2594       * The default type of an inferred closure is &fn instead of @fn
2595       * `use` statements may no longer be "chained" - they cannot import
2596         identifiers imported by previous `use` statements
2597       * `use` statements are crate relative, importing from the "top"
2598         of the crate by default. Paths may be prefixed with `super::`
2599         or `self::` to change the search behavior.
2600       * Method visibility is inherited from the implementation declaration
2601       * Structural records have been removed
2602       * Many more types can be used in static items, including enums
2603         'static-lifetime pointers and vectors
2604       * Pattern matching over vectors improved and expanded
2605       * Typechecking of closure types has been overhauled to
2606         improve inference and eliminate unsoundness
2607       * Macros leave scope at the end of modules, unless that module is
2608         tagged with #[macro_escape]
2609
2610    * Libraries
2611       * Added big integers to `std::bigint`
2612       * Removed `core::oldcomm` module
2613       * Added pipe-based `core::comm` module
2614       * Numeric traits have been reorganized under `core::num`
2615       * `vec::slice` finally returns a slice
2616       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
2617       * Containers reorganized around traits in `core::container`
2618       * `core::dvec` removed, `~[T]` is a drop-in replacement
2619       * `core::send_map` renamed to `core::hashmap`
2620       * `std::map` removed; replaced with `core::hashmap`
2621       * `std::treemap` reimplemented as an owned balanced tree
2622       * `std::deque` and `std::smallintmap` reimplemented as owned containers
2623       * `core::trie` added as a fast ordered map for integer keys
2624       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
2625       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
2626         overload the comparison operators, whereas `TotalOrd` is used
2627         by certain container types
2628
2629    * Other
2630       * Replaced the 'cargo' package manager with 'rustpkg'
2631       * Added all-purpose 'rust' tool
2632       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
2633       * rustc now *attempts* to offer spelling suggestions
2634       * Improved support for ARM and Android
2635       * Preliminary MIPS backend
2636       * Improved foreign function ABI implementation for x86, x86_64
2637       * Various memory usage improvements
2638       * Rust code may be embedded in foreign code under limited circumstances
2639       * Inline assembler supported by new asm!() syntax extension.
2640
2641
2642 Version 0.5 (2012-12-21)
2643 ===========================
2644
2645    * ~900 changes, numerous bugfixes
2646
2647    * Syntax changes
2648       * Removed `<-` move operator
2649       * Completed the transition from the `#fmt` extension syntax to `fmt!`
2650       * Removed old fixed length vector syntax - `[T]/N`
2651       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
2652       * Macros may now expand to items and statements
2653       * `a.b()` is always parsed as a method call, never as a field projection
2654       * `Eq` and `IterBytes` implementations can be automatically generated
2655         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
2656       * Removed the special crate language for `.rc` files
2657       * Function arguments may consist of any irrefutable pattern
2658
2659    * Semantic changes
2660       * `&` and `~` pointers may point to objects
2661       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
2662       * Enum variants may be structs
2663       * Destructors can be added to all nominal types with the Drop trait
2664       * Structs and nullary enum variants may be constants
2665       * Values that cannot be implicitly copied are now automatically moved
2666         without writing `move` explicitly
2667       * `&T` may now be coerced to `*T`
2668       * Coercions happen in `let` statements as well as function calls
2669       * `use` statements now take crate-relative paths
2670       * The module and type namespaces have been merged so that static
2671         method names can be resolved under the trait in which they are
2672         declared
2673
2674    * Improved support for language features
2675       * Trait inheritance works in many scenarios
2676       * More support for explicit self arguments in methods - `self`, `&self`
2677         `@self`, and `~self` all generally work as expected
2678       * Static methods work in more situations
2679       * Experimental: Traits may declare default methods for the implementations
2680         to use
2681
2682    * Libraries
2683       * New condition handling system in `core::condition`
2684       * Timsort added to `std::sort`
2685       * New priority queue, `std::priority_queue`
2686       * Pipes for serializable types, `std::flatpipes'
2687       * Serialization overhauled to be trait-based
2688       * Expanded `getopts` definitions
2689       * Moved futures to `std`
2690       * More functions are pure now
2691       * `core::comm` renamed to `oldcomm`. Still deprecated
2692       * `rustdoc` and `cargo` are libraries now
2693
2694    * Misc
2695       * Added a preliminary REPL, `rusti`
2696       * License changed from MIT to dual MIT/APL2
2697
2698
2699 Version 0.4 (2012-10-15)
2700 ==========================
2701
2702    * ~2000 changes, numerous bugfixes
2703
2704    * Syntax
2705       * All keywords are now strict and may not be used as identifiers anywhere
2706       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
2707         'of', 'with', 'to', 'class'.
2708       * Classes are replaced with simpler structs
2709       * Explicit method self types
2710       * `ret` became `return` and `alt` became `match`
2711       * `import` is now `use`; `use is now `extern mod`
2712       * `extern mod { ... }` is now `extern { ... }`
2713       * `use mod` is the recommended way to import modules
2714       * `pub` and `priv` replace deprecated export lists
2715       * The syntax of `match` pattern arms now uses fat arrow (=>)
2716       * `main` no longer accepts an args vector; use `os::args` instead
2717
2718    * Semantics
2719       * Trait implementations are now coherent, ala Haskell typeclasses
2720       * Trait methods may be static
2721       * Argument modes are deprecated
2722       * Borrowed pointers are much more mature and recommended for use
2723       * Strings and vectors in the static region are stored in constant memory
2724       * Typestate was removed
2725       * Resolution rewritten to be more reliable
2726       * Support for 'dual-mode' data structures (freezing and thawing)
2727
2728    * Libraries
2729       * Most binary operators can now be overloaded via the traits in
2730         `core::ops'
2731       * `std::net::url` for representing URLs
2732       * Sendable hash maps in `core::send_map`
2733       * `core::task' gained a (currently unsafe) task-local storage API
2734
2735    * Concurrency
2736       * An efficient new intertask communication primitive called the pipe,
2737         along with a number of higher-level channel types, in `core::pipes`
2738       * `std::arc`, an atomically reference counted, immutable, shared memory
2739         type
2740       * `std::sync`, various exotic synchronization tools based on arcs and pipes
2741       * Futures are now based on pipes and sendable
2742       * More robust linked task failure
2743       * Improved task builder API
2744
2745    * Other
2746       * Improved error reporting
2747       * Preliminary JIT support
2748       * Preliminary work on precise GC
2749       * Extensive architectural improvements to rustc
2750       * Begun a transition away from buggy C++-based reflection (shape) code to
2751         Rust-based (visitor) code
2752       * All hash functions and tables converted to secure, randomized SipHash
2753
2754
2755 Version 0.3  (2012-07-12)
2756 ========================
2757
2758    * ~1900 changes, numerous bugfixes
2759
2760    * New coding conveniences
2761       * Integer-literal suffix inference
2762       * Per-item control over warnings, errors
2763       * #[cfg(windows)] and #[cfg(unix)] attributes
2764       * Documentation comments
2765       * More compact closure syntax
2766       * 'do' expressions for treating higher-order functions as
2767         control structures
2768       * *-patterns (wildcard extended to all constructor fields)
2769
2770    * Semantic cleanup
2771       * Name resolution pass and exhaustiveness checker rewritten
2772       * Region pointers and borrow checking supersede alias
2773         analysis
2774       * Init-ness checking is now provided by a region-based liveness
2775         pass instead of the typestate pass; same for last-use analysis
2776       * Extensive work on region pointers
2777
2778    * Experimental new language features
2779       * Slices and fixed-size, interior-allocated vectors
2780       * #!-comments for lang versioning, shell execution
2781       * Destructors and iface implementation for classes;
2782         type-parameterized classes and class methods
2783       * 'const' type kind for types that can be used to implement
2784         shared-memory concurrency patterns
2785
2786    * Type reflection
2787
2788    * Removal of various obsolete features
2789       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
2790                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
2791
2792       * Constructs: do-while loops ('do' repurposed), fn binding,
2793                     resources (replaced by destructors)
2794
2795    * Compiler reorganization
2796       * Syntax-layer of compiler split into separate crate
2797       * Clang (from LLVM project) integrated into build
2798       * Typechecker split into sub-modules
2799
2800    * New library code
2801       * New time functions
2802       * Extension methods for many built-in types
2803       * Arc: atomic-refcount read-only / exclusive-use shared cells
2804       * Par: parallel map and search routines
2805       * Extensive work on libuv interface
2806       * Much vector code moved to libraries
2807       * Syntax extensions: #line, #col, #file, #mod, #stringify,
2808         #include, #include_str, #include_bin
2809
2810    * Tool improvements
2811       * Cargo automatically resolves dependencies
2812
2813
2814 Version 0.2  (2012-03-29)
2815 =========================
2816
2817    * >1500 changes, numerous bugfixes
2818
2819    * New docs and doc tooling
2820
2821    * New port: FreeBSD x86_64
2822
2823    * Compilation model enhancements
2824       * Generics now specialized, multiply instantiated
2825       * Functions now inlined across separate crates
2826
2827    * Scheduling, stack and threading fixes
2828       * Noticeably improved message-passing performance
2829       * Explicit schedulers
2830       * Callbacks from C
2831       * Helgrind clean
2832
2833    * Experimental new language features
2834       * Operator overloading
2835       * Region pointers
2836       * Classes
2837
2838    * Various language extensions
2839       * C-callback function types: 'crust fn ...'
2840       * Infinite-loop construct: 'loop { ... }'
2841       * Shorten 'mutable' to 'mut'
2842       * Required mutable-local qualifier: 'let mut ...'
2843       * Basic glob-exporting: 'export foo::*;'
2844       * Alt now exhaustive, 'alt check' for runtime-checked
2845       * Block-function form of 'for' loop, with 'break' and 'ret'.
2846
2847    * New library code
2848       * AST quasi-quote syntax extension
2849       * Revived libuv interface
2850       * New modules: core::{future, iter}, std::arena
2851       * Merged per-platform std::{os*, fs*} to core::{libc, os}
2852       * Extensive cleanup, regularization in libstd, libcore
2853
2854
2855 Version 0.1  (2012-01-20)
2856 ===============================
2857
2858    * Most language features work, including:
2859       * Unique pointers, unique closures, move semantics
2860       * Interface-constrained generics
2861       * Static interface dispatch
2862       * Stack growth
2863       * Multithread task scheduling
2864       * Typestate predicates
2865       * Failure unwinding, destructors
2866       * Pattern matching and destructuring assignment
2867       * Lightweight block-lambda syntax
2868       * Preliminary macro-by-example
2869
2870    * Compiler works with the following configurations:
2871       * Linux: x86 and x86_64 hosts and targets
2872       * MacOS: x86 and x86_64 hosts and targets
2873       * Windows: x86 hosts and targets
2874
2875    * Cross compilation / multi-target configuration supported.
2876
2877    * Preliminary API-documentation and package-management tools included.
2878
2879 Known issues:
2880
2881    * Documentation is incomplete.
2882
2883    * Performance is below intended target.
2884
2885    * Standard library APIs are subject to extensive change, reorganization.
2886
2887    * Language-level versioning is not yet operational - future code will
2888      break unexpectedly.