]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Update RELEASES.md
[rust.git] / RELEASES.md
1 Version 1.29.0 (2018-09-13)
2 ==========================
3
4 Compiler
5 --------
6 - [Bumped minimum LLVM version to 5.0.][51899]
7 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
8 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
9
10 Libraries
11 ---------
12 - [`Once::call_once` now no longer requires `Once` to be `'static`.][52239]
13 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
14 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
15 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
16   for `&str`.][51178]
17 - [`Cell<T>` now allows `T` to be unsized.][50494]
18 - [`SocketAddr` is now stable on Redox.][52656]
19
20 Stabilized APIs
21 ---------------
22 - [`Arc::downcast`]
23 - [`Iterator::flatten`]
24 - [`Rc::downcast`]
25
26 Cargo
27 -----
28 - [Cargo can silently fix some bad lockfiles ][cargo/5831] You can use
29   `--locked` to disable this behaviour.
30 - [`cargo-install` will now ignore the target triple specified in a project
31   directory's `.cargo/config`.][cargo/5606]
32 - [Added the `cargo-fix` subcommand to automatically move project code from
33   2015 edition to 2018.][cargo/5723]
34
35 Misc
36 ----
37 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
38   the specified level to that level.][52354] For example `--cap-lints warn`
39   will demote `deny` and `forbid` lints to `warn`.
40 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
41   fails, and `101` if there is a panic.][52197]
42
43 Compatibility Notes
44 -------------------
45 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
46   Use `str::get_unchecked(begin..end)` instead.
47 - [`std::env::home_dir` is now deprecated for its unintuitive behaviour.][51656]
48   Consider using the `home_dir` function from
49   https://crates.io/crates/dirs instead.
50 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
51
52 [52861]: https://github.com/rust-lang/rust/pull/52861/
53 [52656]: https://github.com/rust-lang/rust/pull/52656/
54 [52239]: https://github.com/rust-lang/rust/pull/52239/
55 [52330]: https://github.com/rust-lang/rust/pull/52330/
56 [52354]: https://github.com/rust-lang/rust/pull/52354/
57 [52402]: https://github.com/rust-lang/rust/pull/52402/
58 [52103]: https://github.com/rust-lang/rust/pull/52103/
59 [52197]: https://github.com/rust-lang/rust/pull/52197/
60 [51807]: https://github.com/rust-lang/rust/pull/51807/
61 [51899]: https://github.com/rust-lang/rust/pull/51899/
62 [51912]: https://github.com/rust-lang/rust/pull/51912/
63 [51511]: https://github.com/rust-lang/rust/pull/51511/
64 [51619]: https://github.com/rust-lang/rust/pull/51619/
65 [51656]: https://github.com/rust-lang/rust/pull/51656/
66 [51178]: https://github.com/rust-lang/rust/pull/51178/
67 [50494]: https://github.com/rust-lang/rust/pull/50494/
68 [cargo/5606]: https://github.com/rust-lang/cargo/pull/5606/
69 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
70 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
71 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
72 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
73 [`Rc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Rc.html#method.downcast
74
75
76 Version 1.28.0 (2018-08-02)
77 ===========================
78
79 Language
80 --------
81 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
82   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
83   the inner type across Foreign Function Interface (FFI) boundaries.
84 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
85   and can now be used as identifiers.][51196]
86 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
87   stable.][51241] This will allow users to specify a global allocator for
88   their program.
89 - [Unit test functions marked with the `#[test]` attribute can now return
90   `Result<(), E: Debug>` in addition to `()`.][51298]
91 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
92   allows macros to easily target lifetimes.
93
94 Compiler
95 --------
96 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
97   prioritise making smaller binary sizes. `z` is the same as `s` with the
98   exception that it does not vectorise loops, which typically results in an even
99   smaller binary.
100 - [The short error format is now stable.][49546] Specified with
101   `--error-format=short` this option will provide a more compressed output of
102   rust error messages.
103 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
104 - [Reduced the number of allocations in the macro parser.][50855] This can
105   improve compile times of macro heavy crates on average by 5%.
106
107 Libraries
108 ---------
109 - [Implemented `Default` for `&mut str`.][51306]
110 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
111 - [Implemented `Extend` for `()`.][50234]
112 - [The `Debug` implementation of `time::Duration` should now be more easily
113   human readable.][50364] Previously a `Duration` of one second would printed as
114   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
115 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
116   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
117   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
118   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
119   for `PathBuf`.][50170]
120 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
121   and `Wrapping<i128>`.][50465]
122 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
123   possible.][51050] This can provide up to a 40% speed increase.
124 - [Improved error messages when using `format!`.][50610]
125
126 Stabilized APIs
127 ---------------
128 - [`Iterator::step_by`]
129 - [`Path::ancestors`]
130 - [`SystemTime::UNIX_EPOCH`]
131 - [`alloc::GlobalAlloc`]
132 - [`alloc::Layout`]
133 - [`alloc::LayoutErr`]
134 - [`alloc::System`]
135 - [`alloc::alloc`]
136 - [`alloc::alloc_zeroed`]
137 - [`alloc::dealloc`]
138 - [`alloc::realloc`]
139 - [`alloc::handle_alloc_error`]
140 - [`btree_map::Entry::or_default`]
141 - [`fmt::Alignment`]
142 - [`hash_map::Entry::or_default`]
143 - [`iter::repeat_with`]
144 - [`num::NonZeroUsize`]
145 - [`num::NonZeroU128`]
146 - [`num::NonZeroU16`]
147 - [`num::NonZeroU32`]
148 - [`num::NonZeroU64`]
149 - [`num::NonZeroU8`]
150 - [`ops::RangeBounds`]
151 - [`slice::SliceIndex`]
152 - [`slice::from_mut`]
153 - [`slice::from_ref`]
154 - [`{Any + Send + Sync}::downcast_mut`]
155 - [`{Any + Send + Sync}::downcast_ref`]
156 - [`{Any + Send + Sync}::is`]
157
158 Cargo
159 -----
160 - [Cargo will now no longer allow you to publish crates with build scripts that
161   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
162   considered to be immutable.
163
164 Misc
165 ----
166 - [The `suggestion_applicability` field in `rustc`'s json output is now
167   stable.][50486] This will allow dev tools to check whether a code suggestion
168   would apply to them.
169
170 Compatibility Notes
171 -------------------
172 - [Rust will consider trait objects with duplicated constraints to be the same
173   type as without the duplicated constraint.][51276] For example the below code will
174   now fail to compile.
175   ```rust
176   trait Trait {}
177
178   impl Trait + Send {
179       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
180   }
181
182   impl Trait + Send + Send {
183       fn test(&self) { println!("two"); }
184   }
185   ```
186
187 [49546]: https://github.com/rust-lang/rust/pull/49546/
188 [50143]: https://github.com/rust-lang/rust/pull/50143/
189 [50170]: https://github.com/rust-lang/rust/pull/50170/
190 [50234]: https://github.com/rust-lang/rust/pull/50234/
191 [50265]: https://github.com/rust-lang/rust/pull/50265/
192 [50364]: https://github.com/rust-lang/rust/pull/50364/
193 [50385]: https://github.com/rust-lang/rust/pull/50385/
194 [50465]: https://github.com/rust-lang/rust/pull/50465/
195 [50486]: https://github.com/rust-lang/rust/pull/50486/
196 [50554]: https://github.com/rust-lang/rust/pull/50554/
197 [50610]: https://github.com/rust-lang/rust/pull/50610/
198 [50855]: https://github.com/rust-lang/rust/pull/50855/
199 [51050]: https://github.com/rust-lang/rust/pull/51050/
200 [51196]: https://github.com/rust-lang/rust/pull/51196/
201 [51200]: https://github.com/rust-lang/rust/pull/51200/
202 [51241]: https://github.com/rust-lang/rust/pull/51241/
203 [51276]: https://github.com/rust-lang/rust/pull/51276/
204 [51298]: https://github.com/rust-lang/rust/pull/51298/
205 [51306]: https://github.com/rust-lang/rust/pull/51306/
206 [51562]: https://github.com/rust-lang/rust/pull/51562/
207 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
208 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
209 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
210 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
211 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
212 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
213 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
214 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
215 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
216 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
217 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
218 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
219 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
220 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
221 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
222 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
223 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
224 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
225 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
226 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
227 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
228 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
229 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
230 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
231 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
232 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
233 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
234 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
235 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
236 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
237
238 Version 1.27.2 (2018-07-20)
239 ===========================
240
241 Compatibility Notes
242 -------------------
243
244 - The borrow checker was fixed to avoid potential unsoundness when using
245   match ergonomics: [#52213][52213].
246
247 [52213]: https://github.com/rust-lang/rust/issues/52213
248
249 Version 1.27.1 (2018-07-10)
250 ===========================
251
252 Security Notes
253 --------------
254
255 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
256   when running, which enabled executing code as some other user on a
257   given machine. This release fixes that vulnerability; you can read
258   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
259
260   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
261
262 Compatibility Notes
263 -------------------
264
265 - The borrow checker was fixed to avoid an additional potential unsoundness when using
266   match ergonomics: [#51415][51415], [#49534][49534].
267
268 [51415]: https://github.com/rust-lang/rust/issues/51415
269 [49534]: https://github.com/rust-lang/rust/issues/49534
270 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
271 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
272
273 Version 1.27.0 (2018-06-21)
274 ==========================
275
276 Language
277 --------
278 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
279   be used as an identifier.
280 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
281   bare `Trait` syntax, and should make it clearer when being used in tandem with
282   `impl Trait`. Since it is equivalent to the following syntax:
283   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
284   `Box<Trait> == Box<dyn Trait>`.
285 - [Attributes on generic parameters such as types and lifetimes are
286   now stable.][48851] e.g.
287   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
288 - [The `#[must_use]` attribute can now also be used on functions as well as
289   types.][48925] It provides a lint that by default warns users when the
290   value returned by a function has not been used.
291
292 Compiler
293 --------
294 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
295
296 Libraries
297 ---------
298 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
299   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
300   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
301   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
302   the `cfg` attribute.
303 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
304   std are now available in core.][49896]
305 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
306   to `Self`.][49630]
307 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
308   that the operation isn't done in place.
309 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
310   the `#[must_use]` attribute][49533] to warn about unused potentially
311   expensive allocations.
312
313 Stabilized APIs
314 ---------------
315 - [`DoubleEndedIterator::rfind`]
316 - [`DoubleEndedIterator::rfold`]
317 - [`DoubleEndedIterator::try_rfold`]
318 - [`Duration::from_micros`]
319 - [`Duration::from_nanos`]
320 - [`Duration::subsec_micros`]
321 - [`Duration::subsec_millis`]
322 - [`HashMap::remove_entry`]
323 - [`Iterator::try_fold`]
324 - [`Iterator::try_for_each`]
325 - [`NonNull::cast`]
326 - [`Option::filter`]
327 - [`String::replace_range`]
328 - [`Take::set_limit`]
329 - [`hint::unreachable_unchecked`]
330 - [`os::unix::process::parent_id`]
331 - [`ptr::swap_nonoverlapping`]
332 - [`slice::rsplit_mut`]
333 - [`slice::rsplit`]
334 - [`slice::swap_with_slice`]
335
336 Cargo
337 -----
338 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
339   `readme`, and `repository` fields.][cargo/5386]
340 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
341 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
342   a different directory than `target` for placing compilation artifacts.
343 - [Cargo will be adding automatic target inference for binaries, benchmarks,
344   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
345   specific targets e.g. using `[[bin]]` and have other binaries in locations
346   where cargo would infer a binary, Cargo will produce a warning. You can
347   disable this feature ahead of time by setting any of the following `autobins`,
348   `autobenches`, `autoexamples`, `autotests` to false.
349 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
350   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
351
352 Misc
353 ----
354 - [Added “The Rustc book” into the official documentation.][49707]
355   [“The Rustc book”] documents and teaches how to use the rustc compiler.
356 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
357
358 Compatibility Notes
359 -------------------
360 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
361   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
362   compile, `"".is_empty()` will still compile.
363 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
364   will only print the inner type.][48553] e.g.
365   `print!("{:?}", AtomicBool::new(true))` will print `true`
366   not `AtomicBool(true)`.
367 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
368   could enter higher numbers but they were not supported by LLVM. Up to 512MB
369   alignment should cover all use cases.
370
371 [48553]: https://github.com/rust-lang/rust/pull/48553/
372 [48851]: https://github.com/rust-lang/rust/pull/48851/
373 [48925]: https://github.com/rust-lang/rust/pull/48925/
374 [49533]: https://github.com/rust-lang/rust/pull/49533/
375 [49623]: https://github.com/rust-lang/rust/pull/49623/
376 [49630]: https://github.com/rust-lang/rust/pull/49630/
377 [49664]: https://github.com/rust-lang/rust/pull/49664/
378 [49699]: https://github.com/rust-lang/rust/pull/49699/
379 [49707]: https://github.com/rust-lang/rust/pull/49707/
380 [49719]: https://github.com/rust-lang/rust/pull/49719/
381 [49896]: https://github.com/rust-lang/rust/pull/49896/
382 [49968]: https://github.com/rust-lang/rust/pull/49968/
383 [50177]: https://github.com/rust-lang/rust/pull/50177/
384 [50378]: https://github.com/rust-lang/rust/pull/50378/
385 [50398]: https://github.com/rust-lang/rust/pull/50398/
386 [50423]: https://github.com/rust-lang/rust/pull/50423/
387 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
388 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
389 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
390 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
391 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
392 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
393 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
394 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
395 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
396 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
397 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
398 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
399 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
400 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
401 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
402 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
403 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
404 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
405 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
406 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
407 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
408 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
409 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
410 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
411 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
412 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
413 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
414 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
415 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
416 [“The Rustc book”]: https://doc.rust-lang.org/rustc
417
418
419 Version 1.26.2 (2018-06-05)
420 ==========================
421
422 Compatibility Notes
423 -------------------
424
425 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics][51117]
426
427 [51117]: https://github.com/rust-lang/rust/issues/51117
428
429
430 Version 1.26.1 (2018-05-29)
431 ==========================
432
433 Tools
434 -----
435
436 - [RLS now works on Windows][50646]
437 - [Rustfmt stopped badly formatting text in some cases][rustfmt/2695]
438
439
440 Compatibility Notes
441 --------
442
443 - [`fn main() -> impl Trait` no longer works for non-Termination
444   trait][50656]
445   This reverts an accidental stabilization.
446 - [`NaN > NaN` no longer returns true in const-fn contexts][50812]
447 - [Prohibit using turbofish for `impl Trait` in method arguments][50950]
448
449 [50646]: https://github.com/rust-lang/rust/issues/50646
450 [50656]: https://github.com/rust-lang/rust/pull/50656
451 [50812]: https://github.com/rust-lang/rust/pull/50812
452 [50950]: https://github.com/rust-lang/rust/issues/50950
453 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
454
455 Version 1.26.0 (2018-05-10)
456 ==========================
457
458 Language
459 --------
460 - [Closures now implement `Copy` and/or `Clone` if all captured variables
461   implement either or both traits.][49299]
462 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
463 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere where a
464   lifetime can be elided.][49458]
465 - [`impl Trait` is now stable allowing you to have abstract types in returns
466    or in function parameters.][49255] e.g. `fn foo() -> impl Iterator<Item=u8>` or
467   `fn open(path: impl AsRef<Path>)`.
468 - [Pattern matching will now automatically apply dereferences.][49394]
469 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
470 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
471 - [A lot of operations are now available in a const context.][46882] E.g. You
472   can now index into constant arrays, reference and dereference into constants,
473   and use Tuple struct constructors.
474 - [Fixed entry slice patterns are now stable.][48516] e.g.
475   ```rust
476   let points = [1, 2, 3, 4];
477   match points {
478       [1, 2, 3, 4] => println!("All points were sequential."),
479       _ => println!("Not all points were sequential."),
480   }
481   ```
482
483
484 Compiler
485 --------
486 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
487 - [Fixed exponential projection complexity on nested types.][48296]
488   This can provide up to a ~12% reduction in compile times for certain crates.
489 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
490   to remap path prefixes outputted by the compiler.
491 - [Added `powerpc-unknown-netbsd` target.][48281]
492
493 Libraries
494 ---------
495 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
496 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
497   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
498 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
499 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
500 - [`ascii::escape_default` is now available in libcore.][48735]
501 - [Trailing commas are now supported in std and core macros.][48056]
502 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
503 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
504
505 Stabilized APIs
506 ---------------
507 - [`*const T::add`]
508 - [`*const T::copy_to_nonoverlapping`]
509 - [`*const T::copy_to`]
510 - [`*const T::read_unaligned`]
511 - [`*const T::read_volatile`]
512 - [`*const T::read`]
513 - [`*const T::sub`]
514 - [`*const T::wrapping_add`]
515 - [`*const T::wrapping_sub`]
516 - [`*mut T::add`]
517 - [`*mut T::copy_to_nonoverlapping`]
518 - [`*mut T::copy_to`]
519 - [`*mut T::read_unaligned`]
520 - [`*mut T::read_volatile`]
521 - [`*mut T::read`]
522 - [`*mut T::replace`]
523 - [`*mut T::sub`]
524 - [`*mut T::swap`]
525 - [`*mut T::wrapping_add`]
526 - [`*mut T::wrapping_sub`]
527 - [`*mut T::write_bytes`]
528 - [`*mut T::write_unaligned`]
529 - [`*mut T::write_volatile`]
530 - [`*mut T::write`]
531 - [`Box::leak`]
532 - [`FromUtf8Error::as_bytes`]
533 - [`LocalKey::try_with`]
534 - [`Option::cloned`]
535 - [`btree_map::Entry::and_modify`]
536 - [`fs::read_to_string`]
537 - [`fs::read`]
538 - [`fs::write`]
539 - [`hash_map::Entry::and_modify`]
540 - [`iter::FusedIterator`]
541 - [`ops::RangeInclusive`]
542 - [`ops::RangeToInclusive`]
543 - [`process::id`]
544 - [`slice::rotate_left`]
545 - [`slice::rotate_right`]
546 - [`String::retain`]
547
548
549 Cargo
550 -----
551 - [Cargo will now output path to custom commands when `-v` is
552   passed with `--list`][cargo/5041]
553 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
554
555 Misc
556 ----
557 - [The second edition of "The Rust Programming Language" book is now recommended
558   over the first.][48404]
559
560 Compatibility Notes
561 -------------------
562
563 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
564   syntax is now invalid.
565   ```
566   use std::ops::Fn as dyn;
567   fn g(_: Box<dyn(std::fmt::Debug)>) {}
568   ```
569 - [The result of dereferences are no longer promoted to `'static`.][47408]
570   e.g.
571   ```rust
572   fn main() {
573       const PAIR: &(i32, i32) = &(0, 1);
574       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
575   }
576   ```
577 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
578 - [`".e0"` will now no longer parse as `0.0` and will instead cause
579   an error.][48235]
580 - [Removed hoedown from rustdoc.][48274]
581 - [Bounds on higher-kinded lifetimes a hard error.][48326]
582
583 [46882]: https://github.com/rust-lang/rust/pull/46882
584 [47379]: https://github.com/rust-lang/rust/pull/47379
585 [47408]: https://github.com/rust-lang/rust/pull/47408
586 [47813]: https://github.com/rust-lang/rust/pull/47813
587 [48056]: https://github.com/rust-lang/rust/pull/48056
588 [48125]: https://github.com/rust-lang/rust/pull/48125
589 [48166]: https://github.com/rust-lang/rust/pull/48166
590 [48235]: https://github.com/rust-lang/rust/pull/48235
591 [48274]: https://github.com/rust-lang/rust/pull/48274
592 [48281]: https://github.com/rust-lang/rust/pull/48281
593 [48296]: https://github.com/rust-lang/rust/pull/48296
594 [48326]: https://github.com/rust-lang/rust/pull/48326
595 [48359]: https://github.com/rust-lang/rust/pull/48359
596 [48404]: https://github.com/rust-lang/rust/pull/48404
597 [48481]: https://github.com/rust-lang/rust/pull/48481
598 [48516]: https://github.com/rust-lang/rust/pull/48516
599 [48628]: https://github.com/rust-lang/rust/pull/48628
600 [48629]: https://github.com/rust-lang/rust/pull/48629
601 [48657]: https://github.com/rust-lang/rust/pull/48657
602 [48735]: https://github.com/rust-lang/rust/pull/48735
603 [48978]: https://github.com/rust-lang/rust/pull/48978
604 [49101]: https://github.com/rust-lang/rust/pull/49101
605 [49109]: https://github.com/rust-lang/rust/pull/49109
606 [49121]: https://github.com/rust-lang/rust/pull/49121
607 [49162]: https://github.com/rust-lang/rust/pull/49162
608 [49184]: https://github.com/rust-lang/rust/pull/49184
609 [49234]: https://github.com/rust-lang/rust/pull/49234
610 [49255]: https://github.com/rust-lang/rust/pull/49255
611 [49299]: https://github.com/rust-lang/rust/pull/49299
612 [49305]: https://github.com/rust-lang/rust/pull/49305
613 [49394]: https://github.com/rust-lang/rust/pull/49394
614 [49458]: https://github.com/rust-lang/rust/pull/49458
615 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
616 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
617 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
618 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
619 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
620 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
621 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
622 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
623 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
624 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
625 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
626 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
627 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
628 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
629 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
630 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
631 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
632 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
633 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
634 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
635 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
636 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
637 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
638 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
639 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
640 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
641 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
642 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
643 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
644 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
645 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
646 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
647 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
648 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
649 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
650 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
651 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
652 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
653 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
654 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
655 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
656 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
657
658
659 Version 1.25.0 (2018-03-29)
660 ==========================
661
662 Language
663 --------
664 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
665 - [You can now use nested groups of imports.][47948]
666   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
667 - [You can now have `|` at the start of a match arm.][47947] e.g.
668 ```rust
669 enum Foo { A, B, C }
670
671 fn main() {
672     let x = Foo::A;
673     match x {
674         | Foo::A
675         | Foo::B => println!("AB"),
676         | Foo::C => println!("C"),
677     }
678 }
679 ```
680
681 Compiler
682 --------
683 - [Upgraded to LLVM 6.][47828]
684 - [Added `-C lto=val` option.][47521]
685 - [Added `i586-unknown-linux-musl` target][47282]
686
687 Libraries
688 ---------
689 - [Impl Send for `process::Command` on Unix.][47760]
690 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
691 - [`UnsafeCell::into_inner` is now safe.][47204]
692 - [Implement libstd for CloudABI.][47268]
693 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
694 - [Implement `AsRef<Path>` for Component][46985]
695 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
696 - [Moved `Duration` to libcore.][46666]
697
698 Stabilized APIs
699 ---------------
700 - [`Location::column`]
701 - [`ptr::NonNull`]
702
703 The following functions can now be used in a constant expression.
704 eg. `static MINUTE: Duration = Duration::from_secs(60);`
705 - [`Duration::new`][47300]
706 - [`Duration::from_secs`][47300]
707 - [`Duration::from_millis`][47300]
708
709 Cargo
710 -----
711 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
712 - [`cargo new` now defaults to creating a binary crate, instead of a
713   library crate.][cargo/5029]
714
715 Misc
716 ----
717 - [Rust by example is now shipped with new releases][46196]
718
719 Compatibility Notes
720 -------------------
721 - [Deprecated `net::lookup_host`.][47510]
722 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
723 - The borrow checker was sometimes incorrectly permitting overlapping borrows
724   around indexing operations (see [#47349][47349]). This has been fixed (which also
725   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
726 - [Removed deprecated unstable attribute `#[simd]`.][47251]
727
728 [33903]: https://github.com/rust-lang/rust/pull/33903
729 [47947]: https://github.com/rust-lang/rust/pull/47947
730 [47948]: https://github.com/rust-lang/rust/pull/47948
731 [47760]: https://github.com/rust-lang/rust/pull/47760
732 [47790]: https://github.com/rust-lang/rust/pull/47790
733 [47828]: https://github.com/rust-lang/rust/pull/47828
734 [47398]: https://github.com/rust-lang/rust/pull/47398
735 [47510]: https://github.com/rust-lang/rust/pull/47510
736 [47521]: https://github.com/rust-lang/rust/pull/47521
737 [47204]: https://github.com/rust-lang/rust/pull/47204
738 [47251]: https://github.com/rust-lang/rust/pull/47251
739 [47268]: https://github.com/rust-lang/rust/pull/47268
740 [47282]: https://github.com/rust-lang/rust/pull/47282
741 [47300]: https://github.com/rust-lang/rust/pull/47300
742 [47349]: https://github.com/rust-lang/rust/pull/47349
743 [46931]: https://github.com/rust-lang/rust/pull/46931
744 [46985]: https://github.com/rust-lang/rust/pull/46985
745 [47006]: https://github.com/rust-lang/rust/pull/47006
746 [46830]: https://github.com/rust-lang/rust/pull/46830
747 [46095]: https://github.com/rust-lang/rust/pull/46095
748 [46666]: https://github.com/rust-lang/rust/pull/46666
749 [46196]: https://github.com/rust-lang/rust/pull/46196
750 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
751 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
752 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
753 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
754 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
755
756
757 Version 1.24.1 (2018-03-01)
758 ==========================
759
760  - [Do not abort when unwinding through FFI][48251]
761  - [Emit UTF-16 files for linker arguments on Windows][48318]
762  - [Make the error index generator work again][48308]
763  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
764
765 [48251]: https://github.com/rust-lang/rust/issues/48251
766 [48308]: https://github.com/rust-lang/rust/issues/48308
767 [48318]: https://github.com/rust-lang/rust/issues/48318
768 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
769
770
771 Version 1.24.0 (2018-02-15)
772 ==========================
773
774 Language
775 --------
776 - [External `sysv64` ffi is now available.][46528]
777   eg. `extern "sysv64" fn foo () {}`
778
779 Compiler
780 --------
781 - [rustc now uses 16 codegen units by default for release builds.][46910]
782   For the fastest builds, utilize `codegen-units=1`.
783 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
784 - [Add `aarch64-unknown-openbsd` support][46760]
785
786 Libraries
787 ---------
788 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
789   improvement in performance in the majority of cases.
790 - [`OsStr`'s `Debug` implementation is now lossless and consistent
791   with Windows.][46798]
792 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
793 - [impl `From<bool>` for `AtomicBool`][46293]
794 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
795 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
796 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
797 - [float::from_bits now just uses transmute.][46012] This provides
798   some optimisations from LLVM.
799 - [Copied `AsciiExt` methods onto `char`][46077]
800 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
801 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
802 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
803 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
804
805 Stabilized APIs
806 ---------------
807 - [`RefCell::replace`]
808 - [`RefCell::swap`]
809 - [`atomic::spin_loop_hint`]
810
811 The following functions can now be used in a constant expression.
812 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
813
814 - [`AtomicBool::new`][46287]
815 - [`AtomicUsize::new`][46287]
816 - [`AtomicIsize::new`][46287]
817 - [`AtomicPtr::new`][46287]
818 - [`Cell::new`][46287]
819 - [`{integer}::min_value`][46287]
820 - [`{integer}::max_value`][46287]
821 - [`mem::size_of`][46287]
822 - [`mem::align_of`][46287]
823 - [`ptr::null`][46287]
824 - [`ptr::null_mut`][46287]
825 - [`RefCell::new`][46287]
826 - [`UnsafeCell::new`][46287]
827
828 Cargo
829 -----
830 - [Added a `workspace.default-members` config that
831   overrides implied `--all` in virtual workspaces.][cargo/4743]
832 - [Enable incremental by default on development builds.][cargo/4817] Also added
833   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
834   per-project or global basis respectively.
835
836 Misc
837 ----
838
839 Compatibility Notes
840 -------------------
841 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
842 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
843   in accordance with IETF RFC 4291 §2.2.
844 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
845 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
846   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
847 - [Leading zeros in tuple struct members is now an error][47084]
848 - [`column!()` macro is one-based instead of zero-based][46977]
849 - [`fmt::Arguments` can no longer be shared across threads][45198]
850 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
851 - [Cargo sets a different working directory for the compiler][cargo/4788]
852
853 [44884]: https://github.com/rust-lang/rust/pull/44884
854 [45198]: https://github.com/rust-lang/rust/pull/45198
855 [45506]: https://github.com/rust-lang/rust/pull/45506
856 [45904]: https://github.com/rust-lang/rust/pull/45904
857 [45990]: https://github.com/rust-lang/rust/pull/45990
858 [46012]: https://github.com/rust-lang/rust/pull/46012
859 [46077]: https://github.com/rust-lang/rust/pull/46077
860 [46094]: https://github.com/rust-lang/rust/pull/46094
861 [46284]: https://github.com/rust-lang/rust/pull/46284
862 [46287]: https://github.com/rust-lang/rust/pull/46287
863 [46293]: https://github.com/rust-lang/rust/pull/46293
864 [46528]: https://github.com/rust-lang/rust/pull/46528
865 [46671]: https://github.com/rust-lang/rust/pull/46671
866 [46713]: https://github.com/rust-lang/rust/pull/46713
867 [46735]: https://github.com/rust-lang/rust/pull/46735
868 [46749]: https://github.com/rust-lang/rust/pull/46749
869 [46760]: https://github.com/rust-lang/rust/pull/46760
870 [46798]: https://github.com/rust-lang/rust/pull/46798
871 [46828]: https://github.com/rust-lang/rust/pull/46828
872 [46831]: https://github.com/rust-lang/rust/pull/46831
873 [46833]: https://github.com/rust-lang/rust/pull/46833
874 [46910]: https://github.com/rust-lang/rust/pull/46910
875 [46977]: https://github.com/rust-lang/rust/pull/46977
876 [47018]: https://github.com/rust-lang/rust/pull/47018
877 [47080]: https://github.com/rust-lang/rust/pull/47080
878 [47084]: https://github.com/rust-lang/rust/pull/47084
879 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
880 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
881 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
882 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
883 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
884 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
885
886
887 Version 1.23.0 (2018-01-04)
888 ==========================
889
890 Language
891 --------
892 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
893 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
894   Which should fix some confusing errors in some operations.
895
896 Compiler
897 --------
898 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
899   undefined behaviour.][45920]
900 - [rustc now suggests renaming import if names clash.][45660]
901 - [Display errors/warnings correctly when there are zero-width or
902   wide characters.][45711]
903 - [rustc now avoids unnecessary copies of arguments that are
904   simple bindings][45380] This should improve memory usage on average by 5-10%.
905 - [Updated musl used to build musl rustc to 1.1.17][45393]
906
907 Libraries
908 ---------
909 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
910 - [Implement Hash for raw pointers to unsized types][45483]
911 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
912 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
913 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
914 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
915   and `<*mut T>::as_mut`][44932]
916 - [Optimized `Thread::{park, unpark}` implementation][45524]
917 - [Improved `SliceExt::binary_search` performance.][45333]
918 - [impl `FromIterator<()>` for `()`][45379]
919 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
920   is now deprecated.
921
922 Stabilized APIs
923 ---------------
924
925 Cargo
926 -----
927 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
928   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
929 - [Added unit test checking to `cargo check`][cargo/4592]
930 - [Cargo now lets you install a specific version
931   using `cargo install --version`][cargo/4637]
932
933 Misc
934 ----
935 - [Releases now ship with the Cargo book documentation.][45692]
936 - [rustdoc now prints rendering warnings on every run.][45324]
937
938 Compatibility Notes
939 -------------------
940 - [Changes have been made to type equality to make it more correct,
941   in rare cases this could break some code.][45853] [Tracking issue for
942   further information][45852]
943 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
944 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
945   Android 9, the minimum supported version is Android 14.
946 - [Bumped the minimum LLVM to 3.9][45326]
947
948 [44042]: https://github.com/rust-lang/rust/pull/44042
949 [44932]: https://github.com/rust-lang/rust/pull/44932
950 [45267]: https://github.com/rust-lang/rust/pull/45267
951 [45324]: https://github.com/rust-lang/rust/pull/45324
952 [45326]: https://github.com/rust-lang/rust/pull/45326
953 [45333]: https://github.com/rust-lang/rust/pull/45333
954 [45379]: https://github.com/rust-lang/rust/pull/45379
955 [45380]: https://github.com/rust-lang/rust/pull/45380
956 [45393]: https://github.com/rust-lang/rust/pull/45393
957 [45435]: https://github.com/rust-lang/rust/pull/45435
958 [45483]: https://github.com/rust-lang/rust/pull/45483
959 [45524]: https://github.com/rust-lang/rust/pull/45524
960 [45571]: https://github.com/rust-lang/rust/pull/45571
961 [45580]: https://github.com/rust-lang/rust/pull/45580
962 [45610]: https://github.com/rust-lang/rust/pull/45610
963 [45660]: https://github.com/rust-lang/rust/pull/45660
964 [45692]: https://github.com/rust-lang/rust/pull/45692
965 [45711]: https://github.com/rust-lang/rust/pull/45711
966 [45772]: https://github.com/rust-lang/rust/pull/45772
967 [45852]: https://github.com/rust-lang/rust/issues/45852
968 [45853]: https://github.com/rust-lang/rust/pull/45853
969 [45887]: https://github.com/rust-lang/rust/pull/45887
970 [45920]: https://github.com/rust-lang/rust/pull/45920
971 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
972 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
973 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
974
975
976 Version 1.22.1 (2017-11-22)
977 ==========================
978
979 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
980
981 [46183]: https://github.com/rust-lang/rust/pull/46183
982
983 Version 1.22.0 (2017-11-22)
984 ==========================
985
986 Language
987 --------
988 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
989 - [Now accepts underscores in unicode escapes][43716]
990 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
991 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
992
993 Compiler
994 --------
995 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
996 - [rustc will no longer inline in codegen units when compiling for debug][45075]
997   This should decrease compile times for debug builds.
998 - [strict memory alignment now enabled on ARMv6][45094]
999 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1000
1001 Libraries
1002 ---------
1003 - [Allow atomic operations up to 32 bits
1004   on `armv5te_unknown_linux_gnueabi`][44978]
1005 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1006 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1007 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1008 - [Properly detect overflow in `Instant += Duration`.][44220]
1009 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1010 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1011 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1012
1013 Stabilized APIs
1014 ---------------
1015
1016 Cargo
1017 -----
1018 - [Cargo will now build multi file examples in subdirectories of the `examples`
1019   folder that have a `main.rs` file.][cargo/4496]
1020 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1021   the old format will continue to work and can be updated with `cargo update`.
1022 - [Now supports vendoring git repositories][cargo/3992]
1023
1024 Misc
1025 ----
1026 - [`libbacktrace` is now available on Apple platforms.][44251]
1027 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1028   This now lets you specify that a given code example will fail to compile.
1029
1030 Compatibility Notes
1031 -------------------
1032 - [The minimum Android version that rustc can build for has been bumped
1033   to `4.0` from `2.3`][45656]
1034 - [Allowing `T op= &T` for numeric types has broken some type
1035   inference cases][45480]
1036
1037
1038 [42526]: https://github.com/rust-lang/rust/pull/42526
1039 [43017]: https://github.com/rust-lang/rust/pull/43017
1040 [43716]: https://github.com/rust-lang/rust/pull/43716
1041 [43949]: https://github.com/rust-lang/rust/pull/43949
1042 [44015]: https://github.com/rust-lang/rust/pull/44015
1043 [44220]: https://github.com/rust-lang/rust/pull/44220
1044 [44251]: https://github.com/rust-lang/rust/pull/44251
1045 [44287]: https://github.com/rust-lang/rust/pull/44287
1046 [44303]: https://github.com/rust-lang/rust/pull/44303
1047 [44456]: https://github.com/rust-lang/rust/pull/44456
1048 [44466]: https://github.com/rust-lang/rust/pull/44466
1049 [44895]: https://github.com/rust-lang/rust/pull/44895
1050 [44966]: https://github.com/rust-lang/rust/pull/44966
1051 [44978]: https://github.com/rust-lang/rust/pull/44978
1052 [45041]: https://github.com/rust-lang/rust/pull/45041
1053 [45064]: https://github.com/rust-lang/rust/pull/45064
1054 [45075]: https://github.com/rust-lang/rust/pull/45075
1055 [45094]: https://github.com/rust-lang/rust/pull/45094
1056 [45095]: https://github.com/rust-lang/rust/pull/45095
1057 [45480]: https://github.com/rust-lang/rust/issues/45480
1058 [45656]: https://github.com/rust-lang/rust/pull/45656
1059 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1060 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1061 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1062
1063
1064
1065
1066
1067
1068 Version 1.21.0 (2017-10-12)
1069 ==========================
1070
1071 Language
1072 --------
1073 - [You can now use static references for literals.][43838]
1074   Example:
1075   ```rust
1076   fn main() {
1077       let x: &'static u32 = &0;
1078   }
1079   ```
1080 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1081   Example:
1082   ```rust
1083   my_macro!(Vec<i32>::new); // Always worked
1084   my_macro!(Vec::<i32>::new); // Now works
1085   ```
1086
1087 Compiler
1088 --------
1089 - [Upgraded jemalloc to 4.5.0][43911]
1090 - [Enabled unwinding panics on Redox][43917]
1091 - [Now runs LLVM in parallel during translation phase.][43506]
1092   This should reduce peak memory usage.
1093
1094 Libraries
1095 ---------
1096 - [Generate builtin impls for `Clone` for all arrays and tuples that
1097   are `T: Clone`][43690]
1098 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1099 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1100   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1101
1102 Stabilized APIs
1103 ---------------
1104
1105 [`std::mem::discriminant`]
1106
1107 Cargo
1108 -----
1109 - [You can now call `cargo install` with multiple package names][cargo/4216]
1110 - [Cargo commands inside a virtual workspace will now implicitly
1111   pass `--all`][cargo/4335]
1112 - [Added a `[patch]` section to `Cargo.toml` to handle
1113   prepublication dependencies][cargo/4123] [RFC 1969]
1114 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1115   like patterns][cargo/4270]
1116 - [Added the `--all-targets` option][cargo/4400]
1117 - [Using required dependencies as a feature is now deprecated and emits
1118   a warning][cargo/4364]
1119
1120
1121 Misc
1122 ----
1123 - [Cargo docs are moving][43916]
1124   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1125 - [The rustdoc book is now available][43863]
1126   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1127 - [Added a preview of RLS has been made available through rustup][44204]
1128   Install with `rustup component add rls-preview`
1129 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1130   Previously only showed `std::os::unix`.
1131
1132 Compatibility Notes
1133 -------------------
1134 - [Changes in method matching against higher-ranked types][43880] This may cause
1135   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1136 - [rustc's JSON error output's byte position start at top of file.][42973]
1137   Was previously relative to the rustc's internal `CodeMap` struct which
1138   required the unstable library `libsyntax` to correctly use.
1139 - [`unused_results` lint no longer ignores booleans][43728]
1140
1141 [42565]: https://github.com/rust-lang/rust/pull/42565
1142 [42973]: https://github.com/rust-lang/rust/pull/42973
1143 [43348]: https://github.com/rust-lang/rust/pull/43348
1144 [43459]: https://github.com/rust-lang/rust/pull/43459
1145 [43506]: https://github.com/rust-lang/rust/pull/43506
1146 [43540]: https://github.com/rust-lang/rust/pull/43540
1147 [43690]: https://github.com/rust-lang/rust/pull/43690
1148 [43728]: https://github.com/rust-lang/rust/pull/43728
1149 [43838]: https://github.com/rust-lang/rust/pull/43838
1150 [43863]: https://github.com/rust-lang/rust/pull/43863
1151 [43880]: https://github.com/rust-lang/rust/pull/43880
1152 [43911]: https://github.com/rust-lang/rust/pull/43911
1153 [43916]: https://github.com/rust-lang/rust/pull/43916
1154 [43917]: https://github.com/rust-lang/rust/pull/43917
1155 [44204]: https://github.com/rust-lang/rust/pull/44204
1156 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1157 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1158 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1159 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1160 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1161 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1162 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1163 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1164 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1165
1166 Version 1.20.0 (2017-08-31)
1167 ===========================
1168
1169 Language
1170 --------
1171 - [Associated constants are now stabilised.][42809]
1172 - [A lot of macro bugs are now fixed.][42913]
1173
1174 Compiler
1175 --------
1176
1177 - [Struct fields are now properly coerced to the expected field type.][42807]
1178 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1179   `wasm32-experimental-emscripten` target.
1180 - [Changed some of the error messages to be more helpful.][42033]
1181 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1182   it.][43170]
1183 - [rustc now reports the total number of errors on compilation failure][43015]
1184   previously this was only the number of errors in the pass that failed.
1185 - [Expansion in rustc has been sped up 29x.][42533]
1186 - [added `msp430-none-elf` target.][43099]
1187 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1188   applicable][43178]
1189 - [Fixes backtraces on Redox][43228]
1190 - [rustc now identifies different versions of same crate when absolute paths of
1191   different types match in an error message.][42826]
1192
1193 Libraries
1194 ---------
1195
1196
1197 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1198 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1199   tuples.][43011]
1200 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1201   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1202 - [Impl `Clone` for `DefaultHasher`.][42799]
1203 - [Impl `Sync` for `SyncSender`.][42397]
1204 - [Impl `FromStr` for `char`][42271]
1205 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1206   NaN.][42431]
1207 - [allow messages in the `unimplemented!()` macro.][42155]
1208   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1209 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1210 - [Upgrade to Unicode 10.0.0][42999]
1211 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1212 - [Skip the main thread's manual stack guard on Linux][43072]
1213 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1214 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1215   previously 2^15.
1216 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1217
1218 Stabilized APIs
1219 ---------------
1220
1221 - [`CStr::into_c_string`]
1222 - [`CString::as_c_str`]
1223 - [`CString::into_boxed_c_str`]
1224 - [`Chain::get_mut`]
1225 - [`Chain::get_ref`]
1226 - [`Chain::into_inner`]
1227 - [`Option::get_or_insert_with`]
1228 - [`Option::get_or_insert`]
1229 - [`OsStr::into_os_string`]
1230 - [`OsString::into_boxed_os_str`]
1231 - [`Take::get_mut`]
1232 - [`Take::get_ref`]
1233 - [`Utf8Error::error_len`]
1234 - [`char::EscapeDebug`]
1235 - [`char::escape_debug`]
1236 - [`compile_error!`]
1237 - [`f32::from_bits`]
1238 - [`f32::to_bits`]
1239 - [`f64::from_bits`]
1240 - [`f64::to_bits`]
1241 - [`mem::ManuallyDrop`]
1242 - [`slice::sort_unstable_by_key`]
1243 - [`slice::sort_unstable_by`]
1244 - [`slice::sort_unstable`]
1245 - [`str::from_boxed_utf8_unchecked`]
1246 - [`str::as_bytes_mut`]
1247 - [`str::as_bytes_mut`]
1248 - [`str::from_utf8_mut`]
1249 - [`str::from_utf8_unchecked_mut`]
1250 - [`str::get_mut`]
1251 - [`str::get_unchecked_mut`]
1252 - [`str::get_unchecked`]
1253 - [`str::get`]
1254 - [`str::into_boxed_bytes`]
1255
1256
1257 Cargo
1258 -----
1259 - [Cargo API token location moved from `~/.cargo/config` to
1260   `~/.cargo/credentials`.][cargo/3978]
1261 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1262   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1263   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1264 - [You can now specify version of a binary when installed through
1265   `cargo install` using `--vers`.][cargo/4229]
1266 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1267   failure.][cargo/4248]
1268 - [Changed the convention around which file is the crate root.][cargo/4259]
1269 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1270   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1271
1272 Compatibility Notes
1273 -------------------
1274
1275 - [Functions with `'static` in their return types will now not be as usable as
1276   if they were using lifetime parameters instead.][42417]
1277 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1278   takes the sign of NaN into account where previously didn't.][42430]
1279
1280 [42033]: https://github.com/rust-lang/rust/pull/42033
1281 [42155]: https://github.com/rust-lang/rust/pull/42155
1282 [42271]: https://github.com/rust-lang/rust/pull/42271
1283 [42397]: https://github.com/rust-lang/rust/pull/42397
1284 [42417]: https://github.com/rust-lang/rust/pull/42417
1285 [42430]: https://github.com/rust-lang/rust/pull/42430
1286 [42431]: https://github.com/rust-lang/rust/pull/42431
1287 [42533]: https://github.com/rust-lang/rust/pull/42533
1288 [42571]: https://github.com/rust-lang/rust/pull/42571
1289 [42613]: https://github.com/rust-lang/rust/pull/42613
1290 [42799]: https://github.com/rust-lang/rust/pull/42799
1291 [42807]: https://github.com/rust-lang/rust/pull/42807
1292 [42809]: https://github.com/rust-lang/rust/pull/42809
1293 [42822]: https://github.com/rust-lang/rust/pull/42822
1294 [42826]: https://github.com/rust-lang/rust/pull/42826
1295 [42854]: https://github.com/rust-lang/rust/pull/42854
1296 [42913]: https://github.com/rust-lang/rust/pull/42913
1297 [42999]: https://github.com/rust-lang/rust/pull/42999
1298 [43011]: https://github.com/rust-lang/rust/pull/43011
1299 [43015]: https://github.com/rust-lang/rust/pull/43015
1300 [43072]: https://github.com/rust-lang/rust/pull/43072
1301 [43077]: https://github.com/rust-lang/rust/pull/43077
1302 [43097]: https://github.com/rust-lang/rust/pull/43097
1303 [43099]: https://github.com/rust-lang/rust/pull/43099
1304 [43170]: https://github.com/rust-lang/rust/pull/43170
1305 [43178]: https://github.com/rust-lang/rust/pull/43178
1306 [43185]: https://github.com/rust-lang/rust/pull/43185
1307 [43228]: https://github.com/rust-lang/rust/pull/43228
1308 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1309 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1310 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1311 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1312 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1313 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1314 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1315 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1316 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1317 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1318 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1319 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1320 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1321 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1322 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1323 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1324 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1325 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1326 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1327 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1328 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1329 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1330 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
1331 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
1332 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
1333 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
1334 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
1335 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
1336 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
1337 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
1338 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
1339 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
1340 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
1341 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
1342 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
1343 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
1344 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
1345 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
1346 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
1347
1348
1349 Version 1.19.0 (2017-07-20)
1350 ===========================
1351
1352 Language
1353 --------
1354
1355 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
1356   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
1357 - [Macro recursion limit increased to 1024 from 64.][41676]
1358 - [Added lint for detecting unused macros.][41907]
1359 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
1360   For example: `let x = loop { break 7; };`
1361 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
1362   contain `Copy` types and cannot have a `Drop` implementation.
1363   Example: `union Foo { bar: u8, baz: usize }`
1364 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
1365   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
1366
1367 Compiler
1368 --------
1369
1370 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
1371 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
1372   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
1373   you should use `--target armv7-linux-androideabi`.
1374 - [Fixed ICE when removing a source file between compilation sessions.][41873]
1375 - [Minor optimisation of string operations.][42037]
1376 - [Compiler error message is now `aborting due to previous error(s)` instead of
1377   `aborting due to N previous errors`][42150] This was previously inaccurate and
1378   would only count certain kinds of errors.
1379 - [The compiler now supports Visual Studio 2017][42225]
1380 - [The compiler is now built against LLVM 4.0.1 by default][42948]
1381 - [Added a lot][42264] of [new error codes][42302]
1382 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
1383   libraries with C Run-time Libraries(CRT) to be statically linked.
1384 - [Fixed various ARM codegen bugs][42740]
1385
1386 Libraries
1387 ---------
1388
1389 - [`String` now implements `FromIterator<Cow<'a, str>>` and
1390   `Extend<Cow<'a, str>>`][41449]
1391 - [`Vec` now implements `From<&mut [T]>`][41530]
1392 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
1393 - [`SplitWhitespace` now implements `Clone`][41659]
1394 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
1395   1.5x faster][41764]
1396 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
1397   macros, but for printing to stderr.
1398
1399 Stabilized APIs
1400 ---------------
1401
1402 - [`OsString::shrink_to_fit`]
1403 - [`cmp::Reverse`]
1404 - [`Command::envs`]
1405 - [`thread::ThreadId`]
1406
1407 Cargo
1408 -----
1409
1410 - [Build scripts can now add environment variables to the environment
1411   the crate is being compiled in.
1412   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
1413 - [Subcommands now replace the current process rather than spawning a new
1414   child process][cargo/3970]
1415 - [Workspace members can now accept glob file patterns][cargo/3979]
1416 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
1417   the members in a given workspace.][cargo/3988]
1418 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
1419 - [Target directory path is now in the cargo metadata][cargo/4022]
1420 - [Cargo no longer checks out a local working directory for the
1421   crates.io index][cargo/4026] This should provide smaller file size for the
1422   registry, and improve cloning times, especially on Windows machines.
1423 - [Added an `--exclude` option for excluding certain packages when using the
1424   `--all` option][cargo/4031]
1425 - [Cargo will now automatically retry when receiving a 5xx error
1426   from crates.io][cargo/4032]
1427 - [The `--features` option now accepts multiple comma or space
1428   delimited values.][cargo/4084]
1429 - [Added support for custom target specific runners][cargo/3954]
1430
1431 Misc
1432 ----
1433
1434 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
1435   Windows Debugger.
1436 - [Rust will now release XZ compressed packages][rust-installer/57]
1437 - [rustup will now prefer to download rust packages with
1438   XZ compression][rustup/1100] over GZip packages.
1439 - [Added the ability to escape `#` in rust documentation][41785] By adding
1440   additional `#`'s ie. `##` is now `#`
1441
1442 Compatibility Notes
1443 -------------------
1444
1445 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
1446 - [`-Z` flags are now no longer allowed to be used on the stable
1447   compiler.][41751] This has been a warning for a year previous to this.
1448 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
1449   longer works][42844]. Users should migrate to the built-in `check`
1450   command, which has been available since 1.16.
1451 - [Ending a float literal with `._` is now a hard error.
1452   Example: `42._` .][41946]
1453 - [Any use of a private `extern crate` outside of its module is now a
1454   hard error.][36886] This was previously a warning.
1455 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
1456   relative while the `::` prefix makes a path absolute, but was ignored and the
1457   path was relative regardless.
1458 - [Floating point constants in match patterns is now a hard error][36890]
1459   This was previously a warning.
1460 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
1461   match patterns is now a hard error][36891] This was previously a warning.
1462 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
1463   a warning.
1464 - [From the pound escape, lines consisting of multiple `#`s are
1465   now visible][41785]
1466 - [It is an error to re-export private enum variants][42460]. This is
1467   known to break a number of crates that depend on an older version of
1468   mustache.
1469 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
1470   to use it to find the linker, and the build will fail where it did
1471   not previously][42607]
1472
1473 [36886]: https://github.com/rust-lang/rust/issues/36886
1474 [36888]: https://github.com/rust-lang/rust/issues/36888
1475 [36890]: https://github.com/rust-lang/rust/issues/36890
1476 [36891]: https://github.com/rust-lang/rust/issues/36891
1477 [36892]: https://github.com/rust-lang/rust/issues/36892
1478 [37406]: https://github.com/rust-lang/rust/issues/37406
1479 [39983]: https://github.com/rust-lang/rust/pull/39983
1480 [41145]: https://github.com/rust-lang/rust/pull/41145
1481 [41192]: https://github.com/rust-lang/rust/pull/41192
1482 [41258]: https://github.com/rust-lang/rust/pull/41258
1483 [41370]: https://github.com/rust-lang/rust/pull/41370
1484 [41449]: https://github.com/rust-lang/rust/pull/41449
1485 [41530]: https://github.com/rust-lang/rust/pull/41530
1486 [41624]: https://github.com/rust-lang/rust/pull/41624
1487 [41656]: https://github.com/rust-lang/rust/pull/41656
1488 [41659]: https://github.com/rust-lang/rust/pull/41659
1489 [41676]: https://github.com/rust-lang/rust/pull/41676
1490 [41751]: https://github.com/rust-lang/rust/pull/41751
1491 [41764]: https://github.com/rust-lang/rust/pull/41764
1492 [41785]: https://github.com/rust-lang/rust/pull/41785
1493 [41873]: https://github.com/rust-lang/rust/pull/41873
1494 [41907]: https://github.com/rust-lang/rust/pull/41907
1495 [41946]: https://github.com/rust-lang/rust/pull/41946
1496 [42016]: https://github.com/rust-lang/rust/pull/42016
1497 [42037]: https://github.com/rust-lang/rust/pull/42037
1498 [42068]: https://github.com/rust-lang/rust/pull/42068
1499 [42150]: https://github.com/rust-lang/rust/pull/42150
1500 [42162]: https://github.com/rust-lang/rust/pull/42162
1501 [42225]: https://github.com/rust-lang/rust/pull/42225
1502 [42264]: https://github.com/rust-lang/rust/pull/42264
1503 [42302]: https://github.com/rust-lang/rust/pull/42302
1504 [42460]: https://github.com/rust-lang/rust/issues/42460
1505 [42607]: https://github.com/rust-lang/rust/issues/42607
1506 [42740]: https://github.com/rust-lang/rust/pull/42740
1507 [42844]: https://github.com/rust-lang/rust/issues/42844
1508 [42948]: https://github.com/rust-lang/rust/pull/42948
1509 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
1510 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
1511 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
1512 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
1513 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
1514 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
1515 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
1516 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
1517 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
1518 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
1519 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
1520 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
1521 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
1522 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
1523 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
1524 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
1525 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
1526 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
1527 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
1528 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
1529 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
1530 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
1531
1532
1533 Version 1.18.0 (2017-06-08)
1534 ===========================
1535
1536 Language
1537 --------
1538
1539 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
1540   make the item visible to just that module tree. Also accepts the keyword
1541   `crate` to make something public to the whole crate but not users of the
1542   library. Example: `pub(crate) mod utils;`. [RFC 1422].
1543 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
1544   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
1545 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
1546   types like `Write + Send`, trailing `+` are now supported in trait objects,
1547   and better error reporting for trait objects starting with `?Sized`.
1548 - [0e+10 is now a valid floating point literal][40589]
1549 - [Now warns if you bind a lifetime parameter to 'static][40734]
1550 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
1551   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
1552   representation in some cases.][40377]
1553
1554 Compiler
1555 --------
1556
1557 - [rustc can now emit mir with `--emit mir`][39891]
1558 - [Improved LLVM IR for trivial functions][40367]
1559 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
1560 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
1561   opportunities found through profiling
1562 - [Improved backtrace formatting when panicking][38165]
1563
1564 Libraries
1565 ---------
1566
1567 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
1568   iterator hasn't been advanced the original `Vec` is reassembled with no actual
1569   iteration or reallocation.
1570 - [Simplified HashMap Bucket interface][40561] provides performance
1571   improvements for iterating and cloning.
1572 - [Specialize Vec::from_elem to use calloc][40409]
1573 - [Fixed Race condition in fs::create_dir_all][39799]
1574 - [No longer caching stdio on Windows][40516]
1575 - [Optimized insertion sort in slice][40807] insertion sort in some cases
1576   2.50%~ faster and in one case now 12.50% faster.
1577 - [Optimized `AtomicBool::fetch_nand`][41143]
1578
1579 Stabilized APIs
1580 ---------------
1581
1582 - [`Child::try_wait`]
1583 - [`HashMap::retain`]
1584 - [`HashSet::retain`]
1585 - [`PeekMut::pop`]
1586 - [`TcpStream::peek`]
1587 - [`UdpSocket::peek`]
1588 - [`UdpSocket::peek_from`]
1589
1590 Cargo
1591 -----
1592
1593 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
1594   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
1595 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
1596 - [Added Android build support][cargo/3885]
1597 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
1598   of a certain type, for example `cargo build --bins` will build all
1599   binaries.
1600 - [Added support for haiku][cargo/3952]
1601
1602 Misc
1603 ----
1604
1605 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
1606 - [Added rust-windbg script for better debugging on Windows][39983]
1607 - [Rust now uses the official cross compiler for NetBSD][40612]
1608 - [rustdoc now accepts `#` at the start of files][40828]
1609 - [Fixed jemalloc support for musl][41168]
1610
1611 Compatibility Notes
1612 -------------------
1613
1614 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
1615   always placed after the sign if it exists and before the digits. With the `#`
1616   flag the zeroes are placed after the prefix and before the digits.
1617 - [Due to the struct field optimisation][40377], using `transmute` on structs
1618   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
1619   always been undefined behavior, but is now more likely to break in practice.
1620 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
1621   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
1622   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
1623 - [Overlapping inherent `impl`s are now a hard error][40728]
1624 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
1625 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
1626   `out.asm` and `out.ll` instead of only one of the filetypes.
1627 - [ calling a function that returns `Self` will no longer work][41805] when
1628   the size of `Self` cannot be statically determined.
1629 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
1630   this has caused a few regressions namely:
1631
1632   - Changed the link order of local static/dynamic libraries (respecting the
1633     order on given rather than having the compiler reorder).
1634   - Changed how MinGW is linked, native code linked to dynamic libraries
1635     may require manually linking to the gcc support library (for the native
1636     code itself)
1637
1638 [38165]: https://github.com/rust-lang/rust/pull/38165
1639 [39799]: https://github.com/rust-lang/rust/pull/39799
1640 [39891]: https://github.com/rust-lang/rust/pull/39891
1641 [39983]: https://github.com/rust-lang/rust/pull/39983
1642 [40043]: https://github.com/rust-lang/rust/pull/40043
1643 [40241]: https://github.com/rust-lang/rust/pull/40241
1644 [40338]: https://github.com/rust-lang/rust/pull/40338
1645 [40367]: https://github.com/rust-lang/rust/pull/40367
1646 [40377]: https://github.com/rust-lang/rust/pull/40377
1647 [40409]: https://github.com/rust-lang/rust/pull/40409
1648 [40516]: https://github.com/rust-lang/rust/pull/40516
1649 [40556]: https://github.com/rust-lang/rust/pull/40556
1650 [40561]: https://github.com/rust-lang/rust/pull/40561
1651 [40589]: https://github.com/rust-lang/rust/pull/40589
1652 [40612]: https://github.com/rust-lang/rust/pull/40612
1653 [40723]: https://github.com/rust-lang/rust/pull/40723
1654 [40728]: https://github.com/rust-lang/rust/pull/40728
1655 [40731]: https://github.com/rust-lang/rust/pull/40731
1656 [40734]: https://github.com/rust-lang/rust/pull/40734
1657 [40805]: https://github.com/rust-lang/rust/pull/40805
1658 [40807]: https://github.com/rust-lang/rust/pull/40807
1659 [40828]: https://github.com/rust-lang/rust/pull/40828
1660 [40870]: https://github.com/rust-lang/rust/pull/40870
1661 [41085]: https://github.com/rust-lang/rust/pull/41085
1662 [41143]: https://github.com/rust-lang/rust/pull/41143
1663 [41168]: https://github.com/rust-lang/rust/pull/41168
1664 [41270]: https://github.com/rust-lang/rust/issues/41270
1665 [41469]: https://github.com/rust-lang/rust/pull/41469
1666 [41805]: https://github.com/rust-lang/rust/issues/41805
1667 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
1668 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
1669 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
1670 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
1671 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
1672 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
1673 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
1674 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
1675 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
1676 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
1677 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
1678 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
1679 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
1680 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
1681
1682
1683 Version 1.17.0 (2017-04-27)
1684 ===========================
1685
1686 Language
1687 --------
1688
1689 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
1690 * [Fields of structs may be initialized without duplicating the field/variable
1691   names][39761]. [RFC 1682]
1692 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
1693 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1694   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
1695   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
1696   `'b`. Soundness fix.
1697 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
1698 * [Static variables may contain references to other statics][40027]
1699
1700 Compiler
1701 --------
1702
1703 * [Exit quickly on only `--emit dep-info`][40336]
1704 * [Make `-C relocation-model` more correctly determine whether the linker
1705   creates a position-independent executable][40245]
1706 * [Add `-C overflow-checks` to directly control whether integer overflow
1707   panics][40037]
1708 * [The rustc type checker now checks items on demand instead of in a single
1709   in-order pass][40008]. This is mostly an internal refactoring in support of
1710   future work, including incremental type checking, but also resolves [RFC
1711   1647], allowing `Self` to appear in `impl` `where` clauses.
1712 * [Optimize vtable loads][39995]
1713 * [Turn off vectorization for Emscripten targets][39990]
1714 * [Provide suggestions for unknown macros imported with `use`][39953]
1715 * [Fix ICEs in path resolution][39939]
1716 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
1717 * [Add clearer error message using `&str + &str`][39116]
1718
1719 Stabilized APIs
1720 ---------------
1721
1722 * [`Arc::into_raw`]
1723 * [`Arc::from_raw`]
1724 * [`Arc::ptr_eq`]
1725 * [`Rc::into_raw`]
1726 * [`Rc::from_raw`]
1727 * [`Rc::ptr_eq`]
1728 * [`Ordering::then`]
1729 * [`Ordering::then_with`]
1730 * [`BTreeMap::range`]
1731 * [`BTreeMap::range_mut`]
1732 * [`collections::Bound`]
1733 * [`process::abort`]
1734 * [`ptr::read_unaligned`]
1735 * [`ptr::write_unaligned`]
1736 * [`Result::expect_err`]
1737 * [`Cell::swap`]
1738 * [`Cell::replace`]
1739 * [`Cell::into_inner`]
1740 * [`Cell::take`]
1741
1742 Libraries
1743 ---------
1744
1745 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
1746 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
1747 * [`String` implements `FromIterator<&char>`][40028]
1748 * `Box` [implements][40009] a number of new conversions:
1749   `From<Box<str>> for String`,
1750   `From<Box<[T]>> for Vec<T>`,
1751   `From<Box<CStr>> for CString`,
1752   `From<Box<OsStr>> for OsString`,
1753   `From<Box<Path>> for PathBuf`,
1754   `Into<Box<str>> for String`,
1755   `Into<Box<[T]>> for Vec<T>`,
1756   `Into<Box<CStr>> for CString`,
1757   `Into<Box<OsStr>> for OsString`,
1758   `Into<Box<Path>> for PathBuf`,
1759   `Default for Box<str>`,
1760   `Default for Box<CStr>`,
1761   `Default for Box<OsStr>`,
1762   `From<&CStr> for Box<CStr>`,
1763   `From<&OsStr> for Box<OsStr>`,
1764   `From<&Path> for Box<Path>`
1765 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
1766 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
1767 * [Slightly optimize `slice::sort`][39538]
1768 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
1769 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
1770   `Box<str>` implements `From<&str>`][39438]
1771 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
1772   `From<(I, u16)> where I: Into<IpAddr>`][39372]
1773 * [`format!` estimates the needed capacity before writing a string][39356]
1774 * [Support unprivileged symlink creation in Windows][38921]
1775 * [`PathBuf` implements `Default`][38764]
1776 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
1777 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
1778   and poor hash functions.
1779
1780 Cargo
1781 -----
1782
1783 * [Add `cargo check --all`][cargo/3731]
1784 * [Add an option to ignore SSL revocation checking][cargo/3699]
1785 * [Add `cargo run --package`][cargo/3691]
1786 * [Add `required_features`][cargo/3667]
1787 * [Assume `build.rs` is a build script][cargo/3664]
1788 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
1789
1790 Misc
1791 ----
1792
1793 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
1794   `rustbook`][39633]
1795 * [The "Unstable Book" documents nightly-only features][ubook]
1796 * [Improve the style of the sidebar in rustdoc output][40265]
1797 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
1798 * [Fix MSP430 breakage due to `i128`][40257]
1799 * [Preliminary Solaris/SPARCv9 support][39903]
1800 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
1801   run without installing the MSVC runtime.
1802 * [`rustdoc --test` includes file names in test names][39788]
1803 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
1804   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
1805 * [Initial support for `aarch64-unknown-freebsd`][39491]
1806 * [Initial support for `i686-unknown-netbsd`][39426]
1807 * [This release no longer includes the old makefile build system][39431]. Rust
1808   is built with a custom build system, written in Rust, and with Cargo.
1809 * [Add Debug implementations for libcollection structs][39002]
1810 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
1811 * [`--test-threads=0` produces an error][38945]
1812 * [`rustup` installs documentation by default][40526]
1813 * [The Rust source includes NatVis visualizations][39843]. These can be used by
1814   WinDbg and Visual Studio to improve the debugging experience.
1815
1816 Compatibility Notes
1817 -------------------
1818
1819 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
1820   workaround, either use MSVC 2015 or run vcvars.bat.
1821 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1822   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
1823   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
1824   fix.
1825 * [`format!` and `Display::to_string` panic if an underlying formatting
1826   implementation returns an error][40117]. Previously the error was silently
1827   ignored. It is incorrect for `write_fmt` to return an error when writing
1828   to a string.
1829 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
1830   crates were marked stable and could be accessed from the stable toolchain.
1831 * [Rust git source no longer includes vendored crates][39728]. Those that need
1832   to build with vendored crates should build from release tarballs.
1833 * [Fix inert attributes from `proc_macro_derives`][39572]
1834 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
1835   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
1836   build system.
1837 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
1838   existing code generally ignores the type of dead-code unless a type-hint is
1839   provided; this can cause surprising inference interactions particularly around
1840   defaulting. The new code uniformly ignores the result type of dead-code.
1841 * [Tuple-struct constructors with private fields are no longer visible][38932]
1842 * [Lifetime parameters that do not appear in the arguments are now considered
1843   early-bound][38897], resolving a soundness bug (#[32330]). The
1844   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
1845   April of 2016.
1846 * [rustdoc: fix doctests with non-feature crate attributes][38161]
1847 * [Make transmuting from fn item types to pointer-sized types a hard
1848   error][34198]
1849
1850 [27787]: https://github.com/rust-lang/rust/issues/27787
1851 [32330]: https://github.com/rust-lang/rust/issues/32330
1852 [34198]: https://github.com/rust-lang/rust/pull/34198
1853 [38161]: https://github.com/rust-lang/rust/pull/38161
1854 [38368]: https://github.com/rust-lang/rust/pull/38368
1855 [38584]: https://github.com/rust-lang/rust/issues/38584
1856 [38661]: https://github.com/rust-lang/rust/pull/38661
1857 [38764]: https://github.com/rust-lang/rust/pull/38764
1858 [38864]: https://github.com/rust-lang/rust/issues/38864
1859 [38897]: https://github.com/rust-lang/rust/pull/38897
1860 [38921]: https://github.com/rust-lang/rust/pull/38921
1861 [38932]: https://github.com/rust-lang/rust/pull/38932
1862 [38945]: https://github.com/rust-lang/rust/pull/38945
1863 [38981]: https://github.com/rust-lang/rust/pull/38981
1864 [39002]: https://github.com/rust-lang/rust/pull/39002
1865 [39116]: https://github.com/rust-lang/rust/pull/39116
1866 [39193]: https://github.com/rust-lang/rust/pull/39193
1867 [39265]: https://github.com/rust-lang/rust/pull/39265
1868 [39356]: https://github.com/rust-lang/rust/pull/39356
1869 [39372]: https://github.com/rust-lang/rust/pull/39372
1870 [39426]: https://github.com/rust-lang/rust/pull/39426
1871 [39431]: https://github.com/rust-lang/rust/pull/39431
1872 [39438]: https://github.com/rust-lang/rust/pull/39438
1873 [39440]: https://github.com/rust-lang/rust/pull/39440
1874 [39485]: https://github.com/rust-lang/rust/pull/39485
1875 [39491]: https://github.com/rust-lang/rust/pull/39491
1876 [39518]: https://github.com/rust-lang/rust/pull/39518
1877 [39538]: https://github.com/rust-lang/rust/pull/39538
1878 [39572]: https://github.com/rust-lang/rust/pull/39572
1879 [39633]: https://github.com/rust-lang/rust/pull/39633
1880 [39642]: https://github.com/rust-lang/rust/pull/39642
1881 [39728]: https://github.com/rust-lang/rust/pull/39728
1882 [39761]: https://github.com/rust-lang/rust/pull/39761
1883 [39788]: https://github.com/rust-lang/rust/pull/39788
1884 [39793]: https://github.com/rust-lang/rust/pull/39793
1885 [39837]: https://github.com/rust-lang/rust/pull/39837
1886 [39843]: https://github.com/rust-lang/rust/pull/39843
1887 [39851]: https://github.com/rust-lang/rust/pull/39851
1888 [39903]: https://github.com/rust-lang/rust/pull/39903
1889 [39939]: https://github.com/rust-lang/rust/pull/39939
1890 [39953]: https://github.com/rust-lang/rust/pull/39953
1891 [39960]: https://github.com/rust-lang/rust/pull/39960
1892 [39990]: https://github.com/rust-lang/rust/pull/39990
1893 [39995]: https://github.com/rust-lang/rust/pull/39995
1894 [40008]: https://github.com/rust-lang/rust/pull/40008
1895 [40009]: https://github.com/rust-lang/rust/pull/40009
1896 [40027]: https://github.com/rust-lang/rust/pull/40027
1897 [40028]: https://github.com/rust-lang/rust/pull/40028
1898 [40037]: https://github.com/rust-lang/rust/pull/40037
1899 [40117]: https://github.com/rust-lang/rust/pull/40117
1900 [40166]: https://github.com/rust-lang/rust/pull/40166
1901 [40245]: https://github.com/rust-lang/rust/pull/40245
1902 [40257]: https://github.com/rust-lang/rust/pull/40257
1903 [40261]: https://github.com/rust-lang/rust/pull/40261
1904 [40265]: https://github.com/rust-lang/rust/pull/40265
1905 [40319]: https://github.com/rust-lang/rust/pull/40319
1906 [40336]: https://github.com/rust-lang/rust/pull/40336
1907 [40526]: https://github.com/rust-lang/rust/pull/40526
1908 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
1909 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
1910 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
1911 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
1912 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
1913 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
1914 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
1915 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
1916 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
1917 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
1918 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
1919 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
1920 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
1921 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
1922 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1923 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
1924 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
1925 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
1926 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
1927 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
1928 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
1929 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
1930 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
1931 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
1932 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
1933 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
1934 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
1935 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
1936 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
1937 [mdbook]: https://crates.io/crates/mdbook
1938 [ubook]: https://doc.rust-lang.org/unstable-book/
1939
1940
1941 Version 1.16.0 (2017-03-16)
1942 ===========================
1943
1944 Language
1945 --------
1946
1947 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
1948 * [Uninhabitable enums (those without any variants) no longer permit wildcard
1949   match patterns][38069]
1950 * [Clean up semantics of `self` in an import list][38313]
1951 * [`Self` may appear in `impl` headers][38920]
1952 * [`Self` may appear in struct expressions][39282]
1953
1954 Compiler
1955 --------
1956
1957 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
1958   a `.rmeta` file containing only crate metadata][38571]. This can be
1959   used by tools like the Rust Language Service to perform
1960   metadata-only builds.
1961 * [Levenshtein based typo suggestions now work in most places, while
1962   previously they worked only for fields and sometimes for local
1963   variables][38927]. Together with the overhaul of "no
1964   resolution"/"unexpected resolution" errors (#[38154]) they result in
1965   large and systematic improvement in resolution diagnostics.
1966 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
1967   `U`][38670]
1968 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
1969 * [`rustc` no longer attempts to provide "consider using an explicit
1970   lifetime" suggestions][37057]. They were inaccurate.
1971
1972 Stabilized APIs
1973 ---------------
1974
1975 * [`VecDeque::truncate`]
1976 * [`VecDeque::resize`]
1977 * [`String::insert_str`]
1978 * [`Duration::checked_add`]
1979 * [`Duration::checked_sub`]
1980 * [`Duration::checked_div`]
1981 * [`Duration::checked_mul`]
1982 * [`str::replacen`]
1983 * [`str::repeat`]
1984 * [`SocketAddr::is_ipv4`]
1985 * [`SocketAddr::is_ipv6`]
1986 * [`IpAddr::is_ipv4`]
1987 * [`IpAddr::is_ipv6`]
1988 * [`Vec::dedup_by`]
1989 * [`Vec::dedup_by_key`]
1990 * [`Result::unwrap_or_default`]
1991 * [`<*const T>::wrapping_offset`]
1992 * [`<*mut T>::wrapping_offset`]
1993 * `CommandExt::creation_flags`
1994 * [`File::set_permissions`]
1995 * [`String::split_off`]
1996
1997 Libraries
1998 ---------
1999
2000 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2001   their argument by `Borrow` parameter][37761]
2002 * [All public types in std implement `Debug`][38006]
2003 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2004 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2005 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2006   Windows][38274]
2007 * [std: Fix partial writes in `LineWriter`][38062]
2008 * [std: Clamp max read/write sizes on Unix][38062]
2009 * [Use more specific panic message for `&str` slicing errors][38066]
2010 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2011   functionality cannot be achieved in std currently.
2012 * [`writeln!`, like `println!`, now accepts a form with no string
2013   or formatting arguments, to just print a newline][38469]
2014 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2015 * [Reduce the size of static data in `std_unicode::tables`][38781]
2016 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2017   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2018   `Display`][38909]
2019 * [`Duration` implements `Sum`][38712]
2020 * [`String` implements `ToSocketAddrs`][39048]
2021
2022 Cargo
2023 -----
2024
2025 * [The `cargo check` command does a type check of a project without
2026   building it][cargo/3296]
2027 * [crates.io will display CI badges from Travis and AppVeyor, if
2028   specified in Cargo.toml][cargo/3546]
2029 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2030 * [Compilation profiles accept integer values for `debug`, in addition
2031   to `true` and `false`. These are passed to `rustc` as the value to
2032   `-C debuginfo`][cargo/3534]
2033 * [Implement `cargo --version --verbose`][cargo/3604]
2034 * [All builds now output 'dep-info' build dependencies compatible with
2035   make and ninja][cargo/3557]
2036 * [Build all workspace members with `build --all`][cargo/3511]
2037 * [Document all workspace members with `doc --all`][cargo/3515]
2038 * [Path deps outside workspace are not members][cargo/3443]
2039
2040 Misc
2041 ----
2042
2043 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2044   the path to the Rust implementation][38589]
2045 * [The `armv7-linux-androideabi` target no longer enables NEON
2046   extensions, per Google's ABI guide][38413]
2047 * [The stock standard library can be compiled for Redox OS][38401]
2048 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2049   available.
2050 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2051   builds available.
2052 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2053
2054 Compatibility Notes
2055 -------------------
2056
2057 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2058   match patterns][38069]
2059 * In this release, references to uninhabited types can not be
2060   pattern-matched. This was accidentally allowed in 1.15.
2061 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2062 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2063   Windows][38274]
2064 * [Clean up semantics of `self` in an import list][38313]
2065 * Reimplemented lifetime elision. This change was almost entirely compatible
2066   with existing code, but it did close a number of small bugs and loopholes,
2067   as well as being more accepting in some other [cases][41105].
2068
2069 [37057]: https://github.com/rust-lang/rust/pull/37057
2070 [37761]: https://github.com/rust-lang/rust/pull/37761
2071 [38006]: https://github.com/rust-lang/rust/pull/38006
2072 [38051]: https://github.com/rust-lang/rust/pull/38051
2073 [38062]: https://github.com/rust-lang/rust/pull/38062
2074 [38062]: https://github.com/rust-lang/rust/pull/38622
2075 [38066]: https://github.com/rust-lang/rust/pull/38066
2076 [38069]: https://github.com/rust-lang/rust/pull/38069
2077 [38131]: https://github.com/rust-lang/rust/pull/38131
2078 [38154]: https://github.com/rust-lang/rust/pull/38154
2079 [38274]: https://github.com/rust-lang/rust/pull/38274
2080 [38304]: https://github.com/rust-lang/rust/pull/38304
2081 [38313]: https://github.com/rust-lang/rust/pull/38313
2082 [38314]: https://github.com/rust-lang/rust/pull/38314
2083 [38327]: https://github.com/rust-lang/rust/pull/38327
2084 [38401]: https://github.com/rust-lang/rust/pull/38401
2085 [38413]: https://github.com/rust-lang/rust/pull/38413
2086 [38469]: https://github.com/rust-lang/rust/pull/38469
2087 [38559]: https://github.com/rust-lang/rust/pull/38559
2088 [38571]: https://github.com/rust-lang/rust/pull/38571
2089 [38580]: https://github.com/rust-lang/rust/pull/38580
2090 [38589]: https://github.com/rust-lang/rust/pull/38589
2091 [38670]: https://github.com/rust-lang/rust/pull/38670
2092 [38712]: https://github.com/rust-lang/rust/pull/38712
2093 [38726]: https://github.com/rust-lang/rust/pull/38726
2094 [38781]: https://github.com/rust-lang/rust/pull/38781
2095 [38798]: https://github.com/rust-lang/rust/pull/38798
2096 [38909]: https://github.com/rust-lang/rust/pull/38909
2097 [38920]: https://github.com/rust-lang/rust/pull/38920
2098 [38927]: https://github.com/rust-lang/rust/pull/38927
2099 [39048]: https://github.com/rust-lang/rust/pull/39048
2100 [39282]: https://github.com/rust-lang/rust/pull/39282
2101 [39379]: https://github.com/rust-lang/rust/pull/39379
2102 [41105]: https://github.com/rust-lang/rust/issues/41105
2103 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2104 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2105 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2106 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2107 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2108 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2109 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2110 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2111 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2112 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2113 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2114 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2115 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2116 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2117 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2118 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2119 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2120 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2121 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2122 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2123 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2124 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2125 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2126 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2127 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2128 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2129 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2130 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2131 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2132 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2133
2134
2135 Version 1.15.1 (2017-02-09)
2136 ===========================
2137
2138 * [Fix IntoIter::as_mut_slice's signature][39466]
2139 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2140
2141 [39466]: https://github.com/rust-lang/rust/pull/39466
2142 [39523]: https://github.com/rust-lang/rust/pull/39523
2143
2144
2145 Version 1.15.0 (2017-02-02)
2146 ===========================
2147
2148 Language
2149 --------
2150
2151 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2152   stable. This allows popular code-generating crates like Serde and Diesel to
2153   work ergonomically. [RFC 1681].
2154 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2155   with curly braces][36868]. Part of [RFC 1506].
2156 * [A number of minor changes to name resolution have been activated][37127].
2157   They add up to more consistent semantics, allowing for future evolution of
2158   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2159   details of what is different. The breaking changes here have been transitioned
2160   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2161 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2162   bounds][38279]
2163 * [`?Sized` can be used in `where` clauses][37791]
2164 * [There is now a limit on the size of monomorphized types and it can be
2165   modified with the `#![type_size_limit]` crate attribute, similarly to
2166   the `#![recursion_limit]` attribute][37789]
2167
2168 Compiler
2169 --------
2170
2171 * [On Windows, the compiler will apply dllimport attributes when linking to
2172   extern functions][37973]. Additional attributes and flags can control which
2173   library kind is linked and its name. [RFC 1717].
2174 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2175 * [The `--test` flag works with procedural macro crates][38107]
2176 * [Fix `extern "aapcs" fn` ABI][37814]
2177 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2178 * [The `format!` expander recognizes incorrect `printf` and shell-style
2179   formatting directives and suggests the correct format][37613].
2180 * [Only report one error for all unused imports in an import list][37456]
2181
2182 Compiler Performance
2183 --------------------
2184
2185 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2186 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2187 * [Don't clone in `UnificationTable::probe`][37848]
2188 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2189 * [Use small vectors in type walker][37760]
2190 * [Macro expansion performance was improved][37701]
2191 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2192 * [Replace FNV with a faster hash function][37229]
2193
2194 Stabilized APIs
2195 ---------------
2196
2197 * [`std::iter::Iterator::min_by`]
2198 * [`std::iter::Iterator::max_by`]
2199 * [`std::os::*::fs::FileExt`]
2200 * [`std::sync::atomic::Atomic*::get_mut`]
2201 * [`std::sync::atomic::Atomic*::into_inner`]
2202 * [`std::vec::IntoIter::as_slice`]
2203 * [`std::vec::IntoIter::as_mut_slice`]
2204 * [`std::sync::mpsc::Receiver::try_iter`]
2205 * [`std::os::unix::process::CommandExt::before_exec`]
2206 * [`std::rc::Rc::strong_count`]
2207 * [`std::rc::Rc::weak_count`]
2208 * [`std::sync::Arc::strong_count`]
2209 * [`std::sync::Arc::weak_count`]
2210 * [`std::char::encode_utf8`]
2211 * [`std::char::encode_utf16`]
2212 * [`std::cell::Ref::clone`]
2213 * [`std::io::Take::into_inner`]
2214
2215 Libraries
2216 ---------
2217
2218 * [The standard sorting algorithm has been rewritten for dramatic performance
2219   improvements][38192]. It is a hybrid merge sort, drawing influences from
2220   Timsort. Previously it was a naive merge sort.
2221 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2222 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2223   performance.
2224 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2225   and `char_indices().last()`][37882]
2226 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2227 * [Chinese characters display correctly in `fmt::Debug`][37855]
2228 * [Derive `Default` for `Duration`][37699]
2229 * [Support creation of anonymous pipes on WinXP/2k][37677]
2230 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2231 * [Don't pass overlapped handles to processes][38835]
2232
2233 Cargo
2234 -----
2235
2236 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2237   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2238   should instead check the variable at runtime with `std::env`. That the value
2239   was set at build time was a bug, and incorrect when cross-compiling. This
2240   change is known to cause breakage.
2241 * [Add `--all` flag to `cargo test`][cargo/3221]
2242 * [Compile statically against the MSVC CRT][cargo/3363]
2243 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2244 * [Link OpenSSL statically on OSX][cargo/3311]
2245 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2246 * [Test for bad path overrides with summaries][cargo/3336]
2247 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2248 * [Fix retrying crate downloads for network errors][cargo/3348]
2249 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2250 * [Emit more info on --message-format=json][cargo/3319]
2251 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2252 * [Don't ignore errors in workspace manifest][cargo/3409]
2253 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2254
2255 Tooling
2256 -------
2257
2258 * [Test runners (binaries built with `--test`) now support a `--list` argument
2259   that lists the tests it contains][38185]
2260 * [Test runners now support a `--exact` argument that makes the test filter
2261   match exactly, instead of matching only a substring of the test name][38181]
2262 * [rustdoc supports a `--playground-url` flag][37763]
2263 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2264
2265 Misc
2266 ----
2267
2268 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2269   continue to be used in this release by passing `--disable-rustbuild` to the
2270   configure script, but they will be deleted soon. Note that the new build
2271   system uses a different on-disk layout that will likely affect any scripts
2272   building Rust.
2273 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2274   releases.
2275 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2276 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2277   releases.
2278
2279 Compatibility Notes
2280 -------------------
2281
2282 * [A number of minor changes to name resolution have been activated][37127].
2283   They add up to more consistent semantics, allowing for future evolution of
2284   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2285   details of what is different. The breaking changes here have been transitioned
2286   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2287 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2288   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2289   should instead check the variable at runtime with `std::env`. That the value
2290   was set at build time was a bug, and incorrect when cross-compiling. This
2291   change is known to cause breakage.
2292 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2293   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2294   1.10 and is now an error by default. It will become a hard error in the near
2295   future.
2296 * [The semantics relating modules to file system directories are changing in
2297   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2298   lint, which is a warning in this release, and will become a hard error in the
2299   future.
2300 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2301 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2302   the underlying iterator][37834]
2303
2304 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2305 [33685]: https://github.com/rust-lang/rust/issues/33685
2306 [36868]: https://github.com/rust-lang/rust/pull/36868
2307 [37127]: https://github.com/rust-lang/rust/pull/37127
2308 [37229]: https://github.com/rust-lang/rust/pull/37229
2309 [37456]: https://github.com/rust-lang/rust/pull/37456
2310 [37527]: https://github.com/rust-lang/rust/pull/37527
2311 [37602]: https://github.com/rust-lang/rust/pull/37602
2312 [37613]: https://github.com/rust-lang/rust/pull/37613
2313 [37615]: https://github.com/rust-lang/rust/pull/37615
2314 [37636]: https://github.com/rust-lang/rust/pull/37636
2315 [37627]: https://github.com/rust-lang/rust/pull/37627
2316 [37642]: https://github.com/rust-lang/rust/pull/37642
2317 [37677]: https://github.com/rust-lang/rust/pull/37677
2318 [37699]: https://github.com/rust-lang/rust/pull/37699
2319 [37701]: https://github.com/rust-lang/rust/pull/37701
2320 [37705]: https://github.com/rust-lang/rust/pull/37705
2321 [37749]: https://github.com/rust-lang/rust/pull/37749
2322 [37760]: https://github.com/rust-lang/rust/pull/37760
2323 [37763]: https://github.com/rust-lang/rust/pull/37763
2324 [37764]: https://github.com/rust-lang/rust/pull/37764
2325 [37789]: https://github.com/rust-lang/rust/pull/37789
2326 [37791]: https://github.com/rust-lang/rust/pull/37791
2327 [37814]: https://github.com/rust-lang/rust/pull/37814
2328 [37817]: https://github.com/rust-lang/rust/pull/37817
2329 [37834]: https://github.com/rust-lang/rust/pull/37834
2330 [37848]: https://github.com/rust-lang/rust/pull/37848
2331 [37855]: https://github.com/rust-lang/rust/pull/37855
2332 [37882]: https://github.com/rust-lang/rust/pull/37882
2333 [37888]: https://github.com/rust-lang/rust/pull/37888
2334 [37973]: https://github.com/rust-lang/rust/pull/37973
2335 [37979]: https://github.com/rust-lang/rust/pull/37979
2336 [38086]: https://github.com/rust-lang/rust/pull/38086
2337 [38107]: https://github.com/rust-lang/rust/pull/38107
2338 [38117]: https://github.com/rust-lang/rust/pull/38117
2339 [38134]: https://github.com/rust-lang/rust/pull/38134
2340 [38146]: https://github.com/rust-lang/rust/pull/38146
2341 [38181]: https://github.com/rust-lang/rust/pull/38181
2342 [38182]: https://github.com/rust-lang/rust/pull/38182
2343 [38185]: https://github.com/rust-lang/rust/pull/38185
2344 [38192]: https://github.com/rust-lang/rust/pull/38192
2345 [38279]: https://github.com/rust-lang/rust/pull/38279
2346 [38835]: https://github.com/rust-lang/rust/pull/38835
2347 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2348 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2349 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
2350 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
2351 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
2352 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
2353 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
2354 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
2355 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
2356 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
2357 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
2358 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
2359 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
2360 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
2361 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
2362 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
2363 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
2364 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
2365 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
2366 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
2367 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
2368 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
2369 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
2370 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
2371 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
2372 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
2373 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
2374 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
2375 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
2376 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
2377 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
2378 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
2379 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
2380 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
2381 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
2382 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
2383 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
2384 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
2385
2386
2387 Version 1.14.0 (2016-12-22)
2388 ===========================
2389
2390 Language
2391 --------
2392
2393 * [`..` matches multiple tuple fields in enum variants, structs
2394   and tuples][36843]. [RFC 1492].
2395 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
2396 * [`use *` and `use ::*` both glob-import from the crate root][37367]
2397 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
2398   dereferencing][36822]
2399
2400 Compiler
2401 --------
2402
2403 * [Mark enums with non-zero discriminant as non-zero][37224]
2404 * [Lower-case `static mut` names are linted like other
2405   statics and consts][37162]
2406 * [Fix ICE on some macros in const integer positions
2407    (e.g. `[u8; m!()]`)][36819]
2408 * [Improve error message and snippet for "did you mean `x`"][36798]
2409 * [Add a panic-strategy field to the target specification][36794]
2410 * [Include LLVM version in `--version --verbose`][37200]
2411
2412 Compile-time Optimizations
2413 --------------------------
2414
2415 * [Improve macro expansion performance][37569]
2416 * [Shrink `Expr_::ExprInlineAsm`][37445]
2417 * [Replace all uses of SHA-256 with BLAKE2b][37439]
2418 * [Reduce the number of bytes hashed by `IchHasher`][37427]
2419 * [Avoid more allocations when compiling html5ever][37373]
2420 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
2421 * [Avoid some allocations in the macro parser][37318]
2422 * [Use a faster deflate setting][37298]
2423 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
2424   during interning of slices][37270]
2425 * [Optimize `write_metadata`][37267]
2426 * [Don't process obligation forest cycles when stalled][37231]
2427 * [Avoid many `CrateConfig` clones][37161]
2428 * [Optimize `Substs::super_fold_with`][37108]
2429 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
2430 * [Speed up `plug_leaks`][36917]
2431
2432 Libraries
2433 ---------
2434
2435 * [`println!()`, with no arguments, prints newline][36825].
2436   Previously, an empty string was required to achieve the same.
2437 * [`Wrapping` impls standard binary and unary operators, as well as
2438    the `Sum` and `Product` iterators][37356]
2439 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
2440   Vec<T>`][37326]
2441 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
2442   `VecDeque` iterators][37315]
2443 * [Improve `SipHasher` performance on small values][37312]
2444 * [Add Iterator trait TrustedLen to enable better FromIterator /
2445   Extend][37306]
2446 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
2447 * [`ReadDir` implements `Debug`][37221]
2448 * [Implement `RefUnwindSafe` for atomic types][37178]
2449 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
2450 * [Avoid allocations in `Decoder::read_str`][37064]
2451 * [`io::Error` implements `From<io::ErrorKind>`][37037]
2452 * [Impl `Debug` for raw pointers to unsized data][36880]
2453 * [Don't reuse `HashMap` random seeds][37470]
2454 * [The internal memory layout of `HashMap` is more cache-friendly, for
2455   significant improvements in some operations][36692]
2456 * [`HashMap` uses less memory on 32-bit architectures][36595]
2457 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
2458
2459 Cargo
2460 -----
2461
2462 * [Expose rustc cfg values to build scripts][cargo/3243]
2463 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
2464 * [Fix passing --features when testing multiple packages][cargo/3280]
2465 * [Use a single profile set per workspace][cargo/3249]
2466 * [Load `replace` sections from lock files][cargo/3220]
2467 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
2468
2469 Tooling
2470 -------
2471
2472 * [rustup is the recommended Rust installation method][1.14rustup]
2473 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
2474   S390x. These are [tier 2] platforms and may have major defects. Follow the
2475   instructions on the website to install, or add the targets to an existing
2476   installation with `rustup target add`. The new target triples are:
2477   - `mips-unknown-linux-gnu`
2478   - `mipsel-unknown-linux-gnu`
2479   - `mips64-unknown-linux-gnuabi64`
2480   - `mips64el-unknown-linux-gnuabi64 `
2481   - `powerpc-unknown-linux-gnu`
2482   - `powerpc64-unknown-linux-gnu`
2483   - `powerpc64le-unknown-linux-gnu`
2484   - `s390x-unknown-linux-gnu `
2485 * This release includes target (std) builds for ARM Linux running MUSL
2486   libc. These are [tier 2] platforms and may have major defects. Add the
2487   following triples to an existing rustup installation with `rustup target add`:
2488   - `arm-unknown-linux-musleabi`
2489   - `arm-unknown-linux-musleabihf`
2490   - `armv7-unknown-linux-musleabihf`
2491 * This release includes [experimental support for WebAssembly][1.14wasm], via
2492   the `wasm32-unknown-emscripten` target. This target is known to have major
2493   defects. Please test, report, and fix.
2494 * rustup no longer installs documentation by default. Run `rustup
2495   component add rust-docs` to install.
2496 * [Fix line stepping in debugger][37310]
2497 * [Enable line number debuginfo in releases][37280]
2498
2499 Misc
2500 ----
2501
2502 * [Disable jemalloc on aarch64/powerpc/mips][37392]
2503 * [Add support for Fuchsia OS][37313]
2504 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
2505
2506 Compatibility Notes
2507 -------------------
2508
2509 * [A number of forward-compatibility lints used by the compiler
2510   to gradually introduce language changes have been converted
2511   to deny by default][36894]:
2512   - ["use of inaccessible extern crate erroneously allowed"][36886]
2513   - ["type parameter default erroneously allowed in invalid location"][36887]
2514   - ["detects super or self keywords at the beginning of global path"][36888]
2515   - ["two overlapping inherent impls define an item with the same name
2516     were erroneously allowed"][36889]
2517   - ["floating-point constants cannot be used in patterns"][36890]
2518   - ["constants of struct or enum type can only be used in a pattern if
2519      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
2520   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
2521 * [Prohibit patterns in trait methods without bodies][37378]
2522 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
2523 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
2524 * [The `$crate` macro variable is accepted in fewer locations][37213]
2525 * [Impls specifying extra region requirements beyond the trait
2526   they implement are rejected][37167]
2527 * [Enums may not be unsized][37111]. Unsized enums are intended to
2528   work but never have. For now they are forbidden.
2529 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
2530
2531 [tier 2]: https://forge.rust-lang.org/platform-support.html
2532 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
2533 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
2534 [36430]: https://github.com/rust-lang/rust/pull/36430
2535 [36595]: https://github.com/rust-lang/rust/pull/36595
2536 [36595]: https://github.com/rust-lang/rust/pull/36595
2537 [36692]: https://github.com/rust-lang/rust/pull/36692
2538 [36767]: https://github.com/rust-lang/rust/pull/36767
2539 [36794]: https://github.com/rust-lang/rust/pull/36794
2540 [36798]: https://github.com/rust-lang/rust/pull/36798
2541 [36819]: https://github.com/rust-lang/rust/pull/36819
2542 [36822]: https://github.com/rust-lang/rust/pull/36822
2543 [36825]: https://github.com/rust-lang/rust/pull/36825
2544 [36843]: https://github.com/rust-lang/rust/pull/36843
2545 [36880]: https://github.com/rust-lang/rust/pull/36880
2546 [36886]: https://github.com/rust-lang/rust/issues/36886
2547 [36887]: https://github.com/rust-lang/rust/issues/36887
2548 [36888]: https://github.com/rust-lang/rust/issues/36888
2549 [36889]: https://github.com/rust-lang/rust/issues/36889
2550 [36890]: https://github.com/rust-lang/rust/issues/36890
2551 [36891]: https://github.com/rust-lang/rust/issues/36891
2552 [36892]: https://github.com/rust-lang/rust/issues/36892
2553 [36894]: https://github.com/rust-lang/rust/pull/36894
2554 [36917]: https://github.com/rust-lang/rust/pull/36917
2555 [36993]: https://github.com/rust-lang/rust/pull/36993
2556 [37037]: https://github.com/rust-lang/rust/pull/37037
2557 [37064]: https://github.com/rust-lang/rust/pull/37064
2558 [37094]: https://github.com/rust-lang/rust/pull/37094
2559 [37108]: https://github.com/rust-lang/rust/pull/37108
2560 [37111]: https://github.com/rust-lang/rust/pull/37111
2561 [37161]: https://github.com/rust-lang/rust/pull/37161
2562 [37162]: https://github.com/rust-lang/rust/pull/37162
2563 [37167]: https://github.com/rust-lang/rust/pull/37167
2564 [37178]: https://github.com/rust-lang/rust/pull/37178
2565 [37200]: https://github.com/rust-lang/rust/pull/37200
2566 [37213]: https://github.com/rust-lang/rust/pull/37213
2567 [37221]: https://github.com/rust-lang/rust/pull/37221
2568 [37224]: https://github.com/rust-lang/rust/pull/37224
2569 [37230]: https://github.com/rust-lang/rust/pull/37230
2570 [37231]: https://github.com/rust-lang/rust/pull/37231
2571 [37247]: https://github.com/rust-lang/rust/pull/37247
2572 [37267]: https://github.com/rust-lang/rust/pull/37267
2573 [37270]: https://github.com/rust-lang/rust/pull/37270
2574 [37273]: https://github.com/rust-lang/rust/pull/37273
2575 [37280]: https://github.com/rust-lang/rust/pull/37280
2576 [37298]: https://github.com/rust-lang/rust/pull/37298
2577 [37306]: https://github.com/rust-lang/rust/pull/37306
2578 [37310]: https://github.com/rust-lang/rust/pull/37310
2579 [37312]: https://github.com/rust-lang/rust/pull/37312
2580 [37313]: https://github.com/rust-lang/rust/pull/37313
2581 [37315]: https://github.com/rust-lang/rust/pull/37315
2582 [37318]: https://github.com/rust-lang/rust/pull/37318
2583 [37322]: https://github.com/rust-lang/rust/pull/37322
2584 [37326]: https://github.com/rust-lang/rust/pull/37326
2585 [37351]: https://github.com/rust-lang/rust/pull/37351
2586 [37356]: https://github.com/rust-lang/rust/pull/37356
2587 [37367]: https://github.com/rust-lang/rust/pull/37367
2588 [37373]: https://github.com/rust-lang/rust/pull/37373
2589 [37378]: https://github.com/rust-lang/rust/pull/37378
2590 [37389]: https://github.com/rust-lang/rust/pull/37389
2591 [37392]: https://github.com/rust-lang/rust/pull/37392
2592 [37427]: https://github.com/rust-lang/rust/pull/37427
2593 [37439]: https://github.com/rust-lang/rust/pull/37439
2594 [37445]: https://github.com/rust-lang/rust/pull/37445
2595 [37470]: https://github.com/rust-lang/rust/pull/37470
2596 [37569]: https://github.com/rust-lang/rust/pull/37569
2597 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2598 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
2599 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
2600 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
2601 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
2602 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
2603 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
2604
2605
2606 Version 1.13.0 (2016-11-10)
2607 ===========================
2608
2609 Language
2610 --------
2611
2612 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
2613   errors, like the `try!` macro, described in [RFC 0243].
2614 * [Stabilize macros in type position][36014]. Described in [RFC 873].
2615 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
2616 * [Fix `#[derive]` for empty tuple structs/variants][35728]
2617 * [Fix lifetime rules for 'if' conditions][36029]
2618 * [Avoid loading and parsing unconfigured non-inline modules][36482]
2619
2620 Compiler
2621 --------
2622
2623 * [Add the `-C link-arg` argument][36574]
2624 * [Remove the old AST-based backend from rustc_trans][35764]
2625 * [Don't enable NEON by default on armv7 Linux][35814]
2626 * [Fix debug line number info for macro expansions][35238]
2627 * [Do not emit "class method" debuginfo for types that are not
2628   DICompositeType][36008]
2629 * [Warn about multiple conflicting #[repr] hints][34623]
2630 * [When sizing DST, don't double-count nested struct prefixes][36351]
2631 * [Default RUST_MIN_STACK to 16MiB for now][36505]
2632 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
2633 * [Reject macros with empty repetitions to avoid infinite loop][36721]
2634 * [Expand macros without recursing to avoid stack overflows][36214]
2635
2636 Diagnostics
2637 -----------
2638
2639 * [Replace macro backtraces with labeled local uses][35702]
2640 * [Improve error message for misplaced doc comments][33922]
2641 * [Buffer unix and lock windows to prevent message interleaving][35975]
2642 * [Update lifetime errors to specifically note temporaries][36171]
2643 * [Special case a few colors for Windows][36178]
2644 * [Suggest `use self` when such an import resolves][36289]
2645 * [Be more specific when type parameter shadows primitive type][36338]
2646 * Many minor improvements
2647
2648 Compile-time Optimizations
2649 --------------------------
2650
2651 * [Compute and cache HIR hashes at beginning][35854]
2652 * [Don't hash types in loan paths][36004]
2653 * [Cache projections in trans][35761]
2654 * [Optimize the parser's last token handling][36527]
2655 * [Only instantiate #[inline] functions in codegen units referencing
2656   them][36524]. This leads to big improvements in cases where crates export
2657   define many inline functions without using them directly.
2658 * [Lazily allocate TypedArena's first chunk][36592]
2659 * [Don't allocate during default HashSet creation][36734]
2660
2661 Stabilized APIs
2662 ---------------
2663
2664 * [`checked_abs`]
2665 * [`wrapping_abs`]
2666 * [`overflowing_abs`]
2667 * [`RefCell::try_borrow`]
2668 * [`RefCell::try_borrow_mut`]
2669
2670 Libraries
2671 ---------
2672
2673 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
2674 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
2675   covariant][35354]
2676 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
2677 * [Implement `Debug` for `std::vec::IntoIter`][35707]
2678 * [`CString`: avoid excessive growth just to 0-terminate][35871]
2679 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
2680 * [Use arc4rand on FreeBSD][35884]
2681 * [memrchr: Correct aligned offset computation][35969]
2682 * [Improve Demangling of Rust Symbols][36059]
2683 * [Use monotonic time in condition variables][35048]
2684 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
2685 * [Implement conversion traits for `char`][35755]
2686 * [Fix illegal instruction caused by overflow in channel cloning][36104]
2687 * [Zero first byte of CString on drop][36264]
2688 * [Inherit overflow checks for sum and product][36372]
2689 * [Add missing Eq implementations][36423]
2690 * [Implement `Debug` for `DirEntry`][36631]
2691 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
2692   `errno`][36754]
2693 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2694 * [Implement more traits for `std::io::ErrorKind`][35911]
2695 * [Optimize BinaryHeap bounds checking][36072]
2696 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
2697   `extend_with_element`][36355]
2698 * [Fix overflow checking in unsigned pow()][34942]
2699
2700 Cargo
2701 -----
2702
2703 * This release includes security fixes to both curl and OpenSSL.
2704 * [Fix transitive doctests when panic=abort][cargo/3021]
2705 * [Add --all-features flag to cargo][cargo/3038]
2706 * [Reject path-based dependencies in `cargo package`][cargo/3060]
2707 * [Don't parse the home directory more than once][cargo/3078]
2708 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
2709 * [Update OpenSSL to 1.0.2j][cargo/3121]
2710 * [Add license and license_file to cargo metadata output][cargo/3110]
2711 * [Make crates-io registry URL optional in config; ignore all changes to
2712   source.crates-io][cargo/3089]
2713 * [Don't download dependencies from other platforms][cargo/3123]
2714 * [Build transitive dev-dependencies when needed][cargo/3125]
2715 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
2716 * [Avoid updating registry when adding existing deps][cargo/3144]
2717 * [Warn about path overrides that won't work][cargo/3136]
2718 * [Use workspaces during `cargo install`][cargo/3146]
2719 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
2720 * [Add --message-format flag][cargo/3000]
2721 * [Pass target environment for rustdoc][cargo/3205]
2722 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
2723 * [Update curl and curl-sys][cargo/3241]
2724 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
2725
2726 Tooling
2727 -------
2728
2729 * [rustdoc: Add the `--sysroot` argument][36586]
2730 * [rustdoc: Fix a couple of issues with the search results][35655]
2731 * [rustdoc: remove the `!` from macro URLs and titles][35234]
2732 * [gdb: Fix pretty-printing special-cased Rust types][35585]
2733 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
2734
2735 Misc
2736 ----
2737
2738 * [Remove unmaintained style guide][35124]
2739 * [Add s390x support][36369]
2740 * [Initial work at Haiku OS support][36727]
2741 * [Add mips-uclibc targets][35734]
2742 * [Crate-ify compiler-rt into compiler-builtins][35021]
2743 * [Add rustc version info (git hash + date) to dist tarball][36213]
2744 * Many documentation improvements
2745
2746 Compatibility Notes
2747 -------------------
2748
2749 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2750 * [Deny (by default) transmuting from fn item types to pointer-sized
2751   types][34923]. Continuing the long transition to zero-sized fn items,
2752   per [RFC 401].
2753 * [Fix `#[derive]` for empty tuple structs/variants][35728].
2754   Part of [RFC 1506].
2755 * [Issue deprecation warnings for safe accesses to extern statics][36173]
2756 * [Fix lifetime rules for 'if' conditions][36029].
2757 * [Inherit overflow checks for sum and product][36372].
2758 * [Forbid user-defined macros named "macro_rules"][36730].
2759
2760 [33922]: https://github.com/rust-lang/rust/pull/33922
2761 [34623]: https://github.com/rust-lang/rust/pull/34623
2762 [34923]: https://github.com/rust-lang/rust/pull/34923
2763 [34942]: https://github.com/rust-lang/rust/pull/34942
2764 [34982]: https://github.com/rust-lang/rust/pull/34982
2765 [35021]: https://github.com/rust-lang/rust/pull/35021
2766 [35048]: https://github.com/rust-lang/rust/pull/35048
2767 [35074]: https://github.com/rust-lang/rust/pull/35074
2768 [35124]: https://github.com/rust-lang/rust/pull/35124
2769 [35234]: https://github.com/rust-lang/rust/pull/35234
2770 [35238]: https://github.com/rust-lang/rust/pull/35238
2771 [35354]: https://github.com/rust-lang/rust/pull/35354
2772 [35559]: https://github.com/rust-lang/rust/pull/35559
2773 [35585]: https://github.com/rust-lang/rust/pull/35585
2774 [35627]: https://github.com/rust-lang/rust/pull/35627
2775 [35655]: https://github.com/rust-lang/rust/pull/35655
2776 [35702]: https://github.com/rust-lang/rust/pull/35702
2777 [35707]: https://github.com/rust-lang/rust/pull/35707
2778 [35728]: https://github.com/rust-lang/rust/pull/35728
2779 [35734]: https://github.com/rust-lang/rust/pull/35734
2780 [35755]: https://github.com/rust-lang/rust/pull/35755
2781 [35761]: https://github.com/rust-lang/rust/pull/35761
2782 [35764]: https://github.com/rust-lang/rust/pull/35764
2783 [35814]: https://github.com/rust-lang/rust/pull/35814
2784 [35854]: https://github.com/rust-lang/rust/pull/35854
2785 [35871]: https://github.com/rust-lang/rust/pull/35871
2786 [35884]: https://github.com/rust-lang/rust/pull/35884
2787 [35911]: https://github.com/rust-lang/rust/pull/35911
2788 [35969]: https://github.com/rust-lang/rust/pull/35969
2789 [35975]: https://github.com/rust-lang/rust/pull/35975
2790 [36004]: https://github.com/rust-lang/rust/pull/36004
2791 [36008]: https://github.com/rust-lang/rust/pull/36008
2792 [36014]: https://github.com/rust-lang/rust/pull/36014
2793 [36029]: https://github.com/rust-lang/rust/pull/36029
2794 [36059]: https://github.com/rust-lang/rust/pull/36059
2795 [36072]: https://github.com/rust-lang/rust/pull/36072
2796 [36101]: https://github.com/rust-lang/rust/pull/36101
2797 [36104]: https://github.com/rust-lang/rust/pull/36104
2798 [36171]: https://github.com/rust-lang/rust/pull/36171
2799 [36173]: https://github.com/rust-lang/rust/pull/36173
2800 [36178]: https://github.com/rust-lang/rust/pull/36178
2801 [36213]: https://github.com/rust-lang/rust/pull/36213
2802 [36214]: https://github.com/rust-lang/rust/pull/36214
2803 [36264]: https://github.com/rust-lang/rust/pull/36264
2804 [36266]: https://github.com/rust-lang/rust/pull/36266
2805 [36289]: https://github.com/rust-lang/rust/pull/36289
2806 [36338]: https://github.com/rust-lang/rust/pull/36338
2807 [36351]: https://github.com/rust-lang/rust/pull/36351
2808 [36355]: https://github.com/rust-lang/rust/pull/36355
2809 [36369]: https://github.com/rust-lang/rust/pull/36369
2810 [36372]: https://github.com/rust-lang/rust/pull/36372
2811 [36423]: https://github.com/rust-lang/rust/pull/36423
2812 [36482]: https://github.com/rust-lang/rust/pull/36482
2813 [36505]: https://github.com/rust-lang/rust/pull/36505
2814 [36524]: https://github.com/rust-lang/rust/pull/36524
2815 [36527]: https://github.com/rust-lang/rust/pull/36527
2816 [36551]: https://github.com/rust-lang/rust/pull/36551
2817 [36574]: https://github.com/rust-lang/rust/pull/36574
2818 [36586]: https://github.com/rust-lang/rust/pull/36586
2819 [36592]: https://github.com/rust-lang/rust/pull/36592
2820 [36631]: https://github.com/rust-lang/rust/pull/36631
2821 [36639]: https://github.com/rust-lang/rust/pull/36639
2822 [36721]: https://github.com/rust-lang/rust/pull/36721
2823 [36727]: https://github.com/rust-lang/rust/pull/36727
2824 [36730]: https://github.com/rust-lang/rust/pull/36730
2825 [36734]: https://github.com/rust-lang/rust/pull/36734
2826 [36754]: https://github.com/rust-lang/rust/pull/36754
2827 [36995]: https://github.com/rust-lang/rust/pull/36995
2828 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
2829 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
2830 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2831 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
2832 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
2833 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
2834 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
2835 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
2836 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
2837 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
2838 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
2839 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
2840 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
2841 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
2842 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
2843 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
2844 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
2845 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
2846 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
2847 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
2848 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
2849 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
2850 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
2851 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
2852 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
2853 [rustup]: https://www.rustup.rs
2854 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
2855 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
2856 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
2857 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
2858 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
2859 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
2860 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
2861
2862
2863 Version 1.12.1 (2016-10-20)
2864 ===========================
2865
2866 Regression Fixes
2867 ----------------
2868
2869 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
2870 * [Confusion with double negation and booleans][36856]
2871 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
2872 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
2873 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
2874 * [Corrupted memory after updated to 1.12][36936]
2875 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
2876 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
2877 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
2878
2879 [36381]: https://github.com/rust-lang/rust/issues/36381
2880 [36856]: https://github.com/rust-lang/rust/issues/36856
2881 [36875]: https://github.com/rust-lang/rust/issues/36875
2882 [36924]: https://github.com/rust-lang/rust/issues/36924
2883 [36926]: https://github.com/rust-lang/rust/issues/36926
2884 [36936]: https://github.com/rust-lang/rust/issues/36936
2885 [37026]: https://github.com/rust-lang/rust/issues/37026
2886 [37112]: https://github.com/rust-lang/rust/issues/37112
2887 [37153]: https://github.com/rust-lang/rust/issues/37153
2888
2889
2890 Version 1.12.0 (2016-09-29)
2891 ===========================
2892
2893 Highlights
2894 ----------
2895
2896 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
2897   This translation pass is far simpler than the previous AST->LLVM pass, and
2898   creates opportunities to perform new optimizations directly on the MIR. It
2899   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
2900 * [`rustc` presents a new, more readable error format, along with
2901   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
2902   Most common editors supporting Rust have been updated to work with it. It was
2903   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
2904
2905 Compiler
2906 --------
2907
2908 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
2909   This translation pass is far simpler than the previous AST->LLVM pass, and
2910   creates opportunities to perform new optimizations directly on the MIR. It
2911   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
2912 * [Print the Rust target name, not the LLVM target name, with
2913   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
2914 * [The computation of `TypeId` is correct in some cases where it was previously
2915   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
2916 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
2917 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
2918   `--print relocation-models`, and `--print code-models` print the available
2919   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
2920   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
2921 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
2922   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
2923   These targets produce statically-linked binaries. There are no binary release
2924   builds yet though.
2925
2926 Diagnostics
2927 -----------
2928
2929 * [`rustc` presents a new, more readable error format, along with
2930   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
2931   Most common editors supporting Rust have been updated to work with it. It was
2932   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
2933 * [In error descriptions, references are now described in plain English,
2934   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
2935 * [In error type descriptions, unknown numeric types are named `{integer}` or
2936   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
2937 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
2938
2939 Language
2940 --------
2941
2942 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
2943 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
2944 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
2945   useful](https://github.com/rust-lang/rust/pull/34908)
2946 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
2947   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
2948 * [Semicolons are properly required as statement delimiters inside
2949   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
2950 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
2951
2952 Stabilized APIs
2953 ---------------
2954
2955 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
2956 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
2957 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
2958 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
2959 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
2960 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
2961 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
2962 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
2963 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
2964 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
2965   Both on Unix and Windows.
2966 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
2967 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
2968 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
2969 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
2970 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
2971 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
2972 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
2973 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
2974
2975 Libraries
2976 ---------
2977
2978 * [The `format!` macro and friends now allow a single argument to be formatted
2979   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
2980 * [The lifetime bounds on `[T]::binary_search_by` and
2981   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
2982 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
2983 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
2984 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
2985 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
2986 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
2987 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
2988 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
2989 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
2990   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
2991 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
2992   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
2993 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
2994 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
2995   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
2996 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
2997 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
2998 * [`mpsc::sync_channel` `Receiver`s return any available message before
2999   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3000 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3001 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3002
3003 Cargo
3004 -----
3005
3006 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3007 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3008 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3009 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3010 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3011 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3012 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3013 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3014 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3015 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3016 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3017 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3018 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3019 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3020 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3021 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3022
3023 Performance
3024 -----------
3025
3026 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3027 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3028
3029 Tooling
3030 -------
3031
3032 * [Test binaries now support a `--test-threads` argument to specify the number
3033   of threads used to run tests, and which acts the same as the
3034   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3035 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3036 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3037 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3038 * [Rust releases now come with source packages that can be installed by rustup
3039   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3040   The resulting source code can be used by tools and IDES, located in the
3041   sysroot under `lib/rustlib/src`.
3042
3043 Misc
3044 ----
3045
3046 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3047 * Many minor improvements to the documentation.
3048 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3049
3050 Compatibility Notes
3051 -------------------
3052
3053 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3054   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3055 * [When formatting strings, if "precision" is specified, the "fill",
3056   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3057 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3058
3059
3060 Version 1.11.0 (2016-08-18)
3061 ===========================
3062
3063 Language
3064 --------
3065
3066 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3067 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3068 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3069 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3070 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3071
3072 Stabilized APIs
3073 ---------------
3074
3075 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3076 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3077 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3078 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3079 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3080 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3081   (in libcore - previously stabilized in libstd)
3082 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3083   (in libcore - previously stabilized in libstd)
3084 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3085   (in libcore - previously stabilized in libstd)
3086 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3087   (in libcore - previously stabilized in libstd)
3088 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3089 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3090 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3091 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3092
3093 Libraries
3094 ---------
3095
3096 * [The `thread_local!` macro supports multiple definitions in a single
3097    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3098 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3099 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3100   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3101 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3102 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3103 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3104 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3105
3106 Cargo
3107 -----
3108
3109 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3110 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3111 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3112 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3113 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3114   and `-vv` prints warnings for all crates.
3115 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3116 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3117   This provides room for expansion by arbitrary tools.
3118 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3119 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3120 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3121 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3122 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3123 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3124 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3125
3126 Performance
3127 -----------
3128
3129 * [Caching projections speeds up type check dramatically for some
3130   workloads](https://github.com/rust-lang/rust/pull/33816)
3131 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3132   This hasher is faster, but is believed to provide sufficient
3133   protection from collision attacks.
3134 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3135
3136 Rustdoc
3137 -------
3138
3139 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3140 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3141 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3142 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3143 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3144
3145 Tooling
3146 -------
3147
3148 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3149 * [When emitting debug info, rustc emits frame pointers for closures,
3150   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3151 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3152 * Many more errors have been given error codes and extended
3153   explanations
3154 * API documentation continues to be improved, with many new examples
3155
3156 Misc
3157 ----
3158
3159 * [rustc no longer hangs when dependencies recursively re-export
3160   submodules](https://github.com/rust-lang/rust/pull/34542)
3161 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3162 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3163   rewritten](https://github.com/rust-lang/rust/pull/33895)
3164 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3165   No targets use this yet, but it works toward AVR support.
3166
3167 Compatibility Notes
3168 -------------------
3169
3170 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3171 * [The new follow-set rules that place restrictions on `macro_rules!`
3172   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3173   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3174   and has been a warning since 1.10.
3175 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3176   This causes breakage in some corner cases.
3177
3178
3179 Version 1.10.0 (2016-07-07)
3180 ===========================
3181
3182 Language
3183 --------
3184
3185 * [Allow `concat_idents!` in type positions as well as in expression
3186   positions](https://github.com/rust-lang/rust/pull/33735).
3187 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3188   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3189 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3190 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3191 * [`panic!` can be converted to a runtime abort with the
3192   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3193   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3194 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3195   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3196   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3197   Note that Cargo does not yet directly support cdylibs.
3198
3199 Stabilized APIs
3200 ---------------
3201
3202 * `os::windows::fs::OpenOptionsExt::access_mode`
3203 * `os::windows::fs::OpenOptionsExt::share_mode`
3204 * `os::windows::fs::OpenOptionsExt::custom_flags`
3205 * `os::windows::fs::OpenOptionsExt::attributes`
3206 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3207 * `os::unix::fs::OpenOptionsExt::custom_flags`
3208 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3209 * `Default for sync::Weak`
3210 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3211 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3212 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3213 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3214 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3215 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3216 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3217 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3218 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3219 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3220 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3221 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3222 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3223 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3224 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3225 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3226 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3227 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3228 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3229 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3230 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3231 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3232 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3233 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3234 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3235 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3236 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3237 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3238 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3239 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3240 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3241 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3242 * Read/Write/RawFd impls for `UnixStream`
3243 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3244 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3245 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3246 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3247 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3248 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3249 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3250 * RawFd impls for `UnixListener`
3251 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3252 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3253 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3254 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3255 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3256 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3257 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3258 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3259 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3260 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3261 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3262 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3263 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3264 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3265 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3266 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3267 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3268 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3269 * RawFd impls for `UnixDatagram`
3270 * `{BTree,Hash}Map::values_mut`
3271 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3272
3273 Libraries
3274 ---------
3275
3276 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3277   The semantics of this minor method are subtle and probably not what
3278   most people want.
3279 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3280 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3281   will fall back to `/dev/urandom` temporarily to avoid blocking
3282   during early boot](https://github.com/rust-lang/rust/pull/33086).
3283 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3284 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3285 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3286 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3287 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3288 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3289   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3290
3291 Cargo
3292 -----
3293 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3294   This controls the runtime behavior of the `panic!` macro
3295   and can be either "unwind" (the default), or "abort".
3296   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3297 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3298 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3299 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3300   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3301 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3302 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3303 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3304   By default they are retried twice, which can be customized with the
3305   `net.retry` value in `.cargo/config`.
3306 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3307 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3308 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3309 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3310   Makes it possible to install multiple crates in parallel.
3311 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3312 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3313 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3314 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3315 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3316 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3317
3318 Performance
3319 -----------
3320
3321 * [rustc memory usage was reduced by refactoring the context used for
3322   type checking](https://github.com/rust-lang/rust/pull/33425).
3323 * [Speed up creation of `HashMap`s by caching the random keys used
3324   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3325 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3326 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3327 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3328   10x faster than the previous lookup tables.
3329 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3330
3331 Usability
3332 ---------
3333
3334 * Many incremental improvements to documentation and rustdoc.
3335 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
3336 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
3337 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
3338 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
3339 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
3340 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
3341 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
3342
3343 Misc
3344 ----
3345
3346 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
3347 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
3348 * [`std` no longer prints backtraces on platforms where the running
3349   module must be loaded with `env::current_exe`, which can't be relied
3350   on](https://github.com/rust-lang/rust/pull/33554).
3351 * This release includes std binaries for the i586-unknown-linux-gnu,
3352   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
3353   i586 target is for old x86 hardware without SSE2, and the armv7
3354   target is for Android running on modern ARM architectures.
3355 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
3356   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
3357 * [On Unix the runtime aborts by calling `libc::abort` instead of
3358   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
3359 * [Rust is now bootstrapped from the previous release of Rust,
3360   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
3361
3362 Compatibility Notes
3363 -------------------
3364
3365 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
3366 * [`target_env` for Linux ARM targets is just `gnu`, not
3367   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
3368 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
3369 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
3370 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
3371   Affects how macros are parsed.
3372 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
3373 * [Feature-gated attributes on macro-generated macro invocations are
3374   now rejected](https://github.com/rust-lang/rust/pull/32791).
3375 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
3376   This caused some minor changes to type inference.
3377
3378
3379 Version 1.9.0 (2016-05-26)
3380 ==========================
3381
3382 Language
3383 --------
3384
3385 * The `#[deprecated]` attribute when applied to an API will generate
3386   warnings when used. The warnings may be suppressed with
3387   `#[allow(deprecated)]`. [RFC 1270].
3388 * [`fn` item types are zero sized, and each `fn` names a unique
3389   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3390   `transmute` on a `fn` type will generate a warning for a few cycles,
3391   then will be converted to an error.
3392 * [Field and method resolution understand visibility, so private
3393   fields and methods cannot prevent the proper use of public fields
3394   and methods][1.9fv].
3395 * [The parser considers unicode codepoints in the
3396   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
3397
3398 Stabilized APIs
3399 ---------------
3400
3401 * [`std::panic`]
3402 * [`std::panic::catch_unwind`][] (renamed from `recover`)
3403 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
3404 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
3405 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
3406 * [`str::is_char_boundary`]
3407 * [`<*const T>::as_ref`]
3408 * [`<*mut T>::as_ref`]
3409 * [`<*mut T>::as_mut`]
3410 * [`AsciiExt::make_ascii_uppercase`]
3411 * [`AsciiExt::make_ascii_lowercase`]
3412 * [`char::decode_utf16`]
3413 * [`char::DecodeUtf16`]
3414 * [`char::DecodeUtf16Error`]
3415 * [`char::DecodeUtf16Error::unpaired_surrogate`]
3416 * [`BTreeSet::take`]
3417 * [`BTreeSet::replace`]
3418 * [`BTreeSet::get`]
3419 * [`HashSet::take`]
3420 * [`HashSet::replace`]
3421 * [`HashSet::get`]
3422 * [`OsString::with_capacity`]
3423 * [`OsString::clear`]
3424 * [`OsString::capacity`]
3425 * [`OsString::reserve`]
3426 * [`OsString::reserve_exact`]
3427 * [`OsStr::is_empty`]
3428 * [`OsStr::len`]
3429 * [`std::os::unix::thread`]
3430 * [`RawPthread`]
3431 * [`JoinHandleExt`]
3432 * [`JoinHandleExt::as_pthread_t`]
3433 * [`JoinHandleExt::into_pthread_t`]
3434 * [`HashSet::hasher`]
3435 * [`HashMap::hasher`]
3436 * [`CommandExt::exec`]
3437 * [`File::try_clone`]
3438 * [`SocketAddr::set_ip`]
3439 * [`SocketAddr::set_port`]
3440 * [`SocketAddrV4::set_ip`]
3441 * [`SocketAddrV4::set_port`]
3442 * [`SocketAddrV6::set_ip`]
3443 * [`SocketAddrV6::set_port`]
3444 * [`SocketAddrV6::set_flowinfo`]
3445 * [`SocketAddrV6::set_scope_id`]
3446 * [`slice::copy_from_slice`]
3447 * [`ptr::read_volatile`]
3448 * [`ptr::write_volatile`]
3449 * [`OpenOptions::create_new`]
3450 * [`TcpStream::set_nodelay`]
3451 * [`TcpStream::nodelay`]
3452 * [`TcpStream::set_ttl`]
3453 * [`TcpStream::ttl`]
3454 * [`TcpStream::set_only_v6`]
3455 * [`TcpStream::only_v6`]
3456 * [`TcpStream::take_error`]
3457 * [`TcpStream::set_nonblocking`]
3458 * [`TcpListener::set_ttl`]
3459 * [`TcpListener::ttl`]
3460 * [`TcpListener::set_only_v6`]
3461 * [`TcpListener::only_v6`]
3462 * [`TcpListener::take_error`]
3463 * [`TcpListener::set_nonblocking`]
3464 * [`UdpSocket::set_broadcast`]
3465 * [`UdpSocket::broadcast`]
3466 * [`UdpSocket::set_multicast_loop_v4`]
3467 * [`UdpSocket::multicast_loop_v4`]
3468 * [`UdpSocket::set_multicast_ttl_v4`]
3469 * [`UdpSocket::multicast_ttl_v4`]
3470 * [`UdpSocket::set_multicast_loop_v6`]
3471 * [`UdpSocket::multicast_loop_v6`]
3472 * [`UdpSocket::set_multicast_ttl_v6`]
3473 * [`UdpSocket::multicast_ttl_v6`]
3474 * [`UdpSocket::set_ttl`]
3475 * [`UdpSocket::ttl`]
3476 * [`UdpSocket::set_only_v6`]
3477 * [`UdpSocket::only_v6`]
3478 * [`UdpSocket::join_multicast_v4`]
3479 * [`UdpSocket::join_multicast_v6`]
3480 * [`UdpSocket::leave_multicast_v4`]
3481 * [`UdpSocket::leave_multicast_v6`]
3482 * [`UdpSocket::take_error`]
3483 * [`UdpSocket::connect`]
3484 * [`UdpSocket::send`]
3485 * [`UdpSocket::recv`]
3486 * [`UdpSocket::set_nonblocking`]
3487
3488 Libraries
3489 ---------
3490
3491 * [`std::sync::Once` is poisoned if its initialization function
3492   fails][1.9o].
3493 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
3494 * [Most types implement `fmt::Debug`][1.9db].
3495 * [The default buffer size used by `BufReader` and `BufWriter` was
3496   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
3497   used by other languages.
3498 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
3499   `Duration` additionally implements `*=` and `/=`][1.9ta].
3500 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
3501 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
3502 * [`Chain` implements `BufRead`][1.9ch].
3503 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
3504
3505 Cargo
3506 -----
3507
3508 * [Cargo can now run concurrently][1.9cc].
3509 * [Top-level overrides allow specific revisions of crates to be
3510   overridden through the entire crate graph][1.9ct].  This is intended
3511   to make upgrades easier for large projects, by allowing crates to be
3512   forked temporarily until they've been upgraded and republished.
3513 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
3514 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
3515   on the commandline][1.9cf]. `rustc` arguments can also be specified
3516   in the `build.rustflags` configuration key.
3517
3518 Performance
3519 -----------
3520
3521 * [The time complexity of comparing variables for equivalence during type
3522   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
3523   to major compilation time improvement in some scenarios.
3524 * [`ToString` is specialized for `str`, giving it the same performance
3525   as `to_owned`][1.9ts].
3526 * [Spawning processes with `Command::output` no longer creates extra
3527   threads][1.9sp].
3528 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
3529   for C-like enums][1.9cl].
3530
3531 Misc
3532 ----
3533
3534 * [Passing the `--quiet` flag to a test runner will produce
3535   much-abbreviated output][1.9q].
3536 * The Rust Project now publishes std binaries for the
3537   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
3538   `i586-pc-windows-msvc` targets.
3539
3540 Compatibility Notes
3541 -------------------
3542
3543 * [`std::sync::Once` is poisoned if its initialization function
3544   fails][1.9o].
3545 * [It is illegal to define methods with the same name in overlapping
3546   inherent `impl` blocks][1.9sn].
3547 * [`fn` item types are zero sized, and each `fn` names a unique
3548   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3549   `transmute` on a `fn` type will generate a warning for a few cycles,
3550   then will be converted to an error.
3551 * [Improvements to const evaluation may trigger new errors when integer
3552   literals are out of range][1.9ce].
3553
3554
3555 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
3556 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
3557 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
3558 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
3559 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
3560 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
3561 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
3562 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
3563 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
3564 [1.9db]: https://github.com/rust-lang/rust/pull/32054
3565 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
3566 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
3567 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
3568 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
3569 [1.9o]: https://github.com/rust-lang/rust/pull/32325
3570 [1.9q]: https://github.com/rust-lang/rust/pull/31887
3571 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
3572 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
3573 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
3574 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
3575 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
3576 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
3577 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
3578 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
3579 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3580 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
3581 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3582 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
3583 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
3584 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
3585 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
3586 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
3587 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
3588 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
3589 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
3590 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
3591 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
3592 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
3593 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
3594 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
3595 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
3596 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
3597 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
3598 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
3599 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
3600 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
3601 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
3602 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
3603 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
3604 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
3605 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
3606 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
3607 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
3608 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
3609 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
3610 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
3611 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
3612 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
3613 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
3614 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
3615 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3616 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3617 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3618 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3619 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3620 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3621 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
3622 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3623 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
3624 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3625 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3626 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3627 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3628 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3629 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
3630 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
3631 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
3632 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
3633 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
3634 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
3635 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
3636 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
3637 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
3638 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
3639 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
3640 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
3641 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
3642 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
3643 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
3644 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
3645 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
3646 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
3647 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
3648 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
3649 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
3650 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
3651 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
3652 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
3653 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
3654 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
3655 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
3656 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
3657 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
3658 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
3659 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
3660 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
3661 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
3662 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
3663 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
3664 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
3665
3666
3667 Version 1.8.0 (2016-04-14)
3668 ==========================
3669
3670 Language
3671 --------
3672
3673 * Rust supports overloading of compound assignment statements like
3674   `+=` by implementing the [`AddAssign`], [`SubAssign`],
3675   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
3676   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
3677   traits. [RFC 953].
3678 * Empty structs can be defined with braces, as in `struct Foo { }`, in
3679   addition to the non-braced form, `struct Foo;`. [RFC 218].
3680
3681 Libraries
3682 ---------
3683
3684 * Stabilized APIs:
3685   * [`str::encode_utf16`][] (renamed from `utf16_units`)
3686   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
3687   * [`Ref::map`]
3688   * [`RefMut::map`]
3689   * [`ptr::drop_in_place`]
3690   * [`time::Instant`]
3691   * [`time::SystemTime`]
3692   * [`Instant::now`]
3693   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
3694   * [`Instant::elapsed`]
3695   * [`SystemTime::now`]
3696   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
3697   * [`SystemTime::elapsed`]
3698   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
3699   * [`SystemTimeError`]
3700   * [`SystemTimeError::duration`]
3701   * Various impls for `SystemTimeError`
3702   * [`UNIX_EPOCH`]
3703   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
3704     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
3705     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
3706 * [The `write!` and `writeln!` macros correctly emit errors if any of
3707   their arguments can't be formatted][1.8w].
3708 * [Various I/O functions support large files on 32-bit Linux][1.8l].
3709 * [The Unix-specific `raw` modules, which contain a number of
3710   redefined C types are deprecated][1.8r], including `os::raw::unix`,
3711   `os::raw::macos`, and `os::raw::linux`. These modules defined types
3712   such as `ino_t` and `dev_t`. The inconsistency of these definitions
3713   across platforms was making it difficult to implement `std`
3714   correctly. Those that need these definitions should use the `libc`
3715   crate. [RFC 1415].
3716 * The Unix-specific `MetadataExt` traits, including
3717   `os::unix::fs::MetadataExt`, which expose values such as inode
3718   numbers [no longer return platform-specific types][1.8r], but
3719   instead return widened integers. [RFC 1415].
3720 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
3721 * [Atomic loads and stores are not volatile][1.8a].
3722 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
3723
3724 Performance
3725 -----------
3726
3727 * [Inlining hash functions lead to a 3% compile-time improvement in
3728   some workloads][1.8h].
3729 * When using jemalloc, its symbols are [unprefixed so that it
3730   overrides the libc malloc implementation][1.8h]. This means that for
3731   rustc, LLVM is now using jemalloc, which results in a 6%
3732   compile-time improvement on a specific workload.
3733 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
3734
3735 Misc
3736 ----
3737
3738 * [32-bit MSVC builds finally implement unwinding][1.8ms].
3739   i686-pc-windows-msvc is now considered a tier-1 platform.
3740 * [The `--print targets` flag prints a list of supported targets][1.8t].
3741 * [The `--print cfg` flag prints the `cfg`s defined for the current
3742   target][1.8cf].
3743 * [`rustc` can be built with an new Cargo-based build system, written
3744   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
3745   build system. To enable it configure with `configure --rustbuild`.
3746 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
3747   variants while also indicating the total number of missing variants
3748   if more than 3][1.8m].
3749 * [Executable stacks are disabled on Linux and BSD][1.8nx].
3750 * The Rust Project now publishes binary releases of the standard
3751   library for a number of tier-2 targets:
3752   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
3753   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
3754   `x86_64-rumprun-netbsd`. These can be installed with
3755   tools such as [multirust][1.8mr].
3756
3757 Cargo
3758 -----
3759
3760 * [`cargo init` creates a new Cargo project in the current
3761   directory][1.8ci].  It is otherwise like `cargo new`.
3762 * [Cargo has configuration keys for `-v` and
3763   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
3764   `[term]` section of `.cargo/config`.
3765 * [Configuration keys that evaluate to strings or integers can be set
3766   via environment variables][1.8ce]. For example the `build.jobs` key
3767   can be set via `CARGO_BUILD_JOBS`. Environment variables take
3768   precedence over config files.
3769 * [Target-specific dependencies support Rust `cfg` syntax for
3770   describing targets][1.8cfg] so that dependencies for multiple
3771   targets can be specified together. [RFC 1361].
3772 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
3773   `RUSTDOC` take precedence over the `build.target-dir`,
3774   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
3775 * [The child process tree is killed on Windows when Cargo is
3776   killed][1.8ck].
3777 * [The `build.target` configuration value sets the target platform,
3778   like `--target`][1.8ct].
3779
3780 Compatibility Notes
3781 -------------------
3782
3783 * [Unstable compiler flags have been further restricted][1.8u]. Since
3784   1.0 `-Z` flags have been considered unstable, and other flags that
3785   were considered unstable additionally required passing `-Z
3786   unstable-options` to access. Unlike unstable language and library
3787   features though, these options have been accessible on the stable
3788   release channel. Going forward, *new unstable flags will not be
3789   available on the stable release channel*, and old unstable flags
3790   will warn about their usage. In the future, all unstable flags will
3791   be unavailable on the stable release channel.
3792 * [It is no longer possible to `match` on empty enum variants using
3793   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
3794 * The Unix-specific `MetadataExt` traits, including
3795   `os::unix::fs::MetadataExt`, which expose values such as inode
3796   numbers [no longer return platform-specific types][1.8r], but
3797   instead return widened integers. [RFC 1415].
3798 * [Modules sourced from the filesystem cannot appear within arbitrary
3799   blocks, but only within other modules][1.8mf].
3800 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
3801 * On Unix, [stack overflow triggers a runtime abort instead of a
3802   SIGSEGV][1.8so].
3803 * [`Command::spawn` and its equivalents return an error if any of
3804   its command-line arguments contain interior `NUL`s][1.8n].
3805 * [Tuple and unit enum variants from other crates are in the type
3806   namespace][1.8tn].
3807 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
3808   type instead of `.a` files][1.8st]. Additionally, for the MSVC
3809   toolchain, `rustc` emits import libraries named `foo.dll.lib`
3810   instead of `foo.lib`.
3811
3812
3813 [1.8a]: https://github.com/rust-lang/rust/pull/30962
3814 [1.8b]: https://github.com/rust-lang/rust/pull/31123
3815 [1.8c]: https://github.com/rust-lang/rust/pull/31530
3816 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
3817 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
3818 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
3819 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
3820 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
3821 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
3822 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
3823 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
3824 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
3825 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
3826 [1.8h]: https://github.com/rust-lang/rust/pull/31460
3827 [1.8l]: https://github.com/rust-lang/rust/pull/31668
3828 [1.8m]: https://github.com/rust-lang/rust/pull/31020
3829 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
3830 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
3831 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
3832 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
3833 [1.8n]: https://github.com/rust-lang/rust/pull/31056
3834 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
3835 [1.8r]: https://github.com/rust-lang/rust/pull/31551
3836 [1.8so]: https://github.com/rust-lang/rust/pull/31333
3837 [1.8st]: https://github.com/rust-lang/rust/pull/29520
3838 [1.8t]: https://github.com/rust-lang/rust/pull/31358
3839 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
3840 [1.8u]: https://github.com/rust-lang/rust/pull/31793
3841 [1.8v]: https://github.com/rust-lang/rust/pull/31757
3842 [1.8w]: https://github.com/rust-lang/rust/pull/31904
3843 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
3844 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
3845 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
3846 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
3847 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
3848 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
3849 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
3850 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
3851 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
3852 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
3853 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
3854 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
3855 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
3856 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
3857 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
3858 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
3859 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
3860 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
3861 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
3862 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
3863 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
3864 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
3865 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
3866 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
3867 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
3868 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
3869 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
3870 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
3871 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
3872 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
3873
3874
3875 Version 1.7.0 (2016-03-03)
3876 ==========================
3877
3878 Libraries
3879 ---------
3880
3881 * Stabilized APIs
3882   * `Path`
3883     * [`Path::strip_prefix`][] (renamed from relative_from)
3884     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
3885   * `Ipv4Addr`
3886     * [`Ipv4Addr::is_loopback`]
3887     * [`Ipv4Addr::is_private`]
3888     * [`Ipv4Addr::is_link_local`]
3889     * [`Ipv4Addr::is_multicast`]
3890     * [`Ipv4Addr::is_broadcast`]
3891     * [`Ipv4Addr::is_documentation`]
3892   * `Ipv6Addr`
3893     * [`Ipv6Addr::is_unspecified`]
3894     * [`Ipv6Addr::is_loopback`]
3895     * [`Ipv6Addr::is_multicast`]
3896   * `Vec`
3897     * [`Vec::as_slice`]
3898     * [`Vec::as_mut_slice`]
3899   * `String`
3900     * [`String::as_str`]
3901     * [`String::as_mut_str`]
3902   * Slices
3903     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
3904     be the same length
3905     * `<[T]>::`[`sort_by_key`]
3906   * checked, saturated, and overflowing operations
3907     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
3908     * [`i32::saturating_mul`]
3909     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
3910     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
3911     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
3912     * [`u32::saturating_mul`]
3913     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
3914     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
3915     * and checked, saturated, and overflowing operations for other primitive types
3916   * FFI
3917     * [`ffi::IntoStringError`]
3918     * [`CString::into_string`]
3919     * [`CString::into_bytes`]
3920     * [`CString::into_bytes_with_nul`]
3921     * `From<CString> for Vec<u8>`
3922   * `IntoStringError`
3923     * [`IntoStringError::into_cstring`]
3924     * [`IntoStringError::utf8_error`]
3925     * `Error for IntoStringError`
3926   * Hashing
3927     * [`std::hash::BuildHasher`]
3928     * [`BuildHasher::Hasher`]
3929     * [`BuildHasher::build_hasher`]
3930     * [`std::hash::BuildHasherDefault`]
3931     * [`HashMap::with_hasher`]
3932     * [`HashMap::with_capacity_and_hasher`]
3933     * [`HashSet::with_hasher`]
3934     * [`HashSet::with_capacity_and_hasher`]
3935     * [`std::collections::hash_map::RandomState`]
3936     * [`RandomState::new`]
3937 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
3938   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
3939   from bytes is faster.
3940 * [The performance of `LineWriter` (and thus `io::stdout`) was
3941   improved by using `memchr` to search for newlines][1.7m].
3942 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
3943   `f64` variants were stabilized previously.
3944 * [`BTreeMap` was rewritten to use less memory and improve the performance
3945   of insertion and iteration, the latter by as much as 5x][1.7bm].
3946 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
3947   covariant over their contained type][1.7bt].
3948 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
3949   over their contained type][1.7ll].
3950 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
3951   searching methods.
3952 * [`Any` is implemented for unsized types][1.7a].
3953 * [`Hash` is implemented for `Duration`][1.7h].
3954
3955 Misc
3956 ----
3957
3958 * [When running tests with `--test`, rustdoc will pass `--cfg`
3959   arguments to the compiler][1.7dt].
3960 * [The compiler is built with RPATH information by default][1.7rpa].
3961   This means that it will be possible to run `rustc` when installed in
3962   unusual configurations without configuring the dynamic linker search
3963   path explicitly.
3964 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
3965   any RPATH entries (emitted with `-C rpath`) *not* take precedence
3966   over `LD_LIBRARY_PATH`.
3967
3968 Cargo
3969 -----
3970
3971 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
3972   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
3973 * [The `rerun-if-changed` build script directive no longer causes the
3974   build script to incorrectly run twice in certain scenarios][1.7rr].
3975
3976 Compatibility Notes
3977 -------------------
3978
3979 * Soundness fixes to the interactions between associated types and
3980   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
3981   code that violates the new rules. This is a significant change that
3982   is known to break existing code, so it has emitted warnings for the
3983   new error cases since 1.4 to give crate authors time to adapt. The
3984   details of what is changing are subtle; read the RFC for more.
3985 * [Several bugs in the compiler's visibility calculations were
3986   fixed][1.7v]. Since this was found to break significant amounts of
3987   code, the new errors will be emitted as warnings for several release
3988   cycles, under the `private_in_public` lint.
3989 * Defaulted type parameters were accidentally accepted in positions
3990   that were not intended. In this release, [defaulted type parameters
3991   appearing outside of type definitions will generate a
3992   warning][1.7d], which will become an error in future releases.
3993 * [Parsing "." as a float results in an error instead of 0][1.7p].
3994   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
3995 * [Borrows of closure parameters may not outlive the closure][1.7bc].
3996
3997 [1.7a]: https://github.com/rust-lang/rust/pull/30928
3998 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
3999 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4000 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4001 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4002 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4003 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4004 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4005 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4006 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4007 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4008 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4009 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4010 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4011 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4012 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4013 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4014 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4015 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4016 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4017 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4018 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4019 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4020 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4021 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4022 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4023 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4024 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4025 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4026 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4027 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4028 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4029 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4030 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4031 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4032 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4033 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4034 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4035 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4036 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4037 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4038 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4039 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4040 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4041 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4042 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4043 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4044 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4045 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4046 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4047 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4048 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4049 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4050 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4051 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4052 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4053 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4054 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4055 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4056 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4057 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4058 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4059 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4060 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4061 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4062 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4063 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4064 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4065 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4066 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4067 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4068 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4069 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4070 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4071 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4072 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4073 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4074 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4075 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4076
4077
4078 Version 1.6.0 (2016-01-21)
4079 ==========================
4080
4081 Language
4082 --------
4083
4084 * The `#![no_std]` attribute causes a crate to not be linked to the
4085   standard library, but only the [core library][1.6co], as described
4086   in [RFC 1184]. The core library defines common types and traits but
4087   has no platform dependencies whatsoever, and is the basis for Rust
4088   software in environments that cannot support a full port of the
4089   standard library, such as operating systems. Most of the core
4090   library is now stable.
4091
4092 Libraries
4093 ---------
4094
4095 * Stabilized APIs:
4096   [`Read::read_exact`],
4097   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4098   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4099   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4100   [`os::unix::fs::DirBuilderExt`],
4101   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4102   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4103   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4104   [`collections::hash_map::Drain`],
4105   [`collections::hash_map::HashMap::drain`],
4106   [`collections::hash_set::Drain`],
4107   [`collections::hash_set::HashSet::drain`],
4108   [`collections::binary_heap::Drain`],
4109   [`collections::binary_heap::BinaryHeap::drain`],
4110   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4111   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4112   [`RwLock::into_inner`],
4113   [`Iterator::min_by_key`][] (renamed from `min_by`),
4114   [`Iterator::max_by_key`][] (renamed from `max_by`).
4115 * The [core library][1.6co] is stable, as are most of its APIs.
4116 * [The `assert_eq!` macro supports arguments that don't implement
4117   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4118   `assert!`.
4119 * Several timer functions that take duration in milliseconds [are
4120   deprecated in favor of those that take `Duration`][1.6ms]. These
4121   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4122   `thread::park_timeout_ms`.
4123 * The algorithm by which `Vec` reserves additional elements was
4124   [tweaked to not allocate excessive space][1.6a] while still growing
4125   exponentially.
4126 * `From` conversions are [implemented from integers to floats][1.6f]
4127   in cases where the conversion is lossless. Thus they are not
4128   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4129   or `f64`. They are also not implemented for `isize` and `usize`
4130   because the implementations would be platform-specific. `From` is
4131   also implemented from `f32` to `f64`.
4132 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4133 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4134 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4135 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4136   improvements.
4137 * Sorting slices that are already sorted [is 50% faster in some
4138   cases][1.6s].
4139
4140 Cargo
4141 -----
4142
4143 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4144 * Cargo build scripts can specify their dependencies by emitting the
4145   [`rerun-if-changed`][1.6rr] key.
4146 * crates.io will reject publication of crates with dependencies that
4147   have a wildcard version constraint. Crates with wildcard
4148   dependencies were seen to cause a variety of problems, as described
4149   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4150   warning.
4151 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4152   release folder.  A variety of artifacts that Cargo failed to clean
4153   are now correctly deleted.
4154
4155 Misc
4156 ----
4157
4158 * The `unreachable_code` lint [warns when a function call's argument
4159   diverges][1.6dv].
4160 * The parser indicates [failures that may be caused by
4161   confusingly-similar Unicode characters][1.6uc]
4162 * Certain macro errors [are reported at definition time][1.6m], not
4163   expansion.
4164
4165 Compatibility Notes
4166 -------------------
4167
4168 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4169   environment variable when locating crates. This was a pre-cargo
4170   feature for integrating with the package manager that was
4171   accidentally never removed.
4172 * [A number of bugs were fixed in the privacy checker][1.6p] that
4173   could cause previously-accepted code to break.
4174 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4175 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4176   struct pattern syntax (`Foo(..)`) can no longer be used to match
4177   unit structs. This is a warning now, but will become an error in
4178   future releases. Patterns that share the same name as a const are
4179   now an error.
4180 * A bug was fixed that causes [rustc not to apply default type
4181   parameters][1.6xc] when resolving certain method implementations of
4182   traits defined in other crates.
4183
4184 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4185 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4186 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4187 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4188 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4189 [1.6co]: http://doc.rust-lang.org/core/index.html
4190 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4191 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4192 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4193 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4194 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4195 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4196 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4197 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4198 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4199 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4200 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4201 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4202 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4203 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4204 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4205 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4206 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4207 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4208 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4209 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4210 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4211 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4212 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4213 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4214 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4215 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4216 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4217 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4218 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4219 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4220 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4221 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4222 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4223 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4224 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4225 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4226 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4227 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4228 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4229 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4230 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4231
4232
4233 Version 1.5.0 (2015-12-10)
4234 ==========================
4235
4236 * ~700 changes, numerous bugfixes
4237
4238 Highlights
4239 ----------
4240
4241 * Stabilized APIs:
4242   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4243   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4244   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4245   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4246   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4247   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4248   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4249   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4250   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4251   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4252   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4253   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4254   [`Path::read_link`], [`Path::symlink_metadata`],
4255   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4256   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4257   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4258   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4259   [`slice::split_first_mut`], [`slice::split_first`],
4260   [`slice::split_last_mut`], [`slice::split_last`],
4261   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4262   [`str::MatchIndices`], [`str::RMatchIndices`],
4263   [`str::match_indices`], [`str::rmatch_indices`],
4264   [`str::slice_mut_unchecked`], [`string::ParseError`].
4265 * Rust applications hosted on crates.io can be installed locally to
4266   `~/.cargo/bin` with the [`cargo install`] command. Among other
4267   things this makes it easier to augment Cargo with new subcommands:
4268   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4269   invoked as `cargo foo`.
4270 * Crates with wildcard (`*`) dependencies will [emit warnings when
4271   published][1.5w]. In 1.6 it will no longer be possible to publish
4272   crates with wildcard dependencies.
4273
4274 Breaking Changes
4275 ----------------
4276
4277 * The rules determining when a particular lifetime must outlive
4278   a particular value (known as '[dropck]') have been [modified
4279   to not rely on parametricity][1.5p].
4280 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4281   and `Arc`][1.5a]. Because these smart pointer types implement
4282   `Deref`, this causes breakage in cases where the interior type
4283   contains methods of the same name.
4284 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4285   that they could drop their content. Soundness fix.
4286 * All method invocations are [properly checked][1.5wf1] for
4287   [well-formedness][1.5wf2]. Soundness fix.
4288 * Traits whose supertraits contain `Self` are [not object
4289   safe][1.5o]. Soundness fix.
4290 * Target specifications support a [`no_default_libraries`][1.5nd]
4291   setting that controls whether `-nodefaultlibs` is passed to the
4292   linker, and in turn the `is_like_windows` setting no longer affects
4293   the `-nodefaultlibs` flag.
4294 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4295 * The `#[inline]` and `#[repr]` attributes [can only appear
4296   in valid locations][1.5at].
4297 * Native libraries linked from the local crate are [passed to
4298   the linker before native libraries from upstream crates][1.5nl].
4299 * Two rarely-used attributes, `#[no_debug]` and
4300   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4301 * Negation of unsigned integers, which has been a warning for
4302   several releases, [is now behind a feature gate and will
4303   generate errors][1.5nu].
4304 * The parser accidentally accepted visibility modifiers on
4305   enum variants, a bug [which has been fixed][1.5ev].
4306 * [A bug was fixed that allowed `use` statements to import unstable
4307   features][1.5use].
4308
4309 Language
4310 --------
4311
4312 * When evaluating expressions at compile-time that are not
4313   compile-time constants (const-evaluating expressions in non-const
4314   contexts), incorrect code such as overlong bitshifts and arithmetic
4315   overflow will [generate a warning instead of an error][1.5ce],
4316   delaying the error until runtime. This will allow the
4317   const-evaluator to be expanded in the future backwards-compatibly.
4318 * The `improper_ctypes` lint [no longer warns about using `isize` and
4319   `usize` in FFI][1.5ict].
4320
4321 Libraries
4322 ---------
4323
4324 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4325   invariant][1.5c].
4326 * `Default` is [implemented for mutable slices][1.5d].
4327 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4328 * There are now `From` conversions [between floating point
4329   types][1.5f] where the conversions are lossless.
4330 * There are now `From` conversions [between integer types][1.5i] where
4331   the conversions are lossless.
4332 * [`fs::Metadata` implements `Clone`][1.5fs].
4333 * The `parse` method [accepts a leading "+" when parsing
4334   integers][1.5pi].
4335 * [`AsMut` is implemented for `Vec`][1.5am].
4336 * The `clone_from` implementations for `String` and `BinaryHeap` [have
4337   been optimized][1.5cf] and no longer rely on the default impl.
4338 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
4339   `unsafe extern "C"` function types now [implement `Clone`,
4340   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
4341   `fmt::Debug` for up to 12 arguments][1.5fp].
4342 * [Dropping `Vec`s is much faster in unoptimized builds when the
4343   element types don't implement `Drop`][1.5dv].
4344 * A bug that caused in incorrect behavior when [combining `VecDeque`
4345   with zero-sized types][1.5vdz] was resolved.
4346 * [`PartialOrd` for slices is faster][1.5po].
4347
4348 Miscellaneous
4349 -------------
4350
4351 * [Crate metadata size was reduced by 20%][1.5md].
4352 * [Improvements to code generation reduced the size of libcore by 3.3
4353   MB and rustc's memory usage by 18MB][1.5m].
4354 * [Improvements to deref translation increased performance in
4355   unoptimized builds][1.5dr].
4356 * Various errors in trait resolution [are deduplicated to only be
4357   reported once][1.5te].
4358 * Rust has preliminary [support for rumprun kernels][1.5rr].
4359 * Rust has preliminary [support for NetBSD on amd64][1.5na].
4360
4361 [1.5use]: https://github.com/rust-lang/rust/pull/28364
4362 [1.5po]: https://github.com/rust-lang/rust/pull/28436
4363 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
4364 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
4365 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
4366 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
4367 [1.5md]: https://github.com/rust-lang/rust/pull/28521
4368 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
4369 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
4370 [1.5na]: https://github.com/rust-lang/rust/pull/28543
4371 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
4372 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
4373 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
4374 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
4375 [1.5te]: https://github.com/rust-lang/rust/pull/28645
4376 [1.5at]: https://github.com/rust-lang/rust/pull/28650
4377 [1.5am]: https://github.com/rust-lang/rust/pull/28663
4378 [1.5m]: https://github.com/rust-lang/rust/pull/28778
4379 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
4380 [1.5a]: https://github.com/rust-lang/rust/pull/28811
4381 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
4382 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
4383 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
4384 [1.5i]: https://github.com/rust-lang/rust/pull/28921
4385 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
4386 [1.5f]: https://github.com/rust-lang/rust/pull/29129
4387 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
4388 [1.5s]: https://github.com/rust-lang/rust/pull/29190
4389 [1.5d]: https://github.com/rust-lang/rust/pull/29245
4390 [1.5o]: https://github.com/rust-lang/rust/pull/29259
4391 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
4392 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4393 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
4394 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
4395 [1.5c]: https://github.com/rust-lang/rust/pull/29110
4396 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4397 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
4398 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
4399 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
4400 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
4401 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
4402 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
4403 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
4404 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
4405 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
4406 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
4407 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
4408 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
4409 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
4410 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
4411 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
4412 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
4413 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
4414 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
4415 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
4416 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
4417 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
4418 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
4419 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
4420 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
4421 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
4422 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
4423 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
4424 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
4425 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
4426 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
4427 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
4428 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
4429 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
4430 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
4431 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
4432 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
4433 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
4434 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
4435 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
4436 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
4437 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
4438 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
4439 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
4440 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
4441 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
4442 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
4443 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
4444 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
4445 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
4446 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
4447 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
4448 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
4449 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
4450
4451 Version 1.4.0 (2015-10-29)
4452 ==========================
4453
4454 * ~1200 changes, numerous bugfixes
4455
4456 Highlights
4457 ----------
4458
4459 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
4460   GNU) are now supported and recommended for use.
4461
4462 Breaking Changes
4463 ----------------
4464
4465 * [Several changes have been made to fix type soundness and improve
4466   the behavior of associated types][sound]. See [RFC 1214]. Although
4467   we have mostly introduced these changes as warnings this release, to
4468   become errors next release, there are still some scenarios that will
4469   see immediate breakage.
4470 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
4471   line breaks in addition to `\n`][crlf].
4472 * [Loans of `'static` lifetime extend to the end of a function][stat].
4473 * [`str::parse` no longer introduces avoidable rounding error when
4474   parsing floating point numbers. Together with earlier changes to
4475   float formatting/output, "round trips" like f.to_string().parse()
4476   now preserve the value of f exactly. Additionally, leading plus
4477   signs are now accepted][fp3].
4478
4479
4480 Language
4481 --------
4482
4483 * `use` statements that import multiple items [can now rename
4484   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
4485 * [Binops work correctly on fat pointers][binfat].
4486 * `pub extern crate`, which does not behave as expected, [issues a
4487   warning][pec] until a better solution is found.
4488
4489 Libraries
4490 ---------
4491
4492 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
4493   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
4494   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
4495   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
4496   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
4497   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
4498   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
4499   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
4500   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
4501   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
4502   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
4503   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
4504   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
4505   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
4506   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
4507   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
4508   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
4509   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
4510   [`thread::sleep`].
4511 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
4512   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
4513   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
4514   `f64::from_str_radix`.
4515 * [Reverse-searching strings is faster with the 'two-way'
4516   algorithm][s].
4517 * [`std::io::copy` allows `?Sized` arguments][cc].
4518 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
4519   [override `count`, `nth` and `last` with an O(1)
4520   implementation][it].
4521 * [`Default` is implemented for arrays up to `[T; 32]`][d].
4522 * [`IntoRawFd` has been added to the Unix-specific prelude,
4523   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
4524   prelude][pr].
4525 * [`Extend<String>` and `FromIterator<String` are both implemented for
4526   `String`][es].
4527 * [`IntoIterator` is implemented for references to `Option` and
4528   `Result`][into2].
4529 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
4530   Copy`][ext] as part of [RFC 839]. This will cause type inference
4531   breakage in rare situations.
4532 * [`BinaryHeap` implements `Debug`][bh2].
4533 * [`Borrow` and `BorrowMut` are implemented for fixed-size
4534   arrays][bm].
4535 * [`extern fn`s with the "Rust" and "C" ABIs implement common
4536   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
4537 * [String comparison is faster][faststr].
4538 * `&mut T` where `T: std::fmt::Write` [also implements
4539   `std::fmt::Write`][mutw].
4540 * [A stable regression in `VecDeque::push_back` and other
4541   capacity-altering methods that caused panics for zero-sized types
4542   was fixed][vd].
4543 * [Function pointers implement traits for up to 12 parameters][fp2].
4544
4545 Miscellaneous
4546 -------------
4547
4548 * The compiler [no longer uses the 'morestack' feature to prevent
4549   stack overflow][mm]. Instead it uses guard pages and stack
4550   probes (though stack probes are not yet implemented on any platform
4551   but Windows).
4552 * [The compiler matches traits faster when projections are involved][p].
4553 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
4554   `usize`][ffi].
4555 * [Cargo now displays useful information about what its doing during
4556   `cargo update`][cu].
4557
4558 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
4559 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
4560 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
4561 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
4562 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
4563 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
4564 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
4565 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
4566 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
4567 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
4568 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
4569 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
4570 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
4571 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
4572 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
4573 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
4574 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
4575 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
4576 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4577 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4578 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4579 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4580 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4581 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4582 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4583 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4584 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
4585 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
4586 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
4587 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
4588 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
4589 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
4590 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
4591 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
4592 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
4593 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
4594 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
4595 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
4596 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
4597 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
4598 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
4599 [bh2]: https://github.com/rust-lang/rust/pull/28156
4600 [binfat]: https://github.com/rust-lang/rust/pull/28270
4601 [bm]: https://github.com/rust-lang/rust/pull/28197
4602 [cc]: https://github.com/rust-lang/rust/pull/27531
4603 [crlf]: https://github.com/rust-lang/rust/pull/28034
4604 [cu]: https://github.com/rust-lang/cargo/pull/1931
4605 [d]: https://github.com/rust-lang/rust/pull/27825
4606 [dep]: https://github.com/rust-lang/rust/pull/28339
4607 [es]: https://github.com/rust-lang/rust/pull/27956
4608 [ext]: https://github.com/rust-lang/rust/pull/28094
4609 [faststr]: https://github.com/rust-lang/rust/pull/28338
4610 [ffi]: https://github.com/rust-lang/rust/pull/28779
4611 [fp]: https://github.com/rust-lang/rust/pull/28268
4612 [fp2]: https://github.com/rust-lang/rust/pull/28560
4613 [fp3]: https://github.com/rust-lang/rust/pull/27307
4614 [i]: https://github.com/rust-lang/rust/pull/27451
4615 [into2]: https://github.com/rust-lang/rust/pull/28039
4616 [it]: https://github.com/rust-lang/rust/pull/27652
4617 [mm]: https://github.com/rust-lang/rust/pull/27338
4618 [mutw]: https://github.com/rust-lang/rust/pull/28368
4619 [sound]: https://github.com/rust-lang/rust/pull/27641
4620 [p]: https://github.com/rust-lang/rust/pull/27866
4621 [pec]: https://github.com/rust-lang/rust/pull/28486
4622 [pr]: https://github.com/rust-lang/rust/pull/27896
4623 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4624 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4625 [s]: https://github.com/rust-lang/rust/pull/27474
4626 [stab]: https://github.com/rust-lang/rust/pull/28339
4627 [stat]: https://github.com/rust-lang/rust/pull/28321
4628 [vd]: https://github.com/rust-lang/rust/pull/28494
4629
4630 Version 1.3.0 (2015-09-17)
4631 ==============================
4632
4633 * ~900 changes, numerous bugfixes
4634
4635 Highlights
4636 ----------
4637
4638 * The [new object lifetime defaults][nold] have been [turned
4639   on][nold2] after a cycle of warnings about the change. Now types
4640   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
4641   being interpreted as `&'a Box<Trait+'a>` to `&'a
4642   Box<Trait+'static>`.
4643 * [The Rustonomicon][nom] is a new book in the official documentation
4644   that dives into writing unsafe Rust.
4645 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
4646   timekeeping is employed by other std APIs, as well as out-of-tree
4647   time crates.
4648
4649 Breaking Changes
4650 ----------------
4651
4652 * The [new object lifetime defaults][nold] have been [turned
4653   on][nold2] after a cycle of warnings about the change.
4654 * There is a known [regression][lr] in how object lifetime elision is
4655   interpreted, the proper solution for which is undetermined.
4656 * The `#[prelude_import]` attribute, an internal implementation
4657   detail, was accidentally stabilized previously. [It has been put
4658   behind the `prelude_import` feature gate][pi]. This change is
4659   believed to break no existing code.
4660 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4661   [more sane for dynamically sized types][dst3]. Code that relied on
4662   the previous behavior is thought to be broken.
4663 * The `dropck` rules, which checks that destructors can't access
4664   destroyed values, [have been updated][dropck] to match the
4665   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
4666   cause some previously-compiling code to no longer build.
4667
4668 Language
4669 --------
4670
4671 * The [new object lifetime defaults][nold] have been [turned
4672   on][nold2] after a cycle of warnings about the change.
4673 * Semicolons may [now follow types and paths in
4674   macros](https://github.com/rust-lang/rust/pull/27000).
4675 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4676   [more sane for dynamically sized types][dst3]. Code that relied on
4677   the previous behavior is not known to exist, and suspected to be
4678   broken.
4679 * `'static` variables [may now be recursive][st].
4680 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
4681   implementations correctly.
4682 * The `dropck` rules, which checks that destructors can't access
4683   destroyed values, [have been updated][dropck] to match the
4684   [RFC][dropckrfc].
4685
4686 Libraries
4687 ---------
4688
4689 * The [`Duration`] API, [has been stabilized][ds], as well as the
4690   `std::time` module, which presently contains only `Duration`.
4691 * `Box<str>` and `Box<[T]>` both implement `Clone`.
4692 * The owned C string, [`CString`], implements [`Borrow`] and the
4693   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
4694   these allow C strings to be borrowed and cloned in generic code.
4695 * [`CStr`] implements [`Debug`].
4696 * [`AtomicPtr`] implements [`Debug`].
4697 * [`Error`] trait objects [can be downcast to their concrete types][e]
4698   in many common configurations, using the [`is`], [`downcast`],
4699   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
4700   [`Any`] trait.
4701 * Searching for substrings now [employs the two-way algorithm][search]
4702   instead of doing a naive search. This gives major speedups to a
4703   number of methods, including [`contains`][sc], [`find`][sf],
4704   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
4705   [`ends_with`][sew] are also faster.
4706 * The performance of `PartialEq` for slices is [much faster][ps].
4707 * The [`Hash`] trait offers the default method, [`hash_slice`], which
4708   is overridden and optimized by the implementations for scalars.
4709 * The [`Hasher`] trait now has a number of specialized `write_*`
4710   methods for primitive types, for efficiency.
4711 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
4712   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
4713   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
4714   of [`std::error::Error::cause`][iec] also delegates to the inner
4715   error.
4716 * [`process::Child`][pc] gained the [`id`] method, which returns a
4717   `u32` representing the platform-specific process identifier.
4718 * The [`connect`] method on slices is deprecated, replaced by the new
4719   [`join`] method (note that both of these are on the *unstable*
4720   [`SliceConcatExt`] trait, but through the magic of the prelude are
4721   available to stable code anyway).
4722 * The [`Div`] operator is implemented for [`Wrapping`] types.
4723 * [`DerefMut` is implemented for `String`][dms].
4724 * Performance of SipHash (the default hasher for `HashMap`) is
4725   [better for long data][sh].
4726 * [`AtomicPtr`] implements [`Send`].
4727 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
4728   are now [specialized to use uninitialized buffers for increased
4729   performance][rte].
4730 * Lifetime parameters of foreign functions [are now resolved
4731   properly][f].
4732
4733 Misc
4734 ----
4735
4736 * Rust can now, with some coercion, [produce programs that run on
4737   Windows XP][xp], though XP is not considered a supported platform.
4738 * Porting Rust on Windows from the GNU toolchain to MSVC continues
4739   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
4740   recommended for use in 1.3, though should be fully-functional
4741   in the [64-bit 1.4 beta][b14].
4742 * On Fedora-based systems installation will [properly configure the
4743   dynamic linker][fl].
4744 * The compiler gained many new extended error descriptions, which can
4745   be accessed with the `--explain` flag.
4746 * The `dropck` pass, which checks that destructors can't access
4747   destroyed values, [has been rewritten][dropck]. This fixes some
4748   soundness holes, and as such will cause some previously-compiling
4749   code to no longer build.
4750 * `rustc` now uses [LLVM to write archive files where possible][ar].
4751   Eventually this will eliminate the compiler's dependency on the ar
4752   utility.
4753 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
4754   supported FreeBSD on x86_64).
4755 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
4756   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
4757   more strict.
4758 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
4759   will kill the process instead of leaking][nlp].
4760
4761 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
4762 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
4763 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
4764 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
4765 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
4766 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
4767 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
4768 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
4769 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
4770 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
4771 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
4772 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
4773 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
4774 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4775 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
4776 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
4777 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
4778 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
4779 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
4780 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
4781 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
4782 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
4783 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
4784 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
4785 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
4786 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
4787 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
4788 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
4789 [ar]: https://github.com/rust-lang/rust/pull/26926
4790 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
4791 [dms]: https://github.com/rust-lang/rust/pull/26241
4792 [dropck]: https://github.com/rust-lang/rust/pull/27261
4793 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
4794 [ds]: https://github.com/rust-lang/rust/pull/26818
4795 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
4796 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
4797 [dst3]: https://github.com/rust-lang/rust/pull/27351
4798 [e]: https://github.com/rust-lang/rust/pull/24793
4799 [f]: https://github.com/rust-lang/rust/pull/26588
4800 [fb]: https://github.com/rust-lang/rust/pull/26959
4801 [fl]: https://github.com/rust-lang/rust-installer/pull/41
4802 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
4803 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
4804 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
4805 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
4806 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
4807 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
4808 [lic]: https://github.com/rust-lang/rust/pull/26583
4809 [lnu]: https://github.com/rust-lang/rust/pull/27026
4810 [lr]: https://github.com/rust-lang/rust/issues/27248
4811 [lum]: https://github.com/rust-lang/rust/pull/26378
4812 [lur]: https://github.com/rust-lang/rust/pull/26783
4813 [nlp]: https://github.com/rust-lang/rust/pull/27176
4814 [nold2]: https://github.com/rust-lang/rust/pull/27045
4815 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
4816 [nom]: http://doc.rust-lang.org/nightly/nomicon/
4817 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
4818 [pi]: https://github.com/rust-lang/rust/pull/26699
4819 [ps]: https://github.com/rust-lang/rust/pull/26884
4820 [rte]: https://github.com/rust-lang/rust/pull/26950
4821 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
4822 [search]: https://github.com/rust-lang/rust/pull/26327
4823 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
4824 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
4825 [sh]: https://github.com/rust-lang/rust/pull/27280
4826 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
4827 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
4828 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
4829 [st]: https://github.com/rust-lang/rust/pull/26630
4830 [win1]: https://github.com/rust-lang/rust/pull/26569
4831 [win2]: https://github.com/rust-lang/rust/pull/26741
4832 [win3]: https://github.com/rust-lang/rust/pull/26741
4833 [win4]: https://github.com/rust-lang/rust/pull/27210
4834 [xp]: https://github.com/rust-lang/rust/pull/26569
4835
4836 Version 1.2.0 (2015-08-07)
4837 ==========================
4838
4839 * ~1200 changes, numerous bugfixes
4840
4841 Highlights
4842 ----------
4843
4844 * [Dynamically-sized-type coercions][dst] allow smart pointer types
4845   like `Rc` to contain types without a fixed size, arrays and trait
4846   objects, finally enabling use of `Rc<[T]>` and completing the
4847   implementation of DST.
4848 * [Parallel codegen][parcodegen] is now working again, which can
4849   substantially speed up large builds in debug mode; It also gets
4850   another ~33% speedup when bootstrapping on a 4 core machine (using 8
4851   jobs). It's not enabled by default, but will be "in the near
4852   future". It can be activated with the `-C codegen-units=N` flag to
4853   `rustc`.
4854 * This is the first release with [experimental support for linking
4855   with the MSVC linker and lib C on Windows (instead of using the GNU
4856   variants via MinGW)][win]. It is yet recommended only for the most
4857   intrepid Rustaceans.
4858 * Benchmark compilations are showing a 30% improvement in
4859   bootstrapping over 1.1.
4860
4861 Breaking Changes
4862 ----------------
4863
4864 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
4865   unicode case mapping, which is a previously-planned change in
4866   behavior and considered a bugfix.
4867 * [`mem::align_of`] now specifies [the *minimum alignment* for
4868   T][align], which is usually the alignment programs are interested
4869   in, and the same value reported by clang's
4870   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
4871   break real code.
4872 * [The `#[packed]` attribute is no longer silently accepted by the
4873   compiler][packed]. This attribute did nothing and code that
4874   mentioned it likely did not work as intended.
4875 * Associated type defaults are [now behind the
4876   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
4877   defaults *did not work*, but could be mentioned syntactically. As
4878   such this breakage has minimal impact.
4879
4880 Language
4881 --------
4882
4883 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
4884   matching against dereferenceable values.
4885
4886 Libraries
4887 ---------
4888
4889 * The [`Extend`] trait, which grows a collection from an iterator, is
4890   implemented over iterators of references, for `String`, `Vec`,
4891   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
4892   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
4893 * The [`iter::once`] function returns an iterator that yields a single
4894   element, and [`iter::empty`] returns an iterator that yields no
4895   elements.
4896 * The [`matches`] and [`rmatches`] methods on `str` return iterators
4897   over substring matches.
4898 * [`Cell`] and [`RefCell`] both implement `Eq`.
4899 * A number of methods for wrapping arithmetic are added to the
4900   integral types, [`wrapping_div`], [`wrapping_rem`],
4901   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
4902   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
4903   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
4904   type.. It is illegal for the default arithmetic operations in Rust
4905   to overflow; the desire to wrap must be explicit.
4906 * The `{:#?}` formatting specifier [displays the alternate,
4907   pretty-printed][debugfmt] form of the `Debug` formatter. This
4908   feature was actually introduced prior to 1.0 with little
4909   fanfare.
4910 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
4911   for writing data to formatted strings, similar to [`io::Write`].
4912 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
4913   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
4914   are used by code generators to emit implementations of [`Debug`].
4915 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
4916   methods that convert case, following Unicode case mapping.
4917 * It is now easier to handle poisoned locks. The [`PoisonError`]
4918   type, returned by failing lock operations, exposes `into_inner`,
4919   `get_ref`, and `get_mut`, which all give access to the inner lock
4920   guard, and allow the poisoned lock to continue to operate. The
4921   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
4922   poisoned lock without attempting to take the lock.
4923 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
4924   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
4925   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
4926   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
4927   `ChildStderr`.
4928 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
4929   malformed input.
4930
4931 Misc
4932 ----
4933
4934 * `rustc` employs smarter heuristics for guessing at [typos].
4935 * `rustc` emits more efficient code for [no-op conversions between
4936   unsafe pointers][nop].
4937 * Fat pointers are now [passed in pairs of immediate arguments][fat],
4938   resulting in faster compile times and smaller code.
4939
4940 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
4941 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4942 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
4943 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
4944 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
4945 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
4946 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
4947 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
4948 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
4949 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
4950 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
4951 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
4952 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
4953 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
4954 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
4955 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
4956 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
4957 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
4958 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
4959 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
4960 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
4961 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
4962 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
4963 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
4964 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
4965 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
4966 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
4967 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
4968 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
4969 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
4970 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
4971 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
4972 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
4973 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
4974 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
4975 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
4976 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
4977 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
4978 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
4979 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
4980 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
4981 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
4982 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
4983 [align]: https://github.com/rust-lang/rust/pull/25646
4984 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
4985 [typos]: https://github.com/rust-lang/rust/pull/26087
4986 [nop]: https://github.com/rust-lang/rust/pull/26336
4987 [fat]: https://github.com/rust-lang/rust/pull/26411
4988 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
4989 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
4990 [packed]: https://github.com/rust-lang/rust/pull/25541
4991 [ad]: https://github.com/rust-lang/rust/pull/27382
4992 [win]: https://github.com/rust-lang/rust/pull/25350
4993
4994 Version 1.1.0 (2015-06-25)
4995 =========================
4996
4997 * ~850 changes, numerous bugfixes
4998
4999 Highlights
5000 ----------
5001
5002 * The [`std::fs` module has been expanded][fs] to expand the set of
5003   functionality exposed:
5004   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5005     don't incur a syscall on some platforms.
5006   * A `symlink_metadata` function has been added.
5007   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5008     access to all underlying information.
5009 * The compiler now contains extended explanations of many errors. When an error
5010   with an explanation occurs the compiler suggests using the `--explain` flag
5011   to read the explanation. Error explanations are also [available online][err-index].
5012 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5013   well as other work, the time to bootstrap the compiler decreased by
5014   32%.
5015
5016 Libraries
5017 ---------
5018
5019 * The [`str::split_whitespace`] method splits a string on unicode
5020   whitespace boundaries.
5021 * On both Windows and Unix, new extension traits provide conversion of
5022   I/O types to and from the underlying system handles. On Unix, these
5023   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5024   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5025   `TcpListener`, and `UpdSocket`. Further implementations for
5026   `std::process` will be stabilized later.
5027 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5028   Windows, symlinks can be created with
5029   `std::os::windows::symlink_dir` and
5030   `std::os::windows::symlink_file`.
5031 * The `mpsc::Receiver` type can now be converted into an iterator with
5032   `into_iter` on the [`IntoIterator`] trait.
5033 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5034   implementation of the [`From`] trait.
5035 * The `Debug` implementation for `RangeFull` [creates output that is
5036   more consistent with other implementations][rf].
5037 * [`Debug` is implemented for `File`][file].
5038 * The `Default` implementation for `Arc` [no longer requires `Sync +
5039   Send`][arc].
5040 * [The `Iterator` methods `count`, `nth`, and `last` have been
5041   overridden for slices to have O(1) performance instead of O(n)][si].
5042 * Incorrect handling of paths on Windows has been improved in both the
5043   compiler and the standard library.
5044 * [`AtomicPtr` gained a `Default` implementation][ap].
5045 * In accordance with Rust's policy on arithmetic overflow `abs` now
5046   [panics on overflow when debug assertions are enabled][abs].
5047 * The [`Cloned`] iterator, which was accidentally left unstable for
5048   1.0 [has been stabilized][c].
5049 * The [`Incoming`] iterator, which iterates over incoming TCP
5050   connections, and which was accidentally unnamable in 1.0, [is now
5051   properly exported][inc].
5052 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5053   `sift_up` or `sift_down` panic][bh].
5054 * The [`split_off`] method of `LinkedList` [no longer corrupts
5055   the list in certain scenarios][ll].
5056
5057 Misc
5058 ----
5059
5060 * Type checking performance [has improved notably][sk] with
5061   [multiple improvements][pre].
5062 * The compiler [suggests code changes][ch] for more errors.
5063 * rustc and it's build system have experimental support for [building
5064   toolchains against MUSL][m] instead of glibc on Linux.
5065 * The compiler defines the `target_env` cfg value, which is used for
5066   distinguishing toolchains that are otherwise for the same
5067   platform. Presently this is set to `gnu` for common GNU Linux
5068   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5069 * The [`cargo rustc`][crc] command invokes a build with custom flags
5070   to rustc.
5071 * [Android executables are always position independent][pie].
5072 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5073   with `Drop`][drop].
5074
5075 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5076 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5077 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5078 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5079 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5080 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5081 [rf]: https://github.com/rust-lang/rust/pull/24491
5082 [err-index]: https://doc.rust-lang.org/error-index.html
5083 [sk]: https://github.com/rust-lang/rust/pull/24615
5084 [pre]: https://github.com/rust-lang/rust/pull/25323
5085 [file]: https://github.com/rust-lang/rust/pull/24598
5086 [ch]: https://github.com/rust-lang/rust/pull/24683
5087 [arc]: https://github.com/rust-lang/rust/pull/24695
5088 [si]: https://github.com/rust-lang/rust/pull/24701
5089 [ap]: https://github.com/rust-lang/rust/pull/24834
5090 [m]: https://github.com/rust-lang/rust/pull/24777
5091 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5092 [crc]: https://github.com/rust-lang/cargo/pull/1568
5093 [pie]: https://github.com/rust-lang/rust/pull/24953
5094 [abs]: https://github.com/rust-lang/rust/pull/25441
5095 [c]: https://github.com/rust-lang/rust/pull/25496
5096 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5097 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5098 [inc]: https://github.com/rust-lang/rust/pull/25522
5099 [bh]: https://github.com/rust-lang/rust/pull/25856
5100 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5101 [ll]: https://github.com/rust-lang/rust/pull/26022
5102 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5103 [drop]: https://github.com/rust-lang/rust/pull/24935
5104
5105 Version 1.0.0 (2015-05-15)
5106 ========================
5107
5108 * ~1500 changes, numerous bugfixes
5109
5110 Highlights
5111 ----------
5112
5113 * The vast majority of the standard library is now `#[stable]`. It is
5114   no longer possible to use unstable features with a stable build of
5115   the compiler.
5116 * Many popular crates on [crates.io] now work on the stable release
5117   channel.
5118 * Arithmetic on basic integer types now [checks for overflow in debug
5119   builds][overflow].
5120
5121 Language
5122 --------
5123
5124 * Several [restrictions have been added to trait coherence][coh] in
5125   order to make it easier for upstream authors to change traits
5126   without breaking downstream code.
5127 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5128   improve error messages and macro behavior. For example, `0b1234` is
5129   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5130 * Trait bounds [are always invariant][inv], eliminating the need for
5131   the `PhantomFn` and `MarkerTrait` lang items, which have been
5132   removed.
5133 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5134   "foo" as bar` syntax has been replaced with `extern crate foo as
5135   bar`, and Cargo now automatically translates "-" in *package* names
5136   to underscore for the crate name.
5137 * [Lifetime shadowing is an error][lt].
5138 * [`Send` no longer implies `'static`][send-rfc].
5139 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5140   `MyType::default()`.
5141 * Primitive types [now have inherent methods][prim-inherent],
5142   obviating the need for extension traits like `SliceExt`.
5143 * Methods with `Self: Sized` in their `where` clause are [considered
5144   object-safe][self-sized], allowing many extension traits like
5145   `IteratorExt` to be merged into the traits they extended.
5146 * You can now [refer to associated types][assoc-where] whose
5147   corresponding trait bounds appear only in a `where` clause.
5148 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5149   like `Send` and `Sync` are now library-defined.
5150 * A [Reflect trait][reflect] was introduced, which means that
5151   downcasting via the `Any` trait is effectively limited to concrete
5152   types. This helps retain the potentially-important "parametricity"
5153   property: generic code cannot behave differently for different type
5154   arguments except in minor ways.
5155 * The `unsafe_destructor` feature is now deprecated in favor of the
5156   [new `dropck`][dropck]. This change is a major reduction in unsafe
5157   code.
5158
5159 Libraries
5160 ---------
5161
5162 * The `thread_local` module [has been renamed to `std::thread`][th].
5163 * The methods of `IteratorExt` [have been moved to the `Iterator`
5164   trait itself][ie].
5165 * Several traits that implement Rust's conventions for type
5166   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5167   [centralized in the `std::convert` module][con].
5168 * The `FromError` trait [was removed in favor of `From`][fe].
5169 * The basic sleep function [has moved to
5170   `std::thread::sleep_ms`][slp].
5171 * The `splitn` function now takes an `n` parameter that represents the
5172   number of items yielded by the returned iterator [instead of the
5173   number of 'splits'][spl].
5174 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5175 * [Derived implementations of `PartialOrd` now order enums according
5176   to their explicitly-assigned discriminants][po].
5177 * [Methods for searching strings are generic over `Pattern`s][pat],
5178   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5179   some others.
5180 * [In method resolution, object methods are resolved before inherent
5181   methods][meth].
5182 * [`String::from_str` has been deprecated in favor of the `From` impl,
5183   `String::from`][sf].
5184 * [`io::Error` implements `Sync`][ios].
5185 * [The `words` method on `&str` has been replaced with
5186   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5187   a word?'
5188 * The new path and IO modules are complete and `#[stable]`. This
5189   was the major library focus for this cycle.
5190 * The path API was [revised][path-normalize] to normalize `.`,
5191   adjusting the tradeoffs in favor of the most common usage.
5192 * A large number of remaining APIs in `std` were also stabilized
5193   during this cycle; about 75% of the non-deprecated API surface
5194   is now stable.
5195 * The new [string pattern API][string-pattern] landed, which makes
5196   the string slice API much more internally consistent and flexible.
5197 * A new set of [generic conversion traits][conversion] replaced
5198   many existing ad hoc traits.
5199 * Generic numeric traits were [completely removed][num-traits]. This
5200   was made possible thanks to inherent methods for primitive types,
5201   and the removal gives maximal flexibility for designing a numeric
5202   hierarchy in the future.
5203 * The `Fn` traits are now related via [inheritance][fn-inherit]
5204   and provide ergonomic [blanket implementations][fn-blanket].
5205 * The `Index` and `IndexMut` traits were changed to
5206   [take the index by value][index-value], enabling code like
5207   `hash_map["string"]` to work.
5208 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5209   `Copy` data is known to be `Clone` as well.
5210
5211 Misc
5212 ----
5213
5214 * Many errors now have extended explanations that can be accessed with
5215   the `--explain` flag to `rustc`.
5216 * Many new examples have been added to the standard library
5217   documentation.
5218 * rustdoc has received a number of improvements focused on completion
5219   and polish.
5220 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5221 * Much headway was made on ecosystem-wide CI, making it possible
5222   to [compare builds for breakage][ci-compare].
5223
5224
5225 [crates.io]: http://crates.io
5226 [clo]: https://github.com/rust-lang/rust/pull/24034
5227 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5228 [con]: https://github.com/rust-lang/rust/pull/23875
5229 [cr]: https://github.com/rust-lang/rust/pull/23419
5230 [fe]: https://github.com/rust-lang/rust/pull/23879
5231 [ie]: https://github.com/rust-lang/rust/pull/23300
5232 [inv]: https://github.com/rust-lang/rust/pull/23938
5233 [ios]: https://github.com/rust-lang/rust/pull/24133
5234 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5235 [lt]: https://github.com/rust-lang/rust/pull/24057
5236 [meth]: https://github.com/rust-lang/rust/pull/24056
5237 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5238 [po]: https://github.com/rust-lang/rust/pull/24270
5239 [sf]: https://github.com/rust-lang/rust/pull/24517
5240 [slp]: https://github.com/rust-lang/rust/pull/23949
5241 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5242 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5243 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5244 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5245 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5246 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5247 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5248 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5249 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5250 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5251 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5252 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5253 [reflect]: https://github.com/rust-lang/rust/pull/23712
5254 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5255 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5256 [index-value]: https://github.com/rust-lang/rust/pull/23601
5257 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5258 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5259 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5260 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5261 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5262 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5263
5264
5265 Version 1.0.0-alpha.2 (2015-02-20)
5266 =====================================
5267
5268 * ~1300 changes, numerous bugfixes
5269
5270 * Highlights
5271
5272     * The various I/O modules were [overhauled][io-rfc] to reduce
5273       unnecessary abstractions and provide better interoperation with
5274       the underlying platform. The old `io` module remains temporarily
5275       at `std::old_io`.
5276     * The standard library now [participates in feature gating][feat],
5277       so use of unstable libraries now requires a `#![feature(...)]`
5278       attribute. The impact of this change is [described on the
5279       forum][feat-forum]. [RFC][feat-rfc].
5280
5281 * Language
5282
5283     * `for` loops [now operate on the `IntoIterator` trait][into],
5284       which eliminates the need to call `.iter()`, etc. to iterate
5285       over collections. There are some new subtleties to remember
5286       though regarding what sort of iterators various types yield, in
5287       particular that `for foo in bar { }` yields values from a move
5288       iterator, destroying the original collection. [RFC][into-rfc].
5289     * Objects now have [default lifetime bounds][obj], so you don't
5290       have to write `Box<Trait+'static>` when you don't care about
5291       storing references. [RFC][obj-rfc].
5292     * In types that implement `Drop`, [lifetimes must outlive the
5293       value][drop]. This will soon make it possible to safely
5294       implement `Drop` for types where `#[unsafe_destructor]` is now
5295       required. Read the [gorgeous RFC][drop-rfc] for details.
5296     * The fully qualified <T as Trait>::X syntax lets you set the Self
5297       type for a trait method or associated type. [RFC][ufcs-rfc].
5298     * References to types that implement `Deref<U>` now [automatically
5299       coerce to references][deref] to the dereferenced type `U`,
5300       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5301       should eliminate many unsightly uses of `&*`, as when converting
5302       from references to vectors into references to
5303       slices. [RFC][deref-rfc].
5304     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5305       `|:|`) is obsolete and closure kind is inferred from context.
5306     * [`Self` is a keyword][Self].
5307
5308 * Libraries
5309
5310     * The `Show` and `String` formatting traits [have been
5311       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5312       their related purposes. Automatically getting a string
5313       conversion to use with `format!("{:?}", something_to_debug)` is
5314       now written `#[derive(Debug)]`.
5315     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5316       OsStr}`, provide strings in platform-specific encodings for easier
5317       interop with system APIs. [RFC][osstr-rfc].
5318     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5319       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5320       creating raw pointers.
5321
5322 * Tooling
5323
5324     * Certain long error messages of the form 'expected foo found bar'
5325       are now [split neatly across multiple
5326       lines][multiline]. Examples in the PR.
5327     * On Unix Rust can be [uninstalled][un] by running
5328       `/usr/local/lib/rustlib/uninstall.sh`.
5329     * The `#[rustc_on_unimplemented]` attribute, requiring the
5330       'on_unimplemented' feature, lets rustc [display custom error
5331       messages when a trait is expected to be implemented for a type
5332       but is not][onun].
5333
5334 * Misc
5335
5336     * Rust is tested against a [LALR grammar][lalr], which parses
5337       almost all the Rust files that rustc does.
5338
5339 [boxraw]: https://github.com/rust-lang/rust/pull/21318
5340 [close]: https://github.com/rust-lang/rust/pull/21843
5341 [deref]: https://github.com/rust-lang/rust/pull/21351
5342 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
5343 [drop]: https://github.com/rust-lang/rust/pull/21972
5344 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5345 [feat]: https://github.com/rust-lang/rust/pull/21248
5346 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
5347 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
5348 [fmt]: https://github.com/rust-lang/rust/pull/21457
5349 [into]: https://github.com/rust-lang/rust/pull/20790
5350 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
5351 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5352 [lalr]: https://github.com/rust-lang/rust/pull/21452
5353 [multiline]: https://github.com/rust-lang/rust/pull/19870
5354 [obj]: https://github.com/rust-lang/rust/pull/22230
5355 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
5356 [onun]: https://github.com/rust-lang/rust/pull/20889
5357 [osstr]: https://github.com/rust-lang/rust/pull/21488
5358 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5359 [Self]: https://github.com/rust-lang/rust/pull/22158
5360 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
5361 [un]: https://github.com/rust-lang/rust/pull/22256
5362
5363
5364 Version 1.0.0-alpha (2015-01-09)
5365 ==================================
5366
5367   * ~2400 changes, numerous bugfixes
5368
5369   * Highlights
5370
5371     * The language itself is considered feature complete for 1.0,
5372       though there will be many usability improvements and bugfixes
5373       before the final release.
5374     * Nearly 50% of the public API surface of the standard library has
5375       been declared 'stable'. Those interfaces are unlikely to change
5376       before 1.0.
5377     * The long-running debate over integer types has been
5378       [settled][ints]: Rust will ship with types named `isize` and
5379       `usize`, rather than `int` and `uint`, for pointer-sized
5380       integers. Guidelines will be rolled out during the alpha cycle.
5381     * Most crates that are not `std` have been moved out of the Rust
5382       distribution into the Cargo ecosystem so they can evolve
5383       separately and don't need to be stabilized as quickly, including
5384       'time', 'getopts', 'num', 'regex', and 'term'.
5385     * Documentation continues to be expanded with more API coverage, more
5386       examples, and more in-depth explanations. The guides have been
5387       consolidated into [The Rust Programming Language][trpl].
5388     * "[Rust By Example][rbe]" is now maintained by the Rust team.
5389     * All official Rust binary installers now come with [Cargo], the
5390       Rust package manager.
5391
5392 * Language
5393
5394     * Closures have been [completely redesigned][unboxed] to be
5395       implemented in terms of traits, can now be used as generic type
5396       bounds and thus monomorphized and inlined, or via an opaque
5397       pointer (boxed) as in the old system. The new system is often
5398       referred to as 'unboxed' closures.
5399     * Traits now support [associated types][assoc], allowing families
5400       of related types to be defined together and used generically in
5401       powerful ways.
5402     * Enum variants are [namespaced by their type names][enum].
5403     * [`where` clauses][where] provide a more versatile and attractive
5404       syntax for specifying generic bounds, though the previous syntax
5405       remains valid.
5406     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
5407       numeric types.
5408     * Rust [no longer has a runtime][rt] of any description, and only
5409       supports OS threads, not green threads.
5410     * At long last, Rust has been overhauled for 'dynamically-sized
5411       types' ([DST]), which integrates 'fat pointers' (object types,
5412       arrays, and `str`) more deeply into the type system, making it
5413       more consistent.
5414     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
5415       `..j` that produce range types and which, when combined with the
5416       `Index` operator and multidispatch, leads to a convenient slice
5417       notation, `[i..j]`.
5418     * The new range syntax revealed an ambiguity in the fixed-length
5419       array syntax, so now fixed length arrays [are written `[T;
5420       N]`][arrays].
5421     * The `Copy` trait is no longer implemented automatically. Unsafe
5422       pointers no longer implement `Sync` and `Send` so types
5423       containing them don't automatically either. `Sync` and `Send`
5424       are now 'unsafe traits' so one can "forcibly" implement them via
5425       `unsafe impl` if a type confirms to the requirements for them
5426       even though the internals do not (e.g. structs containing unsafe
5427       pointers like `Arc`). These changes are intended to prevent some
5428       footguns and are collectively known as [opt-in built-in
5429       traits][oibit] (though `Sync` and `Send` will soon become pure
5430       library types unknown to the compiler).
5431     * Operator traits now take their operands [by value][ops], and
5432       comparison traits can use multidispatch to compare one type
5433       against multiple other types, allowing e.g. `String` to be
5434       compared with `&str`.
5435     * `if let` and `while let` are no longer feature-gated.
5436     * Rust has adopted a more [uniform syntax for escaping unicode
5437       characters][unicode].
5438     * `macro_rules!` [has been declared stable][mac]. Though it is a
5439       flawed system it is sufficiently popular that it must be usable
5440       for 1.0. Effort has gone into [future-proofing][mac-future] it
5441       in ways that will allow other macro systems to be developed in
5442       parallel, and won't otherwise impact the evolution of the
5443       language.
5444     * The prelude has been [pared back significantly][prelude] such
5445       that it is the minimum necessary to support the most pervasive
5446       code patterns, and through [generalized where clauses][where]
5447       many of the prelude extension traits have been consolidated.
5448     * Rust's rudimentary reflection [has been removed][refl], as it
5449       incurred too much code generation for little benefit.
5450     * [Struct variants][structvars] are no longer feature-gated.
5451     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
5452       known as 'higher-ranked trait bounds', this crucially allows
5453       unboxed closures to work.
5454     * Macros invocations surrounded by parens or square brackets and
5455       not terminated by a semicolon are [parsed as
5456       expressions][macros], which makes expressions like `vec![1i32,
5457       2, 3].len()` work as expected.
5458     * Trait objects now implement their traits automatically, and
5459       traits that can be coerced to objects now must be [object
5460       safe][objsafe].
5461     * Automatically deriving traits is now done with `#[derive(...)]`
5462       not `#[deriving(...)]` for [consistency with other naming
5463       conventions][derive].
5464     * Importing the containing module or enum at the same time as
5465       items or variants they contain is [now done with `self` instead
5466       of `mod`][self], as in use `foo::{self, bar}`
5467     * Glob imports are no longer feature-gated.
5468     * The `box` operator and `box` patterns have been feature-gated
5469       pending a redesign. For now unique boxes should be allocated
5470       like other containers, with `Box::new`.
5471
5472 * Libraries
5473
5474     * A [series][coll1] of [efforts][coll2] to establish
5475       [conventions][coll3] for collections types has resulted in API
5476       improvements throughout the standard library.
5477     * New [APIs for error handling][err] provide ergonomic interop
5478       between error types, and [new conventions][err-conv] describe
5479       more clearly the recommended error handling strategies in Rust.
5480     * The `fail!` macro has been renamed to [`panic!`][panic] so that
5481       it is easier to discuss failure in the context of error handling
5482       without making clarifications as to whether you are referring to
5483       the 'fail' macro or failure more generally.
5484     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
5485       syscall when available.
5486     * The 'serialize' crate has been renamed 'rustc-serialize' and
5487       moved out of the distribution to Cargo. Although it is widely
5488       used now, it is expected to be superseded in the near future.
5489     * The `Show` formatter, typically implemented with
5490       `#[derive(Show)]` is [now requested with the `{:?}`
5491       specifier][show] and is intended for use by all types, for uses
5492       such as `println!` debugging. The new `String` formatter must be
5493       implemented by hand, uses the `{}` specifier, and is intended
5494       for full-fidelity conversions of things that can logically be
5495       represented as strings.
5496
5497 * Tooling
5498
5499     * [Flexible target specification][flex] allows rustc's code
5500       generation to be configured to support otherwise-unsupported
5501       platforms.
5502     * Rust comes with rust-gdb and rust-lldb scripts that launch their
5503       respective debuggers with Rust-appropriate pretty-printing.
5504     * The Windows installation of Rust is distributed with the
5505       MinGW components currently required to link binaries on that
5506       platform.
5507
5508 * Misc
5509
5510     * Nullable enum optimizations have been extended to more types so
5511       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
5512       space than the inner types themselves.
5513     * Work has begun on supporting AArch64.
5514
5515 [Cargo]: https://crates.io
5516 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
5517 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
5518 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
5519 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
5520 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
5521 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
5522 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
5523 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
5524 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
5525 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
5526 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
5527 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
5528 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
5529 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
5530 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
5531 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
5532 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
5533 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
5534 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
5535 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
5536 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
5537 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
5538 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
5539 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
5540 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
5541 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
5542 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
5543 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
5544 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
5545 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
5546 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
5547 [trpl]: https://doc.rust-lang.org/book/index.html
5548 [rbe]: http://rustbyexample.com/
5549
5550
5551 Version 0.12.0 (2014-10-09)
5552 =============================
5553
5554   * ~1900 changes, numerous bugfixes
5555
5556   * Highlights
5557
5558     * The introductory documentation (now called The Rust Guide) has
5559       been completely rewritten, as have a number of supplementary
5560       guides.
5561     * Rust's package manager, Cargo, continues to improve and is
5562       sometimes considered to be quite awesome.
5563     * Many API's in `std` have been reviewed and updated for
5564       consistency with the in-development Rust coding
5565       guidelines. The standard library documentation tracks
5566       stabilization progress.
5567     * Minor libraries have been moved out-of-tree to the rust-lang org
5568       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
5569       be installed with Cargo.
5570     * Lifetime elision allows lifetime annotations to be left off of
5571       function declarations in many common scenarios.
5572     * Rust now works on 64-bit Windows.
5573
5574   * Language
5575     * Indexing can be overloaded with the `Index` and `IndexMut`
5576       traits.
5577     * The `if let` construct takes a branch only if the `let` pattern
5578       matches, currently behind the 'if_let' feature gate.
5579     * 'where clauses', a more flexible syntax for specifying trait
5580       bounds that is more aesthetic, have been added for traits and
5581       free functions. Where clauses will in the future make it
5582       possible to constrain associated types, which would be
5583       impossible with the existing syntax.
5584     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
5585       the 'slicing_syntax' feature gate, and can be overloaded with
5586       the `Slice` or `SliceMut` traits.
5587     * The syntax for matching of sub-slices has been changed to use a
5588       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
5589       consistency with other uses of `..` and to future-proof
5590       potential additional uses of the syntax.
5591     * The syntax for matching inclusive ranges in patterns has changed
5592       from `0..3` to `0...4` to be consistent with the exclusive range
5593       syntax for slicing.
5594     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
5595       c]`) has been put behind the 'advanced_slice_patterns' feature
5596       gate and may be removed in the future.
5597     * Components of tuples and tuple structs can be extracted using
5598       the `value.0` syntax, currently behind the `tuple_indexing`
5599       feature gate.
5600     * The `#[crate_id]` attribute is no longer supported; versioning
5601       is handled by the package manager.
5602     * Renaming crate imports are now written `extern crate foo as bar`
5603       instead of `extern crate bar = foo`.
5604     * Renaming use statements are now written `use foo as bar` instead
5605       of `use bar = foo`.
5606     * `let` and `match` bindings and argument names in macros are now
5607       hygienic.
5608     * The new, more efficient, closure types ('unboxed closures') have
5609       been added under a feature gate, 'unboxed_closures'. These will
5610       soon replace the existing closure types, once higher-ranked
5611       trait lifetimes are added to the language.
5612     * `move` has been added as a keyword, for indicating closures
5613       that capture by value.
5614     * Mutation and assignment is no longer allowed in pattern guards.
5615     * Generic structs and enums can now have trait bounds.
5616     * The `Share` trait is now called `Sync` to free up the term
5617       'shared' to refer to 'shared reference' (the default reference
5618       type.
5619     * Dynamically-sized types have been mostly implemented,
5620       unifying the behavior of fat-pointer types with the rest of the
5621       type system.
5622     * As part of dynamically-sized types, the `Sized` trait has been
5623       introduced, which qualifying types implement by default, and
5624       which type parameters expect by default. To specify that a type
5625       parameter does not need to be sized, write `<Sized? T>`. Most
5626       types are `Sized`, notable exceptions being unsized arrays
5627       (`[T]`) and trait types.
5628     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
5629     * Lifetime bounds can now be applied to type parameters and object
5630       types.
5631     * The old, reference counted GC type, `Gc<T>` which was once
5632       denoted by the `@` sigil, has finally been removed. GC will be
5633       revisited in the future.
5634
5635   * Libraries
5636     * Library documentation has been improved for a number of modules.
5637     * Bit-vectors, collections::bitv has been modernized.
5638     * The url crate is deprecated in favor of
5639       http://github.com/servo/rust-url, which can be installed with
5640       Cargo.
5641     * Most I/O stream types can be cloned and subsequently closed from
5642       a different thread.
5643     * A `std::time::Duration` type has been added for use in I/O
5644       methods that rely on timers, as well as in the 'time' crate's
5645       `Timespec` arithmetic.
5646     * The runtime I/O abstraction layer that enabled the green thread
5647       scheduler to do non-thread-blocking I/O has been removed, along
5648       with the libuv-based implementation employed by the green thread
5649       scheduler. This will greatly simplify the future I/O work.
5650     * `collections::btree` has been rewritten to have a more
5651       idiomatic and efficient design.
5652
5653   * Tooling
5654     * rustdoc output now indicates the stability levels of API's.
5655     * The `--crate-name` flag can specify the name of the crate
5656       being compiled, like `#[crate_name]`.
5657     * The `-C metadata` specifies additional metadata to hash into
5658       symbol names, and `-C extra-filename` specifies additional
5659       information to put into the output filename, for use by the
5660       package manager for versioning.
5661     * debug info generation has continued to improve and should be
5662       more reliable under both gdb and lldb.
5663     * rustc has experimental support for compiling in parallel
5664       using the `-C codegen-units` flag.
5665     * rustc no longer encodes rpath information into binaries by
5666       default.
5667
5668   * Misc
5669     * Stack usage has been optimized with LLVM lifetime annotations.
5670     * Official Rust binaries on Linux are more compatible with older
5671       kernels and distributions, built on CentOS 5.10.
5672
5673
5674 Version 0.11.0 (2014-07-02)
5675 ==========================
5676
5677   * ~1700 changes, numerous bugfixes
5678
5679   * Language
5680     * ~[T] has been removed from the language. This type is superseded by
5681       the Vec<T> type.
5682     * ~str has been removed from the language. This type is superseded by
5683       the String type.
5684     * ~T has been removed from the language. This type is superseded by the
5685       Box<T> type.
5686     * @T has been removed from the language. This type is superseded by the
5687       standard library's std::gc::Gc<T> type.
5688     * Struct fields are now all private by default.
5689     * Vector indices and shift amounts are both required to be a `uint`
5690       instead of any integral type.
5691     * Byte character, byte string, and raw byte string literals are now all
5692       supported by prefixing the normal literal with a `b`.
5693     * Multiple ABIs are no longer allowed in an ABI string
5694     * The syntax for lifetimes on closures/procedures has been tweaked
5695       slightly: `<'a>|A, B|: 'b + K -> T`
5696     * Floating point modulus has been removed from the language; however it
5697       is still provided by a library implementation.
5698     * Private enum variants are now disallowed.
5699     * The `priv` keyword has been removed from the language.
5700     * A closure can no longer be invoked through a &-pointer.
5701     * The `use foo, bar, baz;` syntax has been removed from the language.
5702     * The transmute intrinsic no longer works on type parameters.
5703     * Statics now allow blocks/items in their definition.
5704     * Trait bounds are separated from objects with + instead of : now.
5705     * Objects can no longer be read while they are mutably borrowed.
5706     * The address of a static is now marked as insignificant unless the
5707       #[inline(never)] attribute is placed it.
5708     * The #[unsafe_destructor] attribute is now behind a feature gate.
5709     * Struct literals are no longer allowed in ambiguous positions such as
5710       if, while, match, and for..in.
5711     * Declaration of lang items and intrinsics are now feature-gated by
5712       default.
5713     * Integral literals no longer default to `int`, and floating point
5714       literals no longer default to `f64`. Literals must be suffixed with an
5715       appropriate type if inference cannot determine the type of the
5716       literal.
5717     * The Box<T> type is no longer implicitly borrowed to &mut T.
5718     * Procedures are now required to not capture borrowed references.
5719
5720   * Libraries
5721     * The standard library is now a "facade" over a number of underlying
5722       libraries. This means that development on the standard library should
5723       be speedier due to smaller crates, as well as a clearer line between
5724       all dependencies.
5725     * A new library, libcore, lives under the standard library's facade
5726       which is Rust's "0-assumption" library, suitable for embedded and
5727       kernel development for example.
5728     * A regex crate has been added to the standard distribution. This crate
5729       includes statically compiled regular expressions.
5730     * The unwrap/unwrap_err methods on Result require a Show bound for
5731       better error messages.
5732     * The return types of the std::comm primitives have been centralized
5733       around the Result type.
5734     * A number of I/O primitives have gained the ability to time out their
5735       operations.
5736     * A number of I/O primitives have gained the ability to close their
5737       reading/writing halves to cancel pending operations.
5738     * Reverse iterator methods have been removed in favor of `rev()` on
5739       their forward-iteration counterparts.
5740     * A bitflags! macro has been added to enable easy interop with C and
5741       management of bit flags.
5742     * A debug_assert! macro is now provided which is disabled when
5743       `--cfg ndebug` is passed to the compiler.
5744     * A graphviz crate has been added for creating .dot files.
5745     * The std::cast module has been migrated into std::mem.
5746     * The std::local_data api has been migrated from freestanding functions
5747       to being based on methods.
5748     * The Pod trait has been renamed to Copy.
5749     * jemalloc has been added as the default allocator for types.
5750     * The API for allocating memory has been changed to use proper alignment
5751       and sized deallocation
5752     * Connecting a TcpStream or binding a TcpListener is now based on a
5753       string address and a u16 port. This allows connecting to a hostname as
5754       opposed to an IP.
5755     * The Reader trait now contains a core method, read_at_least(), which
5756       correctly handles many repeated 0-length reads.
5757     * The process-spawning API is now centered around a builder-style
5758       Command struct.
5759     * The :? printing qualifier has been moved from the standard library to
5760       an external libdebug crate.
5761     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
5762       have been renamed to Eq/Ord.
5763     * The select/plural methods have been removed from format!. The escapes
5764       for { and } have also changed from \{ and \} to {{ and }},
5765       respectively.
5766     * The TaskBuilder API has been re-worked to be a true builder, and
5767       extension traits for spawning native/green tasks have been added.
5768
5769   * Tooling
5770     * All breaking changes to the language or libraries now have their
5771       commit message annotated with `[breaking-change]` to allow for easy
5772       discovery of breaking changes.
5773     * The compiler will now try to suggest how to annotate lifetimes if a
5774       lifetime-related error occurs.
5775     * Debug info continues to be improved greatly with general bug fixes and
5776       better support for situations like link time optimization (LTO).
5777     * Usage of syntax extensions when cross-compiling has been fixed.
5778     * Functionality equivalent to GCC & Clang's -ffunction-sections,
5779       -fdata-sections and --gc-sections has been enabled by default
5780     * The compiler is now stricter about where it will load module files
5781       from when a module is declared via `mod foo;`.
5782     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
5783       Syntax extensions are now discovered via a "plugin registrar" type
5784       which will be extended in the future to other various plugins.
5785     * Lints have been restructured to allow for dynamically loadable lints.
5786     * A number of rustdoc improvements:
5787       * The HTML output has been visually redesigned.
5788       * Markdown is now powered by hoedown instead of sundown.
5789       * Searching heuristics have been greatly improved.
5790       * The search index has been reduced in size by a great amount.
5791       * Cross-crate documentation via `pub use` has been greatly improved.
5792       * Primitive types are now hyperlinked and documented.
5793     * Documentation has been moved from static.rust-lang.org/doc to
5794       doc.rust-lang.org
5795     * A new sandbox, play.rust-lang.org, is available for running and
5796       sharing rust code examples on-line.
5797     * Unused attributes are now more robustly warned about.
5798     * The dead_code lint now warns about unused struct fields.
5799     * Cross-compiling to iOS is now supported.
5800     * Cross-compiling to mipsel is now supported.
5801     * Stability attributes are now inherited by default and no longer apply
5802       to intra-crate usage, only inter-crate usage.
5803     * Error message related to non-exhaustive match expressions have been
5804       greatly improved.
5805
5806
5807 Version 0.10 (2014-04-03)
5808 =========================
5809
5810   * ~1500 changes, numerous bugfixes
5811
5812   * Language
5813     * A new RFC process is now in place for modifying the language.
5814     * Patterns with `@`-pointers have been removed from the language.
5815     * Patterns with unique vectors (`~[T]`) have been removed from the
5816       language.
5817     * Patterns with unique strings (`~str`) have been removed from the
5818       language.
5819     * `@str` has been removed from the language.
5820     * `@[T]` has been removed from the language.
5821     * `@self` has been removed from the language.
5822     * `@Trait` has been removed from the language.
5823     * Headers on `~` allocations which contain `@` boxes inside the type for
5824       reference counting have been removed.
5825     * The semantics around the lifetimes of temporary expressions have changed,
5826       see #3511 and #11585 for more information.
5827     * Cross-crate syntax extensions are now possible, but feature gated. See
5828       #11151 for more information. This includes both `macro_rules!` macros as
5829       well as syntax extensions such as `format!`.
5830     * New lint modes have been added, and older ones have been turned on to be
5831       warn-by-default.
5832       * Unnecessary parentheses
5833       * Uppercase statics
5834       * Camel Case types
5835       * Uppercase variables
5836       * Publicly visible private types
5837       * `#[deriving]` with raw pointers
5838     * Unsafe functions can no longer be coerced to closures.
5839     * Various obscure macros such as `log_syntax!` are now behind feature gates.
5840     * The `#[simd]` attribute is now behind a feature gate.
5841     * Visibility is no longer allowed on `extern crate` statements, and
5842       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
5843     * Trailing commas are now allowed in argument lists and tuple patterns.
5844     * The `do` keyword has been removed, it is now a reserved keyword.
5845     * Default type parameters have been implemented, but are feature gated.
5846     * Borrowed variables through captures in closures are now considered soundly.
5847     * `extern mod` is now `extern crate`
5848     * The `Freeze` trait has been removed.
5849     * The `Share` trait has been added for types that can be shared among
5850       threads.
5851     * Labels in macros are now hygienic.
5852     * Expression/statement macro invocations can be delimited with `{}` now.
5853     * Treatment of types allowed in `static mut` locations has been tweaked.
5854     * The `*` and `.` operators are now overloadable through the `Deref` and
5855       `DerefMut` traits.
5856     * `~Trait` and `proc` no longer have `Send` bounds by default.
5857     * Partial type hints are now supported with the `_` type marker.
5858     * An `Unsafe` type was introduced for interior mutability. It is now
5859       considered undefined to transmute from `&T` to `&mut T` without using the
5860       `Unsafe` type.
5861     * The #[linkage] attribute was implemented for extern statics/functions.
5862     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
5863     * `Pod` was renamed to `Copy`.
5864
5865   * Libraries
5866     * The `libextra` library has been removed. It has now been decomposed into
5867       component libraries with smaller and more focused nuggets of
5868       functionality. The full list of libraries can be found on the
5869       documentation index page.
5870     * std: `std::condition` has been removed. All I/O errors are now propagated
5871       through the `Result` type. In order to assist with error handling, a
5872       `try!` macro for unwrapping errors with an early return and a lint for
5873       unused results has been added. See #12039 for more information.
5874     * std: The `vec` module has been renamed to `slice`.
5875     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
5876       This will become the only growable vector in the future.
5877     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
5878       are now found at `std::io::BufferedReader` instead of
5879       `std::io::buffered::BufferedReader`.
5880     * std: `print` and `println` are no longer in the prelude, the `print!` and
5881       `println!` macros are intended to be used instead.
5882     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
5883       attempts to statically prevent cycles.
5884     * std: The standard distribution is adopting the policy of pushing failure
5885       to the user rather than failing in libraries. Many functions (such as
5886       `slice::last()`) now return `Option<T>` instead of `T` + failing.
5887     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
5888       deriving mode: `#[deriving(Show)]`.
5889     * std: `ToStr` is now implemented for all types implementing `Show`.
5890     * std: The formatting trait methods now take `&self` instead of `&T`
5891     * std: The `invert()` method on iterators has been renamed to `rev()`
5892     * std: `std::num` has seen a reduction in the genericity of its traits,
5893       consolidating functionality into a few core traits.
5894     * std: Backtraces are now printed on task failure if the environment
5895       variable `RUST_BACKTRACE` is present.
5896     * std: Naming conventions for iterators have been standardized. More details
5897       can be found on the wiki's style guide.
5898     * std: `eof()` has been removed from the `Reader` trait. Specific types may
5899       still implement the function.
5900     * std: Networking types are now cloneable to allow simultaneous reads/writes.
5901     * std: `assert_approx_eq!` has been removed
5902     * std: The `e` and `E` formatting specifiers for floats have been added to
5903       print them in exponential notation.
5904     * std: The `Times` trait has been removed
5905     * std: Indications of variance and opting out of builtin bounds is done
5906       through marker types in `std::kinds::marker` now
5907     * std: `hash` has been rewritten, `IterBytes` has been removed, and
5908       `#[deriving(Hash)]` is now possible.
5909     * std: `SharedChan` has been removed, `Sender` is now cloneable.
5910     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
5911     * std: `Chan::new` is now `channel()`.
5912     * std: A new synchronous channel type has been implemented.
5913     * std: A `select!` macro is now provided for selecting over `Receiver`s.
5914     * std: `hashmap` and `trie` have been moved to `libcollections`
5915     * std: `run` has been rolled into `io::process`
5916     * std: `assert_eq!` now uses `{}` instead of `{:?}`
5917     * std: The equality and comparison traits have seen some reorganization.
5918     * std: `rand` has moved to `librand`.
5919     * std: `to_{lower,upper}case` has been implemented for `char`.
5920     * std: Logging has been moved to `liblog`.
5921     * collections: `HashMap` has been rewritten for higher performance and less
5922       memory usage.
5923     * native: The default runtime is now `libnative`. If `libgreen` is desired,
5924       it can be booted manually. The runtime guide has more information and
5925       examples.
5926     * native: All I/O functionality except signals has been implemented.
5927     * green: Task spawning with `libgreen` has been optimized with stack caching
5928       and various trimming of code.
5929     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
5930     * sync: The `extra::sync` module has been updated to modern rust (and moved
5931       to the `sync` library), tweaking and improving various interfaces while
5932       dropping redundant functionality.
5933     * sync: A new `Barrier` type has been added to the `sync` library.
5934     * sync: An efficient mutex for native and green tasks has been implemented.
5935     * serialize: The `base64` module has seen some improvement. It treats
5936       newlines better, has non-string error values, and has seen general
5937       cleanup.
5938     * fourcc: A `fourcc!` macro was introduced
5939     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
5940       hexadecimal literal.
5941
5942   * Tooling
5943     * `rustpkg` has been deprecated and removed from the main repository. Its
5944       replacement, `cargo`, is under development.
5945     * Nightly builds of rust are now available
5946     * The memory usage of rustc has been improved many times throughout this
5947       release cycle.
5948     * The build process supports disabling rpath support for the rustc binary
5949       itself.
5950     * Code generation has improved in some cases, giving more information to the
5951       LLVM optimization passes to enable more extensive optimizations.
5952     * Debuginfo compatibility with lldb on OSX has been restored.
5953     * The master branch is now gated on an android bot, making building for
5954       android much more reliable.
5955     * Output flags have been centralized into one `--emit` flag.
5956     * Crate type flags have been centralized into one `--crate-type` flag.
5957     * Codegen flags have been consolidated behind a `-C` flag.
5958     * Linking against outdated crates now has improved error messages.
5959     * Error messages with lifetimes will often suggest how to annotate the
5960       function to fix the error.
5961     * Many more types are documented in the standard library, and new guides
5962       were written.
5963     * Many `rustdoc` improvements:
5964       * code blocks are syntax highlighted.
5965       * render standalone markdown files.
5966       * the --test flag tests all code blocks by default.
5967       * exported macros are displayed.
5968       * re-exported types have their documentation inlined at the location of the
5969         first re-export.
5970       * search works across crates that have been rendered to the same output
5971         directory.
5972
5973
5974 Version 0.9 (2014-01-09)
5975 ==========================
5976
5977    * ~1800 changes, numerous bugfixes
5978
5979    * Language
5980       * The `float` type has been removed. Use `f32` or `f64` instead.
5981       * A new facility for enabling experimental features (feature gating) has
5982         been added, using the crate-level `#[feature(foo)]` attribute.
5983       * Managed boxes (@) are now behind a feature gate
5984         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
5985         standard library's `Gc` or `Rc` types instead.
5986       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
5987       * Jumping back to the top of a loop is now done with `continue` instead of
5988         `loop`.
5989       * Strings can no longer be mutated through index assignment.
5990       * Raw strings can be created via the basic `r"foo"` syntax or with matched
5991         hash delimiters, as in `r###"foo"###`.
5992       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
5993         called once.
5994       * The `&fn` type is now written `|args| -> ret` to match the literal form.
5995       * `@fn`s have been removed.
5996       * `do` only works with procs in order to make it obvious what the cost
5997         of `do` is.
5998       * Single-element tuple-like structs can no longer be dereferenced to
5999         obtain the inner value. A more comprehensive solution for overloading
6000         the dereference operator will be provided in the future.
6001       * The `#[link(...)]` attribute has been replaced with
6002         `#[crate_id = "name#vers"]`.
6003       * Empty `impl`s must be terminated with empty braces and may not be
6004         terminated with a semicolon.
6005       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6006         no longer has any special meaning.
6007       * The old `fmt!` string formatting macro has been removed.
6008       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6009         `print!` and `println!`.
6010       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6011       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6012         `extern mod foo = "bar"` instead.
6013       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6014       * Macros can have attributes.
6015       * Macros can expand to items with attributes.
6016       * Macros can expand to multiple items.
6017       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6018       * Comments may be nested.
6019       * Values automatically coerce to trait objects they implement, without
6020         an explicit `as`.
6021       * Enum discriminants are no longer an entire word but as small as needed to
6022         contain all the variants. The `repr` attribute can be used to override
6023         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6024         `#[repr(C)]` to match C enums.
6025       * Non-string literals are not allowed in attributes (they never worked).
6026       * The FFI now supports variadic functions.
6027       * Octal numeric literals, as in `0o7777`.
6028       * The `concat!` syntax extension performs compile-time string concatenation.
6029       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6030         removed as Rust no longer uses segmented stacks.
6031       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6032       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6033         not `*`; ignoring remaining fields of a struct is also done with `..`,
6034         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6035       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6036       * `rustc` supports the "system" calling convention, which defaults to the
6037         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6038         "C" elsewhere.
6039       * The `type_overflow` lint (default: warn) checks literals for overflow.
6040       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6041       * The `attribute_usage` lint (default: warn) warns about unknown
6042         attributes.
6043       * The `unknown_features` lint (default: warn) warns about unknown
6044         feature gates.
6045       * The `dead_code` lint (default: warn) checks for dead code.
6046       * Rust libraries can be linked statically to one another
6047       * `#[link_args]` is behind the `link_args` feature gate.
6048       * Native libraries are now linked with `#[link(name = "foo")]`
6049       * Native libraries can be statically linked to a rust crate
6050         (`#[link(name = "foo", kind = "static")]`).
6051       * Native OS X frameworks are now officially supported
6052         (`#[link(name = "foo", kind = "framework")]`).
6053       * The `#[thread_local]` attribute creates thread-local (not task-local)
6054         variables. Currently behind the `thread_local` feature gate.
6055       * The `return` keyword may be used in closures.
6056       * Types that can be copied via a memcpy implement the `Pod` kind.
6057       * The `cfg` attribute can now be used on struct fields and enum variants.
6058
6059    * Libraries
6060       * std: The `option` and `result` API's have been overhauled to make them
6061         simpler, more consistent, and more composable.
6062       * std: The entire `std::io` module has been replaced with one that is
6063         more comprehensive and that properly interfaces with the underlying
6064         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6065         implemented.
6066       * std: `io::util` contains a number of useful implementations of
6067         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6068         `ZeroReader`, `TeeReader`.
6069       * std: The reference counted pointer type `extra::rc` moved into std.
6070       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6071         just a wrapper around it).
6072       * std: The `Either` type has been removed.
6073       * std: `fmt::Default` can be implemented for any type to provide default
6074         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6075       * std: The `rand` API continues to be tweaked.
6076       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6077         on failure in gdb, is now named `rust_fail`.
6078       * std: The `each_key` and `each_value` methods on `HashMap` have been
6079         replaced by the `keys` and `values` iterators.
6080       * std: Functions dealing with type size and alignment have moved from the
6081         `sys` module to the `mem` module.
6082       * std: The `path` module was written and API changed.
6083       * std: `str::from_utf8` has been changed to cast instead of allocate.
6084       * std: `starts_with` and `ends_with` methods added to vectors via the
6085         `ImmutableEqVector` trait, which is in the prelude.
6086       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6087         if the index is out of bounds.
6088       * std: Task failure no longer propagates between tasks, as the model was
6089         complex, expensive, and incompatible with thread-based tasks.
6090       * std: The `Any` type can be used for dynamic typing.
6091       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6092         `task::try`.
6093       * std: Methods that produce iterators generally do not have an `_iter`
6094         suffix now.
6095       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6096         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6097       * std: `util::ignore` renamed to `prelude::drop`.
6098       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6099         trait.
6100       * std: `vec::raw` has seen a lot of cleanup and API changes.
6101       * std: The standard library no longer includes any C++ code, and very
6102         minimal C, eliminating the dependency on libstdc++.
6103       * std: Runtime scheduling and I/O functionality has been factored out into
6104         extensible interfaces and is now implemented by two different crates:
6105         libnative, for native threading and I/O; and libgreen, for green threading
6106         and I/O. This paves the way for using the standard library in more limited
6107         embedded environments.
6108       * std: The `comm` module has been rewritten to be much faster, have a
6109         simpler, more consistent API, and to work for both native and green
6110         threading.
6111       * std: All libuv dependencies have been moved into the rustuv crate.
6112       * native: New implementations of runtime scheduling on top of OS threads.
6113       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6114         and other I/O.
6115       * green: The green thread scheduler and message passing types are almost
6116         entirely lock-free.
6117       * extra: The `flatpipes` module had bitrotted and was removed.
6118       * extra: All crypto functions have been removed and Rust now has a policy of
6119         not reimplementing crypto in the standard library. In the future crypto
6120         will be provided by external crates with bindings to established libraries.
6121       * extra: `c_vec` has been modernized.
6122       * extra: The `sort` module has been removed. Use the `sort` method on
6123         mutable slices.
6124
6125    * Tooling
6126       * The `rust` and `rusti` commands have been removed, due to lack of
6127         maintenance.
6128       * `rustdoc` was completely rewritten.
6129       * `rustdoc` can test code examples in documentation.
6130       * `rustpkg` can test packages with the argument, 'test'.
6131       * `rustpkg` supports arbitrary dependencies, including C libraries.
6132       * `rustc`'s support for generating debug info is improved again.
6133       * `rustc` has better error reporting for unbalanced delimiters.
6134       * `rustc`'s JIT support was removed due to bitrot.
6135       * Executables and static libraries can be built with LTO (-Z lto)
6136       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6137         build tools.
6138
6139
6140 Version 0.8 (2013-09-26)
6141 ============================
6142
6143    * ~2200 changes, numerous bugfixes
6144
6145    * Language
6146       * The `for` loop syntax has changed to work with the `Iterator` trait.
6147       * At long last, unwinding works on Windows.
6148       * Default methods are ready for use.
6149       * Many trait inheritance bugs fixed.
6150       * Owned and borrowed trait objects work more reliably.
6151       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6152       * rustc can omit emission of code for the `debug!` macro if it is passed
6153         `--cfg ndebug`
6154       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6155         for foo.rs, then foo/mod.rs, and will generate an error when both are
6156         present.
6157       * Strings no longer contain trailing nulls. The new `std::c_str` module
6158         provides new mechanisms for converting to C strings.
6159       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6160       * The FFI has been overhauled such that foreign functions are called directly,
6161         instead of through a stack-switching wrapper.
6162       * Calling a foreign function must be done through a Rust function with the
6163         `#[fixed_stack_segment]` attribute.
6164       * The `externfn!` macro can be used to declare both a foreign function and
6165         a `#[fixed_stack_segment]` wrapper at once.
6166       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6167       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6168       * `priv` is disallowed everywhere except for struct fields and enum variants.
6169       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6170       * `ref` bindings in irrefutable patterns work correctly now.
6171       * `char` is now prevented from containing invalid code points.
6172       * Casting to `bool` is no longer allowed.
6173       * `\0` is now accepted as an escape in chars and strings.
6174       * `yield` is a reserved keyword.
6175       * `typeof` is a reserved keyword.
6176       * Crates may be imported by URL with `extern mod foo = "url";`.
6177       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6178       * Static vectors can be initialized with repeating elements,
6179         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6180       * Static structs can be initialized with functional record update,
6181         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6182       * `cfg!` can be used to conditionally execute code based on the crate
6183         configuration, similarly to `#[cfg(...)]`.
6184       * The `unnecessary_qualification` lint detects unneeded module
6185         prefixes (default: allow).
6186       * Arithmetic operations have been implemented on the SIMD types in
6187         `std::unstable::simd`.
6188       * Exchange allocation headers were removed, reducing memory usage.
6189       * `format!` implements a completely new, extensible, and higher-performance
6190         string formatting system. It will replace `fmt!`.
6191       * `print!` and `println!` write formatted strings (using the `format!`
6192         extension) to stdout.
6193       * `write!` and `writeln!` write formatted strings (using the `format!`
6194         extension) to the new Writers in `std::rt::io`.
6195       * The library section in which a function or static is placed may
6196         be specified with `#[link_section = "..."]`.
6197       * The `proto!` syntax extension for defining bounded message protocols
6198         was removed.
6199       * `macro_rules!` is hygienic for `let` declarations.
6200       * The `#[export_name]` attribute specifies the name of a symbol.
6201       * `unreachable!` can be used to indicate unreachable code, and fails
6202         if executed.
6203
6204    * Libraries
6205       * std: Transitioned to the new runtime, written in Rust.
6206       * std: Added an experimental I/O library, `rt::io`, based on the new
6207         runtime.
6208       * std: A new generic `range` function was added to the prelude, replacing
6209         `uint::range` and friends.
6210       * std: `range_rev` no longer exists. Since range is an iterator it can be
6211         reversed with `range(lo, hi).invert()`.
6212       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6213         renamed to `unwrap_or`.
6214       * std: The `iterator` module was renamed to `iter`.
6215       * std: Integral types now support the `checked_add`, `checked_sub`, and
6216         `checked_mul` operations for detecting overflow.
6217       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6218         consistency.
6219       * std: Methods are standardizing on conventions for casting methods:
6220         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6221         and cheap casts.
6222       * std: The `CString` type in `c_str` provides new ways to convert to and
6223         from C strings.
6224       * std: `DoubleEndedIterator` can yield elements in two directions.
6225       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6226         two splices.
6227       * std: `str::from_bytes` renamed to `str::from_utf8`.
6228       * std: `pop_opt` and `shift_opt` methods added to vectors.
6229       * std: The task-local data interface no longer uses @, and keys are
6230         no longer function pointers.
6231       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6232       * std: Added `SharedPort` to `comm`.
6233       * std: `Eq` has a default method for `ne`; only `eq` is required
6234         in implementations.
6235       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6236         is required in implementations.
6237       * std: `is_utf8` performance is improved, impacting many string functions.
6238       * std: `os::MemoryMap` provides cross-platform mmap.
6239       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6240         are not 'in-bounds' are considered undefined.
6241       * std: Many freestanding functions in `vec` removed in favor of methods.
6242       * std: Many freestanding functions on scalar types removed in favor of
6243         methods.
6244       * std: Many options to task builders were removed since they don't make
6245         sense in the new scheduler design.
6246       * std: More containers implement `FromIterator` so can be created by the
6247         `collect` method.
6248       * std: More complete atomic types in `unstable::atomics`.
6249       * std: `comm::PortSet` removed.
6250       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6251         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6252         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6253         default implementations.
6254       * std: Various `from_str` functions were removed in favor of a generic
6255         `from_str` which is available in the prelude.
6256       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6257       * extra: `dlist`, the doubly-linked list was modernized.
6258       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6259       * extra: Added `glob` module, replacing `std::os::glob`.
6260       * extra: `rope` was removed.
6261       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6262       * extra: `net`, and `timer` were removed. The experimental replacements
6263         are `std::rt::io::net` and `std::rt::io::timer`.
6264       * extra: Iterators implemented for `SmallIntMap`.
6265       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6266       * extra: `SmallIntSet` removed. Use `BitvSet`.
6267       * extra: Performance of JSON parsing greatly improved.
6268       * extra: `semver` updated to SemVer 2.0.0.
6269       * extra: `term` handles more terminals correctly.
6270       * extra: `dbg` module removed.
6271       * extra: `par` module removed.
6272       * extra: `future` was cleaned up, with some method renames.
6273       * extra: Most free functions in `getopts` were converted to methods.
6274
6275    * Other
6276       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6277       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6278         similarly to gcc's `--march` flag.
6279       * rustc's performance compiling small crates is much better.
6280       * rustpkg has received many improvements.
6281       * rustpkg supports git tags as package IDs.
6282       * rustpkg builds into target-specific directories so it can be used for
6283         cross-compiling.
6284       * The number of concurrent test tasks is controlled by the environment
6285         variable RUST_TEST_TASKS.
6286       * The test harness can now report metrics for benchmarks.
6287       * All tools have man pages.
6288       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6289       * The runtime uses jemalloc for allocations.
6290       * Segmented stacks are temporarily disabled as part of the transition to
6291         the new runtime. Stack overflows are possible!
6292       * A new documentation backend, rustdoc_ng, is available for use. It is
6293         still invoked through the normal `rustdoc` command.
6294
6295
6296 Version 0.7 (2013-07-03)
6297 =======================
6298
6299    * ~2000 changes, numerous bugfixes
6300
6301    * Language
6302       * `impl`s no longer accept a visibility qualifier. Put them on methods
6303         instead.
6304       * The borrow checker has been rewritten with flow-sensitivity, fixing
6305         many bugs and inconveniences.
6306       * The `self` parameter no longer implicitly means `&'self self`,
6307         and can be explicitly marked with a lifetime.
6308       * Overloadable compound operators (`+=`, etc.) have been temporarily
6309         removed due to bugs.
6310       * The `for` loop protocol now requires `for`-iterators to return `bool`
6311         so they compose better.
6312       * The `Durable` trait is replaced with the `'static` bounds.
6313       * Trait default methods work more often.
6314       * Structs with the `#[packed]` attribute have byte alignment and
6315         no padding between fields.
6316       * Type parameters bound by `Copy` must now be copied explicitly with
6317         the `copy` keyword.
6318       * It is now illegal to move out of a dereferenced unsafe pointer.
6319       * `Option<~T>` is now represented as a nullable pointer.
6320       * `@mut` does dynamic borrow checks correctly.
6321       * The `main` function is only detected at the topmost level of the crate.
6322         The `#[main]` attribute is still valid anywhere.
6323       * Struct fields may no longer be mutable. Use inherited mutability.
6324       * The `#[no_send]` attribute makes a type that would otherwise be
6325         `Send`, not.
6326       * The `#[no_freeze]` attribute makes a type that would otherwise be
6327         `Freeze`, not.
6328       * Unbounded recursion will abort the process after reaching the limit
6329         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6330       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
6331         are never implicitly copyable.
6332       * `#[static_assert]` makes compile-time assertions about static bools.
6333       * At long last, 'argument modes' no longer exist.
6334       * The rarely used `use mod` statement no longer exists.
6335
6336    * Syntax extensions
6337       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
6338         argument list.
6339       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
6340         `Rand`, `Zero` and `ToStr` can all be automatically derived with
6341         `#[deriving(...)]`.
6342       * The `bytes!` macro returns a vector of bytes for string, u8, char,
6343         and unsuffixed integer literals.
6344
6345    * Libraries
6346       * The `core` crate was renamed to `std`.
6347       * The `std` crate was renamed to `extra`.
6348       * More and improved documentation.
6349       * std: `iterator` module for external iterator objects.
6350       * Many old-style (internal, higher-order function) iterators replaced by
6351         implementations of `Iterator`.
6352       * std: Many old internal vector and string iterators,
6353         incl. `any`, `all`. removed.
6354       * std: The `finalize` method of `Drop` renamed to `drop`.
6355       * std: The `drop` method now takes `&mut self` instead of `&self`.
6356       * std: The prelude no longer re-exports any modules, only types and traits.
6357       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
6358         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
6359       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
6360         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
6361       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
6362         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
6363       * std: Many types implement `Clone`.
6364       * std: `path` type renamed to `Path`.
6365       * std: `mut` module and `Mut` type removed.
6366       * std: Many standalone functions removed in favor of methods and iterators
6367         in `vec`, `str`. In the future methods will also work as functions.
6368       * std: `reinterpret_cast` removed. Use `transmute`.
6369       * std: ascii string handling in `std::ascii`.
6370       * std: `Rand` is implemented for ~/@.
6371       * std: `run` module for spawning processes overhauled.
6372       * std: Various atomic types added to `unstable::atomic`.
6373       * std: Various types implement `Zero`.
6374       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
6375       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
6376       * std: Added `os::mkdir_recursive`.
6377       * std: Added `os::glob` function performs filesystems globs.
6378       * std: `FuzzyEq` renamed to `ApproxEq`.
6379       * std: `Map` now defines `pop` and `swap` methods.
6380       * std: `Cell` constructors converted to static methods.
6381       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
6382       * extra: `flate` module moved from `std` to `extra`.
6383       * extra: `fileinput` module for iterating over a series of files.
6384       * extra: `Complex` number type and `complex` module.
6385       * extra: `Rational` number type and `rational` module.
6386       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
6387       * extra: `term` uses terminfo now, is more correct.
6388       * extra: `arc` functions converted to methods.
6389       * extra: Implementation of fixed output size variations of SHA-2.
6390
6391    * Tooling
6392       * `unused_variable`  lint mode for unused variables (default: warn).
6393       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
6394         (default: warn).
6395       * `unused_mut` lint mode for identifying unused `mut` qualifiers
6396         (default: warn).
6397       * `dead_assignment` lint mode for unread variables (default: warn).
6398       * `unnecessary_allocation` lint mode detects some heap allocations that are
6399         immediately borrowed so could be written without allocating (default: warn).
6400       * `missing_doc` lint mode (default: allow).
6401       * `unreachable_code` lint mode (default: warn).
6402       * The `rusti` command has been rewritten and a number of bugs addressed.
6403       * rustc outputs in color on more terminals.
6404       * rustc accepts a `--link-args` flag to pass arguments to the linker.
6405       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
6406       * Compiling with `-g` will make the binary record information about
6407         dynamic borrowcheck failures for debugging.
6408       * rustdoc has a nicer stylesheet.
6409       * Various improvements to rustdoc.
6410       * Improvements to rustpkg (see the detailed release notes).
6411
6412
6413 Version 0.6 (2013-04-03)
6414 ========================
6415
6416    * ~2100 changes, numerous bugfixes
6417
6418    * Syntax changes
6419       * The self type parameter in traits is now spelled `Self`
6420       * The `self` parameter in trait and impl methods must now be explicitly
6421         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
6422       * Static methods no longer require the `static` keyword and instead
6423         are distinguished by the lack of a `self` parameter
6424       * Replaced the `Durable` trait with the `'static` lifetime
6425       * The old closure type syntax with the trailing sigil has been
6426         removed in favor of the more consistent leading sigil
6427       * `super` is a keyword, and may be prefixed to paths
6428       * Trait bounds are separated with `+` instead of whitespace
6429       * Traits are implemented with `impl Trait for Type`
6430         instead of `impl Type: Trait`
6431       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
6432       * The `export` keyword has finally been removed
6433       * The `move` keyword has been removed (see "Semantic changes")
6434       * The interior mutability qualifier on vectors, `[mut T]`, has been
6435         removed. Use `&mut [T]`, etc.
6436       * `mut` is no longer valid in `~mut T`. Use inherited mutability
6437       * `fail` is no longer a keyword. Use `fail!()`
6438       * `assert` is no longer a keyword. Use `assert!()`
6439       * `log` is no longer a keyword. use `debug!`, etc.
6440       * 1-tuples may be represented as `(T,)`
6441       * Struct fields may no longer be `mut`. Use inherited mutability,
6442         `@mut T`, `core::mut` or `core::cell`
6443       * `extern mod { ... }` is no longer valid syntax for foreign
6444         function modules. Use extern blocks: `extern { ... }`
6445       * Newtype enums removed. Use tuple-structs.
6446       * Trait implementations no longer support visibility modifiers
6447       * Pattern matching over vectors improved and expanded
6448       * `const` renamed to `static` to correspond to lifetime name,
6449         and make room for future `static mut` unsafe mutable globals.
6450       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
6451       * `Clone` implementations can be automatically generated with
6452         `#[deriving(Clone)]`
6453       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
6454         instead of `foo as Bar`.
6455       * Fixed length vector types are now written as `[int, .. 3]`
6456         instead of `[int * 3]`.
6457       * Fixed length vector types can express the length as a constant
6458         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
6459
6460    * Semantic changes
6461       * Types with owned pointers or custom destructors move by default,
6462         eliminating the `move` keyword
6463       * All foreign functions are considered unsafe
6464       * &mut is now unaliasable
6465       * Writes to borrowed @mut pointers are prevented dynamically
6466       * () has size 0
6467       * The name of the main function can be customized using #[main]
6468       * The default type of an inferred closure is &fn instead of @fn
6469       * `use` statements may no longer be "chained" - they cannot import
6470         identifiers imported by previous `use` statements
6471       * `use` statements are crate relative, importing from the "top"
6472         of the crate by default. Paths may be prefixed with `super::`
6473         or `self::` to change the search behavior.
6474       * Method visibility is inherited from the implementation declaration
6475       * Structural records have been removed
6476       * Many more types can be used in static items, including enums
6477         'static-lifetime pointers and vectors
6478       * Pattern matching over vectors improved and expanded
6479       * Typechecking of closure types has been overhauled to
6480         improve inference and eliminate unsoundness
6481       * Macros leave scope at the end of modules, unless that module is
6482         tagged with #[macro_escape]
6483
6484    * Libraries
6485       * Added big integers to `std::bigint`
6486       * Removed `core::oldcomm` module
6487       * Added pipe-based `core::comm` module
6488       * Numeric traits have been reorganized under `core::num`
6489       * `vec::slice` finally returns a slice
6490       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
6491       * Containers reorganized around traits in `core::container`
6492       * `core::dvec` removed, `~[T]` is a drop-in replacement
6493       * `core::send_map` renamed to `core::hashmap`
6494       * `std::map` removed; replaced with `core::hashmap`
6495       * `std::treemap` reimplemented as an owned balanced tree
6496       * `std::deque` and `std::smallintmap` reimplemented as owned containers
6497       * `core::trie` added as a fast ordered map for integer keys
6498       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
6499       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
6500         overload the comparison operators, whereas `TotalOrd` is used
6501         by certain container types
6502
6503    * Other
6504       * Replaced the 'cargo' package manager with 'rustpkg'
6505       * Added all-purpose 'rust' tool
6506       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
6507       * rustc now *attempts* to offer spelling suggestions
6508       * Improved support for ARM and Android
6509       * Preliminary MIPS backend
6510       * Improved foreign function ABI implementation for x86, x86_64
6511       * Various memory usage improvements
6512       * Rust code may be embedded in foreign code under limited circumstances
6513       * Inline assembler supported by new asm!() syntax extension.
6514
6515
6516 Version 0.5 (2012-12-21)
6517 ===========================
6518
6519    * ~900 changes, numerous bugfixes
6520
6521    * Syntax changes
6522       * Removed `<-` move operator
6523       * Completed the transition from the `#fmt` extension syntax to `fmt!`
6524       * Removed old fixed length vector syntax - `[T]/N`
6525       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
6526       * Macros may now expand to items and statements
6527       * `a.b()` is always parsed as a method call, never as a field projection
6528       * `Eq` and `IterBytes` implementations can be automatically generated
6529         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
6530       * Removed the special crate language for `.rc` files
6531       * Function arguments may consist of any irrefutable pattern
6532
6533    * Semantic changes
6534       * `&` and `~` pointers may point to objects
6535       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
6536       * Enum variants may be structs
6537       * Destructors can be added to all nominal types with the Drop trait
6538       * Structs and nullary enum variants may be constants
6539       * Values that cannot be implicitly copied are now automatically moved
6540         without writing `move` explicitly
6541       * `&T` may now be coerced to `*T`
6542       * Coercions happen in `let` statements as well as function calls
6543       * `use` statements now take crate-relative paths
6544       * The module and type namespaces have been merged so that static
6545         method names can be resolved under the trait in which they are
6546         declared
6547
6548    * Improved support for language features
6549       * Trait inheritance works in many scenarios
6550       * More support for explicit self arguments in methods - `self`, `&self`
6551         `@self`, and `~self` all generally work as expected
6552       * Static methods work in more situations
6553       * Experimental: Traits may declare default methods for the implementations
6554         to use
6555
6556    * Libraries
6557       * New condition handling system in `core::condition`
6558       * Timsort added to `std::sort`
6559       * New priority queue, `std::priority_queue`
6560       * Pipes for serializable types, `std::flatpipes'
6561       * Serialization overhauled to be trait-based
6562       * Expanded `getopts` definitions
6563       * Moved futures to `std`
6564       * More functions are pure now
6565       * `core::comm` renamed to `oldcomm`. Still deprecated
6566       * `rustdoc` and `cargo` are libraries now
6567
6568    * Misc
6569       * Added a preliminary REPL, `rusti`
6570       * License changed from MIT to dual MIT/APL2
6571
6572
6573 Version 0.4 (2012-10-15)
6574 ==========================
6575
6576    * ~2000 changes, numerous bugfixes
6577
6578    * Syntax
6579       * All keywords are now strict and may not be used as identifiers anywhere
6580       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
6581         'of', 'with', 'to', 'class'.
6582       * Classes are replaced with simpler structs
6583       * Explicit method self types
6584       * `ret` became `return` and `alt` became `match`
6585       * `import` is now `use`; `use is now `extern mod`
6586       * `extern mod { ... }` is now `extern { ... }`
6587       * `use mod` is the recommended way to import modules
6588       * `pub` and `priv` replace deprecated export lists
6589       * The syntax of `match` pattern arms now uses fat arrow (=>)
6590       * `main` no longer accepts an args vector; use `os::args` instead
6591
6592    * Semantics
6593       * Trait implementations are now coherent, ala Haskell typeclasses
6594       * Trait methods may be static
6595       * Argument modes are deprecated
6596       * Borrowed pointers are much more mature and recommended for use
6597       * Strings and vectors in the static region are stored in constant memory
6598       * Typestate was removed
6599       * Resolution rewritten to be more reliable
6600       * Support for 'dual-mode' data structures (freezing and thawing)
6601
6602    * Libraries
6603       * Most binary operators can now be overloaded via the traits in
6604         `core::ops'
6605       * `std::net::url` for representing URLs
6606       * Sendable hash maps in `core::send_map`
6607       * `core::task' gained a (currently unsafe) task-local storage API
6608
6609    * Concurrency
6610       * An efficient new intertask communication primitive called the pipe,
6611         along with a number of higher-level channel types, in `core::pipes`
6612       * `std::arc`, an atomically reference counted, immutable, shared memory
6613         type
6614       * `std::sync`, various exotic synchronization tools based on arcs and pipes
6615       * Futures are now based on pipes and sendable
6616       * More robust linked task failure
6617       * Improved task builder API
6618
6619    * Other
6620       * Improved error reporting
6621       * Preliminary JIT support
6622       * Preliminary work on precise GC
6623       * Extensive architectural improvements to rustc
6624       * Begun a transition away from buggy C++-based reflection (shape) code to
6625         Rust-based (visitor) code
6626       * All hash functions and tables converted to secure, randomized SipHash
6627
6628
6629 Version 0.3  (2012-07-12)
6630 ========================
6631
6632    * ~1900 changes, numerous bugfixes
6633
6634    * New coding conveniences
6635       * Integer-literal suffix inference
6636       * Per-item control over warnings, errors
6637       * #[cfg(windows)] and #[cfg(unix)] attributes
6638       * Documentation comments
6639       * More compact closure syntax
6640       * 'do' expressions for treating higher-order functions as
6641         control structures
6642       * *-patterns (wildcard extended to all constructor fields)
6643
6644    * Semantic cleanup
6645       * Name resolution pass and exhaustiveness checker rewritten
6646       * Region pointers and borrow checking supersede alias
6647         analysis
6648       * Init-ness checking is now provided by a region-based liveness
6649         pass instead of the typestate pass; same for last-use analysis
6650       * Extensive work on region pointers
6651
6652    * Experimental new language features
6653       * Slices and fixed-size, interior-allocated vectors
6654       * #!-comments for lang versioning, shell execution
6655       * Destructors and iface implementation for classes;
6656         type-parameterized classes and class methods
6657       * 'const' type kind for types that can be used to implement
6658         shared-memory concurrency patterns
6659
6660    * Type reflection
6661
6662    * Removal of various obsolete features
6663       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
6664                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
6665
6666       * Constructs: do-while loops ('do' repurposed), fn binding,
6667                     resources (replaced by destructors)
6668
6669    * Compiler reorganization
6670       * Syntax-layer of compiler split into separate crate
6671       * Clang (from LLVM project) integrated into build
6672       * Typechecker split into sub-modules
6673
6674    * New library code
6675       * New time functions
6676       * Extension methods for many built-in types
6677       * Arc: atomic-refcount read-only / exclusive-use shared cells
6678       * Par: parallel map and search routines
6679       * Extensive work on libuv interface
6680       * Much vector code moved to libraries
6681       * Syntax extensions: #line, #col, #file, #mod, #stringify,
6682         #include, #include_str, #include_bin
6683
6684    * Tool improvements
6685       * Cargo automatically resolves dependencies
6686
6687
6688 Version 0.2  (2012-03-29)
6689 =========================
6690
6691    * >1500 changes, numerous bugfixes
6692
6693    * New docs and doc tooling
6694
6695    * New port: FreeBSD x86_64
6696
6697    * Compilation model enhancements
6698       * Generics now specialized, multiply instantiated
6699       * Functions now inlined across separate crates
6700
6701    * Scheduling, stack and threading fixes
6702       * Noticeably improved message-passing performance
6703       * Explicit schedulers
6704       * Callbacks from C
6705       * Helgrind clean
6706
6707    * Experimental new language features
6708       * Operator overloading
6709       * Region pointers
6710       * Classes
6711
6712    * Various language extensions
6713       * C-callback function types: 'crust fn ...'
6714       * Infinite-loop construct: 'loop { ... }'
6715       * Shorten 'mutable' to 'mut'
6716       * Required mutable-local qualifier: 'let mut ...'
6717       * Basic glob-exporting: 'export foo::*;'
6718       * Alt now exhaustive, 'alt check' for runtime-checked
6719       * Block-function form of 'for' loop, with 'break' and 'ret'.
6720
6721    * New library code
6722       * AST quasi-quote syntax extension
6723       * Revived libuv interface
6724       * New modules: core::{future, iter}, std::arena
6725       * Merged per-platform std::{os*, fs*} to core::{libc, os}
6726       * Extensive cleanup, regularization in libstd, libcore
6727
6728
6729 Version 0.1  (2012-01-20)
6730 ===============================
6731
6732    * Most language features work, including:
6733       * Unique pointers, unique closures, move semantics
6734       * Interface-constrained generics
6735       * Static interface dispatch
6736       * Stack growth
6737       * Multithread task scheduling
6738       * Typestate predicates
6739       * Failure unwinding, destructors
6740       * Pattern matching and destructuring assignment
6741       * Lightweight block-lambda syntax
6742       * Preliminary macro-by-example
6743
6744    * Compiler works with the following configurations:
6745       * Linux: x86 and x86_64 hosts and targets
6746       * macOS: x86 and x86_64 hosts and targets
6747       * Windows: x86 hosts and targets
6748
6749    * Cross compilation / multi-target configuration supported.
6750
6751    * Preliminary API-documentation and package-management tools included.
6752
6753 Known issues:
6754
6755    * Documentation is incomplete.
6756
6757    * Performance is below intended target.
6758
6759    * Standard library APIs are subject to extensive change, reorganization.
6760
6761    * Language-level versioning is not yet operational - future code will
6762      break unexpectedly.