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