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