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