]> git.proxmox.com Git - rustc.git/blame - RELEASES.md
New upstream version 1.52.1+dfsg1
[rustc.git] / RELEASES.md
CommitLineData
f20569fa
XL
1Version 1.52.1 (2021-05-10)
2============================
3
4This release disables incremental compilation, unless the user has explicitly
5opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
6
7This is due to the widespread, and frequently occuring, breakage encountered by
8Rust users due to newly enabled incremental verification in 1.52.0. Notably,
9Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
10newly added incremental verification are still present in past stable versions,
11and are not yet fixed on any channel. These bugs can lead to miscompilation of
12Rust binaries.
13
14These problems only affect incremental builds, so release builds with Cargo
15should not be affected unless the user has explicitly opted into incremental.
16Debug and check builds are affected.
17
18See [84970] for more details.
19
20[84970]: https://github.com/rust-lang/rust/issues/84970
21
36d6ef2b
XL
22Version 1.52.0 (2021-05-06)
23============================
24
25Language
26--------
27- [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
28 in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
29 is allowed by default, and may become a warning or hard error in a
30 future edition.
31- [You can now cast mutable references to arrays to a pointer of the same type as
32 the element.][81479]
33
34Compiler
35--------
36- [Upgraded the default LLVM to LLVM 12.][81451]
37
38Added tier 3\* support for the following targets.
39
40- [`s390x-unknown-linux-musl`][82166]
41- [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
42- [`powerpc-unknown-openbsd`][82733]
43
44\* Refer to Rust's [platform support page][platform-support-doc] for more
45information on Rust's tiered platform support.
46
47Libraries
48---------
49- [`OsString` now implements `Extend` and `FromIterator`.][82121]
50- [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
51- [`Arc<impl Error>` now implements `error::Error`.][80553]
52- [All integer division and remainder operations are now `const`.][80962]
53
54Stabilised APIs
55-------------
56- [`Arguments::as_str`]
57- [`char::MAX`]
58- [`char::REPLACEMENT_CHARACTER`]
59- [`char::UNICODE_VERSION`]
60- [`char::decode_utf16`]
61- [`char::from_digit`]
62- [`char::from_u32_unchecked`]
63- [`char::from_u32`]
64- [`slice::partition_point`]
65- [`str::rsplit_once`]
66- [`str::split_once`]
67
68The following previously stable APIs are now `const`.
69
70- [`char::len_utf8`]
71- [`char::len_utf16`]
72- [`char::to_ascii_uppercase`]
73- [`char::to_ascii_lowercase`]
74- [`char::eq_ignore_ascii_case`]
75- [`u8::to_ascii_uppercase`]
76- [`u8::to_ascii_lowercase`]
77- [`u8::eq_ignore_ascii_case`]
78
79Rustdoc
80-------
81- [Rustdoc lints are now treated as a tool lint, meaning that
82 lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::non_autolinks)]`).][80527]
83 Using the old style is still allowed, and will become a warning in
84 a future release.
85- [Rustdoc now supports argument files.][82261]
86- [Rustdoc now generates smart punctuation for documentation.][79423]
87- [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
88 ```markdown
89 - [x] Complete
90 - [ ] Todo
91 ```
92
93Misc
94----
95- [You can now pass multiple filters to tests.][81356] E.g.
96 `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
97- [Rustup now distributes PDB symbols for the `std` library on Windows,
98 allowing you to see `std` symbols when debugging.][82218]
99
100Internal Only
101-------------
102These changes provide no direct user facing benefits, but represent significant
103improvements to the internals and overall performance of rustc and
104related tools.
105
106- [Check the result cache before the DepGraph when ensuring queries][81855]
107- [Try fast_reject::simplify_type in coherence before doing full check][81744]
108- [Only store a LocalDefId in some HIR nodes][81611]
109- [Store HIR attributes in a side table][79519]
110
111Compatibility Notes
112-------------------
113- [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
114- [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
115- [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
116- [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
117 languages in code blocks.][78429]
118- [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
119- [Changes in how proc macros handle whitespace may lead to panics when used
120 with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
121
122[84136]: https://github.com/rust-lang/rust/issues/84136
123[80763]: https://github.com/rust-lang/rust/pull/80763
124[82166]: https://github.com/rust-lang/rust/pull/82166
125[82121]: https://github.com/rust-lang/rust/pull/82121
126[81879]: https://github.com/rust-lang/rust/pull/81879
127[82261]: https://github.com/rust-lang/rust/pull/82261
128[82218]: https://github.com/rust-lang/rust/pull/82218
129[82216]: https://github.com/rust-lang/rust/pull/82216
130[82202]: https://github.com/rust-lang/rust/pull/82202
131[81855]: https://github.com/rust-lang/rust/pull/81855
132[81766]: https://github.com/rust-lang/rust/pull/81766
133[81744]: https://github.com/rust-lang/rust/pull/81744
134[81611]: https://github.com/rust-lang/rust/pull/81611
135[81479]: https://github.com/rust-lang/rust/pull/81479
136[81451]: https://github.com/rust-lang/rust/pull/81451
137[81356]: https://github.com/rust-lang/rust/pull/81356
138[80962]: https://github.com/rust-lang/rust/pull/80962
139[80553]: https://github.com/rust-lang/rust/pull/80553
140[80527]: https://github.com/rust-lang/rust/pull/80527
141[79519]: https://github.com/rust-lang/rust/pull/79519
142[79423]: https://github.com/rust-lang/rust/pull/79423
143[79208]: https://github.com/rust-lang/rust/pull/79208
144[78429]: https://github.com/rust-lang/rust/pull/78429
145[82733]: https://github.com/rust-lang/rust/pull/82733
146[82594]: https://github.com/rust-lang/rust/pull/82594
147[cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
148[`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
149[`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
150[`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
151[`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
152[`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
153[`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
154[`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
155[`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
156[`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
157[`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
158[`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
159[`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
160[`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
161[`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
162[`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
163[`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
164[`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
165[`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
166[`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
167[`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
168[`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
169
170Version 1.51.0 (2021-03-25)
171============================
172
173Language
174--------
175- [You can now parameterize items such as functions, traits, and `struct`s by constant
176 values in addition to by types and lifetimes.][79135] Also known as "const generics"
177 E.g. you can now write the following. Note: Only values of primitive integers,
178 `bool`, or `char` types are currently permitted.
179 ```rust
180 struct GenericArray<T, const LENGTH: usize> {
181 inner: [T; LENGTH]
182 }
183
184 impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
185 const fn last(&self) -> Option<&T> {
186 if LENGTH == 0 {
187 None
188 } else {
189 Some(&self.inner[LENGTH - 1])
190 }
191 }
192 }
193 ```
194
195
196Compiler
197--------
198
199- [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
200 This option controls whether debug information is split across multiple files
201 or packed into a single file. **Note** This option is unstable on other platforms.
202- [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
203 `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
204- [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
205- [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
206
207\* Refer to Rust's [platform support page][platform-support-doc] for more
208information on Rust's tiered platform support.
209
210Libraries
211---------
212
213- [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
214- [`str` now implements `AsMut<str>`.][80279]
215- [`u64` and `u128` now implement `From<char>`.][79502]
216- [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
217- [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
218- [`unsigned_abs` is now implemented for all signed integer types.][80959]
219- [`io::Empty` now implements `io::Seek`.][78044]
220- [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
221 `T: ?Sized` types.][80764]
222- [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
223
224
225Stabilized APIs
226---------------
227
228- [`Arc::decrement_strong_count`]
229- [`Arc::increment_strong_count`]
230- [`Once::call_once_force`]
231- [`Peekable::next_if_eq`]
232- [`Peekable::next_if`]
233- [`Seek::stream_position`]
234- [`array::IntoIter`]
235- [`panic::panic_any`]
236- [`ptr::addr_of!`]
237- [`ptr::addr_of_mut!`]
238- [`slice::fill_with`]
239- [`slice::split_inclusive_mut`]
240- [`slice::split_inclusive`]
241- [`slice::strip_prefix`]
242- [`slice::strip_suffix`]
243- [`str::split_inclusive`]
244- [`sync::OnceState`]
245- [`task::Wake`]
246- [`VecDeque::range`]
247- [`VecDeque::range_mut`]
248
249Cargo
250-----
251- [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
252 codegen option.][cargo/9112]
253- [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
254 and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
255 to avoid unifying features of dependencies where that unification could be unwanted.
256 Such as using the same dependency with a `std` feature in a build scripts and
257 proc-macros, while using the `no-std` feature in the final binary. See the
258 [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
259
260Rustdoc
261-------
262
263- [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
264- [You can now provide a `--default-theme` flag which sets the default theme to use for
265 documentation.][79642]
266
267Various improvements to intra-doc links:
268
269- [You can link to non-path primitives such as `slice`.][80181]
270- [You can link to associated items.][74489]
271- [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
272
273Misc
274----
275- [You can now pass `--include-ignored` to tests (e.g. with
276 `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
277
278Compatibility Notes
279-------------------
280
281- [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
282- [`rustc` no longer promotes division, modulo and indexing operations to `const` that
283 could fail.][80579]
284- [The minimum version of glibc for the following platforms has been bumped to version 2.31
285 for the distributed artifacts.][81521]
286 - `armv5te-unknown-linux-gnueabi`
287 - `sparc64-unknown-linux-gnu`
288 - `thumbv7neon-unknown-linux-gnueabihf`
289 - `armv7-unknown-linux-gnueabi`
290 - `x86_64-unknown-linux-gnux32`
291- [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
292
293Internal Only
294-------------
295
296- [Consistently avoid constructing optimized MIR when not doing codegen][80718]
297
298[79135]: https://github.com/rust-lang/rust/pull/79135
299[74489]: https://github.com/rust-lang/rust/pull/74489
300[76934]: https://github.com/rust-lang/rust/pull/76934
301[79570]: https://github.com/rust-lang/rust/pull/79570
302[80181]: https://github.com/rust-lang/rust/pull/80181
303[79642]: https://github.com/rust-lang/rust/pull/79642
304[80945]: https://github.com/rust-lang/rust/pull/80945
305[80279]: https://github.com/rust-lang/rust/pull/80279
306[80053]: https://github.com/rust-lang/rust/pull/80053
307[79502]: https://github.com/rust-lang/rust/pull/79502
308[75180]: https://github.com/rust-lang/rust/pull/75180
309[79135]: https://github.com/rust-lang/rust/pull/79135
310[81521]: https://github.com/rust-lang/rust/pull/81521
311[80968]: https://github.com/rust-lang/rust/pull/80968
312[80959]: https://github.com/rust-lang/rust/pull/80959
313[80718]: https://github.com/rust-lang/rust/pull/80718
314[80653]: https://github.com/rust-lang/rust/pull/80653
315[80579]: https://github.com/rust-lang/rust/pull/80579
316[79998]: https://github.com/rust-lang/rust/pull/79998
317[78044]: https://github.com/rust-lang/rust/pull/78044
318[81455]: https://github.com/rust-lang/rust/pull/81455
319[80764]: https://github.com/rust-lang/rust/pull/80764
320[80749]: https://github.com/rust-lang/rust/pull/80749
321[80662]: https://github.com/rust-lang/rust/pull/80662
322[79134]: https://github.com/rust-lang/rust/pull/79134
323[80966]: https://github.com/rust-lang/rust/pull/80966
324[cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
325[cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
326[feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
327[`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
328[`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
329[`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
330[`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
331[`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
332[`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
333[`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
334[`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
335[`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
336[`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
337[`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
338[`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
339[`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
340[`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
341[`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
342[`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
343[`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
344[`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
345[`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
346[`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
347
fc512014
XL
348Version 1.50.0 (2021-02-11)
349============================
350
351Language
352-----------------------
353- [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
354 This has been technically possible since 1.38.0, as it was unintentionally stabilized.
355- [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
356
357Compiler
358-----------------------
359- [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
360- [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
361- [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
6a06907d 362- [Dropped support for all cloudabi targets.][78439]
fc512014 363
36d6ef2b 364\* Refer to Rust's [platform support page][platform-support-doc] for more
fc512014
XL
365information on Rust's tiered platform support.
366
367Libraries
368-----------------------
369
370- [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
371- [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
372- [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
373 This value cannot be a valid file descriptor, and now means `Option<File>` takes
374 up the same amount of space as `File`.
375
376Stabilized APIs
377---------------
378
379- [`bool::then`]
380- [`btree_map::Entry::or_insert_with_key`]
381- [`f32::clamp`]
382- [`f64::clamp`]
383- [`hash_map::Entry::or_insert_with_key`]
384- [`Ord::clamp`]
385- [`RefCell::take`]
386- [`slice::fill`]
387- [`UnsafeCell::get_mut`]
388
389The following previously stable methods are now `const`.
390
391- [`IpAddr::is_ipv4`]
392- [`IpAddr::is_ipv6`]
6a06907d
XL
393- [`IpAddr::is_unspecified`]
394- [`IpAddr::is_loopback`]
395- [`IpAddr::is_multicast`]
396- [`Ipv4Addr::octets`]
397- [`Ipv4Addr::is_loopback`]
398- [`Ipv4Addr::is_private`]
399- [`Ipv4Addr::is_link_local`]
400- [`Ipv4Addr::is_multicast`]
401- [`Ipv4Addr::is_broadcast`]
402- [`Ipv4Addr::is_documentation`]
403- [`Ipv4Addr::to_ipv6_compatible`]
404- [`Ipv4Addr::to_ipv6_mapped`]
405- [`Ipv6Addr::segments`]
406- [`Ipv6Addr::is_unspecified`]
407- [`Ipv6Addr::is_loopback`]
408- [`Ipv6Addr::is_multicast`]
409- [`Ipv6Addr::to_ipv4`]
fc512014
XL
410- [`Layout::size`]
411- [`Layout::align`]
412- [`Layout::from_size_align`]
413- `pow` for all integer types.
414- `checked_pow` for all integer types.
415- `saturating_pow` for all integer types.
416- `wrapping_pow` for all integer types.
417- `next_power_of_two` for all unsigned integer types.
6a06907d 418- `checked_next_power_of_two` for all unsigned integer types.
fc512014
XL
419
420Cargo
421-----------------------
422
423- [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
424 This option sets a wrapper to execute instead of `rustc`, for workspace members only.
425- [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
426 contents of that directory for changes.][cargo/8973]
427- [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
428
429Misc
430----
431
432- [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
433- [Running tests will now print the total time taken to execute.][75752]
434
435Compatibility Notes
436-------------------
437
438- [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
439 recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
440- [Changes in how `TokenStream`s are checked have fixed some cases where you could write
441 unhygenic `macro_rules!` macros.][79472]
442- [`#![test]` as an inner attribute is now considered unstable like other inner macro
443 attributes, and reports an error by default through the `soft_unstable` lint.][79003]
444- [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
fc512014
XL
445- [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
446 recommended to use the `#[panic_handler]` attribute to provide your own implementation.
447- [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
448
449[74989]: https://github.com/rust-lang/rust/pull/74989
450[79261]: https://github.com/rust-lang/rust/pull/79261
451[79896]: https://github.com/rust-lang/rust/pull/79896
452[79484]: https://github.com/rust-lang/rust/pull/79484
453[79472]: https://github.com/rust-lang/rust/pull/79472
454[79270]: https://github.com/rust-lang/rust/pull/79270
455[79003]: https://github.com/rust-lang/rust/pull/79003
456[78864]: https://github.com/rust-lang/rust/pull/78864
457[78636]: https://github.com/rust-lang/rust/pull/78636
458[78439]: https://github.com/rust-lang/rust/pull/78439
459[78343]: https://github.com/rust-lang/rust/pull/78343
460[78296]: https://github.com/rust-lang/rust/pull/78296
461[78068]: https://github.com/rust-lang/rust/pull/78068
462[75752]: https://github.com/rust-lang/rust/pull/75752
463[74699]: https://github.com/rust-lang/rust/pull/74699
464[78142]: https://github.com/rust-lang/rust/pull/78142
465[77484]: https://github.com/rust-lang/rust/pull/77484
466[cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
467[cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
468[cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
469[`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
470[`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
6a06907d
XL
471[`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
472[`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
473[`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
474[`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
475[`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
476[`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
477[`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
478[`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
479[`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
480[`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
481[`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
482[`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
483[`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
484[`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
485[`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
486[`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
487[`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
fc512014
XL
488[`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
489[`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
490[`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
491[`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
492[`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
493[`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
494[`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
495[`btree_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/btree_map/enum.Entry.html#method.or_insert_with_key
496[`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
497[`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
498[`hash_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/hash_map/enum.Entry.html#method.or_insert_with_key
499[`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
500
501
b9856134
XL
502Version 1.49.0 (2020-12-31)
503============================
504
505Language
506-----------------------
507
508- [Unions can now implement `Drop`, and you can now have a field in a union
509 with `ManuallyDrop<T>`.][77547]
510- [You can now cast uninhabited enums to integers.][76199]
511- [You can now bind by reference and by move in patterns.][76119] This
512 allows you to selectively borrow individual components of a type. E.g.
513 ```rust
514 #[derive(Debug)]
515 struct Person {
516 name: String,
517 age: u8,
518 }
519
520 let person = Person {
521 name: String::from("Alice"),
522 age: 20,
523 };
524
525 // `name` is moved out of person, but `age` is referenced.
526 let Person { name, ref age } = person;
527 println!("{} {}", name, age);
528 ```
529
530Compiler
531-----------------------
532
533- [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
534- [Added tier 2 support for `aarch64-apple-darwin`.][75991]
535- [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
536- [Added tier 3 support for `mipsel-unknown-none`.][78676]
537- [Raised the minimum supported LLVM version to LLVM 9.][78848]
538- [Output from threads spawned in tests is now captured.][78227]
539- [Change os and vendor values to "none" and "unknown" for some targets][78951]
540
36d6ef2b 541\* Refer to Rust's [platform support page][platform-support-doc] for more
b9856134
XL
542information on Rust's tiered platform support.
543
544Libraries
545-----------------------
546
547- [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
548- [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
b9856134
XL
549
550Stabilized APIs
551---------------
552
553- [`slice::select_nth_unstable`]
554- [`slice::select_nth_unstable_by`]
555- [`slice::select_nth_unstable_by_key`]
556
557The following previously stable methods are now `const`.
558
559- [`Poll::is_ready`]
560- [`Poll::is_pending`]
561
562Cargo
563-----------------------
564- [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
565- [`cargo-tree` now marks proc-macro crates.][cargo/8765]
566- [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
567 variable will be set if the crate being built is one the user selected to build, either
568 with `-p` or through defaults.
569- [You can now use glob patterns when specifying packages & targets.][cargo/8752]
570
571
572Compatibility Notes
573-------------------
574
575- [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
576- [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
577- [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
578 Previously such invalid or unused attributes could be ignored.
579- Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
580 read [this post about the changes][rustdoc-ws-post] for more details.
581- [Trait bounds are no longer inferred for associated types.][79904]
582
583Internal Only
584-------------
585These changes provide no direct user facing benefits, but represent significant
586improvements to the internals and overall performance of rustc and
587related tools.
588
589- [rustc's internal crates are now compiled using the `initial-exec` Thread
590 Local Storage model.][78201]
591- [Calculate visibilities once in resolve.][78077]
592- [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
593- [Added `--color` for configuring terminal color support to bootstrap.][79004]
594
595
596[75991]: https://github.com/rust-lang/rust/pull/75991
597[78951]: https://github.com/rust-lang/rust/pull/78951
598[78848]: https://github.com/rust-lang/rust/pull/78848
599[78746]: https://github.com/rust-lang/rust/pull/78746
600[78376]: https://github.com/rust-lang/rust/pull/78376
601[78228]: https://github.com/rust-lang/rust/pull/78228
602[78227]: https://github.com/rust-lang/rust/pull/78227
603[78201]: https://github.com/rust-lang/rust/pull/78201
604[78109]: https://github.com/rust-lang/rust/pull/78109
605[78077]: https://github.com/rust-lang/rust/pull/78077
606[77997]: https://github.com/rust-lang/rust/pull/77997
607[77703]: https://github.com/rust-lang/rust/pull/77703
608[77547]: https://github.com/rust-lang/rust/pull/77547
609[77015]: https://github.com/rust-lang/rust/pull/77015
610[76199]: https://github.com/rust-lang/rust/pull/76199
611[76119]: https://github.com/rust-lang/rust/pull/76119
612[75914]: https://github.com/rust-lang/rust/pull/75914
b9856134
XL
613[79004]: https://github.com/rust-lang/rust/pull/79004
614[78676]: https://github.com/rust-lang/rust/pull/78676
615[79904]: https://github.com/rust-lang/rust/issues/79904
616[cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
617[cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
618[cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
619[cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
620[`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
621[`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
622[`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
623[`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
624[`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
625[`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
626[rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
627
2a314972
XL
628Version 1.48.0 (2020-11-19)
629==========================
630
631Language
632--------
633
634- [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
635 is still rejected *semantically*, but can now be parsed by procedural macros.
636
637Compiler
638--------
639- [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
b9856134 640 `rustc` whether to link its own C runtime and libraries or to rely on a external
2a314972
XL
641 linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
642- [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
643 Note: If you're using cargo you must explicitly pass the `--target` flag.
644- [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
645
36d6ef2b 646\* Refer to Rust's [platform support page][platform-support-doc] for more
2a314972
XL
647information on Rust's tiered platform support.
648
649Libraries
650---------
651- [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
652 and `&Stderr`.][76275]
653- [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
654- [The `matches!` macro now supports having a trailing comma.][74880]
655- [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
656- [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
657
658Stabilized APIs
659---------------
660- [`slice::as_ptr_range`]
661- [`slice::as_mut_ptr_range`]
662- [`VecDeque::make_contiguous`]
663- [`future::pending`]
664- [`future::ready`]
665
666The following previously stable methods are now `const fn`'s:
667
668- [`Option::is_some`]
669- [`Option::is_none`]
670- [`Option::as_ref`]
671- [`Result::is_ok`]
672- [`Result::is_err`]
673- [`Result::as_ref`]
674- [`Ordering::reverse`]
675- [`Ordering::then`]
676
677Cargo
678-----
679
680Rustdoc
681-------
682- [You can now link to items in `rustdoc` using the intra-doc link
683 syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
684 a link to `std::future`'s documentation. See ["Linking to items by
685 name"][intradoc-links] for more information.
686- [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
687 when searching through `rustdoc`'s UI.][75740]
688
689Compatibility Notes
690-------------------
691- [Promotion of references to `'static` lifetime inside `const fn` now follows the
692 same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
693 promoted to `'static` lifetime any more inside `const fn`s.
694- [Associated type bindings on trait objects are now verified to meet the bounds
695 declared on the trait when checking that they implement the trait.][27675]
696- [When trait bounds on associated types or opaque types are ambiguous, the
697 compiler no longer makes an arbitrary choice on which bound to use.][54121]
698- [Fixed recursive nonterminals not being expanded in macros during
699 pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
700 correctly handling recursive nonterminal tokens.
701- [`&mut` references to non zero-sized types are no longer promoted.][75585]
702- [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
703 in places where they have no effect.][73461]
704- [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
705 `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
706- [`mem::uninitialized` will now panic if any inner types inside a struct or enum
707 disallow zero-initialization.][71274]
708- [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
709- [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
710 Note: This behaviour is not guaranteed and is still considered undefined behaviour,
711 see the [`catch_unwind`] documentation for further information.
b9856134 712
2a314972
XL
713
714
715Internal Only
716-------------
717These changes provide no direct user facing benefits, but represent significant
718improvements to the internals and overall performance of rustc and
719related tools.
720
721- [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
722 You can continue building with `make` by setting `ninja=false` in
723 your `config.toml`.
724- [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
725- [Made `ensure_sufficient_stack()` non-generic][76680]
726
727[78143]: https://github.com/rust-lang/rust/issues/78143
728[76680]: https://github.com/rust-lang/rust/pull/76680/
729[76030]: https://github.com/rust-lang/rust/pull/76030/
730[70212]: https://github.com/rust-lang/rust/pull/70212/
731[27675]: https://github.com/rust-lang/rust/issues/27675/
b9856134 732[54121]: https://github.com/rust-lang/rust/issues/54121/
2a314972
XL
733[71274]: https://github.com/rust-lang/rust/pull/71274/
734[77386]: https://github.com/rust-lang/rust/pull/77386/
735[77153]: https://github.com/rust-lang/rust/pull/77153/
736[77055]: https://github.com/rust-lang/rust/pull/77055/
737[76275]: https://github.com/rust-lang/rust/pull/76275/
738[76310]: https://github.com/rust-lang/rust/pull/76310/
739[76420]: https://github.com/rust-lang/rust/pull/76420/
740[76158]: https://github.com/rust-lang/rust/pull/76158/
741[75857]: https://github.com/rust-lang/rust/pull/75857/
742[75585]: https://github.com/rust-lang/rust/pull/75585/
743[75740]: https://github.com/rust-lang/rust/pull/75740/
744[75502]: https://github.com/rust-lang/rust/pull/75502/
745[74880]: https://github.com/rust-lang/rust/pull/74880/
746[74922]: https://github.com/rust-lang/rust/pull/74922/
747[74430]: https://github.com/rust-lang/rust/pull/74430/
748[74194]: https://github.com/rust-lang/rust/pull/74194/
749[73461]: https://github.com/rust-lang/rust/pull/73461/
750[73166]: https://github.com/rust-lang/rust/pull/73166/
751[intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
752[`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
753[`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
754[`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
755[`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
756[`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
757[`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
758[`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
759[`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
760[`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
761[`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
762[`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
763[`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
764[`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
765[`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
766
767
6c58768f
XL
768Version 1.47.0 (2020-10-08)
769==========================
770
771Language
772--------
773- [Closures will now warn when not used.][74869]
774
775Compiler
776--------
777- [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
778 [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
779 platforms.
780- [Upgraded to LLVM 11.][73526]
781- [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
782- [Upgrade the FreeBSD toolchain to version 11.4][75204]
783- [`RUST_BACKTRACE`'s output is now more compact.][75048]
784
36d6ef2b 785\* Refer to Rust's [platform support page][platform-support-doc] for more
6c58768f
XL
786information on Rust's tiered platform support.
787
788Libraries
789---------
790- [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
791- [Traits in `std`/`core` are now implemented for arrays of any length, not just
792 those of length less than 33.][74060]
793- [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
794- [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
795 `PartialEq`, and `PartialOrd`.][73583]
796
797Stabilized APIs
798---------------
799- [`Ident::new_raw`]
800- [`Range::is_empty`]
801- [`RangeInclusive::is_empty`]
802- [`Result::as_deref`]
803- [`Result::as_deref_mut`]
804- [`Vec::leak`]
805- [`pointer::offset_from`]
806- [`f32::TAU`]
807- [`f64::TAU`]
808
809The following previously stable APIs have now been made const.
810
811- [The `new` method for all `NonZero` integers.][73858]
812- [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
813 `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
814 methods for all integers.][73858]
815- [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum` for all
816 signed integers.][73858]
817- [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
818 `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
819 `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
820 `is_ascii_control` methods for `char` and `u8`.][73858]
821
822Cargo
823-----
824- [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
825 You can override this by setting the following in your `Cargo.toml`.
826 ```toml
827 [profile.release.build-override]
828 opt-level = 3
829 ```
830- [`cargo-help` will now display man pages for commands rather just the
831 `--help` text.][cargo/8456]
832- [`cargo-metadata` now emits a `test` field indicating if a target has
833 tests enabled.][cargo/8478]
834- [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
835- [`cargo-publish` will now use an alternative registry by default if it's the
836 only registry specified in `package.publish`.][cargo/8571]
837
838Misc
839----
840- [Added a help button beside Rustdoc's searchbar that explains rustdoc's
841 type based search.][75366]
842- [Added the Ayu theme to rustdoc.][71237]
843
844Compatibility Notes
845-------------------
846- [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
847- [Fixed a regression parsing `{} && false` in tail expressions.][74650]
848- [Added changes to how proc-macros are expanded in `macro_rules!` that should
849 help to preserve more span information.][73084] These changes may cause
850 compiliation errors if your macro was unhygenic or didn't correctly handle
851 `Delimiter::None`.
852- [Moved support for the CloudABI target to tier 3.][75568]
853- [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
6c58768f
XL
854- [Added the `rustc-docs` component.][75560] This allows you to install
855 and read the documentation for the compiler internal APIs. (Currently only
856 available for `x86_64-unknown-linux-gnu`.)
857
1b1a35ee
XL
858Internal Only
859--------
2a314972
XL
860
861- [Improved default settings for bootstrapping in `x.py`.][73964] You can read details about this change in the ["Changes to `x.py` defaults"](https://blog.rust-lang.org/inside-rust/2020/08/30/changes-to-x-py-defaults.html) post on the Inside Rust blog.
1b1a35ee 862
6c58768f 863[1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
6c58768f
XL
864[75048]: https://github.com/rust-lang/rust/pull/75048/
865[74163]: https://github.com/rust-lang/rust/pull/74163/
866[71237]: https://github.com/rust-lang/rust/pull/71237/
867[74869]: https://github.com/rust-lang/rust/pull/74869/
868[73858]: https://github.com/rust-lang/rust/pull/73858/
869[75716]: https://github.com/rust-lang/rust/pull/75716/
870[75908]: https://github.com/rust-lang/rust/pull/75908/
871[75516]: https://github.com/rust-lang/rust/pull/75516/
872[75560]: https://github.com/rust-lang/rust/pull/75560/
873[75568]: https://github.com/rust-lang/rust/pull/75568/
874[75366]: https://github.com/rust-lang/rust/pull/75366/
875[75204]: https://github.com/rust-lang/rust/pull/75204/
876[74650]: https://github.com/rust-lang/rust/pull/74650/
877[74419]: https://github.com/rust-lang/rust/pull/74419/
878[73964]: https://github.com/rust-lang/rust/pull/73964/
879[74021]: https://github.com/rust-lang/rust/pull/74021/
880[74060]: https://github.com/rust-lang/rust/pull/74060/
881[73893]: https://github.com/rust-lang/rust/pull/73893/
882[73526]: https://github.com/rust-lang/rust/pull/73526/
883[73583]: https://github.com/rust-lang/rust/pull/73583/
884[73084]: https://github.com/rust-lang/rust/pull/73084/
885[73197]: https://github.com/rust-lang/rust/pull/73197/
886[72488]: https://github.com/rust-lang/rust/pull/72488/
887[cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
888[cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
889[cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
890[cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
891[cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
892[`Ident::new_raw`]: https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
893[`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
894[`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
895[`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
896[`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
897[`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
898[`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
899[`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
900[`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
901[`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
902
903
f9652781
XL
904Version 1.46.0 (2020-08-27)
905==========================
906
907Language
908--------
909- [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
910- [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
911 const functions.][73862]
912- [The `#[track_caller]` attribute can now be added to functions to use the
913 function's caller's location information for panic messages.][72445]
914- [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
915 `x.0.0` over `(x.0).0`.
6c58768f 916- [`mem::transmute` can now be used in statics and constants.][72920] **Note**
f9652781
XL
917 You currently can't use `mem::transmute` in constant functions.
918
919Compiler
920--------
921- [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
922- [Enabled static "Position Independent Executables" by default
923 for `x86_64-unknown-linux-musl`.][70740]
924
925Libraries
926---------
927- [`mem::forget` is now a `const fn`.][73887]
928- [`String` now implements `From<char>`.][73466]
929- [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
930 integer types.][73032]
931- [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
932- [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
933 zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
934- [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
935- [`(String, u16)` now implements `ToSocketAddrs`.][73007]
936- [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
937
938Stabilized APIs
939---------------
940- [`Option::zip`]
941- [`vec::Drain::as_slice`]
942
943Cargo
944-----
945Added a number of new environment variables that are now available when
946compiling your crate.
947
948- [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
949 the specific binary being compiled and the name of the crate.
950- [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
951- [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
952
953Compatibility Notes
954-------------------
955- [The target configuration option `abi_blacklist` has been renamed
956 to `unsupported_abis`.][74150] The old name will still continue to work.
6c58768f 957- [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
f9652781
XL
958 This was previously accepted but will become a hard error in a future release.
959- [Rustc will fail to compile if you have a struct with
960 `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
961 allowed on `enum`s.
962- [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
963 ensure that spans have the correct information, and may cause breakage if you
964 were relying on receiving spans with dummy information.
965- [The InnoSetup installer for Windows is no longer available.][72569] This was
966 a legacy installer that was replaced by a MSI installer a few years ago but
967 was still being built.
968- [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
969- [Rustc will no longer accept overlapping trait implementations that only
970 differ in how the lifetime was bound.][72493]
971- [Rustc now correctly relates the lifetime of an existential associated
972 type.][71896] This fixes some edge cases where `rustc` would erroneously allow
973 you to pass a shorter lifetime than expected.
974- [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
975 The library will need to be installed for `rustc` to work, even though we
976 expect it to be already available on most systems.
977- [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
978 under QEMU.][74820]
979- [Pretty printing of some tokens in procedural macros changed.][75453] The
980 exact output returned by rustc's pretty printing is an unstable
981 implementation detail: we recommend any macro relying on it to switch to a
982 more robust parsing system.
983
984[75453]: https://github.com/rust-lang/rust/issues/75453/
985[74820]: https://github.com/rust-lang/rust/issues/74820/
986[74420]: https://github.com/rust-lang/rust/issues/74420/
987[74109]: https://github.com/rust-lang/rust/pull/74109/
988[74150]: https://github.com/rust-lang/rust/pull/74150/
989[73862]: https://github.com/rust-lang/rust/pull/73862/
990[73887]: https://github.com/rust-lang/rust/pull/73887/
991[73466]: https://github.com/rust-lang/rust/pull/73466/
992[73516]: https://github.com/rust-lang/rust/pull/73516/
993[73293]: https://github.com/rust-lang/rust/pull/73293/
994[73007]: https://github.com/rust-lang/rust/pull/73007/
995[73032]: https://github.com/rust-lang/rust/pull/73032/
996[72920]: https://github.com/rust-lang/rust/pull/72920/
997[72569]: https://github.com/rust-lang/rust/pull/72569/
998[72583]: https://github.com/rust-lang/rust/pull/72583/
999[72584]: https://github.com/rust-lang/rust/pull/72584/
1000[72717]: https://github.com/rust-lang/rust/pull/72717/
1001[72437]: https://github.com/rust-lang/rust/pull/72437/
1002[72445]: https://github.com/rust-lang/rust/pull/72445/
1003[72486]: https://github.com/rust-lang/rust/pull/72486/
1004[72493]: https://github.com/rust-lang/rust/pull/72493/
1005[72331]: https://github.com/rust-lang/rust/pull/72331/
1006[71896]: https://github.com/rust-lang/rust/pull/71896/
1007[71660]: https://github.com/rust-lang/rust/pull/71660/
1008[71322]: https://github.com/rust-lang/rust/pull/71322/
1009[70740]: https://github.com/rust-lang/rust/pull/70740/
1010[cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1011[cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1012[cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1013[`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1014[`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1015
1016
1017Version 1.45.2 (2020-08-03)
1018==========================
1019
1020* [Fix bindings in tuple struct patterns][74954]
1021* [Fix track_caller integration with trait objects][74784]
1022
1023[74954]: https://github.com/rust-lang/rust/issues/74954
1024[74784]: https://github.com/rust-lang/rust/issues/74784
1025
1026
1027Version 1.45.1 (2020-07-30)
1028==========================
1029
1030* [Fix const propagation with references.][73613]
1031* [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1032* [Avoid spurious implicit region bound.][74509]
1033* [Install clippy on x.py install][74457]
1034
1035[73613]: https://github.com/rust-lang/rust/pull/73613
1036[73078]: https://github.com/rust-lang/rust/issues/73078
1037[74509]: https://github.com/rust-lang/rust/pull/74509
1038[74457]: https://github.com/rust-lang/rust/pull/74457
1039
1040
f9f354fc
XL
1041Version 1.45.0 (2020-07-16)
1042==========================
1043
1044Language
1045--------
1046- [Out of range float to int conversions using `as` has been defined as a saturating
1047 conversion.][71269] This was previously undefined behaviour, but you can use the
1048 `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1049 may be desirable in rare performance sensitive situations.
1050- [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1051 using `u64`.][70705]
1052- [Function like procedural macros can now be used in expression, pattern, and statement
1053 positions.][68717] This means you can now use a function-like procedural macro
1054 anywhere you can use a declarative (`macro_rules!`) macro.
1055
1056Compiler
1057--------
1058- [You can now override individual target features through the `target-feature`
1059 flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1060 equivalent to `-C target-feature=+avx2,+fma`.
1061- [Added the `force-unwind-tables` flag.][69984] This option allows
1062 rustc to always generate unwind tables regardless of panic strategy.
1063- [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1064 to include LLVM bitcode into generated `rlib`s (this is on by default).
1065- [Added the `tiny` value to the `code-model` codegen flag.][72397]
1066- [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1067- [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
2a314972 1068- [Upgraded to LLVM 10.][67759]
f9f354fc 1069
36d6ef2b 1070\* Refer to Rust's [platform support page][platform-support-doc] for more
f9f354fc
XL
1071information on Rust's tiered platform support.
1072
1073
1074Libraries
1075---------
1076- [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1077 and `Ord`.][72239]
1078- [`proc_macro::TokenStream` now implements `Default`.][72234]
1079- [You can now use `char` with
1080 `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1081 a range of codepoints.][72413] E.g.
1082 you can now write the following;
1083 ```rust
1084 for ch in 'a'..='z' {
1085 print!("{}", ch);
1086 }
1087 println!();
1088 // Prints "abcdefghijklmnopqrstuvwxyz"
1089 ```
1090- [`OsString` now implements `FromStr`.][71662]
f9652781 1091- [The `saturating_neg` method has been added to all signed integer primitive
f9f354fc
XL
1092 types, and the `saturating_abs` method has been added for all integer
1093 primitive types.][71886]
1094- [`Arc<T>`, `Rc<T>` now implement `From<Cow<'_, T>>`, and `Box` now
1095 implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1096 or `Path`.][71447]
1097- [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1098- [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1099 integer types.][69813]
1100- [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1101 integer types.][72324]
1102- [The `fetch_update` method has been added to all atomic integer types.][71843]
1103
1104Stabilized APIs
1105---------------
1106- [`Arc::as_ptr`]
1107- [`BTreeMap::remove_entry`]
1108- [`Rc::as_ptr`]
1109- [`rc::Weak::as_ptr`]
1110- [`rc::Weak::from_raw`]
1111- [`rc::Weak::into_raw`]
1112- [`str::strip_prefix`]
1113- [`str::strip_suffix`]
1114- [`sync::Weak::as_ptr`]
1115- [`sync::Weak::from_raw`]
1116- [`sync::Weak::into_raw`]
1117- [`char::UNICODE_VERSION`]
1118- [`Span::resolved_at`]
1119- [`Span::located_at`]
1120- [`Span::mixed_site`]
1121- [`unix::process::CommandExt::arg0`]
1122
1123Cargo
1124-----
1125
f9652781
XL
1126- [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1127 time.][cargo/8066]
1128
f9f354fc
XL
1129Misc
1130----
1131- [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1132 `~~outdated information~~` becomes "~~outdated information~~".
1133- [Added an emoji to Rustdoc's deprecated API message.][72014]
1134
1135Compatibility Notes
1136-------------------
1137- [Trying to self initialize a static value (that is creating a value using
1138 itself) is unsound and now causes a compile error.][71140]
1139- [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1140 This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1141- [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1142 previously undocumented and not intended for public use. Rustdoc still provides
1143 a non-zero exit code on errors.
f9652781
XL
1144- [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1145 This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1146 flags while cargo is adding `embed-bitcode` itself. The recommended way to
1147 control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1148 or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
f9f354fc
XL
1149
1150Internals Only
1151--------------
1152- [Make clippy a git subtree instead of a git submodule][70655]
1153- [Unify the undo log of all snapshot types][69464]
1154
f9652781 1155[71848]: https://github.com/rust-lang/rust/issues/71848/
f9f354fc
XL
1156[73420]: https://github.com/rust-lang/rust/issues/73420/
1157[72324]: https://github.com/rust-lang/rust/pull/72324/
1158[71843]: https://github.com/rust-lang/rust/pull/71843/
1159[71886]: https://github.com/rust-lang/rust/pull/71886/
1160[72234]: https://github.com/rust-lang/rust/pull/72234/
1161[72239]: https://github.com/rust-lang/rust/pull/72239/
1162[72397]: https://github.com/rust-lang/rust/pull/72397/
1163[72413]: https://github.com/rust-lang/rust/pull/72413/
1164[72014]: https://github.com/rust-lang/rust/pull/72014/
1165[72062]: https://github.com/rust-lang/rust/pull/72062/
1166[72094]: https://github.com/rust-lang/rust/pull/72094/
1167[72133]: https://github.com/rust-lang/rust/pull/72133/
2a314972 1168[67759]: https://github.com/rust-lang/rust/pull/67759/
f9f354fc
XL
1169[71900]: https://github.com/rust-lang/rust/pull/71900/
1170[71928]: https://github.com/rust-lang/rust/pull/71928/
1171[71662]: https://github.com/rust-lang/rust/pull/71662/
1172[71716]: https://github.com/rust-lang/rust/pull/71716/
1173[71447]: https://github.com/rust-lang/rust/pull/71447/
1174[71269]: https://github.com/rust-lang/rust/pull/71269/
1175[71095]: https://github.com/rust-lang/rust/pull/71095/
1176[71140]: https://github.com/rust-lang/rust/pull/71140/
1177[70655]: https://github.com/rust-lang/rust/pull/70655/
1178[70705]: https://github.com/rust-lang/rust/pull/70705/
1179[69984]: https://github.com/rust-lang/rust/pull/69984/
1180[69813]: https://github.com/rust-lang/rust/pull/69813/
1181[69464]: https://github.com/rust-lang/rust/pull/69464/
1182[68717]: https://github.com/rust-lang/rust/pull/68717/
f9652781 1183[cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
f9f354fc
XL
1184[`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1185[`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1186[`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1187[`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1188[`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1189[`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1190[`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1191[`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1192[`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1193[`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1194[`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1195[`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1196[`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1197[`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1198[`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1199[`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1200
1201
ba9703b0
XL
1202Version 1.44.1 (2020-06-18)
1203===========================
1204
1205* [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1206* [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1207* [Fix crashes when finding backtrace on macOS.][71397]
1208* [Clippy applies lint levels into different files.][clippy/5356]
1209
1210[71397]: https://github.com/rust-lang/rust/issues/71397
1211[73078]: https://github.com/rust-lang/rust/issues/73078
1212[cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1213[clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1214
f9f354fc 1215
ba9703b0
XL
1216Version 1.44.0 (2020-06-04)
1217==========================
1218
1219Language
1220--------
1221- [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1222- [Added the `unused_braces` lint.][70081]
1223
1224**Syntax-only changes**
1225
1226- [Expansion-driven outline module parsing][69838]
1227```rust
1228#[cfg(FALSE)]
1229mod foo {
1230 mod bar {
1231 mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1232 }
1233}
1234```
1235
1236These are still rejected semantically, so you will likely receive an error but
1237these changes can be seen and parsed by macros and conditional compilation.
1238
1239Compiler
1240--------
1241- [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1242 Additionally when in incremental mode rustc defaults to 256 codegen units.
f9f354fc 1243- [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
ba9703b0
XL
1244 a panic is thrown.][67502]
1245- [Added tier 3\* support for the `aarch64-unknown-none` and
1246 `aarch64-unknown-none-softfloat` targets.][68334]
1247- [Added tier 3 support for `arm64-apple-tvos` and
1248 `x86_64-apple-tvos` targets.][68191]
1249
1250
1251Libraries
1252---------
1253- [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1254 `vec![]` to be able to be used in `const` contexts.
1255- [`convert::Infallible` now implements `Hash`.][70281]
1256- [`OsString` now implements `DerefMut` and `IndexMut` returning
1257 a `&mut OsStr`.][70048]
1258- [Unicode 13 is now supported.][69929]
1259- [`String` now implements `From<&mut str>`.][69661]
1260- [`IoSlice` now implements `Copy`.][69403]
f9f354fc 1261- [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
ba9703b0
XL
1262- [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1263- [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1264 `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1265 integer types.][69373]
1266
1267Stabilized APIs
1268---------------
1269- [`PathBuf::with_capacity`]
1270- [`PathBuf::capacity`]
1271- [`PathBuf::clear`]
1272- [`PathBuf::reserve`]
1273- [`PathBuf::reserve_exact`]
1274- [`PathBuf::shrink_to_fit`]
1275- [`f32::to_int_unchecked`]
1276- [`f64::to_int_unchecked`]
1277- [`Layout::align_to`]
1278- [`Layout::pad_to_align`]
1279- [`Layout::array`]
1280- [`Layout::extend`]
1281
1282Cargo
1283-----
1284- [Added the `cargo tree` command which will print a tree graph of
1285 your dependencies.][cargo/8062] E.g.
1286 ```
1287 mdbook v0.3.2 (/Users/src/rust/mdbook)
1288 ├── ammonia v3.0.0
1289 │ ├── html5ever v0.24.0
1290 │ │ ├── log v0.4.8
1291 │ │ │ └── cfg-if v0.1.9
1292 │ │ ├── mac v0.1.1
1293 │ │ └── markup5ever v0.9.0
1294 │ │ ├── log v0.4.8 (*)
1295 │ │ ├── phf v0.7.24
1296 │ │ │ └── phf_shared v0.7.24
1297 │ │ │ ├── siphasher v0.2.3
1298 │ │ │ └── unicase v1.4.2
1299 │ │ │ [build-dependencies]
1300 │ │ │ └── version_check v0.1.5
1301 ...
1302 ```
1303 You can also display dependencies on multiple versions of the same crate with
1304 `cargo tree -d` (short for `cargo tree --duplicates`).
1305
1306Misc
1307----
1308- [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1309 the version in the sidebar.][69494]
1310
1311Compatibility Notes
1312-------------------
1313- [Rustc now correctly generates static libraries on Windows GNU targets with
1314 the `.a` extension, rather than the previous `.lib`.][70937]
1315- [Removed the `-C no_integrated_as` flag from rustc.][70345]
1316- [The `file_name` property in JSON output of macro errors now points the actual
1317 source file rather than the previous format of `<NAME macros>`.][70969]
f9f354fc 1318 **Note:** this may not point to a file that actually exists on the user's system.
ba9703b0
XL
1319- [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1320- [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1321 not allow zero initialization such as `NonZeroU8`.][66059] This was
1322 previously a warning.
1323- [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1324 operator has been defined as a saturating operation.][71269] This was previously
f9f354fc
XL
1325 undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1326 continue using the current behaviour, which may be desirable in rare performance
ba9703b0
XL
1327 sensitive situations.
1328
1329Internal Only
1330-------------
1331These changes provide no direct user facing benefits, but represent significant
1332improvements to the internals and overall performance of rustc and
1333related tools.
1334
1335- [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1336- [Replace big JS dict with JSON parsing.][71250]
1337
1338[69373]: https://github.com/rust-lang/rust/pull/69373/
1339[66059]: https://github.com/rust-lang/rust/pull/66059/
1340[68191]: https://github.com/rust-lang/rust/pull/68191/
1341[68899]: https://github.com/rust-lang/rust/pull/68899/
1342[71147]: https://github.com/rust-lang/rust/pull/71147/
1343[71250]: https://github.com/rust-lang/rust/pull/71250/
1344[70937]: https://github.com/rust-lang/rust/pull/70937/
1345[70969]: https://github.com/rust-lang/rust/pull/70969/
1346[70632]: https://github.com/rust-lang/rust/pull/70632/
1347[70281]: https://github.com/rust-lang/rust/pull/70281/
1348[70345]: https://github.com/rust-lang/rust/pull/70345/
1349[70048]: https://github.com/rust-lang/rust/pull/70048/
1350[70081]: https://github.com/rust-lang/rust/pull/70081/
1351[70156]: https://github.com/rust-lang/rust/pull/70156/
1352[71269]: https://github.com/rust-lang/rust/pull/71269/
1353[69838]: https://github.com/rust-lang/rust/pull/69838/
1354[69929]: https://github.com/rust-lang/rust/pull/69929/
1355[69661]: https://github.com/rust-lang/rust/pull/69661/
1356[69778]: https://github.com/rust-lang/rust/pull/69778/
1357[69494]: https://github.com/rust-lang/rust/pull/69494/
1358[69403]: https://github.com/rust-lang/rust/pull/69403/
1359[69033]: https://github.com/rust-lang/rust/pull/69033/
1360[68692]: https://github.com/rust-lang/rust/pull/68692/
1361[68334]: https://github.com/rust-lang/rust/pull/68334/
1362[67502]: https://github.com/rust-lang/rust/pull/67502/
1363[cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1364[`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1365[`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1366[`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1367[`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1368[`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1369[`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1370[`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1371[`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1372[`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1373[`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1374[`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1375[`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1376
1377
1378Version 1.43.1 (2020-05-07)
1379===========================
1380
1381* [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1382* [Fixed the stabilization of AVX-512 features.][71473]
1383* [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1384
1385[71430]: https://github.com/rust-lang/rust/pull/71430
1386[71473]: https://github.com/rust-lang/rust/issues/71473
1387[cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1388
1389
74b04a01
XL
1390Version 1.43.0 (2020-04-23)
1391==========================
1392
1393Language
1394--------
1395- [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1396 the type inferred correctly.][68129]
1397- [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1398
1399**Syntax only changes**
1400- [Allow `type Foo: Ord` syntactically.][69361]
1401- [Fuse associated and extern items up to defaultness.][69194]
1402- [Syntactically allow `self` in all `fn` contexts.][68764]
1403- [Merge `fn` syntax + cleanup item parsing.][68728]
1404- [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1405 For example, you may now write:
ba9703b0 1406 ```rust
74b04a01
XL
1407 macro_rules! mac_trait {
1408 ($i:item) => {
1409 trait T { $i }
1410 }
1411 }
1412 mac_trait! {
1413 fn foo() {}
1414 }
1415 ```
1416
1417These are still rejected *semantically*, so you will likely receive an error but
1418these changes can be seen and parsed by macros and
1419conditional compilation.
1420
1421
1422Compiler
1423--------
1424- [You can now pass multiple lint flags to rustc to override the previous
1425 flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1426 everything in the `unused` lint group except `unused-variables` which
1427 is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1428 everything in the `unused` lint group **including** `unused-variables` since
1429 the allow flag is specified before the deny flag (and therefore overridden).
1430- [rustc will now prefer your system MinGW libraries over its bundled libraries
1431 if they are available on `windows-gnu`.][67429]
1432- [rustc now buffers errors/warnings printed in JSON.][69227]
1433
1434Libraries
1435---------
1436- [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1437 `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1438 respectively.][69538] **Note** These conversions are only available when `N`
1439 is `0..=32`.
1440- [You can now use associated constants on floats and integers directly, rather
1441 than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1442 `f32::NAN` with no imports.
1443- [`u8::is_ascii` is now `const`.][68984]
1444- [`String` now implements `AsMut<str>`.][68742]
1445- [Added the `primitive` module to `std` and `core`.][67637] This module
1446 reexports Rust's primitive types. This is mainly useful in macros
1447 where you want avoid these types being shadowed.
1448- [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1449- [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1450
1451Stabilized APIs
1452---------------
1453- [`Once::is_completed`]
1454- [`f32::LOG10_2`]
1455- [`f32::LOG2_10`]
1456- [`f64::LOG10_2`]
1457- [`f64::LOG2_10`]
1458- [`iter::once_with`]
1459
1460Cargo
1461-----
1462- [You can now set config `[profile]`s in your `.cargo/config`, or through
1463 your environment.][cargo/7823]
1464- [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1465 executable path when running integration tests or benchmarks.][cargo/7697]
1466 `<name>` is the name of your binary as-is e.g. If you wanted the executable
1467 path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1468
1469Misc
1470----
1471- [Certain checks in the `const_err` lint were deemed unrelated to const
1472 evaluation][69185], and have been moved to the `unconditional_panic` and
1473 `arithmetic_overflow` lints.
ba9703b0 1474
74b04a01
XL
1475Compatibility Notes
1476-------------------
1477
1478- [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1479 has been a warning since 1.36.0.
1480- [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1481 led to some instances being accepted, and now correctly emits a hard error.
1482
1483[69340]: https://github.com/rust-lang/rust/pull/69340
1484
1485Internal Only
1486-------------
1487These changes provide no direct user facing benefits, but represent significant
1488improvements to the internals and overall performance of `rustc` and
1489related tools.
1490
1491- [All components are now built with `opt-level=3` instead of `2`.][67878]
1492- [Improved how rustc generates drop code.][67332]
1493- [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1494- [traits: preallocate 2 Vecs of known initial size][69022]
1495- [Avoid exponential behaviour when relating types][68772]
1496- [Skip `Drop` terminators for enum variants without drop glue][68943]
1497- [Improve performance of coherence checks][68966]
1498- [Deduplicate types in the generator witness][68672]
1499- [Invert control in struct_lint_level.][68725]
1500
1501[67332]: https://github.com/rust-lang/rust/pull/67332/
1502[67429]: https://github.com/rust-lang/rust/pull/67429/
1503[67637]: https://github.com/rust-lang/rust/pull/67637/
1504[67642]: https://github.com/rust-lang/rust/pull/67642/
1505[67878]: https://github.com/rust-lang/rust/pull/67878/
1506[67885]: https://github.com/rust-lang/rust/pull/67885/
1507[68129]: https://github.com/rust-lang/rust/pull/68129/
1508[68672]: https://github.com/rust-lang/rust/pull/68672/
1509[68725]: https://github.com/rust-lang/rust/pull/68725/
1510[68728]: https://github.com/rust-lang/rust/pull/68728/
1511[68738]: https://github.com/rust-lang/rust/pull/68738/
1512[68742]: https://github.com/rust-lang/rust/pull/68742/
1513[68764]: https://github.com/rust-lang/rust/pull/68764/
1514[68772]: https://github.com/rust-lang/rust/pull/68772/
1515[68943]: https://github.com/rust-lang/rust/pull/68943/
1516[68952]: https://github.com/rust-lang/rust/pull/68952/
1517[68966]: https://github.com/rust-lang/rust/pull/68966/
1518[68984]: https://github.com/rust-lang/rust/pull/68984/
1519[69022]: https://github.com/rust-lang/rust/pull/69022/
1520[69185]: https://github.com/rust-lang/rust/pull/69185/
1521[69194]: https://github.com/rust-lang/rust/pull/69194/
1522[69201]: https://github.com/rust-lang/rust/pull/69201/
1523[69227]: https://github.com/rust-lang/rust/pull/69227/
1524[69548]: https://github.com/rust-lang/rust/pull/69548/
1525[69256]: https://github.com/rust-lang/rust/pull/69256/
1526[69361]: https://github.com/rust-lang/rust/pull/69361/
1527[69366]: https://github.com/rust-lang/rust/pull/69366/
1528[69538]: https://github.com/rust-lang/rust/pull/69538/
1529[cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1530[cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1531[`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1532[`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1533[`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1534[`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1535[`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1536[`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1537
1538
dfeec247
XL
1539Version 1.42.0 (2020-03-12)
1540==========================
1541
1542Language
1543--------
1544- [You can now use the slice pattern syntax with subslices.][67712] e.g.
1545 ```rust
1546 fn foo(words: &[&str]) {
1547 match words {
1548 ["Hello", "World", "!", ..] => println!("Hello World!"),
1549 ["Foo", "Bar", ..] => println!("Baz"),
1550 rest => println!("{:?}", rest),
1551 }
1552 }
1553 ```
1554- [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1555 that you can create an enum that has the exact layout and ABI of the type
1556 it contains.
1557- [There are some *syntax-only* changes:][67131]
1558 - `default` is syntactically allowed before items in `trait` definitions.
1559 - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1560 leave out their bodies in favor of `;`.
1561 - Bounds on associated types in `impl`s are now syntactically allowed
1562 (e.g. `type Foo: Ord;`).
1563 - `...` (the C-variadic type) may occur syntactically directly as the type of
1564 any function parameter.
ba9703b0 1565
dfeec247
XL
1566 These are still rejected *semantically*, so you will likely receive an error
1567 but these changes can be seen and parsed by procedural macros and
1568 conditional compilation.
1569
1570Compiler
1571--------
1572- [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1573- [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1574- [`Option::{expect,unwrap}` and
1575 `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1576 pointing to the location where they were called, rather than
1577 `core`'s internals. ][67887]
1578
36d6ef2b 1579\* Refer to Rust's [platform support page][platform-support-doc] for more
dfeec247
XL
1580information on Rust's tiered platform support.
1581
1582Libraries
1583---------
1584- [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1585- [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1586 to implement `Sized`.][67935]
1587- [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1588- [`Layout::new` is now `const`.][66254]
1589- [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1590
1591
1592Stabilized APIs
1593---------------
1594- [`CondVar::wait_while`]
1595- [`CondVar::wait_timeout_while`]
1596- [`DebugMap::key`]
1597- [`DebugMap::value`]
1598- [`ManuallyDrop::take`]
1599- [`matches!`]
1600- [`ptr::slice_from_raw_parts_mut`]
1601- [`ptr::slice_from_raw_parts`]
1602
1603Cargo
1604-----
1605- [You no longer need to include `extern crate proc_macro;` to be able to
1606 `use proc_macro;` in the `2018` edition.][cargo/7700]
1607
1608Compatibility Notes
1609-------------------
1610- [`Error::description` has been deprecated, and its use will now produce a
1611 warning.][66919] It's recommended to use `Display`/`to_string` instead.
74b04a01 1612
dfeec247
XL
1613[68253]: https://github.com/rust-lang/rust/pull/68253/
1614[68348]: https://github.com/rust-lang/rust/pull/68348/
1615[67935]: https://github.com/rust-lang/rust/pull/67935/
1616[68339]: https://github.com/rust-lang/rust/pull/68339/
1617[68122]: https://github.com/rust-lang/rust/pull/68122/
1618[67712]: https://github.com/rust-lang/rust/pull/67712/
1619[67887]: https://github.com/rust-lang/rust/pull/67887/
1620[67131]: https://github.com/rust-lang/rust/pull/67131/
1621[67233]: https://github.com/rust-lang/rust/pull/67233/
1622[66899]: https://github.com/rust-lang/rust/pull/66899/
1623[66919]: https://github.com/rust-lang/rust/pull/66919/
1624[66254]: https://github.com/rust-lang/rust/pull/66254/
1625[cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1626[`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1627[`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1628[`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1629[`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1630[`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1631[`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1632[`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1633[`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1634
1635
60c5eb7d
XL
1636Version 1.41.1 (2020-02-27)
1637===========================
1638
1639* [Always check types of static items][69145]
1640* [Always check lifetime bounds of `Copy` impls][69145]
1641* [Fix miscompilation in callers of `Layout::repeat`][69225]
1642
1643[69225]: https://github.com/rust-lang/rust/issues/69225
1644[69145]: https://github.com/rust-lang/rust/pull/69145
1645
dfeec247 1646
60c5eb7d
XL
1647Version 1.41.0 (2020-01-30)
1648===========================
1649
1650Language
1651--------
1652
1653- [You can now pass type parameters to foreign items when implementing
1654 traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1655- [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1656 now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1657 `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1658- [You can now use any valid identifier in a `format_args` macro.][66847]
1659 Previously identifiers starting with an underscore were not allowed.
1660- [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1661 enum variants.][66183] These are still rejected semantically, but
1662 can be seen and parsed by procedural macros and conditional compilation.
1663
1664Compiler
1665--------
1666
1667- [Rustc will now warn if you have unused loop `'label`s.][66325]
1668- [Removed support for the `i686-unknown-dragonfly` target.][67255]
1669- [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1670- [You can now pass an arguments file passing the `@path` syntax
1671 to rustc.][66172] Note that the format differs somewhat from what is
1672 found in other tooling; please see [the documentation][argfile-docs] for
1673 more information.
1674- [You can now provide `--extern` flag without a path, indicating that it is
1675 available from the search path or specified with an `-L` flag.][64882]
1676
36d6ef2b 1677\* Refer to Rust's [platform support page][platform-support-doc] for more
60c5eb7d
XL
1678information on Rust's tiered platform support.
1679
1680[argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1681
1682Libraries
1683---------
1684
1685- [The `core::panic` module is now stable.][66771] It was already stable
1686 through `std`.
1687- [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1688 width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1689- [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1690
1691Stabilized APIs
1692---------------
1693
1694- [`Result::map_or`]
1695- [`Result::map_or_else`]
1696- [`std::rc::Weak::weak_count`]
1697- [`std::rc::Weak::strong_count`]
1698- [`std::sync::Weak::weak_count`]
1699- [`std::sync::Weak::strong_count`]
1700
1701Cargo
1702-----
1703
1704- [Cargo will now document all the private items for binary crates
1705 by default.][cargo/7593]
1706- [`cargo-install` will now reinstall the package if it detects that it is out
1707 of date.][cargo/7560]
1708- [Cargo.lock now uses a more git friendly format that should help to reduce
1709 merge conflicts.][cargo/7579]
1710- [You can now override specific dependencies's build settings][cargo/7591] E.g.
1711 `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1712 optimisation level to `2` for debug builds. You can also use
1713 `[profile.<profile>.build-override]` to override build scripts and
1714 their dependencies.
1715
1716Misc
1717----
1718
1719- [You can now specify `edition` in documentation code blocks to compile the block
1720 for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1721 should be compiled the 2018 edition of Rust.
1722- [You can now provide custom themes to rustdoc with `--theme`, and check the
1723 current theme with `--check-theme`.][54733]
1724- [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1725
1726Compatibility Notes
1727-------------------
1728
1729- [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1730 Apple targets.][apple-32bit-drop] This means that the source code is still
1731 available to build, but the targets are no longer being tested and release
1732 binaries for those platforms will no longer be distributed by the Rust project.
1733 Please refer to the linked blog post for more information.
1734
1735[54733]: https://github.com/rust-lang/rust/pull/54733/
1736[61351]: https://github.com/rust-lang/rust/pull/61351/
1737[67255]: https://github.com/rust-lang/rust/pull/67255/
1738[66661]: https://github.com/rust-lang/rust/pull/66661/
1739[66771]: https://github.com/rust-lang/rust/pull/66771/
1740[66847]: https://github.com/rust-lang/rust/pull/66847/
1741[66238]: https://github.com/rust-lang/rust/pull/66238/
1742[66277]: https://github.com/rust-lang/rust/pull/66277/
1743[66325]: https://github.com/rust-lang/rust/pull/66325/
1744[66172]: https://github.com/rust-lang/rust/pull/66172/
1745[66183]: https://github.com/rust-lang/rust/pull/66183/
1746[65879]: https://github.com/rust-lang/rust/pull/65879/
1747[65013]: https://github.com/rust-lang/rust/pull/65013/
1748[64882]: https://github.com/rust-lang/rust/pull/64882/
1749[64325]: https://github.com/rust-lang/rust/pull/64325/
1750[cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1751[cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1752[cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1753[cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1754[`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1755[`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1756[`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1757[`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1758[`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1759[`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1760[apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1761
1762Version 1.40.0 (2019-12-19)
1763===========================
1764
1765Language
1766--------
1767- [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1768 `const` contexts.][65188] e.g.
1769
1770 ```rust
1771 pub struct Point(i32, i32);
1772
1773 const ORIGIN: Point = {
1774 let constructor = Point;
1775
1776 constructor(0, 0)
1777 };
1778 ```
1779
1780- [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1781 indicate that there may be variants or fields added in the future.][64639]
1782 For example this requires adding a wild-card branch (`_ => {}`) to any match
1783 statements on a non-exhaustive `enum`. [(RFC 2008)]
1784- [You can now use function-like procedural macros in `extern` blocks and in
1785 type positions.][63931] e.g. `type Generated = macro!();`
1786- [Function-like and attribute procedural macros can now emit
1787 `macro_rules!` items, so you can now have your macros generate macros.][64035]
1788- [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1789 attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1790 `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1791
1792Compiler
1793--------
1794- [Added tier 3 support\* for the
1795 `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1796- [Added tier 3 support for the
1797 `aarch64-unknown-none-softfloat` target.][64589]
1798- [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1799 `mips64el-unknown-linux-muslabi64` targets.][65843]
1800
36d6ef2b 1801\* Refer to Rust's [platform support page][platform-support-doc] for more
60c5eb7d
XL
1802 information on Rust's tiered platform support.
1803
1804Libraries
1805---------
1806- [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1807
1808Stabilized APIs
1809---------------
1810- [`BTreeMap::get_key_value`]
1811- [`HashMap::get_key_value`]
1812- [`Option::as_deref_mut`]
1813- [`Option::as_deref`]
1814- [`Option::flatten`]
1815- [`UdpSocket::peer_addr`]
1816- [`f32::to_be_bytes`]
1817- [`f32::to_le_bytes`]
1818- [`f32::to_ne_bytes`]
1819- [`f64::to_be_bytes`]
1820- [`f64::to_le_bytes`]
1821- [`f64::to_ne_bytes`]
1822- [`f32::from_be_bytes`]
1823- [`f32::from_le_bytes`]
1824- [`f32::from_ne_bytes`]
1825- [`f64::from_be_bytes`]
1826- [`f64::from_le_bytes`]
1827- [`f64::from_ne_bytes`]
1828- [`mem::take`]
1829- [`slice::repeat`]
1830- [`todo!`]
1831
1832Cargo
1833-----
1834- [Cargo will now always display warnings, rather than only on
1835 fresh builds.][cargo/7450]
1836- [Feature flags (except `--all-features`) passed to a virtual workspace will
1837 now produce an error.][cargo/7507] Previously these flags were ignored.
1838- [You can now publish `dev-dependencies` without including
1839 a `version`.][cargo/7333]
1840
1841Misc
1842----
1843- [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1844 when running documentation tests with `rustdoc`.][63803]
1845
1846Compatibility Notes
1847-------------------
1848- [As previously announced, any previous NLL warnings in the 2015 edition are
1849 now hard errors.][64221]
1850- [The `include!` macro will now warn if it failed to include the
1851 entire file.][64284] The `include!` macro unintentionally only includes the
1852 first _expression_ in a file, and this can be unintuitive. This will become
1853 either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1854- [Using `#[inline]` on function prototypes and consts now emits a warning under
1855 `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1856 or `extern` blocks now correctly emits a hard error.
ba9703b0 1857
60c5eb7d
XL
1858[65294]: https://github.com/rust-lang/rust/pull/65294/
1859[66103]: https://github.com/rust-lang/rust/pull/66103/
1860[65843]: https://github.com/rust-lang/rust/pull/65843/
1861[65188]: https://github.com/rust-lang/rust/pull/65188/
1862[65092]: https://github.com/rust-lang/rust/pull/65092/
1863[64589]: https://github.com/rust-lang/rust/pull/64589/
1864[64639]: https://github.com/rust-lang/rust/pull/64639/
1865[64221]: https://github.com/rust-lang/rust/pull/64221/
1866[64284]: https://github.com/rust-lang/rust/pull/64284/
1867[63931]: https://github.com/rust-lang/rust/pull/63931/
1868[64035]: https://github.com/rust-lang/rust/pull/64035/
1869[63674]: https://github.com/rust-lang/rust/pull/63674/
1870[63803]: https://github.com/rust-lang/rust/pull/63803/
1871[cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1872[cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1873[cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1874[cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1875[(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1876[`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1877[`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1878[`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1879[`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1880[`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1881[`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1882[`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1883[`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1884[`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1885[`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1886[`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1887[`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1888[`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1889[`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1890[`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1891[`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1892[`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1893[`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1894[`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1895[`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1896[`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1897
1898
e1599b0c
XL
1899Version 1.39.0 (2019-11-07)
1900===========================
1901
1902Language
1903--------
1904- [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1905 `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1906- [You can now use certain attributes on function, closure, and function pointer
1907 parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1908 `deny`, `forbid` as well as inert helper attributes used by procedural macro
1909 attributes applied to items. e.g.
1910 ```rust
1911 fn len(
1912 #[cfg(windows)] slice: &[u16],
1913 #[cfg(not(windows))] slice: &[u8],
1914 ) -> usize {
1915 slice.len()
1916 }
1917 ```
1918- [You can now take shared references to bind-by-move patterns in the `if` guards
1919 of `match` arms.][63118] e.g.
1920 ```rust
1921 fn main() {
1922 let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1923
1924 match array {
1925 nums
1926 // ---- `nums` is bound by move.
1927 if nums.iter().sum::<u8>() == 10
1928 // ^------ `.iter()` implicitly takes a reference to `nums`.
1929 => {
1930 drop(nums);
1931 // ----------- Legal as `nums` was bound by move and so we have ownership.
1932 }
1933 _ => unreachable!(),
1934 }
1935 }
1936 ```
1937
1938
1939
1940Compiler
1941--------
1942- [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1943- [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1944- [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1945 **Note** Cargo currently doesn't use this feature. Refer to
1946 [cargo#7315][cargo/7315] to track this feature's progress.
1947- [You can now pass `--show-output` argument to test binaries to print the
1948 output of successful tests.][62600]
1949
1950
36d6ef2b 1951\* Refer to Rust's [platform support page][platform-support-doc] for more
e1599b0c
XL
1952information on Rust's tiered platform support.
1953
1954Libraries
1955---------
1956- [`Vec::new` and `String::new` are now `const` functions.][64028]
1957- [`LinkedList::new` is now a `const` function.][63684]
1958- [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1959- [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1960 now `const`.][63786]
1961
1962Stabilized APIs
1963---------------
1964- [`Pin::into_inner`]
1965- [`Instant::checked_duration_since`]
1966- [`Instant::saturating_duration_since`]
1967
1968Cargo
1969-----
1970- [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1971- [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1972 `--all` is now deprecated.
1973
1974Misc
1975----
1976- [You can now pass `-Clinker` to rustdoc to control the linker used
1977 for compiling doctests.][63834]
1978
1979Compatibility Notes
1980-------------------
1981- [Code that was previously accepted by the old borrow checker, but rejected by
1982 the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1983 previously a warning, and will also become a hard error in the Rust 2015
1984 edition in the 1.40.0 release.
1985- [`rustdoc` now requires `rustc` to be installed and in the same directory to
1986 run tests.][63827] This should improve performance when running a large
1987 amount of doctests.
1988- [The `try!` macro will now issue a deprecation warning.][62672] It is
1989 recommended to use the `?` operator instead.
1990- [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1991 returned `0.0`.
1992
1993[62600]: https://github.com/rust-lang/rust/pull/62600/
1994[62672]: https://github.com/rust-lang/rust/pull/62672/
1995[63118]: https://github.com/rust-lang/rust/pull/63118/
1996[63209]: https://github.com/rust-lang/rust/pull/63209/
1997[63402]: https://github.com/rust-lang/rust/pull/63402/
1998[63565]: https://github.com/rust-lang/rust/pull/63565/
1999[63595]: https://github.com/rust-lang/rust/pull/63595/
2000[63684]: https://github.com/rust-lang/rust/pull/63684/
2001[63698]: https://github.com/rust-lang/rust/pull/63698/
2002[63770]: https://github.com/rust-lang/rust/pull/63770/
2003[63786]: https://github.com/rust-lang/rust/pull/63786/
2004[63827]: https://github.com/rust-lang/rust/pull/63827/
2005[63834]: https://github.com/rust-lang/rust/pull/63834/
2006[63927]: https://github.com/rust-lang/rust/pull/63927/
2007[63933]: https://github.com/rust-lang/rust/pull/63933/
2008[63934]: https://github.com/rust-lang/rust/pull/63934/
2009[63938]: https://github.com/rust-lang/rust/pull/63938/
2010[63940]: https://github.com/rust-lang/rust/pull/63940/
2011[63941]: https://github.com/rust-lang/rust/pull/63941/
2012[63945]: https://github.com/rust-lang/rust/pull/63945/
2013[64010]: https://github.com/rust-lang/rust/pull/64010/
2014[64028]: https://github.com/rust-lang/rust/pull/64028/
2015[64334]: https://github.com/rust-lang/rust/pull/64334/
2016[cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2017[cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2018[cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2019[`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2020[`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2021[`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2022
416331ca
XL
2023Version 1.38.0 (2019-09-26)
2024==========================
2025
2026Language
2027--------
2028- [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2029- [The `#[deprecated]` attribute can now be used on macros.][62042]
2030
2031Compiler
2032--------
2033- [Added pipelined compilation support to `rustc`.][62766] This will
2034 improve compilation times in some cases. For further information please refer
2035 to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2036- [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2037 `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2038 `x86_64-uwp-windows-msvc` targets.][60260]
2039- [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2040 `armv7-unknown-linux-musleabi` targets.][63107]
2041- [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2042- [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2a314972 2043- [Upgraded to LLVM 9.][62592]
416331ca 2044
36d6ef2b 2045\* Refer to Rust's [platform support page][platform-support-doc] for more
416331ca
XL
2046information on Rust's tiered platform support.
2047
2048Libraries
2049---------
2050- [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2051- [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2052 available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2053 is available at `std::clone::Clone`). This also makes all built-in macros
2054 available in `std`/`core` root. e.g. `std::include_bytes!`.
2055- [`str::Chars` now implements `Debug`.][63000]
2056- [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2057- [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2058- [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2059- [Added euclidean remainder and division operations (`div_euclid`,
2060 `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2061 `overflowing`, and `wrapping` versions are available for all
2062 integer primitives.
2063- [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2064 `PartialEq`.][61491]
2065- [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2066
2067Stabilized APIs
2068---------------
2069- [`<*const T>::cast`]
2070- [`<*mut T>::cast`]
2071- [`Duration::as_secs_f32`]
2072- [`Duration::as_secs_f64`]
416331ca
XL
2073- [`Duration::div_f32`]
2074- [`Duration::div_f64`]
2075- [`Duration::from_secs_f32`]
2076- [`Duration::from_secs_f64`]
2077- [`Duration::mul_f32`]
2078- [`Duration::mul_f64`]
2079- [`any::type_name`]
2080
2081Cargo
2082-----
2083- [Added pipelined compilation support to `cargo`.][cargo/7143]
2084- [You can now pass the `--features` option multiple times to enable
2085 multiple features.][cargo/7084]
2086
36d6ef2b
XL
2087Rustdoc
2088-------
2089
2090- [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2091
416331ca
XL
2092Misc
2093----
2094- [`rustc` will now warn about some incorrect uses of
2095 `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2096
2097Compatibility Notes
2098-------------------
e1599b0c
XL
2099- The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2100 1.38.0.
2101- The [`armv7-unknown-linux-gnueabihf` platform is known to have
2102 issues][62896] with certain crates such as libc.
416331ca
XL
2103
2104[60260]: https://github.com/rust-lang/rust/pull/60260/
2105[61457]: https://github.com/rust-lang/rust/pull/61457/
2106[61491]: https://github.com/rust-lang/rust/pull/61491/
2107[61884]: https://github.com/rust-lang/rust/pull/61884/
2108[61953]: https://github.com/rust-lang/rust/pull/61953/
2109[62042]: https://github.com/rust-lang/rust/pull/62042/
2110[62528]: https://github.com/rust-lang/rust/pull/62528/
2111[62583]: https://github.com/rust-lang/rust/pull/62583/
2112[62735]: https://github.com/rust-lang/rust/pull/62735/
2113[62766]: https://github.com/rust-lang/rust/pull/62766/
2114[62784]: https://github.com/rust-lang/rust/pull/62784/
2a314972 2115[62592]: https://github.com/rust-lang/rust/pull/62592/
416331ca
XL
2116[62785]: https://github.com/rust-lang/rust/issues/62785/
2117[62814]: https://github.com/rust-lang/rust/pull/62814/
2118[62896]: https://github.com/rust-lang/rust/issues/62896/
2119[63000]: https://github.com/rust-lang/rust/pull/63000/
2120[63056]: https://github.com/rust-lang/rust/pull/63056/
2121[63107]: https://github.com/rust-lang/rust/pull/63107/
2122[63346]: https://github.com/rust-lang/rust/pull/63346/
2123[63421]: https://github.com/rust-lang/rust/pull/63421/
2124[cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2125[cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
36d6ef2b 2126[63048]: https://github.com/rust-lang/rust/pull/63048
416331ca
XL
2127[`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2128[`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2129[`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2130[`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
416331ca
XL
2131[`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2132[`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2133[`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2134[`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2135[`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2136[`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2137[`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
36d6ef2b 2138[platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
416331ca
XL
2139[pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2140
dc9dc135
XL
2141Version 1.37.0 (2019-08-15)
2142==========================
2143
2144Language
2145--------
2146- `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2147 [`Box`][62228], or an [array][62235] and unused.
2148- [You can now use the `cfg` and `cfg_attr` attributes on
2149 generic parameters.][61547]
2150- [You can now use enum variants through type alias.][61682] e.g. You can
2151 write the following:
2152 ```rust
2153 type MyOption = Option<u8>;
2154
2155 fn increment_or_zero(x: MyOption) -> u8 {
2156 match x {
2157 MyOption::Some(y) => y + 1,
2158 MyOption::None => 0,
2159 }
2160 }
2161 ```
2162- [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2163 `const _: u32 = 5;`.
2164- [You can now use `#[repr(align(X)]` on enums.][61229]
416331ca 2165- [The `?` Kleene macro operator is now available in the
dc9dc135
XL
2166 2015 edition.][60932]
2167
2168Compiler
2169--------
2170- [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2171 and `-C profile-use` flags.][61268] For more information on how to use profile
2172 guided optimization, please refer to the [rustc book][rustc-book-pgo].
2173- [The `rust-lldb` wrapper script should now work again.][61827]
2174
2175Libraries
2176---------
2177- [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2178
2179Stabilized APIs
2180---------------
2181- [`BufReader::buffer`]
2182- [`BufWriter::buffer`]
2183- [`Cell::from_mut`]
2184- [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2185- [`DoubleEndedIterator::nth_back`]
2186- [`Option::xor`]
2187- [`Wrapping::reverse_bits`]
2188- [`i128::reverse_bits`]
2189- [`i16::reverse_bits`]
2190- [`i32::reverse_bits`]
2191- [`i64::reverse_bits`]
2192- [`i8::reverse_bits`]
2193- [`isize::reverse_bits`]
2194- [`slice::copy_within`]
2195- [`u128::reverse_bits`]
2196- [`u16::reverse_bits`]
2197- [`u32::reverse_bits`]
2198- [`u64::reverse_bits`]
2199- [`u8::reverse_bits`]
2200- [`usize::reverse_bits`]
2201
2202Cargo
2203-----
2204- [`Cargo.lock` files are now included by default when publishing executable crates
2205 with executables.][cargo/7026]
2206- [You can now specify `default-run="foo"` in `[package]` to specify the
2207 default executable to use for `cargo run`.][cargo/7056]
2208
2209Misc
2210----
2211
2212Compatibility Notes
2213-------------------
2214- [Using `...` for inclusive range patterns will now warn by default.][61342]
2215 Please transition your code to using the `..=` syntax for inclusive
2216 ranges instead.
2217- [Using a trait object without the `dyn` will now warn by default.][61203]
2218 Please transition your code to use `dyn Trait` for trait objects instead.
2219
2220[62228]: https://github.com/rust-lang/rust/pull/62228/
2221[62235]: https://github.com/rust-lang/rust/pull/62235/
2222[61802]: https://github.com/rust-lang/rust/pull/61802/
2223[61827]: https://github.com/rust-lang/rust/pull/61827/
2224[61547]: https://github.com/rust-lang/rust/pull/61547/
2225[61682]: https://github.com/rust-lang/rust/pull/61682/
2226[61268]: https://github.com/rust-lang/rust/pull/61268/
2227[61342]: https://github.com/rust-lang/rust/pull/61342/
2228[61347]: https://github.com/rust-lang/rust/pull/61347/
2229[61100]: https://github.com/rust-lang/rust/pull/61100/
2230[61203]: https://github.com/rust-lang/rust/pull/61203/
2231[61229]: https://github.com/rust-lang/rust/pull/61229/
2232[60932]: https://github.com/rust-lang/rust/pull/60932/
2233[cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2234[cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2235[`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2236[`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2237[`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2238[`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2239[`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2240[`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2241[`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2242[`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2243[`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2244[`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2245[`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2246[`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2247[`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2248[`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2249[`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2250[`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2251[`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2252[`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2253[`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2254[`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2255[`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2256[rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2257
2258
48663c56
XL
2259Version 1.36.0 (2019-07-04)
2260==========================
2261
2262Language
2263--------
2264- [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2265- [The order of traits in trait objects no longer affects the semantics of that
2266 object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2267 `dyn fmt::Debug + Send`, where this was previously not the case.
2268
2269Libraries
2270---------
2271- [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2272- [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2273- [`mem::needs_drop` is now available as a const fn.][60364]
2274- [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2275- [`String` now implements `BorrowMut<str>`.][60404]
2276- [`io::Cursor` now implements `Default`.][60234]
2277- [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2278- [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2279 of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2280 environment has access to heap memory allocation.
2281- [`String` now implements `From<&String>`.][59825]
2282- [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2283 return a tuple of each argument when there is multiple arguments.
2284- [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2285 not used.][59648]
2286
2287Stabilized APIs
2288---------------
2289- [`VecDeque::rotate_left`]
2290- [`VecDeque::rotate_right`]
2291- [`Iterator::copied`]
2292- [`io::IoSlice`]
2293- [`io::IoSliceMut`]
2294- [`Read::read_vectored`]
2295- [`Write::write_vectored`]
2296- [`str::as_mut_ptr`]
2297- [`mem::MaybeUninit`]
2298- [`pointer::align_offset`]
2299- [`future::Future`]
2300- [`task::Context`]
2301- [`task::RawWaker`]
2302- [`task::RawWakerVTable`]
2303- [`task::Waker`]
2304- [`task::Poll`]
2305
2306Cargo
2307-----
2308- [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2309- [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2310
2311You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2312
2313Clippy
2314------
2315There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2316
2317Misc
2318----
2319
2320Compatibility Notes
2321-------------------
48663c56 2322- With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
416331ca 2323 longer recommended, and will be deprecated in 1.39.0.
48663c56
XL
2324
2325[60318]: https://github.com/rust-lang/rust/pull/60318/
2326[60364]: https://github.com/rust-lang/rust/pull/60364/
2327[60370]: https://github.com/rust-lang/rust/pull/60370/
2328[60404]: https://github.com/rust-lang/rust/pull/60404/
2329[60234]: https://github.com/rust-lang/rust/pull/60234/
2330[60244]: https://github.com/rust-lang/rust/pull/60244/
2331[58623]: https://github.com/rust-lang/rust/pull/58623/
2332[59648]: https://github.com/rust-lang/rust/pull/59648/
2333[59675]: https://github.com/rust-lang/rust/pull/59675/
2334[59825]: https://github.com/rust-lang/rust/pull/59825/
2335[59826]: https://github.com/rust-lang/rust/pull/59826/
2336[59445]: https://github.com/rust-lang/rust/pull/59445/
2337[59114]: https://github.com/rust-lang/rust/pull/59114/
2338[cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2339[cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2340[`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2341[`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2342[`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2343[`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2344[`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2345[`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2346[`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2347[`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2348[`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2349[`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2350[`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2351[`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2352[`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2353[`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2354[`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2355[`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2356[clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2357[cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
416331ca 2358
48663c56 2359
532ac7d7
XL
2360Version 1.35.0 (2019-05-23)
2361==========================
2362
2363Language
2364--------
2365- [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2366 `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2367- [You can now coerce closures into unsafe function pointers.][59580] e.g.
2368 ```rust
2369 unsafe fn call_unsafe(func: unsafe fn()) {
2370 func()
2371 }
2372
2373 pub fn main() {
2374 unsafe { call_unsafe(|| {}); }
2375 }
2376 ```
2377
2378
2379Compiler
2380--------
2381- [Added the `armv6-unknown-freebsd-gnueabihf` and
2382 `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2383- [Added the `wasm32-unknown-wasi` target.][59464]
2384
2385
2386Libraries
2387---------
2388- [`Thread` will now show its ID in `Debug` output.][59460]
2389- [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2390- [`alloc::System` now implements `Default`.][59451]
2391- [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2392 last field.][59076]
2393- [`char::{ToLowercase, ToUppercase}` now
2394 implement `ExactSizeIterator`.][58778]
2395- [All `NonZero` numeric types now implement `FromStr`.][58717]
2396- [Removed the `Read` trait bounds
2397 on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2398- [You can now call the `dbg!` macro without any parameters to print the file
2399 and line where it is called.][57847]
2400- [In place ASCII case conversions are now up to 4× faster.][59283]
2401 e.g. `str::make_ascii_lowercase`
2402- [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2403 and `Send`.][58369]
2404
2405Stabilized APIs
2406---------------
2407- [`f32::copysign`]
2408- [`f64::copysign`]
2409- [`RefCell::replace_with`]
2410- [`RefCell::map_split`]
2411- [`ptr::hash`]
2412- [`Range::contains`]
2413- [`RangeFrom::contains`]
2414- [`RangeTo::contains`]
2415- [`RangeInclusive::contains`]
2416- [`RangeToInclusive::contains`]
2417- [`Option::copied`]
2418
2419Cargo
2420-----
2421- [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2422 linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2423 platform specific.
48663c56 2424
532ac7d7
XL
2425Misc
2426----
2427- [The Rust toolchain is now available natively for musl based distros.][58575]
2428
2429[59460]: https://github.com/rust-lang/rust/pull/59460/
2430[59464]: https://github.com/rust-lang/rust/pull/59464/
2431[59500]: https://github.com/rust-lang/rust/pull/59500/
2432[59512]: https://github.com/rust-lang/rust/pull/59512/
2433[59580]: https://github.com/rust-lang/rust/pull/59580/
2434[59283]: https://github.com/rust-lang/rust/pull/59283/
2435[59451]: https://github.com/rust-lang/rust/pull/59451/
2436[59076]: https://github.com/rust-lang/rust/pull/59076/
2437[58778]: https://github.com/rust-lang/rust/pull/58778/
2438[58717]: https://github.com/rust-lang/rust/pull/58717/
2439[58369]: https://github.com/rust-lang/rust/pull/58369/
2440[58423]: https://github.com/rust-lang/rust/pull/58423/
2441[58080]: https://github.com/rust-lang/rust/pull/58080/
2442[57847]: https://github.com/rust-lang/rust/pull/57847/
2443[58575]: https://github.com/rust-lang/rust/pull/58575
2444[cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2445[`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2446[`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2447[`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2448[`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2449[`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2450[`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2451[`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2452[`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2453[`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2454[`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2455[`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2456
9fa01778
XL
2457Version 1.34.2 (2019-05-14)
2458===========================
2459
2460* [Destabilize the `Error::type_id` function due to a security
532ac7d7 2461 vulnerability][60785] ([CVE-2019-12083])
9fa01778
XL
2462
2463[60785]: https://github.com/rust-lang/rust/pull/60785
532ac7d7 2464[CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
9fa01778
XL
2465
2466Version 1.34.1 (2019-04-25)
2467===========================
2468
2469* [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2470* [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2471* [Fix Clippy panic when checking some macros][clippy/3805]
2472
2473[clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2474[clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2475[clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2476
2477Version 1.34.0 (2019-04-11)
2478==========================
2479
2480Language
2481--------
2482- [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2483 `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2484 but had no effect.
2485- [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2486 `#[attr{}]` procedural macros.][57367]
2487- [You can now write `extern crate self as foo;`][57407] to import your
2488 crate's root into the extern prelude.
2489
2490
2491Compiler
2492--------
2493- [You can now target `riscv64imac-unknown-none-elf` and
2494 `riscv64gc-unknown-none-elf`.][58406]
2495- [You can now enable linker plugin LTO optimisations with
2496 `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2497 into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2498 boundaries.
2499- [You can now target `powerpc64-unknown-freebsd`.][57809]
2500
2501
2502Libraries
2503---------
2504- [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2505 `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2506 the `Hash` trait to create an iterator.
2507- [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2508 methods.][58421] Most notably you no longer require the `Ord` trait to create
2509 an iterator.
2510- [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2511 for all numeric types.][58044]
2512- [Indexing a `str` is now generic over all types that
2513 implement `SliceIndex<str>`.][57604]
2514- [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2515 `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2516 produce a warning if their returning type is unused.
2517- [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2518 `overflowing_pow` are now available for all numeric types.][57873] These are
dc9dc135 2519 equivalent to methods such as `wrapping_add` for the `pow` operation.
9fa01778
XL
2520
2521
2522Stabilized APIs
2523---------------
2524
2525#### std & core
2526* [`Any::type_id`]
2527* [`Error::type_id`]
2528* [`atomic::AtomicI16`]
2529* [`atomic::AtomicI32`]
2530* [`atomic::AtomicI64`]
2531* [`atomic::AtomicI8`]
2532* [`atomic::AtomicU16`]
2533* [`atomic::AtomicU32`]
2534* [`atomic::AtomicU64`]
2535* [`atomic::AtomicU8`]
2536* [`convert::Infallible`]
2537* [`convert::TryFrom`]
2538* [`convert::TryInto`]
2539* [`iter::from_fn`]
2540* [`iter::successors`]
2541* [`num::NonZeroI128`]
2542* [`num::NonZeroI16`]
2543* [`num::NonZeroI32`]
2544* [`num::NonZeroI64`]
2545* [`num::NonZeroI8`]
2546* [`num::NonZeroIsize`]
2547* [`slice::sort_by_cached_key`]
2548* [`str::escape_debug`]
2549* [`str::escape_default`]
2550* [`str::escape_unicode`]
2551* [`str::split_ascii_whitespace`]
2552
2553#### std
2554* [`Instant::checked_add`]
2555* [`Instant::checked_sub`]
2556* [`SystemTime::checked_add`]
2557* [`SystemTime::checked_sub`]
2558
2559Cargo
2560-----
2561- [You can now use alternative registries to crates.io.][cargo/6654]
2562
2563Misc
2564----
2565- [You can now use the `?` operator in your documentation tests without manually
2566 adding `fn main() -> Result<(), _> {}`.][56470]
2567
2568Compatibility Notes
2569-------------------
dc9dc135
XL
2570- [`Command::before_exec` is being replaced by the unsafe method
2571 `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2572- [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
9fa01778
XL
2573 can now use `const` functions in `static` variables.
2574
2575[58370]: https://github.com/rust-lang/rust/pull/58370/
2576[58406]: https://github.com/rust-lang/rust/pull/58406/
2577[58421]: https://github.com/rust-lang/rust/pull/58421/
2578[58166]: https://github.com/rust-lang/rust/pull/58166/
2579[58044]: https://github.com/rust-lang/rust/pull/58044/
2580[58057]: https://github.com/rust-lang/rust/pull/58057/
2581[58059]: https://github.com/rust-lang/rust/pull/58059/
2582[57809]: https://github.com/rust-lang/rust/pull/57809/
2583[57873]: https://github.com/rust-lang/rust/pull/57873/
2584[57604]: https://github.com/rust-lang/rust/pull/57604/
2585[57367]: https://github.com/rust-lang/rust/pull/57367/
2586[57407]: https://github.com/rust-lang/rust/pull/57407/
2587[57425]: https://github.com/rust-lang/rust/pull/57425/
2588[57106]: https://github.com/rust-lang/rust/pull/57106/
2589[56470]: https://github.com/rust-lang/rust/pull/56470/
2590[cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2591[`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2592[`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2593[`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2594[`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2595[`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2596[`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2597[`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2598[`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2599[`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2600[`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2601[`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2602[`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2603[`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2604[`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2605[`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2606[`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2607[`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2608[`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2609[`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2610[`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2611[`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2612[`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2613[`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2614[`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2615[`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2616[`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2617[`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2618[`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2619[`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2620[`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2621
2622
0731742a
XL
2623Version 1.33.0 (2019-02-28)
2624==========================
2625
2626Language
2627--------
2628- [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2629 `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2630- [Integer patterns such as in a match expression can now be exhaustive.][56362]
2631 E.g. You can have match statement on a `u8` that covers `0..=255` and
2632 you would no longer be required to have a `_ => unreachable!()` case.
2633- [You can now have multiple patterns in `if let` and `while let`
2634 expressions.][57532] You can do this with the same syntax as a `match`
2635 expression. E.g.
2636 ```rust
2637 enum Creature {
2638 Crab(String),
2639 Lobster(String),
2640 Person(String),
2641 }
2642
2643 fn main() {
2644 let state = Creature::Crab("Ferris");
2645
2646 if let Creature::Crab(name) | Creature::Person(name) = state {
2647 println!("This creature's name is: {}", name);
2648 }
2649 }
2650 ```
2651- [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2652 this feature will by default produce a warning as this behaviour can be
2653 unintuitive. E.g. `if let _ = 5 {}`
2654- [You can now use `let` bindings, assignments, expression statements,
2655 and irrefutable pattern destructuring in const functions.][57175]
2656- [You can now call unsafe const functions.][57067] E.g.
2657 ```rust
2658 const unsafe fn foo() -> i32 { 5 }
2659 const fn bar() -> i32 {
2660 unsafe { foo() }
2661 }
2662 ```
2663- [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2664 E.g. `#[cfg_attr(all(), must_use, optimize)]`
2665- [You can now specify a specific alignment with the `#[repr(packed)]`
2666 attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2667 with an alignment of 2 bytes and a size of 6 bytes.
2668- [You can now import an item from a module as an `_`.][56303] This allows you to
2669 import a trait's impls, and not have the name in the namespace. E.g.
2670 ```rust
2671 use std::io::Read as _;
2672
2673 // Allowed as there is only one `Read` in the module.
2674 pub trait Read {}
2675 ```
2676- [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2677
2678Compiler
2679--------
2680- [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2681 command line argument.][56351]
416331ca 2682- [The minimum required LLVM version has been bumped to 6.0.][56642]
0731742a
XL
2683- [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2684- [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2685 tier 2 support.][57130] Visit the [platform support][platform-support] page for
2686 information on Rust's platform support.
2687- [Added support for the `thumbv7neon-linux-androideabi` and
2688 `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2689- [Added support for the `x86_64-unknown-uefi` target.][56769]
2690
2691Libraries
2692---------
2693- [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2694 functions for all numeric types.][57566]
2695- [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2696 are now `const` functions for all numeric types.][57105]
2697- [The methods `is_positive` and `is_negative` are now `const` functions for
2698 all signed numeric types.][57105]
2699- [The `get` method for all `NonZero` types is now `const`.][57167]
2700- [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2701 `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2702 numeric types.][57234]
2703- [`Ipv4Addr::new` is now a `const` function][57234]
2704
2705Stabilized APIs
2706---------------
2707- [`unix::FileExt::read_exact_at`]
2708- [`unix::FileExt::write_all_at`]
2709- [`Option::transpose`]
2710- [`Result::transpose`]
2711- [`convert::identity`]
2712- [`pin::Pin`]
2713- [`marker::Unpin`]
2714- [`marker::PhantomPinned`]
2715- [`Vec::resize_with`]
2716- [`VecDeque::resize_with`]
2717- [`Duration::as_millis`]
2718- [`Duration::as_micros`]
2719- [`Duration::as_nanos`]
2720
2721
2722Cargo
2723-----
9fa01778
XL
2724- [You can now publish crates that require a feature flag to compile with
2725 `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
0731742a
XL
2726- [Cargo should now rebuild a crate if a file was modified during the initial
2727 build.][cargo/6484]
2728
2729Compatibility Notes
2730-------------------
2731- The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2732 are now deprecated in the standard library, and their usage will now produce a warning.
2733 Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2734 methods instead.
2735- The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2736 downcasting.
9fa01778
XL
2737- [Libtest no longer creates a new thread for each test when
2738 `--test-threads=1`. It also runs the tests in deterministic order][56243]
0731742a
XL
2739
2740[55982]: https://github.com/rust-lang/rust/pull/55982/
9fa01778 2741[56243]: https://github.com/rust-lang/rust/pull/56243
0731742a
XL
2742[56303]: https://github.com/rust-lang/rust/pull/56303/
2743[56351]: https://github.com/rust-lang/rust/pull/56351/
2744[56362]: https://github.com/rust-lang/rust/pull/56362
2745[56642]: https://github.com/rust-lang/rust/pull/56642/
2746[56769]: https://github.com/rust-lang/rust/pull/56769/
2747[56805]: https://github.com/rust-lang/rust/pull/56805
2748[56947]: https://github.com/rust-lang/rust/pull/56947/
2749[57049]: https://github.com/rust-lang/rust/pull/57049/
2750[57067]: https://github.com/rust-lang/rust/pull/57067/
2751[57105]: https://github.com/rust-lang/rust/pull/57105
2752[57130]: https://github.com/rust-lang/rust/pull/57130/
2753[57167]: https://github.com/rust-lang/rust/pull/57167/
2754[57175]: https://github.com/rust-lang/rust/pull/57175/
2755[57234]: https://github.com/rust-lang/rust/pull/57234/
2756[57332]: https://github.com/rust-lang/rust/pull/57332/
2757[57465]: https://github.com/rust-lang/rust/pull/57465/
2758[57532]: https://github.com/rust-lang/rust/pull/57532/
2759[57535]: https://github.com/rust-lang/rust/pull/57535/
2760[57566]: https://github.com/rust-lang/rust/pull/57566/
2761[57615]: https://github.com/rust-lang/rust/pull/57615/
9fa01778 2762[cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
0731742a
XL
2763[cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2764[`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2765[`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2766[`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2767[`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2768[`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2769[`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2770[`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2771[`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2772[`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2773[`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2774[`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2775[`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2776[`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2777[platform-support]: https://forge.rust-lang.org/platform-support.html
2778
69743fb6
XL
2779Version 1.32.0 (2019-01-17)
2780==========================
2781
2782Language
2783--------
2784#### 2018 edition
2785- [You can now use the `?` operator in macro definitions.][56245] The `?`
2786 operator allows you to specify zero or one repetitions similar to the `*` and
2787 `+` operators.
2788- [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2789 now always resolve to the item (`enum`, `struct`, etc.) available in the
2790 module if present, before resolving to a external crate or an item the prelude.][56759]
2791 E.g.
2792 ```rust
2793 enum Color { Red, Green, Blue }
2794
2795 use Color::*;
2796 ```
2797
2798#### All editions
2799- [You can now match against `PhantomData<T>` types.][55837]
2800- [You can now match against literals in macros with the `literal`
2801 specifier.][56072] This will match against a literal of any type.
2802 E.g. `1`, `'A'`, `"Hello World"`
0731742a 2803- [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
69743fb6
XL
2804 ```rust
2805 struct Point(i32, i32);
2806
2807 impl Point {
2808 pub fn new(x: i32, y: i32) -> Self {
2809 Self(x, y)
2810 }
2811
2812 pub fn is_origin(&self) -> bool {
2813 match self {
2814 Self(0, 0) => true,
2815 _ => false,
2816 }
2817 }
2818 }
2819 ```
2820- [Self can also now be used in type definitions.][56366] E.g.
2821 ```rust
2822 enum List<T>
2823 where
2824 Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2825 {
2826 Nil,
2827 Cons(T, Box<Self>) // likewise here
2828 }
2829 ```
2830- [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2831 a `impl Trait` or `dyn Trait` is returned and unused in the program.
2832
2833Compiler
2834--------
2835- [The default allocator has changed from jemalloc to the default allocator on
2836 your system.][55238] The compiler itself on Linux & macOS will still use
2837 jemalloc, but programs compiled with it will use the system allocator.
2838- [Added the `aarch64-pc-windows-msvc` target.][55702]
2839
2840Libraries
2841---------
2842- [`PathBuf` now implements `FromStr`.][55148]
2843- [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2844- [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2845 easily debug expressions in your rust program. E.g.
2846 ```rust
2847 let a = 2;
2848 let b = dbg!(a * 2) + 1;
2849 // ^-- prints: [src/main.rs:4] a * 2 = 4
2850 assert_eq!(b, 5);
2851 ```
2852
2853The following APIs are now `const` functions and can be used in a
2854`const` context.
2855
2856- [`Cell::as_ptr`]
2857- [`UnsafeCell::get`]
2858- [`char::is_ascii`]
2859- [`iter::empty`]
2860- [`ManuallyDrop::new`]
2861- [`ManuallyDrop::into_inner`]
2862- [`RangeInclusive::start`]
2863- [`RangeInclusive::end`]
2864- [`NonNull::as_ptr`]
2865- [`slice::as_ptr`]
2866- [`str::as_ptr`]
2867- [`Duration::as_secs`]
2868- [`Duration::subsec_millis`]
2869- [`Duration::subsec_micros`]
2870- [`Duration::subsec_nanos`]
2871- [`CStr::as_ptr`]
2872- [`Ipv4Addr::is_unspecified`]
2873- [`Ipv6Addr::new`]
2874- [`Ipv6Addr::octets`]
2875
2876Stabilized APIs
2877---------------
2878- [`i8::to_be_bytes`]
2879- [`i8::to_le_bytes`]
2880- [`i8::to_ne_bytes`]
2881- [`i8::from_be_bytes`]
2882- [`i8::from_le_bytes`]
2883- [`i8::from_ne_bytes`]
2884- [`i16::to_be_bytes`]
2885- [`i16::to_le_bytes`]
2886- [`i16::to_ne_bytes`]
2887- [`i16::from_be_bytes`]
2888- [`i16::from_le_bytes`]
2889- [`i16::from_ne_bytes`]
2890- [`i32::to_be_bytes`]
2891- [`i32::to_le_bytes`]
2892- [`i32::to_ne_bytes`]
2893- [`i32::from_be_bytes`]
2894- [`i32::from_le_bytes`]
2895- [`i32::from_ne_bytes`]
2896- [`i64::to_be_bytes`]
2897- [`i64::to_le_bytes`]
2898- [`i64::to_ne_bytes`]
2899- [`i64::from_be_bytes`]
2900- [`i64::from_le_bytes`]
2901- [`i64::from_ne_bytes`]
2902- [`i128::to_be_bytes`]
2903- [`i128::to_le_bytes`]
2904- [`i128::to_ne_bytes`]
2905- [`i128::from_be_bytes`]
2906- [`i128::from_le_bytes`]
2907- [`i128::from_ne_bytes`]
2908- [`isize::to_be_bytes`]
2909- [`isize::to_le_bytes`]
2910- [`isize::to_ne_bytes`]
2911- [`isize::from_be_bytes`]
2912- [`isize::from_le_bytes`]
2913- [`isize::from_ne_bytes`]
2914- [`u8::to_be_bytes`]
2915- [`u8::to_le_bytes`]
2916- [`u8::to_ne_bytes`]
2917- [`u8::from_be_bytes`]
2918- [`u8::from_le_bytes`]
2919- [`u8::from_ne_bytes`]
2920- [`u16::to_be_bytes`]
2921- [`u16::to_le_bytes`]
2922- [`u16::to_ne_bytes`]
2923- [`u16::from_be_bytes`]
2924- [`u16::from_le_bytes`]
2925- [`u16::from_ne_bytes`]
2926- [`u32::to_be_bytes`]
2927- [`u32::to_le_bytes`]
2928- [`u32::to_ne_bytes`]
2929- [`u32::from_be_bytes`]
2930- [`u32::from_le_bytes`]
2931- [`u32::from_ne_bytes`]
2932- [`u64::to_be_bytes`]
2933- [`u64::to_le_bytes`]
2934- [`u64::to_ne_bytes`]
2935- [`u64::from_be_bytes`]
2936- [`u64::from_le_bytes`]
2937- [`u64::from_ne_bytes`]
2938- [`u128::to_be_bytes`]
2939- [`u128::to_le_bytes`]
2940- [`u128::to_ne_bytes`]
2941- [`u128::from_be_bytes`]
2942- [`u128::from_le_bytes`]
2943- [`u128::from_ne_bytes`]
2944- [`usize::to_be_bytes`]
2945- [`usize::to_le_bytes`]
2946- [`usize::to_ne_bytes`]
2947- [`usize::from_be_bytes`]
2948- [`usize::from_le_bytes`]
2949- [`usize::from_ne_bytes`]
2950
2951Cargo
2952-----
2953- [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2954- [Usernames are now allowed in alt registry URLs.][cargo/6242]
2955
2956Misc
2957----
2958- [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2959
2960Compatibility Notes
2961-------------------
2962- [The argument types for AVX's
2963 `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2964 been changed from `*const` to `*mut` as the previous implementation
2965 was unsound.
2966
2967
2968[55148]: https://github.com/rust-lang/rust/pull/55148/
2969[55238]: https://github.com/rust-lang/rust/pull/55238/
2970[55280]: https://github.com/rust-lang/rust/pull/55280/
2971[55610]: https://github.com/rust-lang/rust/pull/55610/
2972[55663]: https://github.com/rust-lang/rust/pull/55663/
2973[55702]: https://github.com/rust-lang/rust/pull/55702/
2974[55837]: https://github.com/rust-lang/rust/pull/55837/
2975[55843]: https://github.com/rust-lang/rust/pull/55843/
2976[56072]: https://github.com/rust-lang/rust/pull/56072/
2977[56245]: https://github.com/rust-lang/rust/pull/56245/
2978[56365]: https://github.com/rust-lang/rust/pull/56365/
2979[56366]: https://github.com/rust-lang/rust/pull/56366/
2980[56395]: https://github.com/rust-lang/rust/pull/56395/
2981[56759]: https://github.com/rust-lang/rust/pull/56759/
2982[cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2983[cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2984[`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2985[`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2986[`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2987[`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2988[`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2989[`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2990[`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2991[`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2992[`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2993[`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2994[`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2995[`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2996[`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2997[`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2998[`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2999[`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3000[`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3001[`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3002[`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3003[`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3004[`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3005[`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3006[`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3007[`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3008[`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3009[`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3010[`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3011[`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3012[`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3013[`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3014[`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3015[`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3016[`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3017[`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3018[`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3019[`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3020[`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3021[`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3022[`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3023[`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3024[`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3025[`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3026[`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3027[`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3028[`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3029[`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3030[`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3031[`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3032[`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3033[`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3034[`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3035[`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3036[`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3037[`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3038[`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3039[`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3040[`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3041[`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3042[`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3043[`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3044[`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3045[`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3046[`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3047[`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3048[`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3049[`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3050[`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3051[`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3052[`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3053[`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3054[`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3055[`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3056[`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3057[`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3058[`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3059[`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3060[`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3061[`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3062[`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3063[`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3064[`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3065[`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3066[`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3067[`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3068[`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3069[`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3070[`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3071[`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3072[`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3073[`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3074[`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3075
3076
3077Version 1.31.1 (2018-12-20)
3078===========================
3079
3080- [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3081- [Fix broken go-to-definition in RLS][rls/1171]
3082- [Fix infinite loop on hover in RLS][rls/1170]
3083
3084[56562]: https://github.com/rust-lang/rust/pull/56562
3085[rls/1171]: https://github.com/rust-lang/rls/issues/1171
3086[rls/1170]: https://github.com/rust-lang/rls/pull/1170
3087
13cf67c4
XL
3088Version 1.31.0 (2018-12-06)
3089==========================
3090
3091Language
3092--------
0731742a 3093- 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
13cf67c4
XL
3094- [New lifetime elision rules now allow for eliding lifetimes in functions and
3095 impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3096 `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3097 in structs.
3098- [You can now define and use `const` functions.][54835] These are currently
3099 a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3100 [language reference][const-reference] for what exactly is available.
3101- [You can now use tool lints, which allow you to scope lints from external
3102 tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3103- [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3104 a crate, not just in exported functions.][54451]
3105- [You can now use parentheses in pattern matches.][54497]
3106
3107Compiler
3108--------
3109- [Updated musl to 1.1.20][54430]
3110
3111Libraries
3112---------
416331ca 3113- [You can now convert `num::NonZero*` types to their raw equivalents using the
13cf67c4
XL
3114 `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3115- [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3116 into `Option<&mut T>` using the `From` trait.][53218]
3117- [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3118
3119
3120Stabilized APIs
3121---------------
3122- [`slice::align_to`]
3123- [`slice::align_to_mut`]
3124- [`slice::chunks_exact`]
3125- [`slice::chunks_exact_mut`]
3126- [`slice::rchunks`]
3127- [`slice::rchunks_mut`]
3128- [`slice::rchunks_exact`]
3129- [`slice::rchunks_exact_mut`]
3130- [`Option::replace`]
3131
3132Cargo
3133-----
3134- [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3135- [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3136 on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3137
3138[52813]: https://github.com/rust-lang/rust/pull/52813/
3139[53218]: https://github.com/rust-lang/rust/pull/53218/
3140[53555]: https://github.com/rust-lang/rust/issues/53555/
3141[54057]: https://github.com/rust-lang/rust/pull/54057/
3142[54240]: https://github.com/rust-lang/rust/pull/54240/
3143[54430]: https://github.com/rust-lang/rust/pull/54430/
3144[54451]: https://github.com/rust-lang/rust/pull/54451/
3145[54497]: https://github.com/rust-lang/rust/pull/54497/
3146[54778]: https://github.com/rust-lang/rust/pull/54778/
3147[54835]: https://github.com/rust-lang/rust/pull/54835/
3148[54870]: https://github.com/rust-lang/rust/pull/54870/
3149[RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3150[`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3151[`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3152[`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3153[`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3154[`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3155[`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3156[`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3157[`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3158[`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3159[cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3160[cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3161[cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3162[const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3163
3164Version 1.30.1 (2018-11-08)
3165===========================
3166
3167- [Fixed overflow ICE in rustdoc][54199]
3168- [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3169
3170[54199]: https://github.com/rust-lang/rust/pull/54199
3171[cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3172
4462d4a0
XL
3173Version 1.30.0 (2018-10-25)
3174==========================
3175
3176Language
3177--------
3178- [Procedural macros are now available.][52081] These kinds of macros allow for
3179 more powerful code generation. There is a [new chapter available][proc-macros]
3180 in the Rust Programming Language book that goes further in depth.
3181- [You can now use keywords as identifiers using the raw identifiers
3182 syntax (`r#`),][53236] e.g. `let r#for = true;`
3183- [Using anonymous parameters in traits is now deprecated with a warning and
3184 will be a hard error in the 2018 edition.][53272]
3185- [You can now use `crate` in paths.][54404] This allows you to refer to the
3186 crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3187- [Using a external crate no longer requires being prefixed with `::`.][54404]
3188 Previously, using a external crate in a module without a use statement
3189 required `let json = ::serde_json::from_str(foo);` but can now be written
3190 as `let json = serde_json::from_str(foo);`.
3191- [You can now apply the `#[used]` attribute to static items to prevent the
3192 compiler from optimising them away, even if they appear to be unused,][51363]
3193 e.g. `#[used] static FOO: u32 = 1;`
3194- [You can now import and reexport macros from other crates with the `use`
3195 syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3196 the root module of the crate. If your macro relies on calling other local
3197 macros, it is recommended to export with the
3198 `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3199 those macros.
3200- [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3201 using the `vis` specifier.][53370]
3202- [Non-macro attributes now allow all forms of literals, not just
3203 strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3204 write `#[attr(true)]`.
3205- [You can now specify a function to handle a panic in the Rust runtime with the
3206 `#[panic_handler]` attribute.][51366]
3207
3208Compiler
3209--------
3210- [Added the `riscv32imc-unknown-none-elf` target.][53822]
3211- [Added the `aarch64-unknown-netbsd` target][53165]
2a314972 3212- [Upgraded to LLVM 8.][53611]
4462d4a0
XL
3213
3214Libraries
3215---------
3216- [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3217
3218Stabilized APIs
3219---------------
3220- [`Ipv4Addr::BROADCAST`]
3221- [`Ipv4Addr::LOCALHOST`]
3222- [`Ipv4Addr::UNSPECIFIED`]
3223- [`Ipv6Addr::LOCALHOST`]
3224- [`Ipv6Addr::UNSPECIFIED`]
3225- [`Iterator::find_map`]
3226
3227 The following methods are replacement methods for `trim_left`, `trim_right`,
3228 `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3229 in 1.33.0:
3230- [`str::trim_end_matches`]
3231- [`str::trim_end`]
3232- [`str::trim_start_matches`]
3233- [`str::trim_start`]
3234
3235Cargo
3236----
3237- [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3238- [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3239 equivalent to calling `rustdoc --error-format=json`.
4462d4a0
XL
3240- [Cargo will now provide a progress bar for builds.][cargo/5995]
3241
3242Misc
3243----
3244- [`rustdoc` allows you to specify what edition to treat your code as with the
3245 `--edition` option.][54057]
3246- [`rustdoc` now has the `--color` (specify whether to output color) and
3247 `--error-format` (specify error format, e.g. `json`) options.][53003]
3248- [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3249 debug symbols.][53774]
3250- [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3251 available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3252
3253[50911]: https://github.com/rust-lang/rust/pull/50911/
3254[51363]: https://github.com/rust-lang/rust/pull/51363/
3255[51366]: https://github.com/rust-lang/rust/pull/51366/
3256[52081]: https://github.com/rust-lang/rust/pull/52081/
3257[53003]: https://github.com/rust-lang/rust/pull/53003/
3258[53033]: https://github.com/rust-lang/rust/pull/53033/
3259[53044]: https://github.com/rust-lang/rust/pull/53044/
3260[53165]: https://github.com/rust-lang/rust/pull/53165/
2a314972 3261[53611]: https://github.com/rust-lang/rust/pull/53611/
4462d4a0
XL
3262[53213]: https://github.com/rust-lang/rust/pull/53213/
3263[53236]: https://github.com/rust-lang/rust/pull/53236/
3264[53272]: https://github.com/rust-lang/rust/pull/53272/
3265[53370]: https://github.com/rust-lang/rust/pull/53370/
3266[53459]: https://github.com/rust-lang/rust/pull/53459/
3267[53774]: https://github.com/rust-lang/rust/pull/53774/
3268[53822]: https://github.com/rust-lang/rust/pull/53822/
3269[54057]: https://github.com/rust-lang/rust/pull/54057/
3270[54146]: https://github.com/rust-lang/rust/pull/54146/
3271[54404]: https://github.com/rust-lang/rust/pull/54404/
3272[cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3273[cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4462d4a0 3274[cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
a1dfa0c6 3275[proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4462d4a0
XL
3276
3277[`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3278[`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3279[`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3280[`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3281[`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3282[`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3283[`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3284[`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3285[`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3286[`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3287
3288
3289Version 1.29.2 (2018-10-11)
3290===========================
3291
3292- [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3293- The `rls-preview` component on the windows-gnu targets has been restored.
3294
3295[54639]: https://github.com/rust-lang/rust/pull/54639
3296
3297
3298Version 1.29.1 (2018-09-25)
3299===========================
3300
3301Security Notes
3302--------------
3303
3304- The standard library's `str::repeat` function contained an out of bounds write
3305 caused by an integer overflow. This has been fixed by deterministically
3306 panicking when an overflow happens.
3307
416331ca 3308 Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4462d4a0
XL
3309 us.
3310
3311
8faf50e0
XL
3312Version 1.29.0 (2018-09-13)
3313==========================
3314
3315Compiler
3316--------
3317- [Bumped minimum LLVM version to 5.0.][51899]
3318- [Added `powerpc64le-unknown-linux-musl` target.][51619]
3319- [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2a314972 3320- [Upgraded to LLVM 7.][51966]
8faf50e0
XL
3321
3322Libraries
3323---------
4462d4a0 3324- [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
8faf50e0
XL
3325- [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3326- [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3327- [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3328 for `&str`.][51178]
3329- [`Cell<T>` now allows `T` to be unsized.][50494]
3330- [`SocketAddr` is now stable on Redox.][52656]
3331
3332Stabilized APIs
3333---------------
3334- [`Arc::downcast`]
3335- [`Iterator::flatten`]
3336- [`Rc::downcast`]
3337
3338Cargo
3339-----
4462d4a0
XL
3340- [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3341 `--locked` to disable this behavior.
8faf50e0 3342- [`cargo-install` will now allow you to cross compile an install
4462d4a0 3343 using `--target`.][cargo/5614]
8faf50e0
XL
3344- [Added the `cargo-fix` subcommand to automatically move project code from
3345 2015 edition to 2018.][cargo/5723]
b7449926
XL
3346- [`cargo doc` can now optionally document private types using the
3347 `--document-private-items` flag.][cargo/5543]
8faf50e0
XL
3348
3349Misc
3350----
3351- [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3352 the specified level to that level.][52354] For example `--cap-lints warn`
3353 will demote `deny` and `forbid` lints to `warn`.
3354- [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4462d4a0 3355 fails and `101` if there is a panic.][52197]
8faf50e0 3356- [A preview of clippy has been made available through rustup.][51122]
4462d4a0 3357 You can install the preview with `rustup component add clippy-preview`.
8faf50e0
XL
3358
3359Compatibility Notes
3360-------------------
3361- [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3362 Use `str::get_unchecked(begin..end)` instead.
4462d4a0 3363- [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
8faf50e0
XL
3364 Consider using the `home_dir` function from
3365 https://crates.io/crates/dirs instead.
3366- [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4462d4a0
XL
3367- [`cfg` attributes and `--cfg` command line flags are now more
3368 strictly validated.][53893]
8faf50e0 3369
4462d4a0 3370[53893]: https://github.com/rust-lang/rust/pull/53893/
8faf50e0 3371[52861]: https://github.com/rust-lang/rust/pull/52861/
2a314972 3372[51966]: https://github.com/rust-lang/rust/pull/51966/
8faf50e0
XL
3373[52656]: https://github.com/rust-lang/rust/pull/52656/
3374[52239]: https://github.com/rust-lang/rust/pull/52239/
3375[52330]: https://github.com/rust-lang/rust/pull/52330/
3376[52354]: https://github.com/rust-lang/rust/pull/52354/
3377[52402]: https://github.com/rust-lang/rust/pull/52402/
3378[52103]: https://github.com/rust-lang/rust/pull/52103/
3379[52197]: https://github.com/rust-lang/rust/pull/52197/
3380[51807]: https://github.com/rust-lang/rust/pull/51807/
3381[51899]: https://github.com/rust-lang/rust/pull/51899/
3382[51912]: https://github.com/rust-lang/rust/pull/51912/
3383[51511]: https://github.com/rust-lang/rust/pull/51511/
3384[51619]: https://github.com/rust-lang/rust/pull/51619/
3385[51656]: https://github.com/rust-lang/rust/pull/51656/
3386[51178]: https://github.com/rust-lang/rust/pull/51178/
3387[51122]: https://github.com/rust-lang/rust/pull/51122
3388[50494]: https://github.com/rust-lang/rust/pull/50494/
b7449926 3389[cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
8faf50e0
XL
3390[cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3391[cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3392[cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3393[`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3394[`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3395[`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3396
3397
94b46f34 3398Version 1.28.0 (2018-08-02)
5d61e2ac
XL
3399===========================
3400
94b46f34
XL
3401Language
3402--------
3403- [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3404 allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3405 the inner type across Foreign Function Interface (FFI) boundaries.
3406- [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3407 and can now be used as identifiers.][51196]
3408- [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3409 stable.][51241] This will allow users to specify a global allocator for
3410 their program.
3411- [Unit test functions marked with the `#[test]` attribute can now return
3412 `Result<(), E: Debug>` in addition to `()`.][51298]
3413- [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3414 allows macros to easily target lifetimes.
3415
3416Compiler
3417--------
3418- [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3419 prioritise making smaller binary sizes. `z` is the same as `s` with the
3420 exception that it does not vectorise loops, which typically results in an even
3421 smaller binary.
3422- [The short error format is now stable.][49546] Specified with
3423 `--error-format=short` this option will provide a more compressed output of
3424 rust error messages.
3425- [Added a lint warning when you have duplicated `macro_export`s.][50143]
3426- [Reduced the number of allocations in the macro parser.][50855] This can
3427 improve compile times of macro heavy crates on average by 5%.
3428
3429Libraries
3430---------
3431- [Implemented `Default` for `&mut str`.][51306]
3432- [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3433- [Implemented `Extend` for `()`.][50234]
3434- [The `Debug` implementation of `time::Duration` should now be more easily
3435 human readable.][50364] Previously a `Duration` of one second would printed as
3436 `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3437- [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3438 `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3439 for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3440 `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3441 for `PathBuf`.][50170]
3442- [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3443 and `Wrapping<i128>`.][50465]
3444- [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3445 possible.][51050] This can provide up to a 40% speed increase.
3446- [Improved error messages when using `format!`.][50610]
3447
3448Stabilized APIs
3449---------------
3450- [`Iterator::step_by`]
3451- [`Path::ancestors`]
74d20737
XL
3452- [`SystemTime::UNIX_EPOCH`]
3453- [`alloc::GlobalAlloc`]
3454- [`alloc::Layout`]
3455- [`alloc::LayoutErr`]
3456- [`alloc::System`]
3457- [`alloc::alloc`]
3458- [`alloc::alloc_zeroed`]
3459- [`alloc::dealloc`]
3460- [`alloc::realloc`]
3461- [`alloc::handle_alloc_error`]
94b46f34
XL
3462- [`btree_map::Entry::or_default`]
3463- [`fmt::Alignment`]
3464- [`hash_map::Entry::or_default`]
3465- [`iter::repeat_with`]
3466- [`num::NonZeroUsize`]
3467- [`num::NonZeroU128`]
3468- [`num::NonZeroU16`]
3469- [`num::NonZeroU32`]
3470- [`num::NonZeroU64`]
3471- [`num::NonZeroU8`]
3472- [`ops::RangeBounds`]
3473- [`slice::SliceIndex`]
3474- [`slice::from_mut`]
3475- [`slice::from_ref`]
3476- [`{Any + Send + Sync}::downcast_mut`]
3477- [`{Any + Send + Sync}::downcast_ref`]
3478- [`{Any + Send + Sync}::is`]
3479
3480Cargo
3481-----
3482- [Cargo will now no longer allow you to publish crates with build scripts that
3483 modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3484 considered to be immutable.
3485
3486Misc
3487----
3488- [The `suggestion_applicability` field in `rustc`'s json output is now
3489 stable.][50486] This will allow dev tools to check whether a code suggestion
3490 would apply to them.
3491
5d61e2ac
XL
3492Compatibility Notes
3493-------------------
8faf50e0
XL
3494- [Rust will consider trait objects with duplicated constraints to be the same
3495 type as without the duplicated constraint.][51276] For example the below code will
3496 now fail to compile.
94b46f34
XL
3497 ```rust
3498 trait Trait {}
3499
3500 impl Trait + Send {
3501 fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3502 }
5d61e2ac 3503
94b46f34
XL
3504 impl Trait + Send + Send {
3505 fn test(&self) { println!("two"); }
3506 }
3507 ```
5d61e2ac 3508
94b46f34
XL
3509[49546]: https://github.com/rust-lang/rust/pull/49546/
3510[50143]: https://github.com/rust-lang/rust/pull/50143/
3511[50170]: https://github.com/rust-lang/rust/pull/50170/
3512[50234]: https://github.com/rust-lang/rust/pull/50234/
3513[50265]: https://github.com/rust-lang/rust/pull/50265/
3514[50364]: https://github.com/rust-lang/rust/pull/50364/
3515[50385]: https://github.com/rust-lang/rust/pull/50385/
3516[50465]: https://github.com/rust-lang/rust/pull/50465/
3517[50486]: https://github.com/rust-lang/rust/pull/50486/
3518[50554]: https://github.com/rust-lang/rust/pull/50554/
3519[50610]: https://github.com/rust-lang/rust/pull/50610/
3520[50855]: https://github.com/rust-lang/rust/pull/50855/
3521[51050]: https://github.com/rust-lang/rust/pull/51050/
3522[51196]: https://github.com/rust-lang/rust/pull/51196/
3523[51200]: https://github.com/rust-lang/rust/pull/51200/
3524[51241]: https://github.com/rust-lang/rust/pull/51241/
3525[51276]: https://github.com/rust-lang/rust/pull/51276/
3526[51298]: https://github.com/rust-lang/rust/pull/51298/
3527[51306]: https://github.com/rust-lang/rust/pull/51306/
3528[51562]: https://github.com/rust-lang/rust/pull/51562/
3529[cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3530[`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3531[`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
74d20737
XL
3532[`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3533[`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3534[`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3535[`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3536[`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3537[`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3538[`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3539[`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3540[`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3541[`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
94b46f34
XL
3542[`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3543[`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
8faf50e0 3544[`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
94b46f34
XL
3545[`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3546[`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3547[`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3548[`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3549[`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3550[`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3551[`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3552[`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3553[`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3554[`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3555[`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3556[`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3557[`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3558[`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
5d61e2ac 3559
8faf50e0
XL
3560Version 1.27.2 (2018-07-20)
3561===========================
3562
3563Compatibility Notes
3564-------------------
3565
3566- The borrow checker was fixed to avoid potential unsoundness when using
3567 match ergonomics: [#52213][52213].
3568
3569[52213]: https://github.com/rust-lang/rust/issues/52213
3570
83c7162d
XL
3571Version 1.27.1 (2018-07-10)
3572===========================
3573
3574Security Notes
3575--------------
3576
3577- rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3578 when running, which enabled executing code as some other user on a
3579 given machine. This release fixes that vulnerability; you can read
94b46f34 3580 more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
83c7162d 3581
416331ca 3582 Thank you to Red Hat for responsibly disclosing this vulnerability to us.
83c7162d
XL
3583
3584Compatibility Notes
3585-------------------
3586
3587- The borrow checker was fixed to avoid an additional potential unsoundness when using
3588 match ergonomics: [#51415][51415], [#49534][49534].
3589
3590[51415]: https://github.com/rust-lang/rust/issues/51415
3591[49534]: https://github.com/rust-lang/rust/issues/49534
3592[rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
94b46f34 3593[CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
83c7162d
XL
3594
3595Version 1.27.0 (2018-06-21)
3596==========================
3597
3598Language
3599--------
3600- [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
8faf50e0 3601 be used as an identifier.
83c7162d
XL
3602- [The dyn syntax is now available.][49968] This syntax is equivalent to the
3603 bare `Trait` syntax, and should make it clearer when being used in tandem with
4462d4a0 3604 `impl Trait` because it is equivalent to the following syntax:
83c7162d
XL
3605 `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3606 `Box<Trait> == Box<dyn Trait>`.
3607- [Attributes on generic parameters such as types and lifetimes are
3608 now stable.][48851] e.g.
3609 `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3610- [The `#[must_use]` attribute can now also be used on functions as well as
3611 types.][48925] It provides a lint that by default warns users when the
3612 value returned by a function has not been used.
3613
3614Compiler
3615--------
b7449926 3616- [Added the `armv5te-unknown-linux-musleabi` target.][50423]
83c7162d
XL
3617
3618Libraries
3619---------
3620- [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3621 This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3622 SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3623 `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3624 the `cfg` attribute.
3625- [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3626 std are now available in core.][49896]
3627- [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3628 to `Self`.][49630]
3629- [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3630 that the operation isn't done in place.
3631- [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3632 the `#[must_use]` attribute][49533] to warn about unused potentially
3633 expensive allocations.
3634
3635Stabilized APIs
3636---------------
3637- [`DoubleEndedIterator::rfind`]
3638- [`DoubleEndedIterator::rfold`]
3639- [`DoubleEndedIterator::try_rfold`]
3640- [`Duration::from_micros`]
3641- [`Duration::from_nanos`]
3642- [`Duration::subsec_micros`]
3643- [`Duration::subsec_millis`]
3644- [`HashMap::remove_entry`]
3645- [`Iterator::try_fold`]
3646- [`Iterator::try_for_each`]
3647- [`NonNull::cast`]
3648- [`Option::filter`]
3649- [`String::replace_range`]
3650- [`Take::set_limit`]
3651- [`hint::unreachable_unchecked`]
3652- [`os::unix::process::parent_id`]
83c7162d
XL
3653- [`ptr::swap_nonoverlapping`]
3654- [`slice::rsplit_mut`]
3655- [`slice::rsplit`]
3656- [`slice::swap_with_slice`]
3657
3658Cargo
3659-----
3660- [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3661 `readme`, and `repository` fields.][cargo/5386]
94b46f34 3662- [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
83c7162d
XL
3663- [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3664 a different directory than `target` for placing compilation artifacts.
3665- [Cargo will be adding automatic target inference for binaries, benchmarks,
3666 examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4462d4a0 3667 specific targets, e.g. using `[[bin]]`, and have other binaries in locations
83c7162d 3668 where cargo would infer a binary, Cargo will produce a warning. You can
4462d4a0
XL
3669 disable this feature ahead of time by setting any of the following to false:
3670 `autobins`, `autobenches`, `autoexamples`, `autotests`.
83c7162d
XL
3671- [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3672 setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3673
3674Misc
3675----
3676- [Added “The Rustc book” into the official documentation.][49707]
3677 [“The Rustc book”] documents and teaches how to use the rustc compiler.
3678- [All books available on `doc.rust-lang.org` are now searchable.][49623]
3679
3680Compatibility Notes
3681-------------------
3682- [Calling a `CharExt` or `StrExt` method directly on core will no longer
3683 work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3684 compile, `"".is_empty()` will still compile.
3685- [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4462d4a0
XL
3686 will only print the inner type.][48553] E.g.
3687 `print!("{:?}", AtomicBool::new(true))` will print `true`,
83c7162d
XL
3688 not `AtomicBool(true)`.
3689- [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3690 could enter higher numbers but they were not supported by LLVM. Up to 512MB
3691 alignment should cover all use cases.
b7449926
XL
3692- The `.description()` method on the `std::error::Error` trait
3693 [has been soft-deprecated][50163]. It is no longer required to implement it.
83c7162d
XL
3694
3695[48553]: https://github.com/rust-lang/rust/pull/48553/
3696[48851]: https://github.com/rust-lang/rust/pull/48851/
3697[48925]: https://github.com/rust-lang/rust/pull/48925/
3698[49533]: https://github.com/rust-lang/rust/pull/49533/
3699[49623]: https://github.com/rust-lang/rust/pull/49623/
3700[49630]: https://github.com/rust-lang/rust/pull/49630/
3701[49664]: https://github.com/rust-lang/rust/pull/49664/
3702[49699]: https://github.com/rust-lang/rust/pull/49699/
3703[49707]: https://github.com/rust-lang/rust/pull/49707/
3704[49719]: https://github.com/rust-lang/rust/pull/49719/
3705[49896]: https://github.com/rust-lang/rust/pull/49896/
3706[49968]: https://github.com/rust-lang/rust/pull/49968/
b7449926 3707[50163]: https://github.com/rust-lang/rust/pull/50163
83c7162d
XL
3708[50177]: https://github.com/rust-lang/rust/pull/50177/
3709[50378]: https://github.com/rust-lang/rust/pull/50378/
3710[50398]: https://github.com/rust-lang/rust/pull/50398/
3711[50423]: https://github.com/rust-lang/rust/pull/50423/
3712[cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3713[cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3714[cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
94b46f34 3715[cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
83c7162d
XL
3716[cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3717[cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3718[`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3719[`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3720[`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3721[`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3722[`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3723[`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3724[`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3725[`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3726[`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3727[`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3728[`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3729[`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3730[`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3731[`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
94b46f34
XL
3732[`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3733[`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3734[`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3735[`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
83c7162d
XL
3736[`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3737[`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3738[`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3739[`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3740[`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
83c7162d
XL
3741[“The Rustc book”]: https://doc.rust-lang.org/rustc
3742
3743
2c912e08
XL
3744Version 1.26.2 (2018-06-05)
3745==========================
3746
3747Compatibility Notes
3748-------------------
3749
4462d4a0 3750- [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2c912e08
XL
3751
3752[51117]: https://github.com/rust-lang/rust/issues/51117
3753
83c7162d 3754
564c78a2
XL
3755Version 1.26.1 (2018-05-29)
3756==========================
3757
3758Tools
3759-----
3760
4462d4a0
XL
3761- [RLS now works on Windows.][50646]
3762- [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
564c78a2 3763
94b46f34 3764
564c78a2
XL
3765Compatibility Notes
3766--------
3767
3768- [`fn main() -> impl Trait` no longer works for non-Termination
4462d4a0 3769 trait.][50656]
564c78a2 3770 This reverts an accidental stabilization.
4462d4a0
XL
3771- [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3772- [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
564c78a2
XL
3773
3774[50646]: https://github.com/rust-lang/rust/issues/50646
3775[50656]: https://github.com/rust-lang/rust/pull/50656
3776[50812]: https://github.com/rust-lang/rust/pull/50812
3777[50950]: https://github.com/rust-lang/rust/issues/50950
3778[rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3779
3780Version 1.26.0 (2018-05-10)
3781==========================
3782
3783Language
3784--------
3785- [Closures now implement `Copy` and/or `Clone` if all captured variables
3786 implement either or both traits.][49299]
3787- [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4462d4a0 3788- [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
564c78a2
XL
3789 lifetime can be elided.][49458]
3790- [`impl Trait` is now stable allowing you to have abstract types in returns
4462d4a0 3791 or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
564c78a2
XL
3792 `fn open(path: impl AsRef<Path>)`.
3793- [Pattern matching will now automatically apply dereferences.][49394]
3794- [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3795- [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3796- [A lot of operations are now available in a const context.][46882] E.g. You
3797 can now index into constant arrays, reference and dereference into constants,
4462d4a0
XL
3798 and use tuple struct constructors.
3799- [Fixed entry slice patterns are now stable.][48516] E.g.
564c78a2
XL
3800 ```rust
3801 let points = [1, 2, 3, 4];
3802 match points {
3803 [1, 2, 3, 4] => println!("All points were sequential."),
3804 _ => println!("Not all points were sequential."),
3805 }
3806 ```
3807
3808
3809Compiler
3810--------
3811- [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3812- [Fixed exponential projection complexity on nested types.][48296]
3813 This can provide up to a ~12% reduction in compile times for certain crates.
3814- [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3815 to remap path prefixes outputted by the compiler.
3816- [Added `powerpc-unknown-netbsd` target.][48281]
3817
3818Libraries
3819---------
3820- [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3821- [Added hexadecimal formatting for integers with fmt::Debug][48978]
3822 e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3823- [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3824- [Optimized `str::repeat` being 8x faster in large cases.][48657]
3825- [`ascii::escape_default` is now available in libcore.][48735]
3826- [Trailing commas are now supported in std and core macros.][48056]
3827- [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3828- [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3829
3830Stabilized APIs
3831---------------
3832- [`*const T::add`]
3833- [`*const T::copy_to_nonoverlapping`]
3834- [`*const T::copy_to`]
3835- [`*const T::read_unaligned`]
3836- [`*const T::read_volatile`]
3837- [`*const T::read`]
3838- [`*const T::sub`]
3839- [`*const T::wrapping_add`]
3840- [`*const T::wrapping_sub`]
3841- [`*mut T::add`]
3842- [`*mut T::copy_to_nonoverlapping`]
3843- [`*mut T::copy_to`]
3844- [`*mut T::read_unaligned`]
3845- [`*mut T::read_volatile`]
3846- [`*mut T::read`]
3847- [`*mut T::replace`]
3848- [`*mut T::sub`]
3849- [`*mut T::swap`]
3850- [`*mut T::wrapping_add`]
3851- [`*mut T::wrapping_sub`]
3852- [`*mut T::write_bytes`]
3853- [`*mut T::write_unaligned`]
3854- [`*mut T::write_volatile`]
3855- [`*mut T::write`]
3856- [`Box::leak`]
3857- [`FromUtf8Error::as_bytes`]
3858- [`LocalKey::try_with`]
3859- [`Option::cloned`]
3860- [`btree_map::Entry::and_modify`]
3861- [`fs::read_to_string`]
3862- [`fs::read`]
3863- [`fs::write`]
3864- [`hash_map::Entry::and_modify`]
3865- [`iter::FusedIterator`]
3866- [`ops::RangeInclusive`]
3867- [`ops::RangeToInclusive`]
3868- [`process::id`]
3869- [`slice::rotate_left`]
3870- [`slice::rotate_right`]
3871- [`String::retain`]
3872
3873
3874Cargo
3875-----
3876- [Cargo will now output path to custom commands when `-v` is
3877 passed with `--list`][cargo/5041]
3878- [The Cargo binary version is now the same as the Rust version][cargo/5083]
564c78a2
XL
3879
3880Misc
3881----
3882- [The second edition of "The Rust Programming Language" book is now recommended
3883 over the first.][48404]
3884
3885Compatibility Notes
3886-------------------
3887
3888- [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3889 syntax is now invalid.
3890 ```
3891 use std::ops::Fn as dyn;
3892 fn g(_: Box<dyn(std::fmt::Debug)>) {}
3893 ```
3894- [The result of dereferences are no longer promoted to `'static`.][47408]
3895 e.g.
3896 ```rust
3897 fn main() {
3898 const PAIR: &(i32, i32) = &(0, 1);
3899 let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3900 }
3901 ```
3902- [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3903- [`".e0"` will now no longer parse as `0.0` and will instead cause
3904 an error.][48235]
3905- [Removed hoedown from rustdoc.][48274]
3906- [Bounds on higher-kinded lifetimes a hard error.][48326]
3907
3908[46882]: https://github.com/rust-lang/rust/pull/46882
3909[47379]: https://github.com/rust-lang/rust/pull/47379
3910[47408]: https://github.com/rust-lang/rust/pull/47408
3911[47813]: https://github.com/rust-lang/rust/pull/47813
3912[48056]: https://github.com/rust-lang/rust/pull/48056
3913[48125]: https://github.com/rust-lang/rust/pull/48125
3914[48166]: https://github.com/rust-lang/rust/pull/48166
3915[48235]: https://github.com/rust-lang/rust/pull/48235
3916[48274]: https://github.com/rust-lang/rust/pull/48274
3917[48281]: https://github.com/rust-lang/rust/pull/48281
3918[48296]: https://github.com/rust-lang/rust/pull/48296
3919[48326]: https://github.com/rust-lang/rust/pull/48326
3920[48359]: https://github.com/rust-lang/rust/pull/48359
3921[48404]: https://github.com/rust-lang/rust/pull/48404
3922[48481]: https://github.com/rust-lang/rust/pull/48481
3923[48516]: https://github.com/rust-lang/rust/pull/48516
3924[48628]: https://github.com/rust-lang/rust/pull/48628
3925[48629]: https://github.com/rust-lang/rust/pull/48629
3926[48657]: https://github.com/rust-lang/rust/pull/48657
3927[48735]: https://github.com/rust-lang/rust/pull/48735
3928[48978]: https://github.com/rust-lang/rust/pull/48978
3929[49101]: https://github.com/rust-lang/rust/pull/49101
3930[49109]: https://github.com/rust-lang/rust/pull/49109
3931[49121]: https://github.com/rust-lang/rust/pull/49121
3932[49162]: https://github.com/rust-lang/rust/pull/49162
3933[49184]: https://github.com/rust-lang/rust/pull/49184
3934[49234]: https://github.com/rust-lang/rust/pull/49234
3935[49255]: https://github.com/rust-lang/rust/pull/49255
3936[49299]: https://github.com/rust-lang/rust/pull/49299
3937[49305]: https://github.com/rust-lang/rust/pull/49305
3938[49394]: https://github.com/rust-lang/rust/pull/49394
3939[49458]: https://github.com/rust-lang/rust/pull/49458
3940[`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3941[`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3942[`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3943[`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3944[`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3945[`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3946[`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3947[`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3948[`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3949[`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3950[`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3951[`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3952[`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3953[`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3954[`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3955[`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3956[`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3957[`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3958[`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3959[`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3960[`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3961[`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3962[`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3963[`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3964[`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3965[`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3966[`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3967[`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3968[`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3969[`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3970[`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3971[`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3972[`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3973[`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3974[`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3975[`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3976[`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3977[`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3978[`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3979[`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3980[cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3981[cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
564c78a2
XL
3982
3983
0531ce1d
XL
3984Version 1.25.0 (2018-03-29)
3985==========================
3986
3987Language
3988--------
94b46f34 3989- [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
0531ce1d
XL
3990- [You can now use nested groups of imports.][47948]
3991 e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3992- [You can now have `|` at the start of a match arm.][47947] e.g.
3993```rust
3994enum Foo { A, B, C }
3995
3996fn main() {
3997 let x = Foo::A;
3998 match x {
3999 | Foo::A
4000 | Foo::B => println!("AB"),
4001 | Foo::C => println!("C"),
4002 }
4003}
4004```
4005
4006Compiler
4007--------
4008- [Upgraded to LLVM 6.][47828]
4009- [Added `-C lto=val` option.][47521]
4010- [Added `i586-unknown-linux-musl` target][47282]
4011
4012Libraries
4013---------
4014- [Impl Send for `process::Command` on Unix.][47760]
4015- [Impl PartialEq and Eq for `ParseCharError`.][47790]
4016- [`UnsafeCell::into_inner` is now safe.][47204]
4017- [Implement libstd for CloudABI.][47268]
4018- [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4019- [Implement `AsRef<Path>` for Component][46985]
4020- [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4021- [Moved `Duration` to libcore.][46666]
4022
4023Stabilized APIs
4024---------------
4025- [`Location::column`]
4026- [`ptr::NonNull`]
4027
4028The following functions can now be used in a constant expression.
4029eg. `static MINUTE: Duration = Duration::from_secs(60);`
4030- [`Duration::new`][47300]
4031- [`Duration::from_secs`][47300]
4032- [`Duration::from_millis`][47300]
4033
4034Cargo
4035-----
4036- [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4037- [`cargo new` now defaults to creating a binary crate, instead of a
4038 library crate.][cargo/5029]
4039
4040Misc
4041----
4042- [Rust by example is now shipped with new releases][46196]
4043
4044Compatibility Notes
4045-------------------
4046- [Deprecated `net::lookup_host`.][47510]
4047- [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4048- The borrow checker was sometimes incorrectly permitting overlapping borrows
4049 around indexing operations (see [#47349][47349]). This has been fixed (which also
4050 enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4051- [Removed deprecated unstable attribute `#[simd]`.][47251]
4052
4053[33903]: https://github.com/rust-lang/rust/pull/33903
4054[47947]: https://github.com/rust-lang/rust/pull/47947
4055[47948]: https://github.com/rust-lang/rust/pull/47948
4056[47760]: https://github.com/rust-lang/rust/pull/47760
4057[47790]: https://github.com/rust-lang/rust/pull/47790
4058[47828]: https://github.com/rust-lang/rust/pull/47828
4059[47398]: https://github.com/rust-lang/rust/pull/47398
4060[47510]: https://github.com/rust-lang/rust/pull/47510
4061[47521]: https://github.com/rust-lang/rust/pull/47521
4062[47204]: https://github.com/rust-lang/rust/pull/47204
4063[47251]: https://github.com/rust-lang/rust/pull/47251
4064[47268]: https://github.com/rust-lang/rust/pull/47268
4065[47282]: https://github.com/rust-lang/rust/pull/47282
4066[47300]: https://github.com/rust-lang/rust/pull/47300
4067[47349]: https://github.com/rust-lang/rust/pull/47349
4068[46931]: https://github.com/rust-lang/rust/pull/46931
4069[46985]: https://github.com/rust-lang/rust/pull/46985
4070[47006]: https://github.com/rust-lang/rust/pull/47006
4071[46830]: https://github.com/rust-lang/rust/pull/46830
4072[46095]: https://github.com/rust-lang/rust/pull/46095
4073[46666]: https://github.com/rust-lang/rust/pull/46666
4074[46196]: https://github.com/rust-lang/rust/pull/46196
4075[cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4076[cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4077[RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4078[`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4079[`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4080
4081
4082Version 1.24.1 (2018-03-01)
4083==========================
4084
4085 - [Do not abort when unwinding through FFI][48251]
4086 - [Emit UTF-16 files for linker arguments on Windows][48318]
4087 - [Make the error index generator work again][48308]
4088 - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4089
4090[48251]: https://github.com/rust-lang/rust/issues/48251
4091[48308]: https://github.com/rust-lang/rust/issues/48308
4092[48318]: https://github.com/rust-lang/rust/issues/48318
4093[cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4094
4095
ff7c6d11
XL
4096Version 1.24.0 (2018-02-15)
4097==========================
4098
4099Language
4100--------
4101- [External `sysv64` ffi is now available.][46528]
4102 eg. `extern "sysv64" fn foo () {}`
4103
4104Compiler
4105--------
4106- [rustc now uses 16 codegen units by default for release builds.][46910]
4107 For the fastest builds, utilize `codegen-units=1`.
4108- [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4109- [Add `aarch64-unknown-openbsd` support][46760]
4110
4111Libraries
4112---------
4113- [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4114 improvement in performance in the majority of cases.
4115- [`OsStr`'s `Debug` implementation is now lossless and consistent
4116 with Windows.][46798]
4117- [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4118- [impl `From<bool>` for `AtomicBool`][46293]
4119- [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4120- [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4121- [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4122- [float::from_bits now just uses transmute.][46012] This provides
4123 some optimisations from LLVM.
4124- [Copied `AsciiExt` methods onto `char`][46077]
4125- [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4126- [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
0531ce1d 4127- [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
ff7c6d11
XL
4128- [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4129
4130Stabilized APIs
4131---------------
4132- [`RefCell::replace`]
4133- [`RefCell::swap`]
4134- [`atomic::spin_loop_hint`]
4135
4136The following functions can now be used in a constant expression.
4137eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4138
4139- [`AtomicBool::new`][46287]
4140- [`AtomicUsize::new`][46287]
4141- [`AtomicIsize::new`][46287]
4142- [`AtomicPtr::new`][46287]
4143- [`Cell::new`][46287]
4144- [`{integer}::min_value`][46287]
4145- [`{integer}::max_value`][46287]
4146- [`mem::size_of`][46287]
4147- [`mem::align_of`][46287]
4148- [`ptr::null`][46287]
4149- [`ptr::null_mut`][46287]
4150- [`RefCell::new`][46287]
4151- [`UnsafeCell::new`][46287]
4152
4153Cargo
4154-----
4155- [Added a `workspace.default-members` config that
4156 overrides implied `--all` in virtual workspaces.][cargo/4743]
4157- [Enable incremental by default on development builds.][cargo/4817] Also added
4158 configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4159 per-project or global basis respectively.
4160
4161Misc
4162----
4163
4164Compatibility Notes
4165-------------------
4166- [Floating point types `Debug` impl now always prints a decimal point.][46831]
4167- [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4168 in accordance with IETF RFC 4291 §2.2.
4169- [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4170- [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4171 `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4172- [Leading zeros in tuple struct members is now an error][47084]
4173- [`column!()` macro is one-based instead of zero-based][46977]
4174- [`fmt::Arguments` can no longer be shared across threads][45198]
4175- [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
0531ce1d 4176- [Cargo sets a different working directory for the compiler][cargo/4788]
ff7c6d11
XL
4177
4178[44884]: https://github.com/rust-lang/rust/pull/44884
4179[45198]: https://github.com/rust-lang/rust/pull/45198
4180[45506]: https://github.com/rust-lang/rust/pull/45506
4181[45904]: https://github.com/rust-lang/rust/pull/45904
4182[45990]: https://github.com/rust-lang/rust/pull/45990
4183[46012]: https://github.com/rust-lang/rust/pull/46012
4184[46077]: https://github.com/rust-lang/rust/pull/46077
4185[46094]: https://github.com/rust-lang/rust/pull/46094
4186[46284]: https://github.com/rust-lang/rust/pull/46284
4187[46287]: https://github.com/rust-lang/rust/pull/46287
4188[46293]: https://github.com/rust-lang/rust/pull/46293
4189[46528]: https://github.com/rust-lang/rust/pull/46528
4190[46671]: https://github.com/rust-lang/rust/pull/46671
4191[46713]: https://github.com/rust-lang/rust/pull/46713
4192[46735]: https://github.com/rust-lang/rust/pull/46735
4193[46749]: https://github.com/rust-lang/rust/pull/46749
4194[46760]: https://github.com/rust-lang/rust/pull/46760
4195[46798]: https://github.com/rust-lang/rust/pull/46798
4196[46828]: https://github.com/rust-lang/rust/pull/46828
4197[46831]: https://github.com/rust-lang/rust/pull/46831
4198[46833]: https://github.com/rust-lang/rust/pull/46833
4199[46910]: https://github.com/rust-lang/rust/pull/46910
4200[46977]: https://github.com/rust-lang/rust/pull/46977
4201[47018]: https://github.com/rust-lang/rust/pull/47018
4202[47080]: https://github.com/rust-lang/rust/pull/47080
4203[47084]: https://github.com/rust-lang/rust/pull/47084
4204[cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
0531ce1d 4205[cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
ff7c6d11
XL
4206[cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4207[`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4208[`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4209[`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4210
4211
4212Version 1.23.0 (2018-01-04)
4213==========================
4214
4215Language
4216--------
4217- [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4218- [rustc now uses subtyping on the left hand side of binary operations.][45435]
4219 Which should fix some confusing errors in some operations.
4220
4221Compiler
4222--------
4223- [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4462d4a0 4224 undefined behavior.][45920]
ff7c6d11
XL
4225- [rustc now suggests renaming import if names clash.][45660]
4226- [Display errors/warnings correctly when there are zero-width or
4227 wide characters.][45711]
4228- [rustc now avoids unnecessary copies of arguments that are
4229 simple bindings][45380] This should improve memory usage on average by 5-10%.
4230- [Updated musl used to build musl rustc to 1.1.17][45393]
4231
4232Libraries
4233---------
4234- [Allow a trailing comma in `assert_eq/ne` macro][45887]
4235- [Implement Hash for raw pointers to unsized types][45483]
4236- [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4237- [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4238- [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4239- [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4240 and `<*mut T>::as_mut`][44932]
4241- [Optimized `Thread::{park, unpark}` implementation][45524]
4242- [Improved `SliceExt::binary_search` performance.][45333]
4243- [impl `FromIterator<()>` for `()`][45379]
4244- [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4245 is now deprecated.
4246
4247Stabilized APIs
4248---------------
4249
4250Cargo
4251-----
ff7c6d11
XL
4252- [Cargo now supports uninstallation of multiple packages][cargo/4561]
4253 eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4254- [Added unit test checking to `cargo check`][cargo/4592]
4255- [Cargo now lets you install a specific version
4256 using `cargo install --version`][cargo/4637]
4257
4258Misc
4259----
4260- [Releases now ship with the Cargo book documentation.][45692]
4261- [rustdoc now prints rendering warnings on every run.][45324]
ff7c6d11
XL
4262
4263Compatibility Notes
4264-------------------
4265- [Changes have been made to type equality to make it more correct,
4266 in rare cases this could break some code.][45853] [Tracking issue for
4267 further information][45852]
4268- [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4269- [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4270 Android 9, the minimum supported version is Android 14.
4271- [Bumped the minimum LLVM to 3.9][45326]
4272
4273[44042]: https://github.com/rust-lang/rust/pull/44042
4274[44932]: https://github.com/rust-lang/rust/pull/44932
4275[45267]: https://github.com/rust-lang/rust/pull/45267
4276[45324]: https://github.com/rust-lang/rust/pull/45324
4277[45326]: https://github.com/rust-lang/rust/pull/45326
4278[45333]: https://github.com/rust-lang/rust/pull/45333
4279[45379]: https://github.com/rust-lang/rust/pull/45379
4280[45380]: https://github.com/rust-lang/rust/pull/45380
4281[45393]: https://github.com/rust-lang/rust/pull/45393
4282[45435]: https://github.com/rust-lang/rust/pull/45435
4283[45483]: https://github.com/rust-lang/rust/pull/45483
4284[45524]: https://github.com/rust-lang/rust/pull/45524
4285[45571]: https://github.com/rust-lang/rust/pull/45571
4286[45580]: https://github.com/rust-lang/rust/pull/45580
4287[45610]: https://github.com/rust-lang/rust/pull/45610
4288[45660]: https://github.com/rust-lang/rust/pull/45660
4289[45692]: https://github.com/rust-lang/rust/pull/45692
4290[45711]: https://github.com/rust-lang/rust/pull/45711
4291[45772]: https://github.com/rust-lang/rust/pull/45772
4292[45852]: https://github.com/rust-lang/rust/issues/45852
4293[45853]: https://github.com/rust-lang/rust/pull/45853
4294[45887]: https://github.com/rust-lang/rust/pull/45887
ff7c6d11 4295[45920]: https://github.com/rust-lang/rust/pull/45920
ff7c6d11
XL
4296[cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4297[cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4298[cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4299
4300
4301Version 1.22.1 (2017-11-22)
4302==========================
4303
4304- [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4305
4306[46183]: https://github.com/rust-lang/rust/pull/46183
4307
4308Version 1.22.0 (2017-11-22)
abe05a73
XL
4309==========================
4310
4311Language
4312--------
4313- [`non_snake_case` lint now allows extern no-mangle functions][44966]
4314- [Now accepts underscores in unicode escapes][43716]
abe05a73
XL
4315- [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4316- [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4317
4318Compiler
4319--------
4320- [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4321- [rustc will no longer inline in codegen units when compiling for debug][45075]
4322 This should decrease compile times for debug builds.
4323- [strict memory alignment now enabled on ARMv6][45094]
4324- [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4325
4326Libraries
4327---------
4328- [Allow atomic operations up to 32 bits
4329 on `armv5te_unknown_linux_gnueabi`][44978]
4330- [`Box<Error>` now impls `From<Cow<str>>`][44466]
4331- [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4332- [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4333- [Properly detect overflow in `Instant += Duration`.][44220]
4334- [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4335- [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4336- [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4337
4338Stabilized APIs
4339---------------
4340
4341Cargo
4342-----
4343- [Cargo will now build multi file examples in subdirectories of the `examples`
4344 folder that have a `main.rs` file.][cargo/4496]
4345- [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4346 the old format will continue to work and can be updated with `cargo update`.
4347- [Now supports vendoring git repositories][cargo/3992]
4348
4349Misc
4350----
4351- [`libbacktrace` is now available on Apple platforms.][44251]
ff7c6d11
XL
4352- [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4353 This now lets you specify that a given code example will fail to compile.
abe05a73
XL
4354
4355Compatibility Notes
4356-------------------
4357- [The minimum Android version that rustc can build for has been bumped
4358 to `4.0` from `2.3`][45656]
4359- [Allowing `T op= &T` for numeric types has broken some type
4360 inference cases][45480]
4361
4362
4363[42526]: https://github.com/rust-lang/rust/pull/42526
4364[43017]: https://github.com/rust-lang/rust/pull/43017
4365[43716]: https://github.com/rust-lang/rust/pull/43716
4366[43949]: https://github.com/rust-lang/rust/pull/43949
4367[44015]: https://github.com/rust-lang/rust/pull/44015
4368[44220]: https://github.com/rust-lang/rust/pull/44220
4369[44251]: https://github.com/rust-lang/rust/pull/44251
4370[44287]: https://github.com/rust-lang/rust/pull/44287
4371[44303]: https://github.com/rust-lang/rust/pull/44303
4372[44456]: https://github.com/rust-lang/rust/pull/44456
4373[44466]: https://github.com/rust-lang/rust/pull/44466
4374[44895]: https://github.com/rust-lang/rust/pull/44895
4375[44966]: https://github.com/rust-lang/rust/pull/44966
4376[44978]: https://github.com/rust-lang/rust/pull/44978
4377[45041]: https://github.com/rust-lang/rust/pull/45041
4378[45064]: https://github.com/rust-lang/rust/pull/45064
4379[45075]: https://github.com/rust-lang/rust/pull/45075
4380[45094]: https://github.com/rust-lang/rust/pull/45094
4381[45095]: https://github.com/rust-lang/rust/pull/45095
4382[45480]: https://github.com/rust-lang/rust/issues/45480
4383[45656]: https://github.com/rust-lang/rust/pull/45656
4384[cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4385[cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4386[cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4387
4388
4389
4390
4391
4392
ea8adc8c
XL
4393Version 1.21.0 (2017-10-12)
4394==========================
4395
4396Language
4397--------
ea8adc8c
XL
4398- [You can now use static references for literals.][43838]
4399 Example:
4400 ```rust
4401 fn main() {
4402 let x: &'static u32 = &0;
4403 }
4404 ```
abe05a73
XL
4405- [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4406 Example:
4407 ```rust
4408 my_macro!(Vec<i32>::new); // Always worked
4409 my_macro!(Vec::<i32>::new); // Now works
4410 ```
ea8adc8c
XL
4411
4412Compiler
4413--------
4414- [Upgraded jemalloc to 4.5.0][43911]
4415- [Enabled unwinding panics on Redox][43917]
4416- [Now runs LLVM in parallel during translation phase.][43506]
4417 This should reduce peak memory usage.
4418
4419Libraries
4420---------
4421- [Generate builtin impls for `Clone` for all arrays and tuples that
4422 are `T: Clone`][43690]
4423- [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4424- [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4425 `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4426
4427Stabilized APIs
4428---------------
4429
4430[`std::mem::discriminant`]
4431
4432Cargo
4433-----
4434- [You can now call `cargo install` with multiple package names][cargo/4216]
4435- [Cargo commands inside a virtual workspace will now implicitly
4436 pass `--all`][cargo/4335]
4437- [Added a `[patch]` section to `Cargo.toml` to handle
4438 prepublication dependencies][cargo/4123] [RFC 1969]
4439- [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4440 like patterns][cargo/4270]
4441- [Added the `--all-targets` option][cargo/4400]
4442- [Using required dependencies as a feature is now deprecated and emits
4443 a warning][cargo/4364]
4444
4445
4446Misc
4447----
4448- [Cargo docs are moving][43916]
4449 to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4450- [The rustdoc book is now available][43863]
4451 at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4452- [Added a preview of RLS has been made available through rustup][44204]
4453 Install with `rustup component add rls-preview`
4454- [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4455 Previously only showed `std::os::unix`.
4456
4457Compatibility Notes
4458-------------------
4459- [Changes in method matching against higher-ranked types][43880] This may cause
4460 breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4461- [rustc's JSON error output's byte position start at top of file.][42973]
4462 Was previously relative to the rustc's internal `CodeMap` struct which
4463 required the unstable library `libsyntax` to correctly use.
4464- [`unused_results` lint no longer ignores booleans][43728]
4465
4466[42565]: https://github.com/rust-lang/rust/pull/42565
4467[42973]: https://github.com/rust-lang/rust/pull/42973
4468[43348]: https://github.com/rust-lang/rust/pull/43348
4469[43459]: https://github.com/rust-lang/rust/pull/43459
4470[43506]: https://github.com/rust-lang/rust/pull/43506
4471[43540]: https://github.com/rust-lang/rust/pull/43540
4472[43690]: https://github.com/rust-lang/rust/pull/43690
4473[43728]: https://github.com/rust-lang/rust/pull/43728
4474[43838]: https://github.com/rust-lang/rust/pull/43838
4475[43863]: https://github.com/rust-lang/rust/pull/43863
4476[43880]: https://github.com/rust-lang/rust/pull/43880
4477[43911]: https://github.com/rust-lang/rust/pull/43911
4478[43916]: https://github.com/rust-lang/rust/pull/43916
4479[43917]: https://github.com/rust-lang/rust/pull/43917
4480[44204]: https://github.com/rust-lang/rust/pull/44204
4481[cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4482[cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4483[cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4484[cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4485[cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4486[cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4487[RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4488[info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4489[`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4490
3b2f2976
XL
4491Version 1.20.0 (2017-08-31)
4492===========================
4493
4494Language
4495--------
ea8adc8c 4496- [Associated constants are now stabilised.][42809]
3b2f2976
XL
4497- [A lot of macro bugs are now fixed.][42913]
4498
4499Compiler
4500--------
4501
4502- [Struct fields are now properly coerced to the expected field type.][42807]
4503- [Enabled wasm LLVM backend][42571] WASM can now be built with the
4504 `wasm32-experimental-emscripten` target.
4505- [Changed some of the error messages to be more helpful.][42033]
4506- [Add support for RELRO(RELocation Read-Only) for platforms that support
4507 it.][43170]
4508- [rustc now reports the total number of errors on compilation failure][43015]
4509 previously this was only the number of errors in the pass that failed.
4510- [Expansion in rustc has been sped up 29x.][42533]
4511- [added `msp430-none-elf` target.][43099]
4512- [rustc will now suggest one-argument enum variant to fix type mismatch when
4513 applicable][43178]
4514- [Fixes backtraces on Redox][43228]
4515- [rustc now identifies different versions of same crate when absolute paths of
4516 different types match in an error message.][42826]
4517
4518Libraries
4519---------
4520
4521
4522- [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4523- [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4524 tuples.][43011]
4525- [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4526 `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4527- [Impl `Clone` for `DefaultHasher`.][42799]
4528- [Impl `Sync` for `SyncSender`.][42397]
4529- [Impl `FromStr` for `char`][42271]
4530- [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4531 NaN.][42431]
4532- [allow messages in the `unimplemented!()` macro.][42155]
4533 ie. `unimplemented!("Waiting for 1.21 to be stable")`
4534- [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4535- [Upgrade to Unicode 10.0.0][42999]
4536- [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4537- [Skip the main thread's manual stack guard on Linux][43072]
4538- [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4539- [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4540 previously 2^15.
4541- [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4542
4543Stabilized APIs
4544---------------
4545
4546- [`CStr::into_c_string`]
4547- [`CString::as_c_str`]
4548- [`CString::into_boxed_c_str`]
4549- [`Chain::get_mut`]
4550- [`Chain::get_ref`]
4551- [`Chain::into_inner`]
4552- [`Option::get_or_insert_with`]
4553- [`Option::get_or_insert`]
4554- [`OsStr::into_os_string`]
4555- [`OsString::into_boxed_os_str`]
4556- [`Take::get_mut`]
4557- [`Take::get_ref`]
4558- [`Utf8Error::error_len`]
4559- [`char::EscapeDebug`]
4560- [`char::escape_debug`]
4561- [`compile_error!`]
4562- [`f32::from_bits`]
4563- [`f32::to_bits`]
4564- [`f64::from_bits`]
4565- [`f64::to_bits`]
4566- [`mem::ManuallyDrop`]
4567- [`slice::sort_unstable_by_key`]
4568- [`slice::sort_unstable_by`]
4569- [`slice::sort_unstable`]
ea8adc8c 4570- [`str::from_boxed_utf8_unchecked`]
3b2f2976
XL
4571- [`str::as_bytes_mut`]
4572- [`str::as_bytes_mut`]
4573- [`str::from_utf8_mut`]
4574- [`str::from_utf8_unchecked_mut`]
4575- [`str::get_mut`]
4576- [`str::get_unchecked_mut`]
4577- [`str::get_unchecked`]
4578- [`str::get`]
4579- [`str::into_boxed_bytes`]
4580
4581
4582Cargo
4583-----
4584- [Cargo API token location moved from `~/.cargo/config` to
4585 `~/.cargo/credentials`.][cargo/3978]
4586- [Cargo will now build `main.rs` binaries that are in sub-directories of
4587 `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4588 `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4589- [You can now specify version of a binary when installed through
4590 `cargo install` using `--vers`.][cargo/4229]
4591- [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4592 failure.][cargo/4248]
4593- [Changed the convention around which file is the crate root.][cargo/4259]
4594- [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4595 instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4596
4597Compatibility Notes
4598-------------------
4599
4600- [Functions with `'static` in their return types will now not be as usable as
4601 if they were using lifetime parameters instead.][42417]
4602- [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
ea8adc8c 4603 takes the sign of NaN into account where previously didn't.][42430]
3b2f2976
XL
4604
4605[42033]: https://github.com/rust-lang/rust/pull/42033
4606[42155]: https://github.com/rust-lang/rust/pull/42155
4607[42271]: https://github.com/rust-lang/rust/pull/42271
4608[42397]: https://github.com/rust-lang/rust/pull/42397
4609[42417]: https://github.com/rust-lang/rust/pull/42417
4610[42430]: https://github.com/rust-lang/rust/pull/42430
4611[42431]: https://github.com/rust-lang/rust/pull/42431
4612[42533]: https://github.com/rust-lang/rust/pull/42533
4613[42571]: https://github.com/rust-lang/rust/pull/42571
4614[42613]: https://github.com/rust-lang/rust/pull/42613
4615[42799]: https://github.com/rust-lang/rust/pull/42799
4616[42807]: https://github.com/rust-lang/rust/pull/42807
4617[42809]: https://github.com/rust-lang/rust/pull/42809
4618[42822]: https://github.com/rust-lang/rust/pull/42822
4619[42826]: https://github.com/rust-lang/rust/pull/42826
4620[42854]: https://github.com/rust-lang/rust/pull/42854
4621[42913]: https://github.com/rust-lang/rust/pull/42913
4622[42999]: https://github.com/rust-lang/rust/pull/42999
4623[43011]: https://github.com/rust-lang/rust/pull/43011
4624[43015]: https://github.com/rust-lang/rust/pull/43015
4625[43072]: https://github.com/rust-lang/rust/pull/43072
4626[43077]: https://github.com/rust-lang/rust/pull/43077
4627[43097]: https://github.com/rust-lang/rust/pull/43097
4628[43099]: https://github.com/rust-lang/rust/pull/43099
4629[43170]: https://github.com/rust-lang/rust/pull/43170
4630[43178]: https://github.com/rust-lang/rust/pull/43178
4631[43185]: https://github.com/rust-lang/rust/pull/43185
4632[43228]: https://github.com/rust-lang/rust/pull/43228
4633[cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4634[cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4635[cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4636[cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4637[cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4638[cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4639[`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4640[`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4641[`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4642[`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4643[`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4644[`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4645[`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4646[`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4647[`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4648[`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4649[`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4650[`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4651[`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4652[`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4653[`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4654[`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4655[`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4656[`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4657[`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4658[`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4659[`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4660[`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4661[`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4662[`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
ea8adc8c 4663[`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3b2f2976
XL
4664[`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4665[`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4666[`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4667[`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4668[`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4669[`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4670[`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4671[`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4672
4673
4674Version 1.19.0 (2017-07-20)
4675===========================
4676
4677Language
4678--------
4679
4680- [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4681 For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4682- [Macro recursion limit increased to 1024 from 64.][41676]
4683- [Added lint for detecting unused macros.][41907]
4684- [`loop` can now return a value with `break`.][42016] [RFC 1624]
4685 For example: `let x = loop { break 7; };`
4686- [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4687 contain `Copy` types and cannot have a `Drop` implementation.
4688 Example: `union Foo { bar: u8, baz: usize }`
4689- [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4690 Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4691
4692Compiler
4693--------
4694
4695- [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4696- [Change `arm-linux-androideabi` to correspond to the `armeabi`
4697 official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4698 you should use `--target armv7-linux-androideabi`.
4699- [Fixed ICE when removing a source file between compilation sessions.][41873]
4700- [Minor optimisation of string operations.][42037]
4701- [Compiler error message is now `aborting due to previous error(s)` instead of
4702 `aborting due to N previous errors`][42150] This was previously inaccurate and
4703 would only count certain kinds of errors.
4704- [The compiler now supports Visual Studio 2017][42225]
4705- [The compiler is now built against LLVM 4.0.1 by default][42948]
4706- [Added a lot][42264] of [new error codes][42302]
4707- [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4708 libraries with C Run-time Libraries(CRT) to be statically linked.
4709- [Fixed various ARM codegen bugs][42740]
4710
4711Libraries
4712---------
4713
4714- [`String` now implements `FromIterator<Cow<'a, str>>` and
4715 `Extend<Cow<'a, str>>`][41449]
4716- [`Vec` now implements `From<&mut [T]>`][41530]
4717- [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4718- [`SplitWhitespace` now implements `Clone`][41659]
4719- [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4720 1.5x faster][41764]
4721- [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4722 macros, but for printing to stderr.
4723
4724Stabilized APIs
4725---------------
4726
4727- [`OsString::shrink_to_fit`]
4728- [`cmp::Reverse`]
4729- [`Command::envs`]
4730- [`thread::ThreadId`]
4731
4732Cargo
4733-----
4734
4735- [Build scripts can now add environment variables to the environment
4736 the crate is being compiled in.
4737 Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4738- [Subcommands now replace the current process rather than spawning a new
4739 child process][cargo/3970]
4740- [Workspace members can now accept glob file patterns][cargo/3979]
4741- [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4742 the members in a given workspace.][cargo/3988]
4743- [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4744- [Target directory path is now in the cargo metadata][cargo/4022]
4745- [Cargo no longer checks out a local working directory for the
4746 crates.io index][cargo/4026] This should provide smaller file size for the
4747 registry, and improve cloning times, especially on Windows machines.
4748- [Added an `--exclude` option for excluding certain packages when using the
4749 `--all` option][cargo/4031]
4750- [Cargo will now automatically retry when receiving a 5xx error
4751 from crates.io][cargo/4032]
4752- [The `--features` option now accepts multiple comma or space
4753 delimited values.][cargo/4084]
4754- [Added support for custom target specific runners][cargo/3954]
4755
4756Misc
4757----
4758
4759- [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4760 Windows Debugger.
4761- [Rust will now release XZ compressed packages][rust-installer/57]
4762- [rustup will now prefer to download rust packages with
4763 XZ compression][rustup/1100] over GZip packages.
4764- [Added the ability to escape `#` in rust documentation][41785] By adding
4765 additional `#`'s ie. `##` is now `#`
4766
4767Compatibility Notes
4768-------------------
4769
4770- [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4771- [`-Z` flags are now no longer allowed to be used on the stable
4772 compiler.][41751] This has been a warning for a year previous to this.
4773- [As a result of the `-Z` flag change, the `cargo-check` plugin no
4774 longer works][42844]. Users should migrate to the built-in `check`
4775 command, which has been available since 1.16.
4776- [Ending a float literal with `._` is now a hard error.
4777 Example: `42._` .][41946]
4778- [Any use of a private `extern crate` outside of its module is now a
4779 hard error.][36886] This was previously a warning.
4780- [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4781 relative while the `::` prefix makes a path absolute, but was ignored and the
4782 path was relative regardless.
4783- [Floating point constants in match patterns is now a hard error][36890]
4784 This was previously a warning.
4785- [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4786 match patterns is now a hard error][36891] This was previously a warning.
4787- [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4788 a warning.
4789- [From the pound escape, lines consisting of multiple `#`s are
4790 now visible][41785]
2c00a5a8 4791- [It is an error to re-export private enum variants][42460]. This is
3b2f2976
XL
4792 known to break a number of crates that depend on an older version of
4793 mustache.
4794- [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4795 to use it to find the linker, and the build will fail where it did
4796 not previously][42607]
4797
4798[36886]: https://github.com/rust-lang/rust/issues/36886
4799[36888]: https://github.com/rust-lang/rust/issues/36888
4800[36890]: https://github.com/rust-lang/rust/issues/36890
4801[36891]: https://github.com/rust-lang/rust/issues/36891
4802[36892]: https://github.com/rust-lang/rust/issues/36892
4803[37406]: https://github.com/rust-lang/rust/issues/37406
4804[39983]: https://github.com/rust-lang/rust/pull/39983
4805[41145]: https://github.com/rust-lang/rust/pull/41145
4806[41192]: https://github.com/rust-lang/rust/pull/41192
4807[41258]: https://github.com/rust-lang/rust/pull/41258
4808[41370]: https://github.com/rust-lang/rust/pull/41370
4809[41449]: https://github.com/rust-lang/rust/pull/41449
4810[41530]: https://github.com/rust-lang/rust/pull/41530
4811[41624]: https://github.com/rust-lang/rust/pull/41624
4812[41656]: https://github.com/rust-lang/rust/pull/41656
4813[41659]: https://github.com/rust-lang/rust/pull/41659
4814[41676]: https://github.com/rust-lang/rust/pull/41676
4815[41751]: https://github.com/rust-lang/rust/pull/41751
4816[41764]: https://github.com/rust-lang/rust/pull/41764
4817[41785]: https://github.com/rust-lang/rust/pull/41785
4818[41873]: https://github.com/rust-lang/rust/pull/41873
4819[41907]: https://github.com/rust-lang/rust/pull/41907
4820[41946]: https://github.com/rust-lang/rust/pull/41946
4821[42016]: https://github.com/rust-lang/rust/pull/42016
4822[42037]: https://github.com/rust-lang/rust/pull/42037
4823[42068]: https://github.com/rust-lang/rust/pull/42068
4824[42150]: https://github.com/rust-lang/rust/pull/42150
4825[42162]: https://github.com/rust-lang/rust/pull/42162
4826[42225]: https://github.com/rust-lang/rust/pull/42225
4827[42264]: https://github.com/rust-lang/rust/pull/42264
4828[42302]: https://github.com/rust-lang/rust/pull/42302
4829[42460]: https://github.com/rust-lang/rust/issues/42460
4830[42607]: https://github.com/rust-lang/rust/issues/42607
4831[42740]: https://github.com/rust-lang/rust/pull/42740
4832[42844]: https://github.com/rust-lang/rust/issues/42844
4833[42948]: https://github.com/rust-lang/rust/pull/42948
4834[RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4835[RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4836[RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4837[RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4838[RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4839[`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4840[`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4841[`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4842[`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4843[cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4844[cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4845[cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4846[cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4847[cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4848[cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4849[cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4850[cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4851[cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4852[cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4853[cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4854[rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4855[rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4856
4857
cc61c64b
XL
4858Version 1.18.0 (2017-06-08)
4859===========================
4860
4861Language
4862--------
4863
4864- [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4865 make the item visible to just that module tree. Also accepts the keyword
4866 `crate` to make something public to the whole crate but not users of the
4867 library. Example: `pub(crate) mod utils;`. [RFC 1422].
4868- [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4869 `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4870- [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4871 types like `Write + Send`, trailing `+` are now supported in trait objects,
4872 and better error reporting for trait objects starting with `?Sized`.
4873- [0e+10 is now a valid floating point literal][40589]
4874- [Now warns if you bind a lifetime parameter to 'static][40734]
4875- [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4876 `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4877 representation in some cases.][40377]
4878
4879Compiler
4880--------
4881
4882- [rustc can now emit mir with `--emit mir`][39891]
4883- [Improved LLVM IR for trivial functions][40367]
4884- [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4885- [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4886 opportunities found through profiling
4887- [Improved backtrace formatting when panicking][38165]
4888
4889Libraries
4890---------
4891
4892- [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4893 iterator hasn't been advanced the original `Vec` is reassembled with no actual
4894 iteration or reallocation.
4895- [Simplified HashMap Bucket interface][40561] provides performance
4896 improvements for iterating and cloning.
4897- [Specialize Vec::from_elem to use calloc][40409]
4898- [Fixed Race condition in fs::create_dir_all][39799]
4899- [No longer caching stdio on Windows][40516]
4900- [Optimized insertion sort in slice][40807] insertion sort in some cases
4901 2.50%~ faster and in one case now 12.50% faster.
4902- [Optimized `AtomicBool::fetch_nand`][41143]
4903
4904Stabilized APIs
4905---------------
4906
4907- [`Child::try_wait`]
4908- [`HashMap::retain`]
4909- [`HashSet::retain`]
4910- [`PeekMut::pop`]
4911- [`TcpStream::peek`]
4912- [`UdpSocket::peek`]
4913- [`UdpSocket::peek_from`]
4914
4915Cargo
4916-----
4917
4918- [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4919 You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4920- [Now always emits build script warnings for crates that fail to build][cargo/3847]
4921- [Added Android build support][cargo/3885]
4922- [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4923 of a certain type, for example `cargo build --bins` will build all
4924 binaries.
4925- [Added support for haiku][cargo/3952]
4926
4927Misc
4928----
4929
4930- [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
ff7c6d11 4931- [Added rust-windbg script for better debugging on Windows][39983]
cc61c64b
XL
4932- [Rust now uses the official cross compiler for NetBSD][40612]
4933- [rustdoc now accepts `#` at the start of files][40828]
4934- [Fixed jemalloc support for musl][41168]
4935
4936Compatibility Notes
4937-------------------
4938
4939- [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4940 always placed after the sign if it exists and before the digits. With the `#`
4941 flag the zeroes are placed after the prefix and before the digits.
4942- [Due to the struct field optimisation][40377], using `transmute` on structs
4943 that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4944 always been undefined behavior, but is now more likely to break in practice.
4945- [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4946 receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4947 `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4948- [Overlapping inherent `impl`s are now a hard error][40728]
4949- [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4950- [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4951 `out.asm` and `out.ll` instead of only one of the filetypes.
4952- [ calling a function that returns `Self` will no longer work][41805] when
4953 the size of `Self` cannot be statically determined.
4954- [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4955 this has caused a few regressions namely:
4956
4957 - Changed the link order of local static/dynamic libraries (respecting the
4958 order on given rather than having the compiler reorder).
4959 - Changed how MinGW is linked, native code linked to dynamic libraries
4960 may require manually linking to the gcc support library (for the native
4961 code itself)
4962
4963[38165]: https://github.com/rust-lang/rust/pull/38165
4964[39799]: https://github.com/rust-lang/rust/pull/39799
4965[39891]: https://github.com/rust-lang/rust/pull/39891
4966[39983]: https://github.com/rust-lang/rust/pull/39983
4967[40043]: https://github.com/rust-lang/rust/pull/40043
4968[40241]: https://github.com/rust-lang/rust/pull/40241
4969[40338]: https://github.com/rust-lang/rust/pull/40338
4970[40367]: https://github.com/rust-lang/rust/pull/40367
4971[40377]: https://github.com/rust-lang/rust/pull/40377
4972[40409]: https://github.com/rust-lang/rust/pull/40409
4973[40516]: https://github.com/rust-lang/rust/pull/40516
4974[40556]: https://github.com/rust-lang/rust/pull/40556
4975[40561]: https://github.com/rust-lang/rust/pull/40561
4976[40589]: https://github.com/rust-lang/rust/pull/40589
4977[40612]: https://github.com/rust-lang/rust/pull/40612
4978[40723]: https://github.com/rust-lang/rust/pull/40723
4979[40728]: https://github.com/rust-lang/rust/pull/40728
4980[40731]: https://github.com/rust-lang/rust/pull/40731
4981[40734]: https://github.com/rust-lang/rust/pull/40734
4982[40805]: https://github.com/rust-lang/rust/pull/40805
4983[40807]: https://github.com/rust-lang/rust/pull/40807
4984[40828]: https://github.com/rust-lang/rust/pull/40828
4985[40870]: https://github.com/rust-lang/rust/pull/40870
4986[41085]: https://github.com/rust-lang/rust/pull/41085
4987[41143]: https://github.com/rust-lang/rust/pull/41143
4988[41168]: https://github.com/rust-lang/rust/pull/41168
4989[41270]: https://github.com/rust-lang/rust/issues/41270
4990[41469]: https://github.com/rust-lang/rust/pull/41469
4991[41805]: https://github.com/rust-lang/rust/issues/41805
4992[RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4993[RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4994[`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4995[`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4996[`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4997[`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4998[`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4999[`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5000[`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5001[cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5002[cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5003[cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5004[cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5005[cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5006
5007
5008Version 1.17.0 (2017-04-27)
5009===========================
5010
5011Language
5012--------
5013
5014* [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5015* [Fields of structs may be initialized without duplicating the field/variable
5016 names][39761]. [RFC 1682]
5017* [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5018* [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5019 there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5020 coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5021 `'b`. Soundness fix.
5022* [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5023* [Static variables may contain references to other statics][40027]
5024
5025Compiler
5026--------
5027
5028* [Exit quickly on only `--emit dep-info`][40336]
5029* [Make `-C relocation-model` more correctly determine whether the linker
5030 creates a position-independent executable][40245]
5031* [Add `-C overflow-checks` to directly control whether integer overflow
5032 panics][40037]
5033* [The rustc type checker now checks items on demand instead of in a single
5034 in-order pass][40008]. This is mostly an internal refactoring in support of
5035 future work, including incremental type checking, but also resolves [RFC
5036 1647], allowing `Self` to appear in `impl` `where` clauses.
5037* [Optimize vtable loads][39995]
5038* [Turn off vectorization for Emscripten targets][39990]
5039* [Provide suggestions for unknown macros imported with `use`][39953]
5040* [Fix ICEs in path resolution][39939]
5041* [Strip exception handling code on Emscripten when `panic=abort`][39193]
5042* [Add clearer error message using `&str + &str`][39116]
5043
5044Stabilized APIs
5045---------------
5046
5047* [`Arc::into_raw`]
5048* [`Arc::from_raw`]
5049* [`Arc::ptr_eq`]
5050* [`Rc::into_raw`]
5051* [`Rc::from_raw`]
5052* [`Rc::ptr_eq`]
5053* [`Ordering::then`]
5054* [`Ordering::then_with`]
5055* [`BTreeMap::range`]
5056* [`BTreeMap::range_mut`]
5057* [`collections::Bound`]
5058* [`process::abort`]
5059* [`ptr::read_unaligned`]
5060* [`ptr::write_unaligned`]
5061* [`Result::expect_err`]
5062* [`Cell::swap`]
5063* [`Cell::replace`]
5064* [`Cell::into_inner`]
5065* [`Cell::take`]
5066
5067Libraries
5068---------
5069
5070* [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5071* [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5072* [`String` implements `FromIterator<&char>`][40028]
5073* `Box` [implements][40009] a number of new conversions:
5074 `From<Box<str>> for String`,
5075 `From<Box<[T]>> for Vec<T>`,
5076 `From<Box<CStr>> for CString`,
5077 `From<Box<OsStr>> for OsString`,
5078 `From<Box<Path>> for PathBuf`,
5079 `Into<Box<str>> for String`,
5080 `Into<Box<[T]>> for Vec<T>`,
5081 `Into<Box<CStr>> for CString`,
5082 `Into<Box<OsStr>> for OsString`,
5083 `Into<Box<Path>> for PathBuf`,
5084 `Default for Box<str>`,
5085 `Default for Box<CStr>`,
5086 `Default for Box<OsStr>`,
5087 `From<&CStr> for Box<CStr>`,
5088 `From<&OsStr> for Box<OsStr>`,
5089 `From<&Path> for Box<Path>`
5090* [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5091* [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5092* [Slightly optimize `slice::sort`][39538]
5093* [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5094* [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5095 `Box<str>` implements `From<&str>`][39438]
5096* [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5097 `From<(I, u16)> where I: Into<IpAddr>`][39372]
5098* [`format!` estimates the needed capacity before writing a string][39356]
5099* [Support unprivileged symlink creation in Windows][38921]
5100* [`PathBuf` implements `Default`][38764]
5101* [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5102* [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5103 and poor hash functions.
5104
5105Cargo
5106-----
5107
5108* [Add `cargo check --all`][cargo/3731]
5109* [Add an option to ignore SSL revocation checking][cargo/3699]
5110* [Add `cargo run --package`][cargo/3691]
5111* [Add `required_features`][cargo/3667]
5112* [Assume `build.rs` is a build script][cargo/3664]
5113* [Find workspace via `workspace_root` link in containing member][cargo/3562]
5114
5115Misc
5116----
5117
5118* [Documentation is rendered with mdbook instead of the obsolete, in-tree
5119 `rustbook`][39633]
5120* [The "Unstable Book" documents nightly-only features][ubook]
5121* [Improve the style of the sidebar in rustdoc output][40265]
5122* [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5123* [Fix MSP430 breakage due to `i128`][40257]
5124* [Preliminary Solaris/SPARCv9 support][39903]
5125* [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5126 run without installing the MSVC runtime.
5127* [`rustdoc --test` includes file names in test names][39788]
5128* This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5129 `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5130* [Initial support for `aarch64-unknown-freebsd`][39491]
5131* [Initial support for `i686-unknown-netbsd`][39426]
5132* [This release no longer includes the old makefile build system][39431]. Rust
5133 is built with a custom build system, written in Rust, and with Cargo.
5134* [Add Debug implementations for libcollection structs][39002]
5135* [`TypeId` implements `PartialOrd` and `Ord`][38981]
5136* [`--test-threads=0` produces an error][38945]
5137* [`rustup` installs documentation by default][40526]
5138* [The Rust source includes NatVis visualizations][39843]. These can be used by
5139 WinDbg and Visual Studio to improve the debugging experience.
5140
5141Compatibility Notes
5142-------------------
5143
5144* [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5145 workaround, either use MSVC 2015 or run vcvars.bat.
5146* [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5147 disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5148 `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5149 fix.
5150* [`format!` and `Display::to_string` panic if an underlying formatting
5151 implementation returns an error][40117]. Previously the error was silently
5152 ignored. It is incorrect for `write_fmt` to return an error when writing
5153 to a string.
5154* [In-tree crates are verified to be unstable][39851]. Previously, some minor
5155 crates were marked stable and could be accessed from the stable toolchain.
5156* [Rust git source no longer includes vendored crates][39728]. Those that need
5157 to build with vendored crates should build from release tarballs.
5158* [Fix inert attributes from `proc_macro_derives`][39572]
5159* [During crate resolution, rustc prefers a crate in the sysroot if two crates
5160 are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5161 build system.
5162* [Fixed bugs around how type inference interacts with dead-code][39485]. The
5163 existing code generally ignores the type of dead-code unless a type-hint is
5164 provided; this can cause surprising inference interactions particularly around
5165 defaulting. The new code uniformly ignores the result type of dead-code.
5166* [Tuple-struct constructors with private fields are no longer visible][38932]
5167* [Lifetime parameters that do not appear in the arguments are now considered
5168 early-bound][38897], resolving a soundness bug (#[32330]). The
5169 `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5170 April of 2016.
5171* [rustdoc: fix doctests with non-feature crate attributes][38161]
5172* [Make transmuting from fn item types to pointer-sized types a hard
5173 error][34198]
5174
5175[27787]: https://github.com/rust-lang/rust/issues/27787
5176[32330]: https://github.com/rust-lang/rust/issues/32330
5177[34198]: https://github.com/rust-lang/rust/pull/34198
5178[38161]: https://github.com/rust-lang/rust/pull/38161
5179[38368]: https://github.com/rust-lang/rust/pull/38368
5180[38584]: https://github.com/rust-lang/rust/issues/38584
5181[38661]: https://github.com/rust-lang/rust/pull/38661
5182[38764]: https://github.com/rust-lang/rust/pull/38764
5183[38864]: https://github.com/rust-lang/rust/issues/38864
5184[38897]: https://github.com/rust-lang/rust/pull/38897
5185[38921]: https://github.com/rust-lang/rust/pull/38921
5186[38932]: https://github.com/rust-lang/rust/pull/38932
5187[38945]: https://github.com/rust-lang/rust/pull/38945
5188[38981]: https://github.com/rust-lang/rust/pull/38981
5189[39002]: https://github.com/rust-lang/rust/pull/39002
5190[39116]: https://github.com/rust-lang/rust/pull/39116
5191[39193]: https://github.com/rust-lang/rust/pull/39193
5192[39265]: https://github.com/rust-lang/rust/pull/39265
5193[39356]: https://github.com/rust-lang/rust/pull/39356
5194[39372]: https://github.com/rust-lang/rust/pull/39372
5195[39426]: https://github.com/rust-lang/rust/pull/39426
5196[39431]: https://github.com/rust-lang/rust/pull/39431
5197[39438]: https://github.com/rust-lang/rust/pull/39438
5198[39440]: https://github.com/rust-lang/rust/pull/39440
5199[39485]: https://github.com/rust-lang/rust/pull/39485
5200[39491]: https://github.com/rust-lang/rust/pull/39491
5201[39518]: https://github.com/rust-lang/rust/pull/39518
5202[39538]: https://github.com/rust-lang/rust/pull/39538
5203[39572]: https://github.com/rust-lang/rust/pull/39572
5204[39633]: https://github.com/rust-lang/rust/pull/39633
5205[39642]: https://github.com/rust-lang/rust/pull/39642
5206[39728]: https://github.com/rust-lang/rust/pull/39728
5207[39761]: https://github.com/rust-lang/rust/pull/39761
5208[39788]: https://github.com/rust-lang/rust/pull/39788
5209[39793]: https://github.com/rust-lang/rust/pull/39793
5210[39837]: https://github.com/rust-lang/rust/pull/39837
5211[39843]: https://github.com/rust-lang/rust/pull/39843
5212[39851]: https://github.com/rust-lang/rust/pull/39851
5213[39903]: https://github.com/rust-lang/rust/pull/39903
5214[39939]: https://github.com/rust-lang/rust/pull/39939
5215[39953]: https://github.com/rust-lang/rust/pull/39953
5216[39960]: https://github.com/rust-lang/rust/pull/39960
5217[39990]: https://github.com/rust-lang/rust/pull/39990
5218[39995]: https://github.com/rust-lang/rust/pull/39995
5219[40008]: https://github.com/rust-lang/rust/pull/40008
5220[40009]: https://github.com/rust-lang/rust/pull/40009
5221[40027]: https://github.com/rust-lang/rust/pull/40027
5222[40028]: https://github.com/rust-lang/rust/pull/40028
5223[40037]: https://github.com/rust-lang/rust/pull/40037
5224[40117]: https://github.com/rust-lang/rust/pull/40117
5225[40166]: https://github.com/rust-lang/rust/pull/40166
5226[40245]: https://github.com/rust-lang/rust/pull/40245
5227[40257]: https://github.com/rust-lang/rust/pull/40257
5228[40261]: https://github.com/rust-lang/rust/pull/40261
5229[40265]: https://github.com/rust-lang/rust/pull/40265
5230[40319]: https://github.com/rust-lang/rust/pull/40319
5231[40336]: https://github.com/rust-lang/rust/pull/40336
5232[40526]: https://github.com/rust-lang/rust/pull/40526
5233[RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5234[RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5235[RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5236[RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5237[`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5238[`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5239[`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5240[`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5241[`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5242[`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5243[`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5244[`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5245[`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5246[`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5247[`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5248[`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5249[`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5250[`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5251[`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5252[`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5253[`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5254[`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5255[`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5256[cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5257[cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5258[cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5259[cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5260[cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5261[cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5262[mdbook]: https://crates.io/crates/mdbook
5263[ubook]: https://doc.rust-lang.org/unstable-book/
5264
5265
32a655c1
SL
5266Version 1.16.0 (2017-03-16)
5267===========================
5268
5269Language
5270--------
5271
32a655c1
SL
5272* [The compiler's `dead_code` lint now accounts for type aliases][38051].
5273* [Uninhabitable enums (those without any variants) no longer permit wildcard
5274 match patterns][38069]
5275* [Clean up semantics of `self` in an import list][38313]
5276* [`Self` may appear in `impl` headers][38920]
5277* [`Self` may appear in struct expressions][39282]
5278
5279Compiler
5280--------
5281
5282* [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5283 a `.rmeta` file containing only crate metadata][38571]. This can be
5284 used by tools like the Rust Language Service to perform
5285 metadata-only builds.
5286* [Levenshtein based typo suggestions now work in most places, while
5287 previously they worked only for fields and sometimes for local
5288 variables][38927]. Together with the overhaul of "no
5289 resolution"/"unexpected resolution" errors (#[38154]) they result in
5290 large and systematic improvement in resolution diagnostics.
5291* [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5292 `U`][38670]
5293* [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5294* [`rustc` no longer attempts to provide "consider using an explicit
5295 lifetime" suggestions][37057]. They were inaccurate.
5296
5297Stabilized APIs
5298---------------
5299
5300* [`VecDeque::truncate`]
5301* [`VecDeque::resize`]
5302* [`String::insert_str`]
5303* [`Duration::checked_add`]
5304* [`Duration::checked_sub`]
5305* [`Duration::checked_div`]
5306* [`Duration::checked_mul`]
5307* [`str::replacen`]
5308* [`str::repeat`]
5309* [`SocketAddr::is_ipv4`]
5310* [`SocketAddr::is_ipv6`]
5311* [`IpAddr::is_ipv4`]
5312* [`IpAddr::is_ipv6`]
5313* [`Vec::dedup_by`]
5314* [`Vec::dedup_by_key`]
5315* [`Result::unwrap_or_default`]
5316* [`<*const T>::wrapping_offset`]
5317* [`<*mut T>::wrapping_offset`]
5318* `CommandExt::creation_flags`
5319* [`File::set_permissions`]
5320* [`String::split_off`]
5321
5322Libraries
5323---------
5324
5325* [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5326 their argument by `Borrow` parameter][37761]
5327* [All public types in std implement `Debug`][38006]
5328* [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5329* [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5330* [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5331 Windows][38274]
5332* [std: Fix partial writes in `LineWriter`][38062]
5333* [std: Clamp max read/write sizes on Unix][38062]
5334* [Use more specific panic message for `&str` slicing errors][38066]
5335* [`TcpListener::set_only_v6` is deprecated][38304]. This
5336 functionality cannot be achieved in std currently.
5337* [`writeln!`, like `println!`, now accepts a form with no string
5338 or formatting arguments, to just print a newline][38469]
5339* [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5340* [Reduce the size of static data in `std_unicode::tables`][38781]
5341* [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5342 `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5343 `Display`][38909]
5344* [`Duration` implements `Sum`][38712]
5345* [`String` implements `ToSocketAddrs`][39048]
5346
5347Cargo
5348-----
5349
5350* [The `cargo check` command does a type check of a project without
5351 building it][cargo/3296]
5352* [crates.io will display CI badges from Travis and AppVeyor, if
5353 specified in Cargo.toml][cargo/3546]
5354* [crates.io will display categories listed in Cargo.toml][cargo/3301]
5355* [Compilation profiles accept integer values for `debug`, in addition
5356 to `true` and `false`. These are passed to `rustc` as the value to
5357 `-C debuginfo`][cargo/3534]
5358* [Implement `cargo --version --verbose`][cargo/3604]
5359* [All builds now output 'dep-info' build dependencies compatible with
5360 make and ninja][cargo/3557]
5361* [Build all workspace members with `build --all`][cargo/3511]
5362* [Document all workspace members with `doc --all`][cargo/3515]
5363* [Path deps outside workspace are not members][cargo/3443]
5364
5365Misc
5366----
5367
5368* [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5369 the path to the Rust implementation][38589]
5370* [The `armv7-linux-androideabi` target no longer enables NEON
5371 extensions, per Google's ABI guide][38413]
5372* [The stock standard library can be compiled for Redox OS][38401]
5373* [Rust has initial SPARC support][38726]. Tier 3. No builds
5374 available.
5375* [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5376 builds available.
5377* [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5378
5379Compatibility Notes
5380-------------------
5381
5382* [Uninhabitable enums (those without any variants) no longer permit wildcard
5383 match patterns][38069]
5384* In this release, references to uninhabited types can not be
5385 pattern-matched. This was accidentally allowed in 1.15.
5386* [The compiler's `dead_code` lint now accounts for type aliases][38051].
5387* [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5388 Windows][38274]
5389* [Clean up semantics of `self` in an import list][38313]
3b2f2976
XL
5390* Reimplemented lifetime elision. This change was almost entirely compatible
5391 with existing code, but it did close a number of small bugs and loopholes,
5392 as well as being more accepting in some other [cases][41105].
32a655c1
SL
5393
5394[37057]: https://github.com/rust-lang/rust/pull/37057
5395[37761]: https://github.com/rust-lang/rust/pull/37761
5396[38006]: https://github.com/rust-lang/rust/pull/38006
5397[38051]: https://github.com/rust-lang/rust/pull/38051
5398[38062]: https://github.com/rust-lang/rust/pull/38062
5399[38062]: https://github.com/rust-lang/rust/pull/38622
5400[38066]: https://github.com/rust-lang/rust/pull/38066
5401[38069]: https://github.com/rust-lang/rust/pull/38069
5402[38131]: https://github.com/rust-lang/rust/pull/38131
5403[38154]: https://github.com/rust-lang/rust/pull/38154
5404[38274]: https://github.com/rust-lang/rust/pull/38274
5405[38304]: https://github.com/rust-lang/rust/pull/38304
5406[38313]: https://github.com/rust-lang/rust/pull/38313
5407[38314]: https://github.com/rust-lang/rust/pull/38314
5408[38327]: https://github.com/rust-lang/rust/pull/38327
5409[38401]: https://github.com/rust-lang/rust/pull/38401
5410[38413]: https://github.com/rust-lang/rust/pull/38413
5411[38469]: https://github.com/rust-lang/rust/pull/38469
5412[38559]: https://github.com/rust-lang/rust/pull/38559
5413[38571]: https://github.com/rust-lang/rust/pull/38571
5414[38580]: https://github.com/rust-lang/rust/pull/38580
5415[38589]: https://github.com/rust-lang/rust/pull/38589
5416[38670]: https://github.com/rust-lang/rust/pull/38670
5417[38712]: https://github.com/rust-lang/rust/pull/38712
5418[38726]: https://github.com/rust-lang/rust/pull/38726
5419[38781]: https://github.com/rust-lang/rust/pull/38781
5420[38798]: https://github.com/rust-lang/rust/pull/38798
5421[38909]: https://github.com/rust-lang/rust/pull/38909
5422[38920]: https://github.com/rust-lang/rust/pull/38920
5423[38927]: https://github.com/rust-lang/rust/pull/38927
5424[39048]: https://github.com/rust-lang/rust/pull/39048
5425[39282]: https://github.com/rust-lang/rust/pull/39282
5426[39379]: https://github.com/rust-lang/rust/pull/39379
3b2f2976 5427[41105]: https://github.com/rust-lang/rust/issues/41105
32a655c1
SL
5428[`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5429[`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5430[`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5431[`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5432[`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5433[`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5434[`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5435[`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5436[`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5437[`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5438[`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5439[`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5440[`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5441[`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5442[`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5443[`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5444[`VecDeque::resize`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5445[`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5446[`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5447[`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5448[cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5449[cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5450[cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5451[cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5452[cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5453[cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5454[cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5455[cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5456[cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5457[RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5458
5459
e81b0574
SL
5460Version 1.15.1 (2017-02-09)
5461===========================
5462
5463* [Fix IntoIter::as_mut_slice's signature][39466]
5464* [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5465
5466[39466]: https://github.com/rust-lang/rust/pull/39466
5467[39523]: https://github.com/rust-lang/rust/pull/39523
5468
5469
476ff2be
SL
5470Version 1.15.0 (2017-02-02)
5471===========================
5472
5473Language
5474--------
5475
5476* Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5477 stable. This allows popular code-generating crates like Serde and Diesel to
5478 work ergonomically. [RFC 1681].
5479* [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5480 with curly braces][36868]. Part of [RFC 1506].
5481* [A number of minor changes to name resolution have been activated][37127].
5482 They add up to more consistent semantics, allowing for future evolution of
5483 Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5484 details of what is different. The breaking changes here have been transitioned
5485 through the [`legacy_imports`] lint since 1.14, with no known regressions.
5486* [In `macro_rules`, `path` fragments can now be parsed as type parameter
5487 bounds][38279]
5488* [`?Sized` can be used in `where` clauses][37791]
5489* [There is now a limit on the size of monomorphized types and it can be
5490 modified with the `#![type_size_limit]` crate attribute, similarly to
5491 the `#![recursion_limit]` attribute][37789]
5492
5493Compiler
5494--------
5495
5496* [On Windows, the compiler will apply dllimport attributes when linking to
5497 extern functions][37973]. Additional attributes and flags can control which
5498 library kind is linked and its name. [RFC 1717].
5499* [Rust-ABI symbols are no longer exported from cdylibs][38117]
5500* [The `--test` flag works with procedural macro crates][38107]
5501* [Fix `extern "aapcs" fn` ABI][37814]
5502* [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5503* [The `format!` expander recognizes incorrect `printf` and shell-style
5504 formatting directives and suggests the correct format][37613].
5505* [Only report one error for all unused imports in an import list][37456]
5506
5507Compiler Performance
5508--------------------
5509
5510* [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5511* [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5512* [Don't clone in `UnificationTable::probe`][37848]
5513* [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5514* [Use small vectors in type walker][37760]
5515* [Macro expansion performance was improved][37701]
5516* [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5517* [Replace FNV with a faster hash function][37229]
5518
5519Stabilized APIs
5520---------------
5521
5522* [`std::iter::Iterator::min_by`]
5523* [`std::iter::Iterator::max_by`]
5524* [`std::os::*::fs::FileExt`]
5525* [`std::sync::atomic::Atomic*::get_mut`]
5526* [`std::sync::atomic::Atomic*::into_inner`]
5527* [`std::vec::IntoIter::as_slice`]
5528* [`std::vec::IntoIter::as_mut_slice`]
5529* [`std::sync::mpsc::Receiver::try_iter`]
5530* [`std::os::unix::process::CommandExt::before_exec`]
5531* [`std::rc::Rc::strong_count`]
5532* [`std::rc::Rc::weak_count`]
5533* [`std::sync::Arc::strong_count`]
5534* [`std::sync::Arc::weak_count`]
5535* [`std::char::encode_utf8`]
5536* [`std::char::encode_utf16`]
5537* [`std::cell::Ref::clone`]
5538* [`std::io::Take::into_inner`]
5539
5540Libraries
5541---------
5542
5543* [The standard sorting algorithm has been rewritten for dramatic performance
5544 improvements][38192]. It is a hybrid merge sort, drawing influences from
5545 Timsort. Previously it was a naive merge sort.
5546* [`Iterator::nth` no longer has a `Sized` bound][38134]
5547* [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5548 performance.
5549* [`chars().count()` is much faster][37888] and so are [`chars().last()`
5550 and `char_indices().last()`][37882]
5551* [Fix ARM Objective-C ABI in `std::env::args`][38146]
5552* [Chinese characters display correctly in `fmt::Debug`][37855]
5553* [Derive `Default` for `Duration`][37699]
5554* [Support creation of anonymous pipes on WinXP/2k][37677]
5555* [`mpsc::RecvTimeoutError` implements `Error`][37527]
5556* [Don't pass overlapped handles to processes][38835]
5557
5558Cargo
5559-----
5560
5561* [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5562 environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5563 should instead check the variable at runtime with `std::env`. That the value
5564 was set at build time was a bug, and incorrect when cross-compiling. This
5565 change is known to cause breakage.
5566* [Add `--all` flag to `cargo test`][cargo/3221]
5567* [Compile statically against the MSVC CRT][cargo/3363]
5568* [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5569* [Link OpenSSL statically on OSX][cargo/3311]
5570* [Apply new fingerprinting to build dir outputs][cargo/3310]
5571* [Test for bad path overrides with summaries][cargo/3336]
5572* [Require `cargo install --vers` to take a semver version][cargo/3338]
5573* [Fix retrying crate downloads for network errors][cargo/3348]
5574* [Implement string lookup for `build.rustflags` config key][cargo/3356]
5575* [Emit more info on --message-format=json][cargo/3319]
5576* [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5577* [Don't ignore errors in workspace manifest][cargo/3409]
5578* [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5579
5580Tooling
5581-------
5582
5583* [Test runners (binaries built with `--test`) now support a `--list` argument
5584 that lists the tests it contains][38185]
5585* [Test runners now support a `--exact` argument that makes the test filter
5586 match exactly, instead of matching only a substring of the test name][38181]
5587* [rustdoc supports a `--playground-url` flag][37763]
5588* [rustdoc provides more details about `#[should_panic]` errors][37749]
5589
5590Misc
5591----
5592
5593* [The Rust build system is now written in Rust][37817]. The Makefiles may
5594 continue to be used in this release by passing `--disable-rustbuild` to the
5595 configure script, but they will be deleted soon. Note that the new build
5596 system uses a different on-disk layout that will likely affect any scripts
5597 building Rust.
5598* [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5599 releases.
5600* [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5601* [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5602 releases.
5603
5604Compatibility Notes
5605-------------------
5606
5607* [A number of minor changes to name resolution have been activated][37127].
5608 They add up to more consistent semantics, allowing for future evolution of
5609 Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5610 details of what is different. The breaking changes here have been transitioned
5611 through the [`legacy_imports`] lint since 1.14, with no known regressions.
5612* [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5613 environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5614 should instead check the variable at runtime with `std::env`. That the value
5615 was set at build time was a bug, and incorrect when cross-compiling. This
5616 change is known to cause breakage.
5617* [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5618 types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5619 1.10 and is now an error by default. It will become a hard error in the near
5620 future.
5621* [The semantics relating modules to file system directories are changing in
5622 minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5623 lint, which is a warning in this release, and will become a hard error in the
5624 future.
5625* [Rust-ABI symbols are no longer exported from cdylibs][38117]
5626* [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5627 the underlying iterator][37834]
5628
5629["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5630[33685]: https://github.com/rust-lang/rust/issues/33685
5631[36868]: https://github.com/rust-lang/rust/pull/36868
5632[37127]: https://github.com/rust-lang/rust/pull/37127
5633[37229]: https://github.com/rust-lang/rust/pull/37229
5634[37456]: https://github.com/rust-lang/rust/pull/37456
5635[37527]: https://github.com/rust-lang/rust/pull/37527
5636[37602]: https://github.com/rust-lang/rust/pull/37602
5637[37613]: https://github.com/rust-lang/rust/pull/37613
5638[37615]: https://github.com/rust-lang/rust/pull/37615
5639[37636]: https://github.com/rust-lang/rust/pull/37636
32a655c1 5640[37627]: https://github.com/rust-lang/rust/pull/37627
476ff2be
SL
5641[37642]: https://github.com/rust-lang/rust/pull/37642
5642[37677]: https://github.com/rust-lang/rust/pull/37677
5643[37699]: https://github.com/rust-lang/rust/pull/37699
5644[37701]: https://github.com/rust-lang/rust/pull/37701
5645[37705]: https://github.com/rust-lang/rust/pull/37705
5646[37749]: https://github.com/rust-lang/rust/pull/37749
5647[37760]: https://github.com/rust-lang/rust/pull/37760
5648[37763]: https://github.com/rust-lang/rust/pull/37763
5649[37764]: https://github.com/rust-lang/rust/pull/37764
5650[37789]: https://github.com/rust-lang/rust/pull/37789
5651[37791]: https://github.com/rust-lang/rust/pull/37791
5652[37814]: https://github.com/rust-lang/rust/pull/37814
5653[37817]: https://github.com/rust-lang/rust/pull/37817
5654[37834]: https://github.com/rust-lang/rust/pull/37834
5655[37848]: https://github.com/rust-lang/rust/pull/37848
5656[37855]: https://github.com/rust-lang/rust/pull/37855
5657[37882]: https://github.com/rust-lang/rust/pull/37882
5658[37888]: https://github.com/rust-lang/rust/pull/37888
5659[37973]: https://github.com/rust-lang/rust/pull/37973
5660[37979]: https://github.com/rust-lang/rust/pull/37979
5661[38086]: https://github.com/rust-lang/rust/pull/38086
5662[38107]: https://github.com/rust-lang/rust/pull/38107
5663[38117]: https://github.com/rust-lang/rust/pull/38117
5664[38134]: https://github.com/rust-lang/rust/pull/38134
5665[38146]: https://github.com/rust-lang/rust/pull/38146
5666[38181]: https://github.com/rust-lang/rust/pull/38181
5667[38182]: https://github.com/rust-lang/rust/pull/38182
5668[38185]: https://github.com/rust-lang/rust/pull/38185
5669[38192]: https://github.com/rust-lang/rust/pull/38192
5670[38279]: https://github.com/rust-lang/rust/pull/38279
5671[38835]: https://github.com/rust-lang/rust/pull/38835
5672[RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5673[RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5674[RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5675[RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5676[RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5677[`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5678[`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5679[cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5680[cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5681[cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5682[cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5683[cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5684[cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5685[cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5686[cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5687[cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5688[cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5689[cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5690[cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5691[cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5692[cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5693[`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5694[`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5695[`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5696[`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5697[`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5698[`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5699[`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5700[`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5701[`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5702[`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5703[`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5704[`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5705[`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5706[`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5707[`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5708[`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5709[`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5710
5711
5712Version 1.14.0 (2016-12-22)
5713===========================
5714
5715Language
5716--------
5717
5718* [`..` matches multiple tuple fields in enum variants, structs
5719 and tuples][36843]. [RFC 1492].
5720* [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5721* [`use *` and `use ::*` both glob-import from the crate root][37367]
5722* [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5723 dereferencing][36822]
5724
5725Compiler
5726--------
5727
5728* [Mark enums with non-zero discriminant as non-zero][37224]
5729* [Lower-case `static mut` names are linted like other
5730 statics and consts][37162]
5731* [Fix ICE on some macros in const integer positions
5732 (e.g. `[u8; m!()]`)][36819]
5733* [Improve error message and snippet for "did you mean `x`"][36798]
5734* [Add a panic-strategy field to the target specification][36794]
5735* [Include LLVM version in `--version --verbose`][37200]
5736
5737Compile-time Optimizations
5738--------------------------
5739
5740* [Improve macro expansion performance][37569]
5741* [Shrink `Expr_::ExprInlineAsm`][37445]
5742* [Replace all uses of SHA-256 with BLAKE2b][37439]
5743* [Reduce the number of bytes hashed by `IchHasher`][37427]
5744* [Avoid more allocations when compiling html5ever][37373]
5745* [Use `SmallVector` in `CombineFields::instantiate`][37322]
5746* [Avoid some allocations in the macro parser][37318]
5747* [Use a faster deflate setting][37298]
5748* [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5749 during interning of slices][37270]
5750* [Optimize `write_metadata`][37267]
5751* [Don't process obligation forest cycles when stalled][37231]
5752* [Avoid many `CrateConfig` clones][37161]
5753* [Optimize `Substs::super_fold_with`][37108]
5754* [Optimize `ObligationForest`'s `NodeState` handling][36993]
5755* [Speed up `plug_leaks`][36917]
5756
5757Libraries
5758---------
5759
5760* [`println!()`, with no arguments, prints newline][36825].
5761 Previously, an empty string was required to achieve the same.
5762* [`Wrapping` impls standard binary and unary operators, as well as
5763 the `Sum` and `Product` iterators][37356]
5764* [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5765 Vec<T>`][37326]
5766* [Improve `fold` performance for `chain`, `cloned`, `map`, and
5767 `VecDeque` iterators][37315]
5768* [Improve `SipHasher` performance on small values][37312]
5769* [Add Iterator trait TrustedLen to enable better FromIterator /
5770 Extend][37306]
5771* [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5772* [`ReadDir` implements `Debug`][37221]
5773* [Implement `RefUnwindSafe` for atomic types][37178]
5774* [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5775* [Avoid allocations in `Decoder::read_str`][37064]
5776* [`io::Error` implements `From<io::ErrorKind>`][37037]
5777* [Impl `Debug` for raw pointers to unsized data][36880]
5778* [Don't reuse `HashMap` random seeds][37470]
5779* [The internal memory layout of `HashMap` is more cache-friendly, for
5780 significant improvements in some operations][36692]
5781* [`HashMap` uses less memory on 32-bit architectures][36595]
5782* [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5783
5784Cargo
5785-----
5786
5787* [Expose rustc cfg values to build scripts][cargo/3243]
5788* [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5789* [Fix passing --features when testing multiple packages][cargo/3280]
5790* [Use a single profile set per workspace][cargo/3249]
5791* [Load `replace` sections from lock files][cargo/3220]
5792* [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5793
5794Tooling
5795-------
5796
5797* [rustup is the recommended Rust installation method][1.14rustup]
5798* This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5799 S390x. These are [tier 2] platforms and may have major defects. Follow the
5800 instructions on the website to install, or add the targets to an existing
5801 installation with `rustup target add`. The new target triples are:
5802 - `mips-unknown-linux-gnu`
5803 - `mipsel-unknown-linux-gnu`
5804 - `mips64-unknown-linux-gnuabi64`
5805 - `mips64el-unknown-linux-gnuabi64 `
5806 - `powerpc-unknown-linux-gnu`
5807 - `powerpc64-unknown-linux-gnu`
5808 - `powerpc64le-unknown-linux-gnu`
5809 - `s390x-unknown-linux-gnu `
5810* This release includes target (std) builds for ARM Linux running MUSL
5811 libc. These are [tier 2] platforms and may have major defects. Add the
5812 following triples to an existing rustup installation with `rustup target add`:
5813 - `arm-unknown-linux-musleabi`
5814 - `arm-unknown-linux-musleabihf`
5815 - `armv7-unknown-linux-musleabihf`
5816* This release includes [experimental support for WebAssembly][1.14wasm], via
5817 the `wasm32-unknown-emscripten` target. This target is known to have major
5818 defects. Please test, report, and fix.
5819* rustup no longer installs documentation by default. Run `rustup
5820 component add rust-docs` to install.
5821* [Fix line stepping in debugger][37310]
5822* [Enable line number debuginfo in releases][37280]
5823
5824Misc
5825----
5826
5827* [Disable jemalloc on aarch64/powerpc/mips][37392]
5828* [Add support for Fuchsia OS][37313]
5829* [Detect local-rebuild by only MAJOR.MINOR version][37273]
5830
5831Compatibility Notes
5832-------------------
5833
5834* [A number of forward-compatibility lints used by the compiler
5835 to gradually introduce language changes have been converted
5836 to deny by default][36894]:
5837 - ["use of inaccessible extern crate erroneously allowed"][36886]
5838 - ["type parameter default erroneously allowed in invalid location"][36887]
5839 - ["detects super or self keywords at the beginning of global path"][36888]
5840 - ["two overlapping inherent impls define an item with the same name
5841 were erroneously allowed"][36889]
5842 - ["floating-point constants cannot be used in patterns"][36890]
5843 - ["constants of struct or enum type can only be used in a pattern if
5844 the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5845 - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5846* [Prohibit patterns in trait methods without bodies][37378]
5847* [The atomic `Ordering` enum may not be matched exhaustively][37351]
5848* [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5849* [The `$crate` macro variable is accepted in fewer locations][37213]
5850* [Impls specifying extra region requirements beyond the trait
5851 they implement are rejected][37167]
5852* [Enums may not be unsized][37111]. Unsized enums are intended to
5853 work but never have. For now they are forbidden.
5854* [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5855
5856[tier 2]: https://forge.rust-lang.org/platform-support.html
5857[1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5858[1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5859[36430]: https://github.com/rust-lang/rust/pull/36430
5860[36595]: https://github.com/rust-lang/rust/pull/36595
5861[36595]: https://github.com/rust-lang/rust/pull/36595
5862[36692]: https://github.com/rust-lang/rust/pull/36692
5863[36767]: https://github.com/rust-lang/rust/pull/36767
5864[36794]: https://github.com/rust-lang/rust/pull/36794
5865[36798]: https://github.com/rust-lang/rust/pull/36798
5866[36819]: https://github.com/rust-lang/rust/pull/36819
5867[36822]: https://github.com/rust-lang/rust/pull/36822
5868[36825]: https://github.com/rust-lang/rust/pull/36825
5869[36843]: https://github.com/rust-lang/rust/pull/36843
5870[36880]: https://github.com/rust-lang/rust/pull/36880
5871[36886]: https://github.com/rust-lang/rust/issues/36886
5872[36887]: https://github.com/rust-lang/rust/issues/36887
5873[36888]: https://github.com/rust-lang/rust/issues/36888
5874[36889]: https://github.com/rust-lang/rust/issues/36889
5875[36890]: https://github.com/rust-lang/rust/issues/36890
5876[36891]: https://github.com/rust-lang/rust/issues/36891
5877[36892]: https://github.com/rust-lang/rust/issues/36892
5878[36894]: https://github.com/rust-lang/rust/pull/36894
5879[36917]: https://github.com/rust-lang/rust/pull/36917
5880[36993]: https://github.com/rust-lang/rust/pull/36993
5881[37037]: https://github.com/rust-lang/rust/pull/37037
5882[37064]: https://github.com/rust-lang/rust/pull/37064
5883[37094]: https://github.com/rust-lang/rust/pull/37094
5884[37108]: https://github.com/rust-lang/rust/pull/37108
5885[37111]: https://github.com/rust-lang/rust/pull/37111
5886[37161]: https://github.com/rust-lang/rust/pull/37161
5887[37162]: https://github.com/rust-lang/rust/pull/37162
5888[37167]: https://github.com/rust-lang/rust/pull/37167
5889[37178]: https://github.com/rust-lang/rust/pull/37178
5890[37200]: https://github.com/rust-lang/rust/pull/37200
5891[37213]: https://github.com/rust-lang/rust/pull/37213
5892[37221]: https://github.com/rust-lang/rust/pull/37221
5893[37224]: https://github.com/rust-lang/rust/pull/37224
5894[37230]: https://github.com/rust-lang/rust/pull/37230
5895[37231]: https://github.com/rust-lang/rust/pull/37231
5896[37247]: https://github.com/rust-lang/rust/pull/37247
5897[37267]: https://github.com/rust-lang/rust/pull/37267
5898[37270]: https://github.com/rust-lang/rust/pull/37270
5899[37273]: https://github.com/rust-lang/rust/pull/37273
5900[37280]: https://github.com/rust-lang/rust/pull/37280
5901[37298]: https://github.com/rust-lang/rust/pull/37298
5902[37306]: https://github.com/rust-lang/rust/pull/37306
5903[37310]: https://github.com/rust-lang/rust/pull/37310
5904[37312]: https://github.com/rust-lang/rust/pull/37312
5905[37313]: https://github.com/rust-lang/rust/pull/37313
5906[37315]: https://github.com/rust-lang/rust/pull/37315
5907[37318]: https://github.com/rust-lang/rust/pull/37318
5908[37322]: https://github.com/rust-lang/rust/pull/37322
5909[37326]: https://github.com/rust-lang/rust/pull/37326
5910[37351]: https://github.com/rust-lang/rust/pull/37351
5911[37356]: https://github.com/rust-lang/rust/pull/37356
5912[37367]: https://github.com/rust-lang/rust/pull/37367
5913[37373]: https://github.com/rust-lang/rust/pull/37373
5914[37378]: https://github.com/rust-lang/rust/pull/37378
5915[37389]: https://github.com/rust-lang/rust/pull/37389
5916[37392]: https://github.com/rust-lang/rust/pull/37392
5917[37427]: https://github.com/rust-lang/rust/pull/37427
5918[37439]: https://github.com/rust-lang/rust/pull/37439
5919[37445]: https://github.com/rust-lang/rust/pull/37445
5920[37470]: https://github.com/rust-lang/rust/pull/37470
5921[37569]: https://github.com/rust-lang/rust/pull/37569
5922[RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5923[cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5924[cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5925[cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5926[cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5927[cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5928[cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5929
5930
5931Version 1.13.0 (2016-11-10)
5932===========================
5933
5934Language
5935--------
5936
5937* [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5938 errors, like the `try!` macro, described in [RFC 0243].
5939* [Stabilize macros in type position][36014]. Described in [RFC 873].
5940* [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5941* [Fix `#[derive]` for empty tuple structs/variants][35728]
5942* [Fix lifetime rules for 'if' conditions][36029]
5943* [Avoid loading and parsing unconfigured non-inline modules][36482]
5944
5945Compiler
5946--------
5947
5948* [Add the `-C link-arg` argument][36574]
5949* [Remove the old AST-based backend from rustc_trans][35764]
5950* [Don't enable NEON by default on armv7 Linux][35814]
5951* [Fix debug line number info for macro expansions][35238]
5952* [Do not emit "class method" debuginfo for types that are not
5953 DICompositeType][36008]
5954* [Warn about multiple conflicting #[repr] hints][34623]
5955* [When sizing DST, don't double-count nested struct prefixes][36351]
5956* [Default RUST_MIN_STACK to 16MiB for now][36505]
5957* [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5958* [Reject macros with empty repetitions to avoid infinite loop][36721]
5959* [Expand macros without recursing to avoid stack overflows][36214]
5960
5961Diagnostics
5962-----------
5963
5964* [Replace macro backtraces with labeled local uses][35702]
ff7c6d11 5965* [Improve error message for misplaced doc comments][33922]
476ff2be
SL
5966* [Buffer unix and lock windows to prevent message interleaving][35975]
5967* [Update lifetime errors to specifically note temporaries][36171]
5968* [Special case a few colors for Windows][36178]
5969* [Suggest `use self` when such an import resolves][36289]
5970* [Be more specific when type parameter shadows primitive type][36338]
5971* Many minor improvements
5972
5973Compile-time Optimizations
5974--------------------------
5975
5976* [Compute and cache HIR hashes at beginning][35854]
5977* [Don't hash types in loan paths][36004]
5978* [Cache projections in trans][35761]
5979* [Optimize the parser's last token handling][36527]
5980* [Only instantiate #[inline] functions in codegen units referencing
5981 them][36524]. This leads to big improvements in cases where crates export
5982 define many inline functions without using them directly.
5983* [Lazily allocate TypedArena's first chunk][36592]
5984* [Don't allocate during default HashSet creation][36734]
5985
5986Stabilized APIs
5987---------------
5988
5989* [`checked_abs`]
5990* [`wrapping_abs`]
5991* [`overflowing_abs`]
5992* [`RefCell::try_borrow`]
5993* [`RefCell::try_borrow_mut`]
5994
5995Libraries
5996---------
5997
5998* [Add `assert_ne!` and `debug_assert_ne!`][35074]
5999* [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6000 covariant][35354]
6001* [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6002* [Implement `Debug` for `std::vec::IntoIter`][35707]
6003* [`CString`: avoid excessive growth just to 0-terminate][35871]
6004* [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6005* [Use arc4rand on FreeBSD][35884]
6006* [memrchr: Correct aligned offset computation][35969]
6007* [Improve Demangling of Rust Symbols][36059]
6008* [Use monotonic time in condition variables][35048]
6009* [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6010* [Implement conversion traits for `char`][35755]
6011* [Fix illegal instruction caused by overflow in channel cloning][36104]
6012* [Zero first byte of CString on drop][36264]
6013* [Inherit overflow checks for sum and product][36372]
6014* [Add missing Eq implementations][36423]
6015* [Implement `Debug` for `DirEntry`][36631]
6016* [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6017 `errno`][36754]
6018* [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6019* [Implement more traits for `std::io::ErrorKind`][35911]
6020* [Optimize BinaryHeap bounds checking][36072]
6021* [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6022 `extend_with_element`][36355]
6023* [Fix overflow checking in unsigned pow()][34942]
6024
6025Cargo
6026-----
6027
6028* This release includes security fixes to both curl and OpenSSL.
6029* [Fix transitive doctests when panic=abort][cargo/3021]
6030* [Add --all-features flag to cargo][cargo/3038]
6031* [Reject path-based dependencies in `cargo package`][cargo/3060]
6032* [Don't parse the home directory more than once][cargo/3078]
6033* [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6034* [Update OpenSSL to 1.0.2j][cargo/3121]
6035* [Add license and license_file to cargo metadata output][cargo/3110]
6036* [Make crates-io registry URL optional in config; ignore all changes to
6037 source.crates-io][cargo/3089]
6038* [Don't download dependencies from other platforms][cargo/3123]
6039* [Build transitive dev-dependencies when needed][cargo/3125]
6040* [Add support for per-target rustflags in .cargo/config][cargo/3157]
6041* [Avoid updating registry when adding existing deps][cargo/3144]
6042* [Warn about path overrides that won't work][cargo/3136]
6043* [Use workspaces during `cargo install`][cargo/3146]
6044* [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6045* [Add --message-format flag][cargo/3000]
6046* [Pass target environment for rustdoc][cargo/3205]
6047* [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6048* [Update curl and curl-sys][cargo/3241]
6049* [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6050
6051Tooling
6052-------
6053
6054* [rustdoc: Add the `--sysroot` argument][36586]
6055* [rustdoc: Fix a couple of issues with the search results][35655]
6056* [rustdoc: remove the `!` from macro URLs and titles][35234]
6057* [gdb: Fix pretty-printing special-cased Rust types][35585]
6058* [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6059
6060Misc
6061----
6062
6063* [Remove unmaintained style guide][35124]
6064* [Add s390x support][36369]
6065* [Initial work at Haiku OS support][36727]
6066* [Add mips-uclibc targets][35734]
6067* [Crate-ify compiler-rt into compiler-builtins][35021]
6068* [Add rustc version info (git hash + date) to dist tarball][36213]
6069* Many documentation improvements
6070
6071Compatibility Notes
6072-------------------
6073
6074* [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6075* [Deny (by default) transmuting from fn item types to pointer-sized
6076 types][34923]. Continuing the long transition to zero-sized fn items,
6077 per [RFC 401].
6078* [Fix `#[derive]` for empty tuple structs/variants][35728].
6079 Part of [RFC 1506].
6080* [Issue deprecation warnings for safe accesses to extern statics][36173]
6081* [Fix lifetime rules for 'if' conditions][36029].
6082* [Inherit overflow checks for sum and product][36372].
6083* [Forbid user-defined macros named "macro_rules"][36730].
6084
6085[33922]: https://github.com/rust-lang/rust/pull/33922
6086[34623]: https://github.com/rust-lang/rust/pull/34623
6087[34923]: https://github.com/rust-lang/rust/pull/34923
6088[34942]: https://github.com/rust-lang/rust/pull/34942
6089[34982]: https://github.com/rust-lang/rust/pull/34982
6090[35021]: https://github.com/rust-lang/rust/pull/35021
6091[35048]: https://github.com/rust-lang/rust/pull/35048
6092[35074]: https://github.com/rust-lang/rust/pull/35074
6093[35124]: https://github.com/rust-lang/rust/pull/35124
6094[35234]: https://github.com/rust-lang/rust/pull/35234
6095[35238]: https://github.com/rust-lang/rust/pull/35238
6096[35354]: https://github.com/rust-lang/rust/pull/35354
6097[35559]: https://github.com/rust-lang/rust/pull/35559
6098[35585]: https://github.com/rust-lang/rust/pull/35585
6099[35627]: https://github.com/rust-lang/rust/pull/35627
6100[35655]: https://github.com/rust-lang/rust/pull/35655
6101[35702]: https://github.com/rust-lang/rust/pull/35702
6102[35707]: https://github.com/rust-lang/rust/pull/35707
6103[35728]: https://github.com/rust-lang/rust/pull/35728
6104[35734]: https://github.com/rust-lang/rust/pull/35734
6105[35755]: https://github.com/rust-lang/rust/pull/35755
6106[35761]: https://github.com/rust-lang/rust/pull/35761
6107[35764]: https://github.com/rust-lang/rust/pull/35764
6108[35814]: https://github.com/rust-lang/rust/pull/35814
6109[35854]: https://github.com/rust-lang/rust/pull/35854
6110[35871]: https://github.com/rust-lang/rust/pull/35871
6111[35884]: https://github.com/rust-lang/rust/pull/35884
6112[35911]: https://github.com/rust-lang/rust/pull/35911
6113[35969]: https://github.com/rust-lang/rust/pull/35969
6114[35975]: https://github.com/rust-lang/rust/pull/35975
6115[36004]: https://github.com/rust-lang/rust/pull/36004
6116[36008]: https://github.com/rust-lang/rust/pull/36008
6117[36014]: https://github.com/rust-lang/rust/pull/36014
6118[36029]: https://github.com/rust-lang/rust/pull/36029
6119[36059]: https://github.com/rust-lang/rust/pull/36059
6120[36072]: https://github.com/rust-lang/rust/pull/36072
6121[36101]: https://github.com/rust-lang/rust/pull/36101
6122[36104]: https://github.com/rust-lang/rust/pull/36104
6123[36171]: https://github.com/rust-lang/rust/pull/36171
6124[36173]: https://github.com/rust-lang/rust/pull/36173
6125[36178]: https://github.com/rust-lang/rust/pull/36178
6126[36213]: https://github.com/rust-lang/rust/pull/36213
6127[36214]: https://github.com/rust-lang/rust/pull/36214
6128[36264]: https://github.com/rust-lang/rust/pull/36264
6129[36266]: https://github.com/rust-lang/rust/pull/36266
6130[36289]: https://github.com/rust-lang/rust/pull/36289
6131[36338]: https://github.com/rust-lang/rust/pull/36338
6132[36351]: https://github.com/rust-lang/rust/pull/36351
6133[36355]: https://github.com/rust-lang/rust/pull/36355
6134[36369]: https://github.com/rust-lang/rust/pull/36369
6135[36372]: https://github.com/rust-lang/rust/pull/36372
6136[36423]: https://github.com/rust-lang/rust/pull/36423
6137[36482]: https://github.com/rust-lang/rust/pull/36482
6138[36505]: https://github.com/rust-lang/rust/pull/36505
6139[36524]: https://github.com/rust-lang/rust/pull/36524
6140[36527]: https://github.com/rust-lang/rust/pull/36527
6141[36551]: https://github.com/rust-lang/rust/pull/36551
6142[36574]: https://github.com/rust-lang/rust/pull/36574
6143[36586]: https://github.com/rust-lang/rust/pull/36586
6144[36592]: https://github.com/rust-lang/rust/pull/36592
6145[36631]: https://github.com/rust-lang/rust/pull/36631
6146[36639]: https://github.com/rust-lang/rust/pull/36639
6147[36721]: https://github.com/rust-lang/rust/pull/36721
6148[36727]: https://github.com/rust-lang/rust/pull/36727
6149[36730]: https://github.com/rust-lang/rust/pull/36730
6150[36734]: https://github.com/rust-lang/rust/pull/36734
6151[36754]: https://github.com/rust-lang/rust/pull/36754
6152[36995]: https://github.com/rust-lang/rust/pull/36995
6153[RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6154[RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6155[RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6156[RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6157[RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6158[cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6159[cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6160[cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6161[cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6162[cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6163[cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6164[cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6165[cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6166[cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6167[cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6168[cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6169[cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6170[cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6171[cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6172[cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6173[cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6174[cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6175[cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6176[cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6177[cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6178[rustup]: https://www.rustup.rs
6179[`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6180[`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6181[`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6182[`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6183[`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6184[`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6185[`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6186
6187
9e0c209e
SL
6188Version 1.12.1 (2016-10-20)
6189===========================
6190
6191Regression Fixes
6192----------------
6193
6194* [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6195* [Confusion with double negation and booleans][36856]
6196* [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6197* [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6198* [1.12.0: High memory usage when linking in release mode with debug info][36926]
6199* [Corrupted memory after updated to 1.12][36936]
6200* ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6201* [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6202* [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6203
6204[36381]: https://github.com/rust-lang/rust/issues/36381
6205[36856]: https://github.com/rust-lang/rust/issues/36856
6206[36875]: https://github.com/rust-lang/rust/issues/36875
6207[36924]: https://github.com/rust-lang/rust/issues/36924
6208[36926]: https://github.com/rust-lang/rust/issues/36926
6209[36936]: https://github.com/rust-lang/rust/issues/36936
6210[37026]: https://github.com/rust-lang/rust/issues/37026
6211[37112]: https://github.com/rust-lang/rust/issues/37112
6212[37153]: https://github.com/rust-lang/rust/issues/37153
6213
6214
5bcae85e
SL
6215Version 1.12.0 (2016-09-29)
6216===========================
6217
6218Highlights
6219----------
6220
7cac9316 6221* [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5bcae85e
SL
6222 This translation pass is far simpler than the previous AST->LLVM pass, and
6223 creates opportunities to perform new optimizations directly on the MIR. It
7cac9316 6224 was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5bcae85e 6225* [`rustc` presents a new, more readable error format, along with
7cac9316 6226 machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5bcae85e 6227 Most common editors supporting Rust have been updated to work with it. It was
7cac9316 6228 previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5bcae85e
SL
6229
6230Compiler
6231--------
6232
7cac9316 6233* [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5bcae85e
SL
6234 This translation pass is far simpler than the previous AST->LLVM pass, and
6235 creates opportunities to perform new optimizations directly on the MIR. It
7cac9316 6236 was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5bcae85e 6237* [Print the Rust target name, not the LLVM target name, with
7cac9316 6238 `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5bcae85e 6239* [The computation of `TypeId` is correct in some cases where it was previously
7cac9316
XL
6240 producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6241* [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5bcae85e
SL
6242* [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6243 `--print relocation-models`, and `--print code-models` print the available
6244 options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7cac9316 6245 `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5bcae85e 6246* [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7cac9316 6247 `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5bcae85e
SL
6248 These targets produce statically-linked binaries. There are no binary release
6249 builds yet though.
6250
6251Diagnostics
6252-----------
6253
6254* [`rustc` presents a new, more readable error format, along with
7cac9316 6255 machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5bcae85e 6256 Most common editors supporting Rust have been updated to work with it. It was
7cac9316 6257 previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
c30ab7b3 6258* [In error descriptions, references are now described in plain English,
7cac9316 6259 instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5bcae85e 6260* [In error type descriptions, unknown numeric types are named `{integer}` or
7cac9316
XL
6261 `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6262* [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5bcae85e
SL
6263
6264Language
6265--------
6266
7cac9316
XL
6267* [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6268* [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5bcae85e 6269* [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7cac9316 6270 useful](https://github.com/rust-lang/rust/pull/34908)
5bcae85e 6271* [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7cac9316 6272 inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
ff7c6d11 6273* [Semicolons are properly required as statement delimiters inside
7cac9316
XL
6274 `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6275* [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5bcae85e
SL
6276
6277Stabilized APIs
6278---------------
6279
7cac9316
XL
6280* [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6281* [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6282* [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6283* [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6284* [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6285* [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6286* [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6287* [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6288* [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6289* [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5bcae85e 6290 Both on Unix and Windows.
7cac9316
XL
6291* [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6292* [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6293* [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6294* [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6295* [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6296* [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6297* [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6298* [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5bcae85e
SL
6299
6300Libraries
6301---------
6302
6303* [The `format!` macro and friends now allow a single argument to be formatted
7cac9316 6304 in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5bcae85e 6305* [The lifetime bounds on `[T]::binary_search_by` and
7cac9316
XL
6306 `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6307* [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6308* [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6309* [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6310* [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6311* [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6312* [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6313* [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5bcae85e 6314* [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7cac9316 6315 implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5bcae85e 6316* [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7cac9316
XL
6317 implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6318* [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5bcae85e 6319* [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7cac9316
XL
6320 `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6321* [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6322* [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5bcae85e 6323* [`mpsc::sync_channel` `Receiver`s return any available message before
7cac9316
XL
6324 reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6325* [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6326* [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5bcae85e
SL
6327
6328Cargo
6329-----
6330
7cac9316
XL
6331* [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6332* [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6333* [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6334* [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6335* [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6336* [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6337* [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6338* [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6339* [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6340* [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6341* [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6342* [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6343* [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6344* [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6345* [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6346* [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5bcae85e
SL
6347
6348Performance
6349-----------
6350
7cac9316
XL
6351* [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6352* [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5bcae85e
SL
6353
6354Tooling
6355-------
6356
6357* [Test binaries now support a `--test-threads` argument to specify the number
6358 of threads used to run tests, and which acts the same as the
3b2f2976 6359 `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7cac9316
XL
6360* [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6361* [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6362* [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5bcae85e 6363* [Rust releases now come with source packages that can be installed by rustup
7cac9316 6364 via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5bcae85e
SL
6365 The resulting source code can be used by tools and IDES, located in the
6366 sysroot under `lib/rustlib/src`.
6367
6368Misc
6369----
6370
7cac9316 6371* [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5bcae85e 6372* Many minor improvements to the documentation.
7cac9316 6373* [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5bcae85e
SL
6374
6375Compatibility Notes
6376-------------------
6377
6378* [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7cac9316 6379 with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5bcae85e 6380* [When formatting strings, if "precision" is specified, the "fill",
7cac9316
XL
6381 "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6382* [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5bcae85e
SL
6383
6384
6385Version 1.11.0 (2016-08-18)
6386===========================
6387
6388Language
6389--------
6390
7cac9316
XL
6391* [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6392* [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6393* [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6394* [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5bcae85e
SL
6395
6396Stabilized APIs
6397---------------
6398
7cac9316
XL
6399* [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6400* [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6401* [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6402* [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6403* [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6404* [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5bcae85e 6405 (in libcore - previously stabilized in libstd)
7cac9316 6406* [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5bcae85e 6407 (in libcore - previously stabilized in libstd)
7cac9316 6408* [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5bcae85e 6409 (in libcore - previously stabilized in libstd)
7cac9316 6410* [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5bcae85e 6411 (in libcore - previously stabilized in libstd)
7cac9316
XL
6412* [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6413* [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6414* [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6415* [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5bcae85e
SL
6416
6417Libraries
6418---------
6419
6420* [The `thread_local!` macro supports multiple definitions in a single
7cac9316
XL
6421 invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6422* [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5bcae85e 6423* [`Wrapping` implements binary, octal, lower-hex and upper-hex
7cac9316
XL
6424 `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6425* [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6426* [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6427* [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6428* [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5bcae85e
SL
6429
6430Cargo
6431-----
6432
7cac9316
XL
6433* [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6434* [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6435* [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6436* [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6437* [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5bcae85e 6438 and `-vv` prints warnings for all crates.
7cac9316
XL
6439* [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6440* [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5bcae85e 6441 This provides room for expansion by arbitrary tools.
7cac9316
XL
6442* [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6443* [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6444* [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6445* [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6446* [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6447* [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6448* [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5bcae85e
SL
6449
6450Performance
6451-----------
6452
6453* [Caching projections speeds up type check dramatically for some
7cac9316
XL
6454 workloads](https://github.com/rust-lang/rust/pull/33816)
6455* [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5bcae85e
SL
6456 This hasher is faster, but is believed to provide sufficient
6457 protection from collision attacks.
7cac9316 6458* [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5bcae85e
SL
6459
6460Rustdoc
6461-------
6462
7cac9316 6463* [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
2c00a5a8 6464* [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7cac9316
XL
6465* [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6466* [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
2c00a5a8 6467* [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5bcae85e
SL
6468
6469Tooling
6470-------
6471
7cac9316 6472* [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5bcae85e 6473* [When emitting debug info, rustc emits frame pointers for closures,
7cac9316
XL
6474 shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6475* [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5bcae85e
SL
6476* Many more errors have been given error codes and extended
6477 explanations
6478* API documentation continues to be improved, with many new examples
6479
6480Misc
6481----
6482
6483* [rustc no longer hangs when dependencies recursively re-export
7cac9316
XL
6484 submodules](https://github.com/rust-lang/rust/pull/34542)
6485* [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5bcae85e 6486* [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7cac9316
XL
6487 rewritten](https://github.com/rust-lang/rust/pull/33895)
6488* [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5bcae85e
SL
6489 No targets use this yet, but it works toward AVR support.
6490
6491Compatibility Notes
6492-------------------
6493
7cac9316 6494* [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5bcae85e 6495* [The new follow-set rules that place restrictions on `macro_rules!`
7cac9316 6496 in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
ff7c6d11 6497 This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5bcae85e 6498 and has been a warning since 1.10.
7cac9316 6499* [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5bcae85e
SL
6500 This causes breakage in some corner cases.
6501
6502
a7813a04
XL
6503Version 1.10.0 (2016-07-07)
6504===========================
6505
6506Language
6507--------
6508
7cac9316 6509* [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
a7813a04 6510 [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7cac9316
XL
6511* [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6512* [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
a7813a04 6513* [`panic!` can be converted to a runtime abort with the
7cac9316 6514 `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
a7813a04 6515 [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7cac9316 6516* [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
a7813a04 6517 cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
8faf50e0 6518 [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
a7813a04
XL
6519 Note that Cargo does not yet directly support cdylibs.
6520
6521Stabilized APIs
6522---------------
6523
6524* `os::windows::fs::OpenOptionsExt::access_mode`
6525* `os::windows::fs::OpenOptionsExt::share_mode`
6526* `os::windows::fs::OpenOptionsExt::custom_flags`
6527* `os::windows::fs::OpenOptionsExt::attributes`
6528* `os::windows::fs::OpenOptionsExt::security_qos_flags`
6529* `os::unix::fs::OpenOptionsExt::custom_flags`
7cac9316 6530* [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
a7813a04 6531* `Default for sync::Weak`
7cac9316
XL
6532* [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6533* [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6534* [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6535* [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6536* [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6537* [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6538* [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6539* [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6540* [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6541* [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6542* [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6543* [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6544* [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6545* [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
a7813a04
XL
6546* `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6547* `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6548* `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6549* `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7cac9316
XL
6550* [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6551* [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6552* [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6553* [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6554* [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6555* [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6556* [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6557* [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6558* [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6559* [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6560* [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6561* [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6562* [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6563* [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
a7813a04 6564* Read/Write/RawFd impls for `UnixStream`
7cac9316
XL
6565* [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6566* [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6567* [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6568* [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6569* [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6570* [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6571* [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
a7813a04 6572* RawFd impls for `UnixListener`
7cac9316
XL
6573* [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6574* [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6575* [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6576* [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6577* [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6578* [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6579* [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6580* [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6581* [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6582* [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6583* [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6584* [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6585* [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6586* [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6587* [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6588* [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6589* [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6590* [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
a7813a04
XL
6591* RawFd impls for `UnixDatagram`
6592* `{BTree,Hash}Map::values_mut`
74d20737 6593* [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
a7813a04
XL
6594
6595Libraries
6596---------
6597
7cac9316 6598* [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
a7813a04
XL
6599 The semantics of this minor method are subtle and probably not what
6600 most people want.
7cac9316 6601* [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
a7813a04
XL
6602* [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6603 will fall back to `/dev/urandom` temporarily to avoid blocking
7cac9316
XL
6604 during early boot](https://github.com/rust-lang/rust/pull/33086).
6605* [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6606* [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6607* [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6608* [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6609* [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
a7813a04 6610* [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7cac9316 6611 `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
a7813a04
XL
6612
6613Cargo
6614-----
7cac9316 6615* [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
a7813a04
XL
6616 This controls the runtime behavior of the `panic!` macro
6617 and can be either "unwind" (the default), or "abort".
6618 [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7cac9316
XL
6619* [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6620* [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
a7813a04 6621* [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7cac9316
XL
6622 variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6623* [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6624* [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6625* [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
a7813a04
XL
6626 By default they are retried twice, which can be customized with the
6627 `net.retry` value in `.cargo/config`.
7cac9316
XL
6628* [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6629* [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6630* [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6631* [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
a7813a04 6632 Makes it possible to install multiple crates in parallel.
7cac9316
XL
6633* [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6634* [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6635* [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6636* [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6637* [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6638* [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
a7813a04
XL
6639
6640Performance
6641-----------
6642
6643* [rustc memory usage was reduced by refactoring the context used for
7cac9316 6644 type checking](https://github.com/rust-lang/rust/pull/33425).
a7813a04 6645* [Speed up creation of `HashMap`s by caching the random keys used
7cac9316
XL
6646 to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6647* [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6648* [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6649* [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
a7813a04 6650 10x faster than the previous lookup tables.
7cac9316 6651* [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
a7813a04
XL
6652
6653Usability
6654---------
6655
6656* Many incremental improvements to documentation and rustdoc.
7cac9316
XL
6657* [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6658* [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6659* [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6660* [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6661* [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6662* [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6663* [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
a7813a04
XL
6664
6665Misc
6666----
6667
7cac9316
XL
6668* [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6669* [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
a7813a04
XL
6670* [`std` no longer prints backtraces on platforms where the running
6671 module must be loaded with `env::current_exe`, which can't be relied
6672 on](https://github.com/rust-lang/rust/pull/33554).
6673* This release includes std binaries for the i586-unknown-linux-gnu,
6674 i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6675 i586 target is for old x86 hardware without SSE2, and the armv7
6676 target is for Android running on modern ARM architectures.
6677* [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6678 Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6679* [On Unix the runtime aborts by calling `libc::abort` instead of
7cac9316 6680 generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
a7813a04 6681* [Rust is now bootstrapped from the previous release of Rust,
7cac9316 6682 instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
a7813a04
XL
6683
6684Compatibility Notes
6685-------------------
6686
7cac9316 6687* [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
a7813a04 6688* [`target_env` for Linux ARM targets is just `gnu`, not
7cac9316
XL
6689 `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6690* [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6691* [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6692* [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
a7813a04 6693 Affects how macros are parsed.
7cac9316 6694* [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
a7813a04 6695* [Feature-gated attributes on macro-generated macro invocations are
7cac9316
XL
6696 now rejected](https://github.com/rust-lang/rust/pull/32791).
6697* [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
a7813a04
XL
6698 This caused some minor changes to type inference.
6699
6700
54a0048b
SL
6701Version 1.9.0 (2016-05-26)
6702==========================
6703
6704Language
6705--------
6706
6707* The `#[deprecated]` attribute when applied to an API will generate
6708 warnings when used. The warnings may be suppressed with
6709 `#[allow(deprecated)]`. [RFC 1270].
6710* [`fn` item types are zero sized, and each `fn` names a unique
6711 type][1.9fn]. This will break code that transmutes `fn`s, so calling
6712 `transmute` on a `fn` type will generate a warning for a few cycles,
6713 then will be converted to an error.
6714* [Field and method resolution understand visibility, so private
6715 fields and methods cannot prevent the proper use of public fields
6716 and methods][1.9fv].
6717* [The parser considers unicode codepoints in the
6718 `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6719
6720Stabilized APIs
6721---------------
6722
6723* [`std::panic`]
dfeec247
XL
6724* [`std::panic::catch_unwind`] (renamed from `recover`)
6725* [`std::panic::resume_unwind`] (renamed from `propagate`)
6726* [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6727* [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
54a0048b
SL
6728* [`str::is_char_boundary`]
6729* [`<*const T>::as_ref`]
6730* [`<*mut T>::as_ref`]
6731* [`<*mut T>::as_mut`]
6732* [`AsciiExt::make_ascii_uppercase`]
6733* [`AsciiExt::make_ascii_lowercase`]
6734* [`char::decode_utf16`]
6735* [`char::DecodeUtf16`]
6736* [`char::DecodeUtf16Error`]
6737* [`char::DecodeUtf16Error::unpaired_surrogate`]
6738* [`BTreeSet::take`]
6739* [`BTreeSet::replace`]
6740* [`BTreeSet::get`]
6741* [`HashSet::take`]
6742* [`HashSet::replace`]
6743* [`HashSet::get`]
6744* [`OsString::with_capacity`]
6745* [`OsString::clear`]
6746* [`OsString::capacity`]
6747* [`OsString::reserve`]
6748* [`OsString::reserve_exact`]
6749* [`OsStr::is_empty`]
6750* [`OsStr::len`]
6751* [`std::os::unix::thread`]
6752* [`RawPthread`]
6753* [`JoinHandleExt`]
6754* [`JoinHandleExt::as_pthread_t`]
6755* [`JoinHandleExt::into_pthread_t`]
6756* [`HashSet::hasher`]
6757* [`HashMap::hasher`]
6758* [`CommandExt::exec`]
6759* [`File::try_clone`]
6760* [`SocketAddr::set_ip`]
6761* [`SocketAddr::set_port`]
6762* [`SocketAddrV4::set_ip`]
6763* [`SocketAddrV4::set_port`]
6764* [`SocketAddrV6::set_ip`]
6765* [`SocketAddrV6::set_port`]
6766* [`SocketAddrV6::set_flowinfo`]
6767* [`SocketAddrV6::set_scope_id`]
6768* [`slice::copy_from_slice`]
6769* [`ptr::read_volatile`]
6770* [`ptr::write_volatile`]
6771* [`OpenOptions::create_new`]
6772* [`TcpStream::set_nodelay`]
6773* [`TcpStream::nodelay`]
6774* [`TcpStream::set_ttl`]
6775* [`TcpStream::ttl`]
6776* [`TcpStream::set_only_v6`]
6777* [`TcpStream::only_v6`]
6778* [`TcpStream::take_error`]
6779* [`TcpStream::set_nonblocking`]
6780* [`TcpListener::set_ttl`]
6781* [`TcpListener::ttl`]
6782* [`TcpListener::set_only_v6`]
6783* [`TcpListener::only_v6`]
6784* [`TcpListener::take_error`]
6785* [`TcpListener::set_nonblocking`]
6786* [`UdpSocket::set_broadcast`]
6787* [`UdpSocket::broadcast`]
6788* [`UdpSocket::set_multicast_loop_v4`]
6789* [`UdpSocket::multicast_loop_v4`]
6790* [`UdpSocket::set_multicast_ttl_v4`]
6791* [`UdpSocket::multicast_ttl_v4`]
6792* [`UdpSocket::set_multicast_loop_v6`]
6793* [`UdpSocket::multicast_loop_v6`]
6794* [`UdpSocket::set_multicast_ttl_v6`]
6795* [`UdpSocket::multicast_ttl_v6`]
6796* [`UdpSocket::set_ttl`]
6797* [`UdpSocket::ttl`]
6798* [`UdpSocket::set_only_v6`]
6799* [`UdpSocket::only_v6`]
6800* [`UdpSocket::join_multicast_v4`]
6801* [`UdpSocket::join_multicast_v6`]
6802* [`UdpSocket::leave_multicast_v4`]
6803* [`UdpSocket::leave_multicast_v6`]
6804* [`UdpSocket::take_error`]
6805* [`UdpSocket::connect`]
6806* [`UdpSocket::send`]
6807* [`UdpSocket::recv`]
6808* [`UdpSocket::set_nonblocking`]
6809
6810Libraries
6811---------
6812
6813* [`std::sync::Once` is poisoned if its initialization function
6814 fails][1.9o].
6815* [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6816* [Most types implement `fmt::Debug`][1.9db].
6817* [The default buffer size used by `BufReader` and `BufWriter` was
6818 reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6819 used by other languages.
6820* [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6821 `Duration` additionally implements `*=` and `/=`][1.9ta].
6822* [`Skip` is a `DoubleEndedIterator`][1.9sk].
6823* [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6824* [`Chain` implements `BufRead`][1.9ch].
6825* [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6826
6827Cargo
6828-----
6829
6830* [Cargo can now run concurrently][1.9cc].
6831* [Top-level overrides allow specific revisions of crates to be
6832 overridden through the entire crate graph][1.9ct]. This is intended
6833 to make upgrades easier for large projects, by allowing crates to be
6834 forked temporarily until they've been upgraded and republished.
6835* [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6836* [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6837 on the commandline][1.9cf]. `rustc` arguments can also be specified
6838 in the `build.rustflags` configuration key.
6839
6840Performance
6841-----------
6842
c30ab7b3 6843* [The time complexity of comparing variables for equivalence during type
a7813a04
XL
6844 unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6845 to major compilation time improvement in some scenarios.
54a0048b
SL
6846* [`ToString` is specialized for `str`, giving it the same performance
6847 as `to_owned`][1.9ts].
6848* [Spawning processes with `Command::output` no longer creates extra
6849 threads][1.9sp].
6850* [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6851 for C-like enums][1.9cl].
6852
6853Misc
6854----
6855
6856* [Passing the `--quiet` flag to a test runner will produce
6857 much-abbreviated output][1.9q].
6858* The Rust Project now publishes std binaries for the
6859 `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6860 `i586-pc-windows-msvc` targets.
6861
6862Compatibility Notes
6863-------------------
6864
6865* [`std::sync::Once` is poisoned if its initialization function
6866 fails][1.9o].
6867* [It is illegal to define methods with the same name in overlapping
6868 inherent `impl` blocks][1.9sn].
6869* [`fn` item types are zero sized, and each `fn` names a unique
6870 type][1.9fn]. This will break code that transmutes `fn`s, so calling
6871 `transmute` on a `fn` type will generate a warning for a few cycles,
6872 then will be converted to an error.
6873* [Improvements to const evaluation may trigger new errors when integer
6874 literals are out of range][1.9ce].
6875
6876
6877[1.9bf]: https://github.com/rust-lang/rust/pull/32695
6878[1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6879[1.9ce]: https://github.com/rust-lang/rust/pull/30587
6880[1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6881[1.9ch]: https://github.com/rust-lang/rust/pull/32541
6882[1.9cl]: https://github.com/rust-lang/rust/pull/31977
6883[1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6884[1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6885[1.9cu]: https://github.com/rust-lang/rust/pull/32652
6886[1.9db]: https://github.com/rust-lang/rust/pull/32054
6887[1.9fi]: https://github.com/rust-lang/rust/pull/32050
6888[1.9fn]: https://github.com/rust-lang/rust/pull/31710
6889[1.9fv]: https://github.com/rust-lang/rust/pull/31938
6890[1.9hc]: https://github.com/rust-lang/rust/pull/32635
6891[1.9o]: https://github.com/rust-lang/rust/pull/32325
6892[1.9q]: https://github.com/rust-lang/rust/pull/31887
6893[1.9sk]: https://github.com/rust-lang/rust/pull/31700
6894[1.9sn]: https://github.com/rust-lang/rust/pull/31925
6895[1.9sp]: https://github.com/rust-lang/rust/pull/31618
6896[1.9ta]: https://github.com/rust-lang/rust/pull/32448
6897[1.9ts]: https://github.com/rust-lang/rust/pull/32586
6898[1.9tu]: https://github.com/rust-lang/rust/pull/32062
6899[1.9ws]: https://github.com/rust-lang/rust/pull/29734
6900[RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6901[`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6902[`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6903[`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6904[`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6905[`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6906[`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6907[`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6908[`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6909[`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6910[`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6911[`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6912[`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6913[`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6914[`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6915[`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6916[`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6917[`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6918[`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6919[`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6920[`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6921[`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6922[`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6923[`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6924[`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6925[`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6926[`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6927[`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6928[`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6929[`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6930[`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6931[`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6932[`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6933[`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6934[`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6935[`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6936[`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6937[`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6938[`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6939[`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6940[`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6941[`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6942[`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6943[`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6944[`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6945[`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6946[`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6947[`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6948[`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6949[`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6950[`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6951[`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6952[`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6953[`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6954[`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6955[`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6956[`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6957[`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6958[`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6959[`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6960[`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6961[`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6962[`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6963[`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6964[`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6965[`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6966[`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6967[`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6968[`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6969[`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6970[`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6971[`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6972[`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6973[`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6974[`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6975[`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6976[`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6977[`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6978[`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6979[`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6980[`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6981[`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6982[`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6983[`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6984[`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6985[`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6986[`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6987
6988
7453a54e
SL
6989Version 1.8.0 (2016-04-14)
6990==========================
6991
6992Language
6993--------
6994
6995* Rust supports overloading of compound assignment statements like
6996 `+=` by implementing the [`AddAssign`], [`SubAssign`],
6997 [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6998 [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6999 traits. [RFC 953].
7000* Empty structs can be defined with braces, as in `struct Foo { }`, in
7001 addition to the non-braced form, `struct Foo;`. [RFC 218].
7002
7003Libraries
7004---------
7005
7006* Stabilized APIs:
dfeec247
XL
7007 * [`str::encode_utf16`] (renamed from `utf16_units`)
7008 * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7453a54e
SL
7009 * [`Ref::map`]
7010 * [`RefMut::map`]
7011 * [`ptr::drop_in_place`]
7012 * [`time::Instant`]
7013 * [`time::SystemTime`]
7014 * [`Instant::now`]
dfeec247 7015 * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7453a54e
SL
7016 * [`Instant::elapsed`]
7017 * [`SystemTime::now`]
dfeec247 7018 * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7453a54e
SL
7019 * [`SystemTime::elapsed`]
7020 * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7021 * [`SystemTimeError`]
7022 * [`SystemTimeError::duration`]
7023 * Various impls for `SystemTimeError`
7024 * [`UNIX_EPOCH`]
7025 * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7026 [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7027 [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7028* [The `write!` and `writeln!` macros correctly emit errors if any of
7029 their arguments can't be formatted][1.8w].
7030* [Various I/O functions support large files on 32-bit Linux][1.8l].
7031* [The Unix-specific `raw` modules, which contain a number of
7032 redefined C types are deprecated][1.8r], including `os::raw::unix`,
7033 `os::raw::macos`, and `os::raw::linux`. These modules defined types
7034 such as `ino_t` and `dev_t`. The inconsistency of these definitions
7035 across platforms was making it difficult to implement `std`
7036 correctly. Those that need these definitions should use the `libc`
7037 crate. [RFC 1415].
7038* The Unix-specific `MetadataExt` traits, including
7039 `os::unix::fs::MetadataExt`, which expose values such as inode
7040 numbers [no longer return platform-specific types][1.8r], but
7041 instead return widened integers. [RFC 1415].
7042* [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7043* [Atomic loads and stores are not volatile][1.8a].
7044* [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7045
7046Performance
7047-----------
7048
7049* [Inlining hash functions lead to a 3% compile-time improvement in
7050 some workloads][1.8h].
7051* When using jemalloc, its symbols are [unprefixed so that it
7052 overrides the libc malloc implementation][1.8h]. This means that for
7053 rustc, LLVM is now using jemalloc, which results in a 6%
7054 compile-time improvement on a specific workload.
7055* [Avoid quadratic growth in function size due to cleanups][1.8cu].
7056
7057Misc
7058----
7059
7060* [32-bit MSVC builds finally implement unwinding][1.8ms].
7061 i686-pc-windows-msvc is now considered a tier-1 platform.
7062* [The `--print targets` flag prints a list of supported targets][1.8t].
7063* [The `--print cfg` flag prints the `cfg`s defined for the current
7064 target][1.8cf].
7065* [`rustc` can be built with an new Cargo-based build system, written
7066 in Rust][1.8b]. It will eventually replace Rust's Makefile-based
7067 build system. To enable it configure with `configure --rustbuild`.
7068* [Errors for non-exhaustive `match` patterns now list up to 3 missing
7069 variants while also indicating the total number of missing variants
7070 if more than 3][1.8m].
7071* [Executable stacks are disabled on Linux and BSD][1.8nx].
7072* The Rust Project now publishes binary releases of the standard
7073 library for a number of tier-2 targets:
7074 `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7075 `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7076 `x86_64-rumprun-netbsd`. These can be installed with
7077 tools such as [multirust][1.8mr].
7078
7079Cargo
7080-----
7081
7082* [`cargo init` creates a new Cargo project in the current
7083 directory][1.8ci]. It is otherwise like `cargo new`.
7084* [Cargo has configuration keys for `-v` and
7085 `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7086 `[term]` section of `.cargo/config`.
7087* [Configuration keys that evaluate to strings or integers can be set
7088 via environment variables][1.8ce]. For example the `build.jobs` key
7089 can be set via `CARGO_BUILD_JOBS`. Environment variables take
7090 precedence over config files.
7091* [Target-specific dependencies support Rust `cfg` syntax for
7092 describing targets][1.8cfg] so that dependencies for multiple
7093 targets can be specified together. [RFC 1361].
7094* [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7095 `RUSTDOC` take precedence over the `build.target-dir`,
7096 `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7097* [The child process tree is killed on Windows when Cargo is
7098 killed][1.8ck].
7099* [The `build.target` configuration value sets the target platform,
7100 like `--target`][1.8ct].
7101
7102Compatibility Notes
7103-------------------
7104
7105* [Unstable compiler flags have been further restricted][1.8u]. Since
7106 1.0 `-Z` flags have been considered unstable, and other flags that
7107 were considered unstable additionally required passing `-Z
7108 unstable-options` to access. Unlike unstable language and library
7109 features though, these options have been accessible on the stable
7110 release channel. Going forward, *new unstable flags will not be
7111 available on the stable release channel*, and old unstable flags
7112 will warn about their usage. In the future, all unstable flags will
7113 be unavailable on the stable release channel.
7114* [It is no longer possible to `match` on empty enum variants using
7115 the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7116* The Unix-specific `MetadataExt` traits, including
7117 `os::unix::fs::MetadataExt`, which expose values such as inode
7118 numbers [no longer return platform-specific types][1.8r], but
7119 instead return widened integers. [RFC 1415].
7120* [Modules sourced from the filesystem cannot appear within arbitrary
a7813a04 7121 blocks, but only within other modules][1.8mf].
7453a54e
SL
7122* [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7123* On Unix, [stack overflow triggers a runtime abort instead of a
7124 SIGSEGV][1.8so].
7125* [`Command::spawn` and its equivalents return an error if any of
7126 its command-line arguments contain interior `NUL`s][1.8n].
7127* [Tuple and unit enum variants from other crates are in the type
7128 namespace][1.8tn].
7129* [On Windows `rustc` emits `.lib` files for the `staticlib` library
7130 type instead of `.a` files][1.8st]. Additionally, for the MSVC
7131 toolchain, `rustc` emits import libraries named `foo.dll.lib`
7132 instead of `foo.lib`.
7133
7134
7135[1.8a]: https://github.com/rust-lang/rust/pull/30962
7136[1.8b]: https://github.com/rust-lang/rust/pull/31123
7137[1.8c]: https://github.com/rust-lang/rust/pull/31530
7138[1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7139[1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7140[1.8cf]: https://github.com/rust-lang/rust/pull/31278
7141[1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7142[1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7143[1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7144[1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7145[1.8cu]: https://github.com/rust-lang/rust/pull/31390
7146[1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7147[1.8cv]: https://github.com/rust-lang/rust/pull/30998
7148[1.8h]: https://github.com/rust-lang/rust/pull/31460
7149[1.8l]: https://github.com/rust-lang/rust/pull/31668
7150[1.8m]: https://github.com/rust-lang/rust/pull/31020
a7813a04 7151[1.8mf]: https://github.com/rust-lang/rust/pull/31534
7453a54e
SL
7152[1.8mp]: https://github.com/rust-lang/rust/pull/30894
7153[1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7154[1.8ms]: https://github.com/rust-lang/rust/pull/30448
7155[1.8n]: https://github.com/rust-lang/rust/pull/31056
7156[1.8nx]: https://github.com/rust-lang/rust/pull/30859
7157[1.8r]: https://github.com/rust-lang/rust/pull/31551
7158[1.8so]: https://github.com/rust-lang/rust/pull/31333
7159[1.8st]: https://github.com/rust-lang/rust/pull/29520
7160[1.8t]: https://github.com/rust-lang/rust/pull/31358
7161[1.8tn]: https://github.com/rust-lang/rust/pull/30882
7162[1.8u]: https://github.com/rust-lang/rust/pull/31793
7163[1.8v]: https://github.com/rust-lang/rust/pull/31757
7164[1.8w]: https://github.com/rust-lang/rust/pull/31904
7165[RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7166[RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7167[RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7168[RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7169[`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7170[`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7171[`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7172[`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7173[`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7174[`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7175[`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7176[`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7177[`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7178[`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7179[`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7180[`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7181[`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7182[`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7183[`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7184[`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7185[`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7186[`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7187[`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7188[`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7189[`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7190[`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7191[`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7192[`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7193[`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7194[`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7195
7196
9cc50fc6
SL
7197Version 1.7.0 (2016-03-03)
7198==========================
7199
7200Libraries
7201---------
7202
7203* Stabilized APIs
7204 * `Path`
dfeec247
XL
7205 * [`Path::strip_prefix`] (renamed from relative_from)
7206 * [`path::StripPrefixError`] (new error type returned from strip_prefix)
9cc50fc6
SL
7207 * `Ipv4Addr`
7208 * [`Ipv4Addr::is_loopback`]
7209 * [`Ipv4Addr::is_private`]
7210 * [`Ipv4Addr::is_link_local`]
7211 * [`Ipv4Addr::is_multicast`]
7212 * [`Ipv4Addr::is_broadcast`]
7213 * [`Ipv4Addr::is_documentation`]
7214 * `Ipv6Addr`
7215 * [`Ipv6Addr::is_unspecified`]
7216 * [`Ipv6Addr::is_loopback`]
7217 * [`Ipv6Addr::is_multicast`]
7218 * `Vec`
7219 * [`Vec::as_slice`]
7220 * [`Vec::as_mut_slice`]
7221 * `String`
7222 * [`String::as_str`]
7223 * [`String::as_mut_str`]
7224 * Slices
7225 * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7226 be the same length
7227 * `<[T]>::`[`sort_by_key`]
7228 * checked, saturated, and overflowing operations
7229 * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7230 * [`i32::saturating_mul`]
7231 * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7232 * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7233 * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7234 * [`u32::saturating_mul`]
7235 * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7236 * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7237 * and checked, saturated, and overflowing operations for other primitive types
7238 * FFI
7239 * [`ffi::IntoStringError`]
7240 * [`CString::into_string`]
7241 * [`CString::into_bytes`]
7242 * [`CString::into_bytes_with_nul`]
7243 * `From<CString> for Vec<u8>`
7244 * `IntoStringError`
7245 * [`IntoStringError::into_cstring`]
7246 * [`IntoStringError::utf8_error`]
7247 * `Error for IntoStringError`
54a0048b
SL
7248 * Hashing
7249 * [`std::hash::BuildHasher`]
7250 * [`BuildHasher::Hasher`]
7251 * [`BuildHasher::build_hasher`]
7252 * [`std::hash::BuildHasherDefault`]
7253 * [`HashMap::with_hasher`]
7254 * [`HashMap::with_capacity_and_hasher`]
7255 * [`HashSet::with_hasher`]
7256 * [`HashSet::with_capacity_and_hasher`]
7257 * [`std::collections::hash_map::RandomState`]
7258 * [`RandomState::new`]
9cc50fc6
SL
7259* [Validating UTF-8 is faster by a factor of between 7 and 14x for
7260 ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7261 from bytes is faster.
7262* [The performance of `LineWriter` (and thus `io::stdout`) was
7263 improved by using `memchr` to search for newlines][1.7m].
7264* [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7265 `f64` variants were stabilized previously.
7266* [`BTreeMap` was rewritten to use less memory and improve the performance
7267 of insertion and iteration, the latter by as much as 5x][1.7bm].
7268* [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7269 covariant over their contained type][1.7bt].
7270* [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7271 over their contained type][1.7ll].
7272* [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7273 searching methods.
7274* [`Any` is implemented for unsized types][1.7a].
7275* [`Hash` is implemented for `Duration`][1.7h].
7276
7277Misc
7278----
7279
7280* [When running tests with `--test`, rustdoc will pass `--cfg`
7281 arguments to the compiler][1.7dt].
7282* [The compiler is built with RPATH information by default][1.7rpa].
7283 This means that it will be possible to run `rustc` when installed in
7284 unusual configurations without configuring the dynamic linker search
7285 path explicitly.
7286* [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7287 any RPATH entries (emitted with `-C rpath`) *not* take precedence
7288 over `LD_LIBRARY_PATH`.
7289
7290Cargo
7291-----
7292
7293* [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7294 any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7295* [The `rerun-if-changed` build script directive no longer causes the
7296 build script to incorrectly run twice in certain scenarios][1.7rr].
7297
7298Compatibility Notes
7299-------------------
7300
54a0048b
SL
7301* Soundness fixes to the interactions between associated types and
7302 lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7303 code that violates the new rules. This is a significant change that
7304 is known to break existing code, so it has emitted warnings for the
7305 new error cases since 1.4 to give crate authors time to adapt. The
7306 details of what is changing are subtle; read the RFC for more.
9cc50fc6
SL
7307* [Several bugs in the compiler's visibility calculations were
7308 fixed][1.7v]. Since this was found to break significant amounts of
7309 code, the new errors will be emitted as warnings for several release
7310 cycles, under the `private_in_public` lint.
7311* Defaulted type parameters were accidentally accepted in positions
7312 that were not intended. In this release, [defaulted type parameters
7313 appearing outside of type definitions will generate a
7314 warning][1.7d], which will become an error in future releases.
54a0048b
SL
7315* [Parsing "." as a float results in an error instead of 0][1.7p].
7316 That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
9cc50fc6
SL
7317* [Borrows of closure parameters may not outlive the closure][1.7bc].
7318
7319[1.7a]: https://github.com/rust-lang/rust/pull/30928
7320[1.7bc]: https://github.com/rust-lang/rust/pull/30341
7321[1.7bm]: https://github.com/rust-lang/rust/pull/30426
7322[1.7bt]: https://github.com/rust-lang/rust/pull/30998
7323[1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7324[1.7d]: https://github.com/rust-lang/rust/pull/30724
7325[1.7dt]: https://github.com/rust-lang/rust/pull/30372
7326[1.7dta]: https://github.com/rust-lang/rust/pull/30394
7327[1.7f]: https://github.com/rust-lang/rust/pull/30672
7328[1.7h]: https://github.com/rust-lang/rust/pull/30818
7329[1.7ll]: https://github.com/rust-lang/rust/pull/30663
7330[1.7m]: https://github.com/rust-lang/rust/pull/30381
7331[1.7p]: https://github.com/rust-lang/rust/pull/30681
7332[1.7rp]: https://github.com/rust-lang/rust/pull/29498
7333[1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7334[1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7335[1.7sf]: https://github.com/rust-lang/rust/pull/30389
7336[1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7337[1.7v]: https://github.com/rust-lang/rust/pull/29973
7338[RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
54a0048b
SL
7339[`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7340[`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
9cc50fc6
SL
7341[`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7342[`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7343[`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
54a0048b
SL
7344[`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7345[`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7346[`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7347[`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
9cc50fc6
SL
7348[`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7349[`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7350[`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7351[`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7352[`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7353[`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7354[`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7355[`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7356[`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7357[`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7358[`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7359[`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
54a0048b 7360[`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
9cc50fc6
SL
7361[`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7362[`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7363[`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7364[`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
54a0048b 7365[`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
9cc50fc6
SL
7366[`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7367[`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7368[`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7369[`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7370[`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7371[`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7372[`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7373[`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7374[`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7375[`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7376[`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7377[`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7378[`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7379[`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7380[`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
54a0048b
SL
7381[`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7382[`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7383[`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7384[`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
9cc50fc6
SL
7385[`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7386[`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
54a0048b 7387[`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
9cc50fc6
SL
7388[`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7389[`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7390[`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7391[`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7392[`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7393[`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7394[`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7395[`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7396[`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7397[`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7398
7399
92a42be0
SL
7400Version 1.6.0 (2016-01-21)
7401==========================
7402
7403Language
7404--------
7405
7406* The `#![no_std]` attribute causes a crate to not be linked to the
7407 standard library, but only the [core library][1.6co], as described
7408 in [RFC 1184]. The core library defines common types and traits but
7409 has no platform dependencies whatsoever, and is the basis for Rust
7410 software in environments that cannot support a full port of the
7411 standard library, such as operating systems. Most of the core
7412 library is now stable.
7413
7414Libraries
7415---------
7416
7417* Stabilized APIs:
9cc50fc6 7418 [`Read::read_exact`],
dfeec247 7419 [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
9cc50fc6 7420 [`fs::DirBuilder`], [`fs::DirBuilder::new`],
92a42be0
SL
7421 [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7422 [`os::unix::fs::DirBuilderExt`],
7423 [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7424 [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7425 [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7426 [`collections::hash_map::Drain`],
7427 [`collections::hash_map::HashMap::drain`],
7428 [`collections::hash_set::Drain`],
7429 [`collections::hash_set::HashSet::drain`],
7430 [`collections::binary_heap::Drain`],
7431 [`collections::binary_heap::BinaryHeap::drain`],
dfeec247 7432 [`Vec::extend_from_slice`] (renamed from `push_all`),
92a42be0 7433 [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
9cc50fc6 7434 [`RwLock::into_inner`],
dfeec247
XL
7435 [`Iterator::min_by_key`] (renamed from `min_by`),
7436 [`Iterator::max_by_key`] (renamed from `max_by`).
92a42be0
SL
7437* The [core library][1.6co] is stable, as are most of its APIs.
7438* [The `assert_eq!` macro supports arguments that don't implement
7439 `Sized`][1.6ae], such as arrays. In this way it behaves more like
7440 `assert!`.
7441* Several timer functions that take duration in milliseconds [are
7442 deprecated in favor of those that take `Duration`][1.6ms]. These
7443 include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
9cc50fc6 7444 `thread::park_timeout_ms`.
92a42be0
SL
7445* The algorithm by which `Vec` reserves additional elements was
7446 [tweaked to not allocate excessive space][1.6a] while still growing
7447 exponentially.
7448* `From` conversions are [implemented from integers to floats][1.6f]
7449 in cases where the conversion is lossless. Thus they are not
7450 implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7451 or `f64`. They are also not implemented for `isize` and `usize`
7452 because the implementations would be platform-specific. `From` is
7453 also implemented from `f32` to `f64`.
7454* `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7455* `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7456* `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7457* [`BinaryHeap` was refactored][1.6bh] for modest performance
7458 improvements.
7459* Sorting slices that are already sorted [is 50% faster in some
7460 cases][1.6s].
7461
7462Cargo
7463-----
7464
7465* Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7466* Cargo build scripts can specify their dependencies by emitting the
7467 [`rerun-if-changed`][1.6rr] key.
7468* crates.io will reject publication of crates with dependencies that
7469 have a wildcard version constraint. Crates with wildcard
7470 dependencies were seen to cause a variety of problems, as described
9cc50fc6
SL
7471 in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7472 warning.
92a42be0
SL
7473* `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7474 release folder. A variety of artifacts that Cargo failed to clean
7475 are now correctly deleted.
7476
7477Misc
7478----
7479
7480* The `unreachable_code` lint [warns when a function call's argument
7481 diverges][1.6dv].
7482* The parser indicates [failures that may be caused by
7483 confusingly-similar Unicode characters][1.6uc]
7484* Certain macro errors [are reported at definition time][1.6m], not
7485 expansion.
7486
7487Compatibility Notes
7488-------------------
7489
7490* The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7491 environment variable when locating crates. This was a pre-cargo
7492 feature for integrating with the package manager that was
7493 accidentally never removed.
7494* [A number of bugs were fixed in the privacy checker][1.6p] that
7495 could cause previously-accepted code to break.
7496* [Modules and unit/tuple structs may not share the same name][1.6ts].
9cc50fc6
SL
7497* [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7498 struct pattern syntax (`Foo(..)`) can no longer be used to match
7499 unit structs. This is a warning now, but will become an error in
7500 future releases. Patterns that share the same name as a const are
7501 now an error.
92a42be0
SL
7502* A bug was fixed that causes [rustc not to apply default type
7503 parameters][1.6xc] when resolving certain method implementations of
7504 traits defined in other crates.
7505
7506[1.6a]: https://github.com/rust-lang/rust/pull/29454
7507[1.6ae]: https://github.com/rust-lang/rust/pull/29770
7508[1.6bh]: https://github.com/rust-lang/rust/pull/29811
7509[1.6c]: https://github.com/rust-lang/cargo/pull/2192
7510[1.6cc]: https://github.com/rust-lang/cargo/pull/2131
74d20737 7511[1.6co]: http://doc.rust-lang.org/core/index.html
92a42be0
SL
7512[1.6dv]: https://github.com/rust-lang/rust/pull/30000
7513[1.6f]: https://github.com/rust-lang/rust/pull/29129
7514[1.6m]: https://github.com/rust-lang/rust/pull/29828
7515[1.6ms]: https://github.com/rust-lang/rust/pull/29604
7516[1.6p]: https://github.com/rust-lang/rust/pull/29726
7517[1.6rp]: https://github.com/rust-lang/rust/pull/30034
7518[1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7519[1.6s]: https://github.com/rust-lang/rust/pull/29675
7520[1.6ts]: https://github.com/rust-lang/rust/issues/21546
7521[1.6uc]: https://github.com/rust-lang/rust/pull/29837
7522[1.6us]: https://github.com/rust-lang/rust/pull/29383
7523[1.6xc]: https://github.com/rust-lang/rust/issues/30123
7524[RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7525[RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7526[`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7527[`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7528[`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7529[`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7530[`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7531[`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7532[`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7533[`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7534[`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7535[`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7536[`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7537[`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7538[`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7539[`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7540[`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7541[`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7542[`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7543[`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7544[`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7545[`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7546[`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7547[`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7548[`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7549[`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7550[`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7551[`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7552[`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7553
7554
b039eaaf
SL
7555Version 1.5.0 (2015-12-10)
7556==========================
7557
7558* ~700 changes, numerous bugfixes
7559
7560Highlights
7561----------
7562
7563* Stabilized APIs:
7564 [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7565 [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7566 [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7567 [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7568 [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7569 [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7570 [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7571 [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7572 [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7573 [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7574 [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7575 [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7576 [`Path::read_link`], [`Path::symlink_metadata`],
7577 [`Utf8Error::valid_up_to`], [`Vec::resize`],
7578 [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7579 [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7580 [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7581 [`slice::split_first_mut`], [`slice::split_first`],
7582 [`slice::split_last_mut`], [`slice::split_last`],
7583 [`char::from_u32_unchecked`], [`fs::canonicalize`],
7584 [`str::MatchIndices`], [`str::RMatchIndices`],
7585 [`str::match_indices`], [`str::rmatch_indices`],
7586 [`str::slice_mut_unchecked`], [`string::ParseError`].
7587* Rust applications hosted on crates.io can be installed locally to
7588 `~/.cargo/bin` with the [`cargo install`] command. Among other
7589 things this makes it easier to augment Cargo with new subcommands:
7590 when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7591 invoked as `cargo foo`.
7592* Crates with wildcard (`*`) dependencies will [emit warnings when
7593 published][1.5w]. In 1.6 it will no longer be possible to publish
7594 crates with wildcard dependencies.
7595
7596Breaking Changes
7597----------------
7598
7599* The rules determining when a particular lifetime must outlive
7600 a particular value (known as '[dropck]') have been [modified
7601 to not rely on parametricity][1.5p].
7602* [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7603 and `Arc`][1.5a]. Because these smart pointer types implement
7604 `Deref`, this causes breakage in cases where the interior type
7605 contains methods of the same name.
7606* [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7607 that they could drop their content. Soundness fix.
7608* All method invocations are [properly checked][1.5wf1] for
7609 [well-formedness][1.5wf2]. Soundness fix.
7610* Traits whose supertraits contain `Self` are [not object
7611 safe][1.5o]. Soundness fix.
7612* Target specifications support a [`no_default_libraries`][1.5nd]
7613 setting that controls whether `-nodefaultlibs` is passed to the
7614 linker, and in turn the `is_like_windows` setting no longer affects
7615 the `-nodefaultlibs` flag.
7616* `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7617* The `#[inline]` and `#[repr]` attributes [can only appear
7618 in valid locations][1.5at].
7619* Native libraries linked from the local crate are [passed to
7620 the linker before native libraries from upstream crates][1.5nl].
7621* Two rarely-used attributes, `#[no_debug]` and
7622 `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7623* Negation of unsigned integers, which has been a warning for
7624 several releases, [is now behind a feature gate and will
7625 generate errors][1.5nu].
7626* The parser accidentally accepted visibility modifiers on
7627 enum variants, a bug [which has been fixed][1.5ev].
7628* [A bug was fixed that allowed `use` statements to import unstable
7629 features][1.5use].
7630
7631Language
7632--------
7633
7634* When evaluating expressions at compile-time that are not
7635 compile-time constants (const-evaluating expressions in non-const
7636 contexts), incorrect code such as overlong bitshifts and arithmetic
7637 overflow will [generate a warning instead of an error][1.5ce],
7638 delaying the error until runtime. This will allow the
7639 const-evaluator to be expanded in the future backwards-compatibly.
7640* The `improper_ctypes` lint [no longer warns about using `isize` and
7641 `usize` in FFI][1.5ict].
7642
7643Libraries
7644---------
7645
7646* `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7647 invariant][1.5c].
7648* `Default` is [implemented for mutable slices][1.5d].
7649* `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7650* There are now `From` conversions [between floating point
7651 types][1.5f] where the conversions are lossless.
ff7c6d11 7652* There are now `From` conversions [between integer types][1.5i] where
b039eaaf
SL
7653 the conversions are lossless.
7654* [`fs::Metadata` implements `Clone`][1.5fs].
7655* The `parse` method [accepts a leading "+" when parsing
7656 integers][1.5pi].
7657* [`AsMut` is implemented for `Vec`][1.5am].
7658* The `clone_from` implementations for `String` and `BinaryHeap` [have
7659 been optimized][1.5cf] and no longer rely on the default impl.
7660* The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7661 `unsafe extern "C"` function types now [implement `Clone`,
7662 `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7663 `fmt::Debug` for up to 12 arguments][1.5fp].
7664* [Dropping `Vec`s is much faster in unoptimized builds when the
7665 element types don't implement `Drop`][1.5dv].
7666* A bug that caused in incorrect behavior when [combining `VecDeque`
7667 with zero-sized types][1.5vdz] was resolved.
7668* [`PartialOrd` for slices is faster][1.5po].
7669
7670Miscellaneous
7671-------------
7672
7673* [Crate metadata size was reduced by 20%][1.5md].
7674* [Improvements to code generation reduced the size of libcore by 3.3
7675 MB and rustc's memory usage by 18MB][1.5m].
7676* [Improvements to deref translation increased performance in
7677 unoptimized builds][1.5dr].
7678* Various errors in trait resolution [are deduplicated to only be
7679 reported once][1.5te].
7680* Rust has preliminary [support for rumprun kernels][1.5rr].
7681* Rust has preliminary [support for NetBSD on amd64][1.5na].
7682
7683[1.5use]: https://github.com/rust-lang/rust/pull/28364
7684[1.5po]: https://github.com/rust-lang/rust/pull/28436
7685[1.5ev]: https://github.com/rust-lang/rust/pull/28442
7686[1.5nu]: https://github.com/rust-lang/rust/pull/28468
7687[1.5dr]: https://github.com/rust-lang/rust/pull/28491
7688[1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7689[1.5md]: https://github.com/rust-lang/rust/pull/28521
7690[1.5fg]: https://github.com/rust-lang/rust/pull/28522
7691[1.5dv]: https://github.com/rust-lang/rust/pull/28531
7692[1.5na]: https://github.com/rust-lang/rust/pull/28543
7693[1.5fp]: https://github.com/rust-lang/rust/pull/28560
7694[1.5rr]: https://github.com/rust-lang/rust/pull/28593
7695[1.5cf]: https://github.com/rust-lang/rust/pull/28602
7696[1.5nl]: https://github.com/rust-lang/rust/pull/28605
7697[1.5te]: https://github.com/rust-lang/rust/pull/28645
7698[1.5at]: https://github.com/rust-lang/rust/pull/28650
7699[1.5am]: https://github.com/rust-lang/rust/pull/28663
7700[1.5m]: https://github.com/rust-lang/rust/pull/28778
7701[1.5ict]: https://github.com/rust-lang/rust/pull/28779
7702[1.5a]: https://github.com/rust-lang/rust/pull/28811
7703[1.5pi]: https://github.com/rust-lang/rust/pull/28826
7704[1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7705[1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7706[1.5i]: https://github.com/rust-lang/rust/pull/28921
7707[1.5fs]: https://github.com/rust-lang/rust/pull/29021
7708[1.5f]: https://github.com/rust-lang/rust/pull/29129
7709[1.5ds]: https://github.com/rust-lang/rust/pull/29148
7710[1.5s]: https://github.com/rust-lang/rust/pull/29190
7711[1.5d]: https://github.com/rust-lang/rust/pull/29245
7712[1.5o]: https://github.com/rust-lang/rust/pull/29259
7713[1.5nd]: https://github.com/rust-lang/rust/pull/28578
7714[1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7715[1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7716[dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7717[1.5c]: https://github.com/rust-lang/rust/pull/29110
7718[1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7719[`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7720[`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7721[`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7722[`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7723[`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7724[`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7725[`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7726[`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7727[`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7728[`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7729[`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7730[`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7731[`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7732[`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7733[`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7734[`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7735[`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7736[`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7737[`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7738[`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7739[`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7740[`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7741[`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7742[`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7743[`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7744[`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7745[`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7746[`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7747[`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7748[`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7749[`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7750[`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7751[`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7752[`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7753[`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7754[`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7755[`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7756[`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7757[`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7758[`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7759[`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7760[`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7761[`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7762[`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7763[`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7764[`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7765[`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7766[`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7767[`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7768[`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7769[`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7770[`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7771[`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7772
7773Version 1.4.0 (2015-10-29)
7774==========================
e9174d1e
SL
7775
7776* ~1200 changes, numerous bugfixes
7777
7778Highlights
7779----------
7780
7781* Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7782 GNU) are now supported and recommended for use.
7783
7784Breaking Changes
7785----------------
7786
7787* [Several changes have been made to fix type soundness and improve
7788 the behavior of associated types][sound]. See [RFC 1214]. Although
7789 we have mostly introduced these changes as warnings this release, to
7790 become errors next release, there are still some scenarios that will
7791 see immediate breakage.
7792* [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7793 line breaks in addition to `\n`][crlf].
7794* [Loans of `'static` lifetime extend to the end of a function][stat].
b039eaaf
SL
7795* [`str::parse` no longer introduces avoidable rounding error when
7796 parsing floating point numbers. Together with earlier changes to
7797 float formatting/output, "round trips" like f.to_string().parse()
7798 now preserve the value of f exactly. Additionally, leading plus
7799 signs are now accepted][fp3].
7800
e9174d1e
SL
7801
7802Language
7803--------
7804
7805* `use` statements that import multiple items [can now rename
7806 them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7807* [Binops work correctly on fat pointers][binfat].
7808* `pub extern crate`, which does not behave as expected, [issues a
7809 warning][pec] until a better solution is found.
7810
7811Libraries
7812---------
7813
7814* [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7815 [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7816 [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7817 [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7818 [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7819 `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7820 `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7821 [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7822 [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7823 [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7824 [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7825 [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7826 [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7827 [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7828 [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7829 [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7830 [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7831 [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7832 [`thread::sleep`].
7833* [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7834 `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7835 `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7836 `f64::from_str_radix`.
7837* [Reverse-searching strings is faster with the 'two-way'
7838 algorithm][s].
7839* [`std::io::copy` allows `?Sized` arguments][cc].
7840* The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7841 [override `count`, `nth` and `last` with an O(1)
7842 implementation][it].
7843* [`Default` is implemented for arrays up to `[T; 32]`][d].
7844* [`IntoRawFd` has been added to the Unix-specific prelude,
7845 `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7846 prelude][pr].
7847* [`Extend<String>` and `FromIterator<String` are both implemented for
7848 `String`][es].
b039eaaf
SL
7849* [`IntoIterator` is implemented for references to `Option` and
7850 `Result`][into2].
e9174d1e 7851* [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
ff7c6d11 7852 Copy`][ext] as part of [RFC 839]. This will cause type inference
b039eaaf 7853 breakage in rare situations.
e9174d1e
SL
7854* [`BinaryHeap` implements `Debug`][bh2].
7855* [`Borrow` and `BorrowMut` are implemented for fixed-size
7856 arrays][bm].
b039eaaf 7857* [`extern fn`s with the "Rust" and "C" ABIs implement common
e9174d1e
SL
7858 traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7859* [String comparison is faster][faststr].
b039eaaf
SL
7860* `&mut T` where `T: std::fmt::Write` [also implements
7861 `std::fmt::Write`][mutw].
7862* [A stable regression in `VecDeque::push_back` and other
ff7c6d11 7863 capacity-altering methods that caused panics for zero-sized types
b039eaaf 7864 was fixed][vd].
e9174d1e
SL
7865* [Function pointers implement traits for up to 12 parameters][fp2].
7866
7867Miscellaneous
7868-------------
7869
7870* The compiler [no longer uses the 'morestack' feature to prevent
7871 stack overflow][mm]. Instead it uses guard pages and stack
7872 probes (though stack probes are not yet implemented on any platform
7873 but Windows).
7874* [The compiler matches traits faster when projections are involved][p].
7875* The 'improper_ctypes' lint [no longer warns about use of `isize` and
7876 `usize`][ffi].
7877* [Cargo now displays useful information about what its doing during
7878 `cargo update`][cu].
7879
7880[`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7881[`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7882[`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7883[`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7884[`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7885[`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7886[`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7887[`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7888[`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7889[`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7890[`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7891[`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7892[`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7893[`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7894[`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7895[`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7896[`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7897[`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7898[`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7899[`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7900[`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7901[`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7902[`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7903[`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7904[`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7905[`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7906[`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7907[`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7908[`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7909[`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7910[`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7911[`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7912[`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7913[`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7914[`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7915[`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7916[`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7917[`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7918[`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7919[`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7920[`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7921[bh2]: https://github.com/rust-lang/rust/pull/28156
7922[binfat]: https://github.com/rust-lang/rust/pull/28270
7923[bm]: https://github.com/rust-lang/rust/pull/28197
7924[cc]: https://github.com/rust-lang/rust/pull/27531
7925[crlf]: https://github.com/rust-lang/rust/pull/28034
7926[cu]: https://github.com/rust-lang/cargo/pull/1931
7927[d]: https://github.com/rust-lang/rust/pull/27825
7928[dep]: https://github.com/rust-lang/rust/pull/28339
7929[es]: https://github.com/rust-lang/rust/pull/27956
7930[ext]: https://github.com/rust-lang/rust/pull/28094
7931[faststr]: https://github.com/rust-lang/rust/pull/28338
7932[ffi]: https://github.com/rust-lang/rust/pull/28779
7933[fp]: https://github.com/rust-lang/rust/pull/28268
7934[fp2]: https://github.com/rust-lang/rust/pull/28560
b039eaaf 7935[fp3]: https://github.com/rust-lang/rust/pull/27307
e9174d1e 7936[i]: https://github.com/rust-lang/rust/pull/27451
b039eaaf 7937[into2]: https://github.com/rust-lang/rust/pull/28039
e9174d1e
SL
7938[it]: https://github.com/rust-lang/rust/pull/27652
7939[mm]: https://github.com/rust-lang/rust/pull/27338
7940[mutw]: https://github.com/rust-lang/rust/pull/28368
7941[sound]: https://github.com/rust-lang/rust/pull/27641
7942[p]: https://github.com/rust-lang/rust/pull/27866
7943[pec]: https://github.com/rust-lang/rust/pull/28486
7944[pr]: https://github.com/rust-lang/rust/pull/27896
7945[RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7946[RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7947[s]: https://github.com/rust-lang/rust/pull/27474
7948[stab]: https://github.com/rust-lang/rust/pull/28339
7949[stat]: https://github.com/rust-lang/rust/pull/28321
7950[vd]: https://github.com/rust-lang/rust/pull/28494
7951
7952Version 1.3.0 (2015-09-17)
c1a9b12d
SL
7953==============================
7954
7955* ~900 changes, numerous bugfixes
7956
7957Highlights
7958----------
7959
7960* The [new object lifetime defaults][nold] have been [turned
7961 on][nold2] after a cycle of warnings about the change. Now types
7962 like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7963 being interpreted as `&'a Box<Trait+'a>` to `&'a
7964 Box<Trait+'static>`.
7965* [The Rustonomicon][nom] is a new book in the official documentation
7966 that dives into writing unsafe Rust.
7967* The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7968 timekeeping is employed by other std APIs, as well as out-of-tree
7969 time crates.
7970
7971Breaking Changes
7972----------------
7973
7974* The [new object lifetime defaults][nold] have been [turned
7975 on][nold2] after a cycle of warnings about the change.
7976* There is a known [regression][lr] in how object lifetime elision is
7977 interpreted, the proper solution for which is undetermined.
7978* The `#[prelude_import]` attribute, an internal implementation
7979 detail, was accidentally stabilized previously. [It has been put
7980 behind the `prelude_import` feature gate][pi]. This change is
7981 believed to break no existing code.
7982* The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7983 [more sane for dynamically sized types][dst3]. Code that relied on
7984 the previous behavior is thought to be broken.
7985* The `dropck` rules, which checks that destructors can't access
7986 destroyed values, [have been updated][dropck] to match the
7987 [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7988 cause some previously-compiling code to no longer build.
7989
7990Language
7991--------
7992
7993* The [new object lifetime defaults][nold] have been [turned
7994 on][nold2] after a cycle of warnings about the change.
7995* Semicolons may [now follow types and paths in
7996 macros](https://github.com/rust-lang/rust/pull/27000).
7997* The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7998 [more sane for dynamically sized types][dst3]. Code that relied on
7999 the previous behavior is not known to exist, and suspected to be
8000 broken.
8001* `'static` variables [may now be recursive][st].
8002* `ref` bindings choose between [`Deref`] and [`DerefMut`]
8003 implementations correctly.
8004* The `dropck` rules, which checks that destructors can't access
8005 destroyed values, [have been updated][dropck] to match the
8006 [RFC][dropckrfc].
8007
8008Libraries
8009---------
8010
8011* The [`Duration`] API, [has been stabilized][ds], as well as the
8012 `std::time` module, which presently contains only `Duration`.
8013* `Box<str>` and `Box<[T]>` both implement `Clone`.
8014* The owned C string, [`CString`], implements [`Borrow`] and the
8015 borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8016 these allow C strings to be borrowed and cloned in generic code.
8017* [`CStr`] implements [`Debug`].
8018* [`AtomicPtr`] implements [`Debug`].
8019* [`Error`] trait objects [can be downcast to their concrete types][e]
8020 in many common configurations, using the [`is`], [`downcast`],
8021 [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8022 [`Any`] trait.
8023* Searching for substrings now [employs the two-way algorithm][search]
8024 instead of doing a naive search. This gives major speedups to a
8025 number of methods, including [`contains`][sc], [`find`][sf],
8026 [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8027 [`ends_with`][sew] are also faster.
8028* The performance of `PartialEq` for slices is [much faster][ps].
8029* The [`Hash`] trait offers the default method, [`hash_slice`], which
8030 is overridden and optimized by the implementations for scalars.
8031* The [`Hasher`] trait now has a number of specialized `write_*`
8032 methods for primitive types, for efficiency.
8033* The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8034 methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8035 [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8036 of [`std::error::Error::cause`][iec] also delegates to the inner
8037 error.
8038* [`process::Child`][pc] gained the [`id`] method, which returns a
8039 `u32` representing the platform-specific process identifier.
8040* The [`connect`] method on slices is deprecated, replaced by the new
8041 [`join`] method (note that both of these are on the *unstable*
8042 [`SliceConcatExt`] trait, but through the magic of the prelude are
8043 available to stable code anyway).
8044* The [`Div`] operator is implemented for [`Wrapping`] types.
8045* [`DerefMut` is implemented for `String`][dms].
8046* Performance of SipHash (the default hasher for `HashMap`) is
8047 [better for long data][sh].
8048* [`AtomicPtr`] implements [`Send`].
8049* The [`read_to_end`] implementations for [`Stdin`] and [`File`]
ff7c6d11 8050 are now [specialized to use uninitialized buffers for increased
c1a9b12d
SL
8051 performance][rte].
8052* Lifetime parameters of foreign functions [are now resolved
8053 properly][f].
8054
8055Misc
8056----
8057
8058* Rust can now, with some coercion, [produce programs that run on
8059 Windows XP][xp], though XP is not considered a supported platform.
8060* Porting Rust on Windows from the GNU toolchain to MSVC continues
8061 ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8062 recommended for use in 1.3, though should be fully-functional
8063 in the [64-bit 1.4 beta][b14].
8064* On Fedora-based systems installation will [properly configure the
8065 dynamic linker][fl].
8066* The compiler gained many new extended error descriptions, which can
8067 be accessed with the `--explain` flag.
8068* The `dropck` pass, which checks that destructors can't access
8069 destroyed values, [has been rewritten][dropck]. This fixes some
8070 soundness holes, and as such will cause some previously-compiling
8071 code to no longer build.
8072* `rustc` now uses [LLVM to write archive files where possible][ar].
8073 Eventually this will eliminate the compiler's dependency on the ar
8074 utility.
8075* Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8076 supported FreeBSD on x86_64).
8077* The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8078 [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8079 more strict.
8080* If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8081 will kill the process instead of leaking][nlp].
8082
8083[`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8084[`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8085[`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8086[`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8087[`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8088[`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8089[`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8090[`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8091[`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8092[`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8093[`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8094[`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8095[`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
e9174d1e 8096[`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
c1a9b12d
SL
8097[`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8098[`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8099[`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8100[`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8101[`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8102[`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8103[`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8104[`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8105[`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8106[`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8107[`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8108[`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8109[`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8110[`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8111[ar]: https://github.com/rust-lang/rust/pull/26926
8112[b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8113[dms]: https://github.com/rust-lang/rust/pull/26241
8114[dropck]: https://github.com/rust-lang/rust/pull/27261
8115[dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8116[ds]: https://github.com/rust-lang/rust/pull/26818
8117[dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8118[dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8119[dst3]: https://github.com/rust-lang/rust/pull/27351
8120[e]: https://github.com/rust-lang/rust/pull/24793
8121[f]: https://github.com/rust-lang/rust/pull/26588
8122[fb]: https://github.com/rust-lang/rust/pull/26959
8123[fl]: https://github.com/rust-lang/rust-installer/pull/41
8124[hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8125[ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8126[iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8127[iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8128[iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8129[ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8130[lic]: https://github.com/rust-lang/rust/pull/26583
8131[lnu]: https://github.com/rust-lang/rust/pull/27026
8132[lr]: https://github.com/rust-lang/rust/issues/27248
8133[lum]: https://github.com/rust-lang/rust/pull/26378
8134[lur]: https://github.com/rust-lang/rust/pull/26783
8135[nlp]: https://github.com/rust-lang/rust/pull/27176
8136[nold2]: https://github.com/rust-lang/rust/pull/27045
8137[nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8138[nom]: http://doc.rust-lang.org/nightly/nomicon/
8139[pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8140[pi]: https://github.com/rust-lang/rust/pull/26699
8141[ps]: https://github.com/rust-lang/rust/pull/26884
8142[rte]: https://github.com/rust-lang/rust/pull/26950
8143[sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8144[search]: https://github.com/rust-lang/rust/pull/26327
8145[sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8146[sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8147[sh]: https://github.com/rust-lang/rust/pull/27280
8148[srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8149[ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8150[ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8151[st]: https://github.com/rust-lang/rust/pull/26630
8152[win1]: https://github.com/rust-lang/rust/pull/26569
8153[win2]: https://github.com/rust-lang/rust/pull/26741
8154[win3]: https://github.com/rust-lang/rust/pull/26741
8155[win4]: https://github.com/rust-lang/rust/pull/27210
8156[xp]: https://github.com/rust-lang/rust/pull/26569
8157
e9174d1e
SL
8158Version 1.2.0 (2015-08-07)
8159==========================
62682a34
SL
8160
8161* ~1200 changes, numerous bugfixes
8162
8163Highlights
8164----------
8165
8166* [Dynamically-sized-type coercions][dst] allow smart pointer types
8167 like `Rc` to contain types without a fixed size, arrays and trait
8168 objects, finally enabling use of `Rc<[T]>` and completing the
8169 implementation of DST.
8170* [Parallel codegen][parcodegen] is now working again, which can
8171 substantially speed up large builds in debug mode; It also gets
8172 another ~33% speedup when bootstrapping on a 4 core machine (using 8
8173 jobs). It's not enabled by default, but will be "in the near
8174 future". It can be activated with the `-C codegen-units=N` flag to
8175 `rustc`.
8176* This is the first release with [experimental support for linking
8177 with the MSVC linker and lib C on Windows (instead of using the GNU
8178 variants via MinGW)][win]. It is yet recommended only for the most
ff7c6d11 8179 intrepid Rustaceans.
62682a34
SL
8180* Benchmark compilations are showing a 30% improvement in
8181 bootstrapping over 1.1.
8182
8183Breaking Changes
8184----------------
8185
8186* The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8187 unicode case mapping, which is a previously-planned change in
8188 behavior and considered a bugfix.
8189* [`mem::align_of`] now specifies [the *minimum alignment* for
8190 T][align], which is usually the alignment programs are interested
8191 in, and the same value reported by clang's
8192 `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8193 break real code.
8194* [The `#[packed]` attribute is no longer silently accepted by the
8195 compiler][packed]. This attribute did nothing and code that
8196 mentioned it likely did not work as intended.
8197* Associated type defaults are [now behind the
8198 `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8199 defaults *did not work*, but could be mentioned syntactically. As
8200 such this breakage has minimal impact.
8201
8202Language
8203--------
8204
8205* Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8faf50e0 8206 matching against dereferenceable values.
62682a34
SL
8207
8208Libraries
8209---------
8210
8211* The [`Extend`] trait, which grows a collection from an iterator, is
8212 implemented over iterators of references, for `String`, `Vec`,
8213 `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8214 `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8215* The [`iter::once`] function returns an iterator that yields a single
8216 element, and [`iter::empty`] returns an iterator that yields no
8217 elements.
8218* The [`matches`] and [`rmatches`] methods on `str` return iterators
8219 over substring matches.
8220* [`Cell`] and [`RefCell`] both implement `Eq`.
8221* A number of methods for wrapping arithmetic are added to the
8222 integral types, [`wrapping_div`], [`wrapping_rem`],
8223 [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8224 addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8225 [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8226 type.. It is illegal for the default arithmetic operations in Rust
8227 to overflow; the desire to wrap must be explicit.
8228* The `{:#?}` formatting specifier [displays the alternate,
8229 pretty-printed][debugfmt] form of the `Debug` formatter. This
8230 feature was actually introduced prior to 1.0 with little
8231 fanfare.
8232* [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8233 for writing data to formatted strings, similar to [`io::Write`].
8234* [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8235 [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8236 are used by code generators to emit implementations of [`Debug`].
8237* `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8238 methods that convert case, following Unicode case mapping.
8239* It is now easier to handle poisoned locks. The [`PoisonError`]
8240 type, returned by failing lock operations, exposes `into_inner`,
8241 `get_ref`, and `get_mut`, which all give access to the inner lock
8242 guard, and allow the poisoned lock to continue to operate. The
8243 `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8244 poisoned lock without attempting to take the lock.
8245* On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8246 [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8247 On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8248 and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8249 `ChildStderr`.
8250* [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8251 malformed input.
8252
8253Misc
8254----
8255
8256* `rustc` employs smarter heuristics for guessing at [typos].
8257* `rustc` emits more efficient code for [no-op conversions between
8258 unsafe pointers][nop].
8259* Fat pointers are now [passed in pairs of immediate arguments][fat],
8260 resulting in faster compile times and smaller code.
8261
e9174d1e 8262[`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
62682a34 8263[extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
e9174d1e
SL
8264[`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8265[`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8266[`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8267[`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8268[`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8269[`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8270[`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8271[`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8272[`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8273[`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8274[`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8275[`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8276[`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8277[`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8278[`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8279[`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8280[`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8281[`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8282[`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8283[`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8284[`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8285[`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8286[`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8287[`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8288[strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8289[strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8290[`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8291[`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8292[`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8293[`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8294[`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8295[`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8296[`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8297[`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8298[`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8299[`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8300[`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8301[`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
62682a34 8302[debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
e9174d1e
SL
8303[`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8304[`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
62682a34 8305[align]: https://github.com/rust-lang/rust/pull/25646
e9174d1e 8306[`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
62682a34
SL
8307[typos]: https://github.com/rust-lang/rust/pull/26087
8308[nop]: https://github.com/rust-lang/rust/pull/26336
8309[fat]: https://github.com/rust-lang/rust/pull/26411
8310[dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8311[parcodegen]: https://github.com/rust-lang/rust/pull/26018
8312[packed]: https://github.com/rust-lang/rust/pull/25541
8313[ad]: https://github.com/rust-lang/rust/pull/27382
8314[win]: https://github.com/rust-lang/rust/pull/25350
8315
e9174d1e 8316Version 1.1.0 (2015-06-25)
d9579d0f
AL
8317=========================
8318
8319* ~850 changes, numerous bugfixes
8320
8321Highlights
8322----------
8323
c1a9b12d 8324* The [`std::fs` module has been expanded][fs] to expand the set of
d9579d0f
AL
8325 functionality exposed:
8326 * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8327 don't incur a syscall on some platforms.
8328 * A `symlink_metadata` function has been added.
8329 * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8330 access to all underlying information.
c1a9b12d
SL
8331* The compiler now contains extended explanations of many errors. When an error
8332 with an explanation occurs the compiler suggests using the `--explain` flag
8333 to read the explanation. Error explanations are also [available online][err-index].
d9579d0f
AL
8334* Thanks to multiple [improvements][sk] to [type checking][pre], as
8335 well as other work, the time to bootstrap the compiler decreased by
8336 32%.
8337
8338Libraries
8339---------
8340
c1a9b12d 8341* The [`str::split_whitespace`] method splits a string on unicode
d9579d0f
AL
8342 whitespace boundaries.
8343* On both Windows and Unix, new extension traits provide conversion of
8344 I/O types to and from the underlying system handles. On Unix, these
c1a9b12d 8345 traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
d9579d0f
AL
8346 and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8347 `TcpListener`, and `UpdSocket`. Further implementations for
8348 `std::process` will be stabilized later.
8349* On Unix, [`std::os::unix::symlink`] creates symlinks. On
8350 Windows, symlinks can be created with
8351 `std::os::windows::symlink_dir` and
8352 `std::os::windows::symlink_file`.
8353* The `mpsc::Receiver` type can now be converted into an iterator with
8354 `into_iter` on the [`IntoIterator`] trait.
8355* `Ipv4Addr` can be created from `u32` with the `From<u32>`
8356 implementation of the [`From`] trait.
8357* The `Debug` implementation for `RangeFull` [creates output that is
8358 more consistent with other implementations][rf].
8359* [`Debug` is implemented for `File`][file].
8360* The `Default` implementation for `Arc` [no longer requires `Sync +
8361 Send`][arc].
8362* [The `Iterator` methods `count`, `nth`, and `last` have been
8363 overridden for slices to have O(1) performance instead of O(n)][si].
8364* Incorrect handling of paths on Windows has been improved in both the
8365 compiler and the standard library.
8366* [`AtomicPtr` gained a `Default` implementation][ap].
8367* In accordance with Rust's policy on arithmetic overflow `abs` now
8368 [panics on overflow when debug assertions are enabled][abs].
8369* The [`Cloned`] iterator, which was accidentally left unstable for
8370 1.0 [has been stabilized][c].
8371* The [`Incoming`] iterator, which iterates over incoming TCP
8372 connections, and which was accidentally unnamable in 1.0, [is now
8373 properly exported][inc].
8374* [`BinaryHeap`] no longer corrupts itself [when functions called by
8375 `sift_up` or `sift_down` panic][bh].
8376* The [`split_off`] method of `LinkedList` [no longer corrupts
8377 the list in certain scenarios][ll].
8378
8379Misc
8380----
8381
8382* Type checking performance [has improved notably][sk] with
8383 [multiple improvements][pre].
8384* The compiler [suggests code changes][ch] for more errors.
8385* rustc and it's build system have experimental support for [building
8386 toolchains against MUSL][m] instead of glibc on Linux.
8387* The compiler defines the `target_env` cfg value, which is used for
8388 distinguishing toolchains that are otherwise for the same
8389 platform. Presently this is set to `gnu` for common GNU Linux
8390 targets and for MinGW targets, and `musl` for MUSL Linux targets.
8391* The [`cargo rustc`][crc] command invokes a build with custom flags
8392 to rustc.
8393* [Android executables are always position independent][pie].
8394* [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8395 with `Drop`][drop].
8396
e9174d1e
SL
8397[`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8398[`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8399[`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8400[`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8401[`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8402[`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
d9579d0f 8403[rf]: https://github.com/rust-lang/rust/pull/24491
e9174d1e 8404[err-index]: https://doc.rust-lang.org/error-index.html
d9579d0f
AL
8405[sk]: https://github.com/rust-lang/rust/pull/24615
8406[pre]: https://github.com/rust-lang/rust/pull/25323
8407[file]: https://github.com/rust-lang/rust/pull/24598
8408[ch]: https://github.com/rust-lang/rust/pull/24683
8409[arc]: https://github.com/rust-lang/rust/pull/24695
8410[si]: https://github.com/rust-lang/rust/pull/24701
8411[ap]: https://github.com/rust-lang/rust/pull/24834
8412[m]: https://github.com/rust-lang/rust/pull/24777
8413[fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8414[crc]: https://github.com/rust-lang/cargo/pull/1568
8415[pie]: https://github.com/rust-lang/rust/pull/24953
8416[abs]: https://github.com/rust-lang/rust/pull/25441
8417[c]: https://github.com/rust-lang/rust/pull/25496
e9174d1e
SL
8418[`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8419[`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
d9579d0f
AL
8420[inc]: https://github.com/rust-lang/rust/pull/25522
8421[bh]: https://github.com/rust-lang/rust/pull/25856
e9174d1e 8422[`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
d9579d0f 8423[ll]: https://github.com/rust-lang/rust/pull/26022
e9174d1e 8424[`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
d9579d0f
AL
8425[drop]: https://github.com/rust-lang/rust/pull/24935
8426
e9174d1e 8427Version 1.0.0 (2015-05-15)
bd371182 8428========================
c34b1796 8429
bd371182 8430* ~1500 changes, numerous bugfixes
c34b1796 8431
bd371182
AL
8432Highlights
8433----------
8434
8435* The vast majority of the standard library is now `#[stable]`. It is
8436 no longer possible to use unstable features with a stable build of
8437 the compiler.
8438* Many popular crates on [crates.io] now work on the stable release
8439 channel.
8440* Arithmetic on basic integer types now [checks for overflow in debug
8441 builds][overflow].
8442
8443Language
8444--------
8445
8446* Several [restrictions have been added to trait coherence][coh] in
8447 order to make it easier for upstream authors to change traits
62682a34 8448 without breaking downstream code.
bd371182
AL
8449* Digits of binary and octal literals are [lexed more eagerly][lex] to
8450 improve error messages and macro behavior. For example, `0b1234` is
8451 now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
62682a34 8452* Trait bounds [are always invariant][inv], eliminating the need for
bd371182
AL
8453 the `PhantomFn` and `MarkerTrait` lang items, which have been
8454 removed.
8455* ["-" is no longer a valid character in crate names][cr], the `extern crate
8456 "foo" as bar` syntax has been replaced with `extern crate foo as
8457 bar`, and Cargo now automatically translates "-" in *package* names
8458 to underscore for the crate name.
8459* [Lifetime shadowing is an error][lt].
8460* [`Send` no longer implies `'static`][send-rfc].
8461* [UFCS now supports trait-less associated paths][moar-ufcs] like
8462 `MyType::default()`.
8463* Primitive types [now have inherent methods][prim-inherent],
8464 obviating the need for extension traits like `SliceExt`.
8465* Methods with `Self: Sized` in their `where` clause are [considered
8466 object-safe][self-sized], allowing many extension traits like
8467 `IteratorExt` to be merged into the traits they extended.
8468* You can now [refer to associated types][assoc-where] whose
8469 corresponding trait bounds appear only in a `where` clause.
8470* The final bits of [OIBIT landed][oibit-final], meaning that traits
8471 like `Send` and `Sync` are now library-defined.
8472* A [Reflect trait][reflect] was introduced, which means that
8473 downcasting via the `Any` trait is effectively limited to concrete
8474 types. This helps retain the potentially-important "parametricity"
8475 property: generic code cannot behave differently for different type
8476 arguments except in minor ways.
8477* The `unsafe_destructor` feature is now deprecated in favor of the
8478 [new `dropck`][dropck]. This change is a major reduction in unsafe
8479 code.
c34b1796 8480
bd371182
AL
8481Libraries
8482---------
c34b1796 8483
bd371182
AL
8484* The `thread_local` module [has been renamed to `std::thread`][th].
8485* The methods of `IteratorExt` [have been moved to the `Iterator`
8486 trait itself][ie].
8487* Several traits that implement Rust's conventions for type
8488 conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8489 [centralized in the `std::convert` module][con].
8490* The `FromError` trait [was removed in favor of `From`][fe].
8491* The basic sleep function [has moved to
8492 `std::thread::sleep_ms`][slp].
8493* The `splitn` function now takes an `n` parameter that represents the
8494 number of items yielded by the returned iterator [instead of the
8495 number of 'splits'][spl].
8496* [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8497* [Derived implementations of `PartialOrd` now order enums according
8498 to their explicitly-assigned discriminants][po].
8499* [Methods for searching strings are generic over `Pattern`s][pat],
8500 implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8501 some others.
8502* [In method resolution, object methods are resolved before inherent
8503 methods][meth].
8504* [`String::from_str` has been deprecated in favor of the `From` impl,
8505 `String::from`][sf].
8506* [`io::Error` implements `Sync`][ios].
8507* [The `words` method on `&str` has been replaced with
8508 `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8509 a word?'
8510* The new path and IO modules are complete and `#[stable]`. This
8511 was the major library focus for this cycle.
8512* The path API was [revised][path-normalize] to normalize `.`,
8513 adjusting the tradeoffs in favor of the most common usage.
8514* A large number of remaining APIs in `std` were also stabilized
8515 during this cycle; about 75% of the non-deprecated API surface
8516 is now stable.
8517* The new [string pattern API][string-pattern] landed, which makes
8518 the string slice API much more internally consistent and flexible.
8519* A new set of [generic conversion traits][conversion] replaced
8520 many existing ad hoc traits.
8521* Generic numeric traits were [completely removed][num-traits]. This
8522 was made possible thanks to inherent methods for primitive types,
8523 and the removal gives maximal flexibility for designing a numeric
8524 hierarchy in the future.
8525* The `Fn` traits are now related via [inheritance][fn-inherit]
8526 and provide ergonomic [blanket implementations][fn-blanket].
8527* The `Index` and `IndexMut` traits were changed to
8528 [take the index by value][index-value], enabling code like
8529 `hash_map["string"]` to work.
8530* `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8531 `Copy` data is known to be `Clone` as well.
8532
8533Misc
8534----
8535
8536* Many errors now have extended explanations that can be accessed with
8537 the `--explain` flag to `rustc`.
8538* Many new examples have been added to the standard library
8539 documentation.
8540* rustdoc has received a number of improvements focused on completion
8541 and polish.
8542* Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8543* Much headway was made on ecosystem-wide CI, making it possible
8544 to [compare builds for breakage][ci-compare].
8545
8546
8547[crates.io]: http://crates.io
8548[clo]: https://github.com/rust-lang/rust/pull/24034
8549[coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8550[con]: https://github.com/rust-lang/rust/pull/23875
8551[cr]: https://github.com/rust-lang/rust/pull/23419
8552[fe]: https://github.com/rust-lang/rust/pull/23879
8553[ie]: https://github.com/rust-lang/rust/pull/23300
8554[inv]: https://github.com/rust-lang/rust/pull/23938
8555[ios]: https://github.com/rust-lang/rust/pull/24133
8556[lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8557[lt]: https://github.com/rust-lang/rust/pull/24057
8558[meth]: https://github.com/rust-lang/rust/pull/24056
8559[pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8560[po]: https://github.com/rust-lang/rust/pull/24270
8561[sf]: https://github.com/rust-lang/rust/pull/24517
8562[slp]: https://github.com/rust-lang/rust/pull/23949
8563[spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8564[sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8565[th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
c34b1796 8566[send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
c34b1796
AL
8567[moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8568[prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8569[overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8570[metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8571[self-sized]: https://github.com/rust-lang/rust/pull/22301
8572[assoc-where]: https://github.com/rust-lang/rust/pull/22512
8573[string-pattern]: https://github.com/rust-lang/rust/pull/22466
8574[oibit-final]: https://github.com/rust-lang/rust/pull/21689
8575[reflect]: https://github.com/rust-lang/rust/pull/23712
c34b1796
AL
8576[conversion]: https://github.com/rust-lang/rfcs/pull/529
8577[num-traits]: https://github.com/rust-lang/rust/pull/23549
8578[index-value]: https://github.com/rust-lang/rust/pull/23601
8579[dropck]: https://github.com/rust-lang/rfcs/pull/769
c34b1796
AL
8580[ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8581[fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8582[fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8583[copy-clone]: https://github.com/rust-lang/rust/pull/23860
8584[path-normalize]: https://github.com/rust-lang/rust/pull/23229
8585
bd371182 8586
b039eaaf 8587Version 1.0.0-alpha.2 (2015-02-20)
62682a34 8588=====================================
85aaf69f
SL
8589
8590* ~1300 changes, numerous bugfixes
8591
8592* Highlights
8593
8594 * The various I/O modules were [overhauled][io-rfc] to reduce
62682a34 8595 unnecessary abstractions and provide better interoperation with
85aaf69f
SL
8596 the underlying platform. The old `io` module remains temporarily
8597 at `std::old_io`.
62682a34 8598 * The standard library now [participates in feature gating][feat],
85aaf69f
SL
8599 so use of unstable libraries now requires a `#![feature(...)]`
8600 attribute. The impact of this change is [described on the
8601 forum][feat-forum]. [RFC][feat-rfc].
8602
8603* Language
8604
8605 * `for` loops [now operate on the `IntoIterator` trait][into],
8606 which eliminates the need to call `.iter()`, etc. to iterate
8607 over collections. There are some new subtleties to remember
8608 though regarding what sort of iterators various types yield, in
8609 particular that `for foo in bar { }` yields values from a move
8610 iterator, destroying the original collection. [RFC][into-rfc].
8611 * Objects now have [default lifetime bounds][obj], so you don't
8612 have to write `Box<Trait+'static>` when you don't care about
8613 storing references. [RFC][obj-rfc].
8614 * In types that implement `Drop`, [lifetimes must outlive the
8615 value][drop]. This will soon make it possible to safely
8616 implement `Drop` for types where `#[unsafe_destructor]` is now
8617 required. Read the [gorgeous RFC][drop-rfc] for details.
8618 * The fully qualified <T as Trait>::X syntax lets you set the Self
8619 type for a trait method or associated type. [RFC][ufcs-rfc].
8620 * References to types that implement `Deref<U>` now [automatically
8621 coerce to references][deref] to the dereferenced type `U`,
8622 e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8623 should eliminate many unsightly uses of `&*`, as when converting
8624 from references to vectors into references to
8625 slices. [RFC][deref-rfc].
8626 * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8627 `|:|`) is obsolete and closure kind is inferred from context.
8628 * [`Self` is a keyword][Self].
8629
8630* Libraries
8631
8632 * The `Show` and `String` formatting traits [have been
8633 renamed][fmt] to `Debug` and `Display` to more clearly reflect
8634 their related purposes. Automatically getting a string
8635 conversion to use with `format!("{:?}", something_to_debug)` is
8636 now written `#[derive(Debug)]`.
8637 * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8638 OsStr}`, provide strings in platform-specific encodings for easier
8639 interop with system APIs. [RFC][osstr-rfc].
c34b1796 8640 * The `boxed::into_raw` and `Box::from_raw` functions [convert
85aaf69f
SL
8641 between `Box<T>` and `*mut T`][boxraw], a common pattern for
8642 creating raw pointers.
8643
8644* Tooling
8645
8646 * Certain long error messages of the form 'expected foo found bar'
8647 are now [split neatly across multiple
8648 lines][multiline]. Examples in the PR.
8649 * On Unix Rust can be [uninstalled][un] by running
8650 `/usr/local/lib/rustlib/uninstall.sh`.
8651 * The `#[rustc_on_unimplemented]` attribute, requiring the
8652 'on_unimplemented' feature, lets rustc [display custom error
8653 messages when a trait is expected to be implemented for a type
8654 but is not][onun].
8655
8656* Misc
8657
8658 * Rust is tested against a [LALR grammar][lalr], which parses
8659 almost all the Rust files that rustc does.
8660
8661[boxraw]: https://github.com/rust-lang/rust/pull/21318
8662[close]: https://github.com/rust-lang/rust/pull/21843
8663[deref]: https://github.com/rust-lang/rust/pull/21351
8664[deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8665[drop]: https://github.com/rust-lang/rust/pull/21972
8666[drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8667[feat]: https://github.com/rust-lang/rust/pull/21248
e9174d1e 8668[feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
85aaf69f
SL
8669[feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8670[fmt]: https://github.com/rust-lang/rust/pull/21457
8671[into]: https://github.com/rust-lang/rust/pull/20790
8672[into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8673[io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8674[lalr]: https://github.com/rust-lang/rust/pull/21452
8675[multiline]: https://github.com/rust-lang/rust/pull/19870
8676[obj]: https://github.com/rust-lang/rust/pull/22230
8677[obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8678[onun]: https://github.com/rust-lang/rust/pull/20889
8679[osstr]: https://github.com/rust-lang/rust/pull/21488
8680[osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8681[Self]: https://github.com/rust-lang/rust/pull/22158
85aaf69f
SL
8682[ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8683[un]: https://github.com/rust-lang/rust/pull/22256
8684
62682a34 8685
b039eaaf 8686Version 1.0.0-alpha (2015-01-09)
62682a34 8687==================================
1a4d82fc
JJ
8688
8689 * ~2400 changes, numerous bugfixes
8690
8691 * Highlights
8692
8693 * The language itself is considered feature complete for 1.0,
8694 though there will be many usability improvements and bugfixes
8695 before the final release.
8696 * Nearly 50% of the public API surface of the standard library has
8697 been declared 'stable'. Those interfaces are unlikely to change
8698 before 1.0.
8699 * The long-running debate over integer types has been
8700 [settled][ints]: Rust will ship with types named `isize` and
8701 `usize`, rather than `int` and `uint`, for pointer-sized
8702 integers. Guidelines will be rolled out during the alpha cycle.
8703 * Most crates that are not `std` have been moved out of the Rust
8704 distribution into the Cargo ecosystem so they can evolve
8705 separately and don't need to be stabilized as quickly, including
8706 'time', 'getopts', 'num', 'regex', and 'term'.
8707 * Documentation continues to be expanded with more API coverage, more
8708 examples, and more in-depth explanations. The guides have been
8709 consolidated into [The Rust Programming Language][trpl].
85aaf69f 8710 * "[Rust By Example][rbe]" is now maintained by the Rust team.
1a4d82fc
JJ
8711 * All official Rust binary installers now come with [Cargo], the
8712 Rust package manager.
8713
8714* Language
8715
8716 * Closures have been [completely redesigned][unboxed] to be
8717 implemented in terms of traits, can now be used as generic type
8718 bounds and thus monomorphized and inlined, or via an opaque
8719 pointer (boxed) as in the old system. The new system is often
8720 referred to as 'unboxed' closures.
8721 * Traits now support [associated types][assoc], allowing families
8722 of related types to be defined together and used generically in
8723 powerful ways.
8724 * Enum variants are [namespaced by their type names][enum].
8725 * [`where` clauses][where] provide a more versatile and attractive
8726 syntax for specifying generic bounds, though the previous syntax
8727 remains valid.
8728 * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8729 numeric types.
8730 * Rust [no longer has a runtime][rt] of any description, and only
8731 supports OS threads, not green threads.
8732 * At long last, Rust has been overhauled for 'dynamically-sized
8733 types' ([DST]), which integrates 'fat pointers' (object types,
8734 arrays, and `str`) more deeply into the type system, making it
8735 more consistent.
8736 * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8737 `..j` that produce range types and which, when combined with the
8738 `Index` operator and multidispatch, leads to a convenient slice
8739 notation, `[i..j]`.
8740 * The new range syntax revealed an ambiguity in the fixed-length
8741 array syntax, so now fixed length arrays [are written `[T;
8742 N]`][arrays].
8743 * The `Copy` trait is no longer implemented automatically. Unsafe
8744 pointers no longer implement `Sync` and `Send` so types
8745 containing them don't automatically either. `Sync` and `Send`
8746 are now 'unsafe traits' so one can "forcibly" implement them via
8747 `unsafe impl` if a type confirms to the requirements for them
8748 even though the internals do not (e.g. structs containing unsafe
8749 pointers like `Arc`). These changes are intended to prevent some
8750 footguns and are collectively known as [opt-in built-in
8751 traits][oibit] (though `Sync` and `Send` will soon become pure
8752 library types unknown to the compiler).
8753 * Operator traits now take their operands [by value][ops], and
8754 comparison traits can use multidispatch to compare one type
8755 against multiple other types, allowing e.g. `String` to be
8756 compared with `&str`.
8757 * `if let` and `while let` are no longer feature-gated.
8758 * Rust has adopted a more [uniform syntax for escaping unicode
8759 characters][unicode].
8760 * `macro_rules!` [has been declared stable][mac]. Though it is a
8761 flawed system it is sufficiently popular that it must be usable
8762 for 1.0. Effort has gone into [future-proofing][mac-future] it
8763 in ways that will allow other macro systems to be developed in
8764 parallel, and won't otherwise impact the evolution of the
8765 language.
8766 * The prelude has been [pared back significantly][prelude] such
8767 that it is the minimum necessary to support the most pervasive
8768 code patterns, and through [generalized where clauses][where]
8769 many of the prelude extension traits have been consolidated.
8770 * Rust's rudimentary reflection [has been removed][refl], as it
8771 incurred too much code generation for little benefit.
8772 * [Struct variants][structvars] are no longer feature-gated.
8773 * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8774 known as 'higher-ranked trait bounds', this crucially allows
8775 unboxed closures to work.
8776 * Macros invocations surrounded by parens or square brackets and
8777 not terminated by a semicolon are [parsed as
8778 expressions][macros], which makes expressions like `vec![1i32,
8779 2, 3].len()` work as expected.
8780 * Trait objects now implement their traits automatically, and
8781 traits that can be coerced to objects now must be [object
8782 safe][objsafe].
8783 * Automatically deriving traits is now done with `#[derive(...)]`
8784 not `#[deriving(...)]` for [consistency with other naming
8785 conventions][derive].
8786 * Importing the containing module or enum at the same time as
8787 items or variants they contain is [now done with `self` instead
8788 of `mod`][self], as in use `foo::{self, bar}`
8789 * Glob imports are no longer feature-gated.
8790 * The `box` operator and `box` patterns have been feature-gated
8791 pending a redesign. For now unique boxes should be allocated
8792 like other containers, with `Box::new`.
8793
8794* Libraries
8795
8796 * A [series][coll1] of [efforts][coll2] to establish
8797 [conventions][coll3] for collections types has resulted in API
8798 improvements throughout the standard library.
8799 * New [APIs for error handling][err] provide ergonomic interop
8800 between error types, and [new conventions][err-conv] describe
8801 more clearly the recommended error handling strategies in Rust.
8802 * The `fail!` macro has been renamed to [`panic!`][panic] so that
8803 it is easier to discuss failure in the context of error handling
8804 without making clarifications as to whether you are referring to
8805 the 'fail' macro or failure more generally.
8806 * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8807 syscall when available.
8808 * The 'serialize' crate has been renamed 'rustc-serialize' and
8809 moved out of the distribution to Cargo. Although it is widely
62682a34 8810 used now, it is expected to be superseded in the near future.
1a4d82fc
JJ
8811 * The `Show` formatter, typically implemented with
8812 `#[derive(Show)]` is [now requested with the `{:?}`
8813 specifier][show] and is intended for use by all types, for uses
8814 such as `println!` debugging. The new `String` formatter must be
8815 implemented by hand, uses the `{}` specifier, and is intended
8816 for full-fidelity conversions of things that can logically be
8817 represented as strings.
8818
8819* Tooling
8820
8821 * [Flexible target specification][flex] allows rustc's code
8822 generation to be configured to support otherwise-unsupported
8823 platforms.
8824 * Rust comes with rust-gdb and rust-lldb scripts that launch their
8825 respective debuggers with Rust-appropriate pretty-printing.
32a655c1 8826 * The Windows installation of Rust is distributed with the
1a4d82fc
JJ
8827 MinGW components currently required to link binaries on that
8828 platform.
8829
8830* Misc
8831
8832 * Nullable enum optimizations have been extended to more types so
8833 that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8834 space than the inner types themselves.
8835 * Work has begun on supporting AArch64.
8836
8837[Cargo]: https://crates.io
8838[unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8839[enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8840[flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8841[err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8842[err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8843[rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8844[mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8845[mac-future]: https://github.com/rust-lang/rfcs/pull/550
8846[DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8847[coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8848[coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8849[coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8850[ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8851[prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8852[where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8853[refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8854[panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8855[structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8856[hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8857[unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8858[oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8859[macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8860[range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8861[arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8862[show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8863[derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8864[self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8865[fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8866[objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8867[assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8868[ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
e9174d1e 8869[trpl]: https://doc.rust-lang.org/book/index.html
85aaf69f 8870[rbe]: http://rustbyexample.com/
1a4d82fc 8871
62682a34 8872
b039eaaf 8873Version 0.12.0 (2014-10-09)
62682a34 8874=============================
1a4d82fc
JJ
8875
8876 * ~1900 changes, numerous bugfixes
8877
8878 * Highlights
8879
8880 * The introductory documentation (now called The Rust Guide) has
8881 been completely rewritten, as have a number of supplementary
8882 guides.
8883 * Rust's package manager, Cargo, continues to improve and is
8884 sometimes considered to be quite awesome.
8885 * Many API's in `std` have been reviewed and updated for
8886 consistency with the in-development Rust coding
8887 guidelines. The standard library documentation tracks
8888 stabilization progress.
8889 * Minor libraries have been moved out-of-tree to the rust-lang org
8890 on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8891 be installed with Cargo.
8892 * Lifetime elision allows lifetime annotations to be left off of
8893 function declarations in many common scenarios.
8894 * Rust now works on 64-bit Windows.
8895
8896 * Language
8897 * Indexing can be overloaded with the `Index` and `IndexMut`
8898 traits.
8899 * The `if let` construct takes a branch only if the `let` pattern
8900 matches, currently behind the 'if_let' feature gate.
8901 * 'where clauses', a more flexible syntax for specifying trait
8902 bounds that is more aesthetic, have been added for traits and
8903 free functions. Where clauses will in the future make it
8904 possible to constrain associated types, which would be
8905 impossible with the existing syntax.
8906 * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8907 the 'slicing_syntax' feature gate, and can be overloaded with
8908 the `Slice` or `SliceMut` traits.
8909 * The syntax for matching of sub-slices has been changed to use a
8910 postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8911 consistency with other uses of `..` and to future-proof
8912 potential additional uses of the syntax.
8913 * The syntax for matching inclusive ranges in patterns has changed
8914 from `0..3` to `0...4` to be consistent with the exclusive range
8915 syntax for slicing.
8916 * Matching of sub-slices in non-tail positions (e.g. `[a.., b,
8917 c]`) has been put behind the 'advanced_slice_patterns' feature
8918 gate and may be removed in the future.
8919 * Components of tuples and tuple structs can be extracted using
8920 the `value.0` syntax, currently behind the `tuple_indexing`
8921 feature gate.
8922 * The `#[crate_id]` attribute is no longer supported; versioning
8923 is handled by the package manager.
8924 * Renaming crate imports are now written `extern crate foo as bar`
8925 instead of `extern crate bar = foo`.
8926 * Renaming use statements are now written `use foo as bar` instead
8927 of `use bar = foo`.
8928 * `let` and `match` bindings and argument names in macros are now
8929 hygienic.
8930 * The new, more efficient, closure types ('unboxed closures') have
8931 been added under a feature gate, 'unboxed_closures'. These will
8932 soon replace the existing closure types, once higher-ranked
8933 trait lifetimes are added to the language.
8934 * `move` has been added as a keyword, for indicating closures
8935 that capture by value.
8936 * Mutation and assignment is no longer allowed in pattern guards.
8937 * Generic structs and enums can now have trait bounds.
8938 * The `Share` trait is now called `Sync` to free up the term
8939 'shared' to refer to 'shared reference' (the default reference
8940 type.
8941 * Dynamically-sized types have been mostly implemented,
8942 unifying the behavior of fat-pointer types with the rest of the
8943 type system.
8944 * As part of dynamically-sized types, the `Sized` trait has been
8945 introduced, which qualifying types implement by default, and
8946 which type parameters expect by default. To specify that a type
8947 parameter does not need to be sized, write `<Sized? T>`. Most
8948 types are `Sized`, notable exceptions being unsized arrays
8949 (`[T]`) and trait types.
8950 * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8951 * Lifetime bounds can now be applied to type parameters and object
8952 types.
8953 * The old, reference counted GC type, `Gc<T>` which was once
8954 denoted by the `@` sigil, has finally been removed. GC will be
8955 revisited in the future.
8956
8957 * Libraries
8958 * Library documentation has been improved for a number of modules.
8959 * Bit-vectors, collections::bitv has been modernized.
8960 * The url crate is deprecated in favor of
8961 http://github.com/servo/rust-url, which can be installed with
8962 Cargo.
8963 * Most I/O stream types can be cloned and subsequently closed from
8964 a different thread.
8965 * A `std::time::Duration` type has been added for use in I/O
8966 methods that rely on timers, as well as in the 'time' crate's
8967 `Timespec` arithmetic.
8968 * The runtime I/O abstraction layer that enabled the green thread
8969 scheduler to do non-thread-blocking I/O has been removed, along
8970 with the libuv-based implementation employed by the green thread
8971 scheduler. This will greatly simplify the future I/O work.
8972 * `collections::btree` has been rewritten to have a more
8973 idiomatic and efficient design.
8974
8975 * Tooling
8976 * rustdoc output now indicates the stability levels of API's.
8977 * The `--crate-name` flag can specify the name of the crate
8978 being compiled, like `#[crate_name]`.
8979 * The `-C metadata` specifies additional metadata to hash into
8980 symbol names, and `-C extra-filename` specifies additional
8981 information to put into the output filename, for use by the
8982 package manager for versioning.
8983 * debug info generation has continued to improve and should be
8984 more reliable under both gdb and lldb.
8985 * rustc has experimental support for compiling in parallel
8986 using the `-C codegen-units` flag.
8987 * rustc no longer encodes rpath information into binaries by
8988 default.
8989
8990 * Misc
8991 * Stack usage has been optimized with LLVM lifetime annotations.
8992 * Official Rust binaries on Linux are more compatible with older
8993 kernels and distributions, built on CentOS 5.10.
8994
62682a34 8995
b039eaaf 8996Version 0.11.0 (2014-07-02)
62682a34 8997==========================
1a4d82fc
JJ
8998
8999 * ~1700 changes, numerous bugfixes
9000
9001 * Language
9002 * ~[T] has been removed from the language. This type is superseded by
9003 the Vec<T> type.
9004 * ~str has been removed from the language. This type is superseded by
9005 the String type.
9006 * ~T has been removed from the language. This type is superseded by the
9007 Box<T> type.
9008 * @T has been removed from the language. This type is superseded by the
9009 standard library's std::gc::Gc<T> type.
9010 * Struct fields are now all private by default.
9011 * Vector indices and shift amounts are both required to be a `uint`
9012 instead of any integral type.
9013 * Byte character, byte string, and raw byte string literals are now all
9014 supported by prefixing the normal literal with a `b`.
9015 * Multiple ABIs are no longer allowed in an ABI string
9016 * The syntax for lifetimes on closures/procedures has been tweaked
9017 slightly: `<'a>|A, B|: 'b + K -> T`
9018 * Floating point modulus has been removed from the language; however it
9019 is still provided by a library implementation.
9020 * Private enum variants are now disallowed.
9021 * The `priv` keyword has been removed from the language.
9022 * A closure can no longer be invoked through a &-pointer.
9023 * The `use foo, bar, baz;` syntax has been removed from the language.
9024 * The transmute intrinsic no longer works on type parameters.
9025 * Statics now allow blocks/items in their definition.
9026 * Trait bounds are separated from objects with + instead of : now.
9027 * Objects can no longer be read while they are mutably borrowed.
9028 * The address of a static is now marked as insignificant unless the
9029 #[inline(never)] attribute is placed it.
9030 * The #[unsafe_destructor] attribute is now behind a feature gate.
9031 * Struct literals are no longer allowed in ambiguous positions such as
9032 if, while, match, and for..in.
9033 * Declaration of lang items and intrinsics are now feature-gated by
9034 default.
9035 * Integral literals no longer default to `int`, and floating point
9036 literals no longer default to `f64`. Literals must be suffixed with an
9037 appropriate type if inference cannot determine the type of the
9038 literal.
9039 * The Box<T> type is no longer implicitly borrowed to &mut T.
9040 * Procedures are now required to not capture borrowed references.
9041
9042 * Libraries
9043 * The standard library is now a "facade" over a number of underlying
9044 libraries. This means that development on the standard library should
ff7c6d11 9045 be speedier due to smaller crates, as well as a clearer line between
1a4d82fc
JJ
9046 all dependencies.
9047 * A new library, libcore, lives under the standard library's facade
9048 which is Rust's "0-assumption" library, suitable for embedded and
9049 kernel development for example.
9050 * A regex crate has been added to the standard distribution. This crate
9051 includes statically compiled regular expressions.
9052 * The unwrap/unwrap_err methods on Result require a Show bound for
9053 better error messages.
9054 * The return types of the std::comm primitives have been centralized
9055 around the Result type.
9056 * A number of I/O primitives have gained the ability to time out their
9057 operations.
9058 * A number of I/O primitives have gained the ability to close their
9059 reading/writing halves to cancel pending operations.
9060 * Reverse iterator methods have been removed in favor of `rev()` on
9061 their forward-iteration counterparts.
9062 * A bitflags! macro has been added to enable easy interop with C and
9063 management of bit flags.
9064 * A debug_assert! macro is now provided which is disabled when
9065 `--cfg ndebug` is passed to the compiler.
9066 * A graphviz crate has been added for creating .dot files.
9067 * The std::cast module has been migrated into std::mem.
9068 * The std::local_data api has been migrated from freestanding functions
9069 to being based on methods.
9070 * The Pod trait has been renamed to Copy.
9071 * jemalloc has been added as the default allocator for types.
9072 * The API for allocating memory has been changed to use proper alignment
9073 and sized deallocation
9074 * Connecting a TcpStream or binding a TcpListener is now based on a
9075 string address and a u16 port. This allows connecting to a hostname as
9076 opposed to an IP.
9077 * The Reader trait now contains a core method, read_at_least(), which
9078 correctly handles many repeated 0-length reads.
9079 * The process-spawning API is now centered around a builder-style
9080 Command struct.
9081 * The :? printing qualifier has been moved from the standard library to
9082 an external libdebug crate.
9083 * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9084 have been renamed to Eq/Ord.
9085 * The select/plural methods have been removed from format!. The escapes
9086 for { and } have also changed from \{ and \} to {{ and }},
9087 respectively.
9088 * The TaskBuilder API has been re-worked to be a true builder, and
9089 extension traits for spawning native/green tasks have been added.
9090
9091 * Tooling
9092 * All breaking changes to the language or libraries now have their
9093 commit message annotated with `[breaking-change]` to allow for easy
9094 discovery of breaking changes.
9095 * The compiler will now try to suggest how to annotate lifetimes if a
9096 lifetime-related error occurs.
9097 * Debug info continues to be improved greatly with general bug fixes and
9098 better support for situations like link time optimization (LTO).
9099 * Usage of syntax extensions when cross-compiling has been fixed.
9100 * Functionality equivalent to GCC & Clang's -ffunction-sections,
9101 -fdata-sections and --gc-sections has been enabled by default
9102 * The compiler is now stricter about where it will load module files
9103 from when a module is declared via `mod foo;`.
9104 * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9105 Syntax extensions are now discovered via a "plugin registrar" type
9106 which will be extended in the future to other various plugins.
9107 * Lints have been restructured to allow for dynamically loadable lints.
9108 * A number of rustdoc improvements:
9109 * The HTML output has been visually redesigned.
9110 * Markdown is now powered by hoedown instead of sundown.
9111 * Searching heuristics have been greatly improved.
9112 * The search index has been reduced in size by a great amount.
9113 * Cross-crate documentation via `pub use` has been greatly improved.
9114 * Primitive types are now hyperlinked and documented.
9115 * Documentation has been moved from static.rust-lang.org/doc to
9116 doc.rust-lang.org
9117 * A new sandbox, play.rust-lang.org, is available for running and
9118 sharing rust code examples on-line.
9119 * Unused attributes are now more robustly warned about.
9120 * The dead_code lint now warns about unused struct fields.
9121 * Cross-compiling to iOS is now supported.
9122 * Cross-compiling to mipsel is now supported.
9123 * Stability attributes are now inherited by default and no longer apply
9124 to intra-crate usage, only inter-crate usage.
9125 * Error message related to non-exhaustive match expressions have been
9126 greatly improved.
9127
62682a34 9128
b039eaaf 9129Version 0.10 (2014-04-03)
62682a34 9130=========================
1a4d82fc
JJ
9131
9132 * ~1500 changes, numerous bugfixes
9133
9134 * Language
9135 * A new RFC process is now in place for modifying the language.
9136 * Patterns with `@`-pointers have been removed from the language.
9137 * Patterns with unique vectors (`~[T]`) have been removed from the
9138 language.
9139 * Patterns with unique strings (`~str`) have been removed from the
9140 language.
9141 * `@str` has been removed from the language.
9142 * `@[T]` has been removed from the language.
9143 * `@self` has been removed from the language.
9144 * `@Trait` has been removed from the language.
9145 * Headers on `~` allocations which contain `@` boxes inside the type for
9146 reference counting have been removed.
9147 * The semantics around the lifetimes of temporary expressions have changed,
9148 see #3511 and #11585 for more information.
9149 * Cross-crate syntax extensions are now possible, but feature gated. See
9150 #11151 for more information. This includes both `macro_rules!` macros as
9151 well as syntax extensions such as `format!`.
9152 * New lint modes have been added, and older ones have been turned on to be
9153 warn-by-default.
9154 * Unnecessary parentheses
9155 * Uppercase statics
9156 * Camel Case types
9157 * Uppercase variables
9158 * Publicly visible private types
9159 * `#[deriving]` with raw pointers
9160 * Unsafe functions can no longer be coerced to closures.
9161 * Various obscure macros such as `log_syntax!` are now behind feature gates.
9162 * The `#[simd]` attribute is now behind a feature gate.
9163 * Visibility is no longer allowed on `extern crate` statements, and
9164 unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9165 * Trailing commas are now allowed in argument lists and tuple patterns.
9166 * The `do` keyword has been removed, it is now a reserved keyword.
9167 * Default type parameters have been implemented, but are feature gated.
9168 * Borrowed variables through captures in closures are now considered soundly.
9169 * `extern mod` is now `extern crate`
9170 * The `Freeze` trait has been removed.
9171 * The `Share` trait has been added for types that can be shared among
9172 threads.
9173 * Labels in macros are now hygienic.
9174 * Expression/statement macro invocations can be delimited with `{}` now.
9175 * Treatment of types allowed in `static mut` locations has been tweaked.
9176 * The `*` and `.` operators are now overloadable through the `Deref` and
9177 `DerefMut` traits.
9178 * `~Trait` and `proc` no longer have `Send` bounds by default.
9179 * Partial type hints are now supported with the `_` type marker.
9180 * An `Unsafe` type was introduced for interior mutability. It is now
9181 considered undefined to transmute from `&T` to `&mut T` without using the
9182 `Unsafe` type.
9183 * The #[linkage] attribute was implemented for extern statics/functions.
9184 * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9185 * `Pod` was renamed to `Copy`.
9186
9187 * Libraries
9188 * The `libextra` library has been removed. It has now been decomposed into
9189 component libraries with smaller and more focused nuggets of
9190 functionality. The full list of libraries can be found on the
9191 documentation index page.
9192 * std: `std::condition` has been removed. All I/O errors are now propagated
9193 through the `Result` type. In order to assist with error handling, a
9194 `try!` macro for unwrapping errors with an early return and a lint for
9195 unused results has been added. See #12039 for more information.
9196 * std: The `vec` module has been renamed to `slice`.
9197 * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9198 This will become the only growable vector in the future.
2c00a5a8 9199 * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
1a4d82fc
JJ
9200 are now found at `std::io::BufferedReader` instead of
9201 `std::io::buffered::BufferedReader`.
9202 * std: `print` and `println` are no longer in the prelude, the `print!` and
9203 `println!` macros are intended to be used instead.
9204 * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9205 attempts to statically prevent cycles.
9206 * std: The standard distribution is adopting the policy of pushing failure
9207 to the user rather than failing in libraries. Many functions (such as
9208 `slice::last()`) now return `Option<T>` instead of `T` + failing.
9209 * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9210 deriving mode: `#[deriving(Show)]`.
9211 * std: `ToStr` is now implemented for all types implementing `Show`.
9212 * std: The formatting trait methods now take `&self` instead of `&T`
9213 * std: The `invert()` method on iterators has been renamed to `rev()`
9214 * std: `std::num` has seen a reduction in the genericity of its traits,
9215 consolidating functionality into a few core traits.
9216 * std: Backtraces are now printed on task failure if the environment
9217 variable `RUST_BACKTRACE` is present.
9218 * std: Naming conventions for iterators have been standardized. More details
9219 can be found on the wiki's style guide.
9220 * std: `eof()` has been removed from the `Reader` trait. Specific types may
9221 still implement the function.
9222 * std: Networking types are now cloneable to allow simultaneous reads/writes.
9223 * std: `assert_approx_eq!` has been removed
9224 * std: The `e` and `E` formatting specifiers for floats have been added to
9225 print them in exponential notation.
9226 * std: The `Times` trait has been removed
9227 * std: Indications of variance and opting out of builtin bounds is done
9228 through marker types in `std::kinds::marker` now
9229 * std: `hash` has been rewritten, `IterBytes` has been removed, and
9230 `#[deriving(Hash)]` is now possible.
9231 * std: `SharedChan` has been removed, `Sender` is now cloneable.
9232 * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9233 * std: `Chan::new` is now `channel()`.
9234 * std: A new synchronous channel type has been implemented.
9235 * std: A `select!` macro is now provided for selecting over `Receiver`s.
9236 * std: `hashmap` and `trie` have been moved to `libcollections`
9237 * std: `run` has been rolled into `io::process`
9238 * std: `assert_eq!` now uses `{}` instead of `{:?}`
9239 * std: The equality and comparison traits have seen some reorganization.
9240 * std: `rand` has moved to `librand`.
9241 * std: `to_{lower,upper}case` has been implemented for `char`.
9242 * std: Logging has been moved to `liblog`.
9243 * collections: `HashMap` has been rewritten for higher performance and less
9244 memory usage.
9245 * native: The default runtime is now `libnative`. If `libgreen` is desired,
9246 it can be booted manually. The runtime guide has more information and
9247 examples.
9248 * native: All I/O functionality except signals has been implemented.
9249 * green: Task spawning with `libgreen` has been optimized with stack caching
9250 and various trimming of code.
9251 * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9252 * sync: The `extra::sync` module has been updated to modern rust (and moved
9253 to the `sync` library), tweaking and improving various interfaces while
9254 dropping redundant functionality.
9255 * sync: A new `Barrier` type has been added to the `sync` library.
9256 * sync: An efficient mutex for native and green tasks has been implemented.
9257 * serialize: The `base64` module has seen some improvement. It treats
9258 newlines better, has non-string error values, and has seen general
9259 cleanup.
9260 * fourcc: A `fourcc!` macro was introduced
9261 * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9262 hexadecimal literal.
9263
9264 * Tooling
9265 * `rustpkg` has been deprecated and removed from the main repository. Its
9266 replacement, `cargo`, is under development.
9267 * Nightly builds of rust are now available
9268 * The memory usage of rustc has been improved many times throughout this
9269 release cycle.
9270 * The build process supports disabling rpath support for the rustc binary
9271 itself.
9272 * Code generation has improved in some cases, giving more information to the
9273 LLVM optimization passes to enable more extensive optimizations.
9274 * Debuginfo compatibility with lldb on OSX has been restored.
9275 * The master branch is now gated on an android bot, making building for
9276 android much more reliable.
9277 * Output flags have been centralized into one `--emit` flag.
9278 * Crate type flags have been centralized into one `--crate-type` flag.
9279 * Codegen flags have been consolidated behind a `-C` flag.
9280 * Linking against outdated crates now has improved error messages.
9281 * Error messages with lifetimes will often suggest how to annotate the
9282 function to fix the error.
9283 * Many more types are documented in the standard library, and new guides
9284 were written.
9285 * Many `rustdoc` improvements:
9286 * code blocks are syntax highlighted.
9287 * render standalone markdown files.
9288 * the --test flag tests all code blocks by default.
9289 * exported macros are displayed.
2c00a5a8
XL
9290 * re-exported types have their documentation inlined at the location of the
9291 first re-export.
1a4d82fc
JJ
9292 * search works across crates that have been rendered to the same output
9293 directory.
9294
62682a34 9295
b039eaaf 9296Version 0.9 (2014-01-09)
62682a34 9297==========================
1a4d82fc
JJ
9298
9299 * ~1800 changes, numerous bugfixes
9300
9301 * Language
9302 * The `float` type has been removed. Use `f32` or `f64` instead.
9303 * A new facility for enabling experimental features (feature gating) has
9304 been added, using the crate-level `#[feature(foo)]` attribute.
9305 * Managed boxes (@) are now behind a feature gate
9306 (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9307 standard library's `Gc` or `Rc` types instead.
9308 * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9309 * Jumping back to the top of a loop is now done with `continue` instead of
9310 `loop`.
9311 * Strings can no longer be mutated through index assignment.
9312 * Raw strings can be created via the basic `r"foo"` syntax or with matched
9313 hash delimiters, as in `r###"foo"###`.
9314 * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9315 called once.
9316 * The `&fn` type is now written `|args| -> ret` to match the literal form.
9317 * `@fn`s have been removed.
9318 * `do` only works with procs in order to make it obvious what the cost
9319 of `do` is.
9320 * Single-element tuple-like structs can no longer be dereferenced to
9321 obtain the inner value. A more comprehensive solution for overloading
9322 the dereference operator will be provided in the future.
9323 * The `#[link(...)]` attribute has been replaced with
9324 `#[crate_id = "name#vers"]`.
9325 * Empty `impl`s must be terminated with empty braces and may not be
9326 terminated with a semicolon.
9327 * Keywords are no longer allowed as lifetime names; the `self` lifetime
9328 no longer has any special meaning.
9329 * The old `fmt!` string formatting macro has been removed.
9330 * `printf!` and `printfln!` (old-style formatting) removed in favor of
9331 `print!` and `println!`.
9332 * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9333 * The `extern mod foo (name = "bar")` syntax has been removed. Use
9334 `extern mod foo = "bar"` instead.
9335 * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9336 * Macros can have attributes.
9337 * Macros can expand to items with attributes.
9338 * Macros can expand to multiple items.
9339 * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9340 * Comments may be nested.
9341 * Values automatically coerce to trait objects they implement, without
9342 an explicit `as`.
9343 * Enum discriminants are no longer an entire word but as small as needed to
9344 contain all the variants. The `repr` attribute can be used to override
9345 the discriminant size, as in `#[repr(int)]` for integer-sized, and
9346 `#[repr(C)]` to match C enums.
9347 * Non-string literals are not allowed in attributes (they never worked).
9348 * The FFI now supports variadic functions.
9349 * Octal numeric literals, as in `0o7777`.
9350 * The `concat!` syntax extension performs compile-time string concatenation.
9351 * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9352 removed as Rust no longer uses segmented stacks.
9353 * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9354 * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9355 not `*`; ignoring remaining fields of a struct is also done with `..`,
9356 not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9357 * `rustc` supports the "win64" calling convention via `extern "win64"`.
9358 * `rustc` supports the "system" calling convention, which defaults to the
9359 preferred convention for the target platform, "stdcall" on 32-bit Windows,
9360 "C" elsewhere.
9361 * The `type_overflow` lint (default: warn) checks literals for overflow.
9362 * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9363 * The `attribute_usage` lint (default: warn) warns about unknown
9364 attributes.
9365 * The `unknown_features` lint (default: warn) warns about unknown
9366 feature gates.
9367 * The `dead_code` lint (default: warn) checks for dead code.
9368 * Rust libraries can be linked statically to one another
9369 * `#[link_args]` is behind the `link_args` feature gate.
9370 * Native libraries are now linked with `#[link(name = "foo")]`
9371 * Native libraries can be statically linked to a rust crate
9372 (`#[link(name = "foo", kind = "static")]`).
9373 * Native OS X frameworks are now officially supported
9374 (`#[link(name = "foo", kind = "framework")]`).
9375 * The `#[thread_local]` attribute creates thread-local (not task-local)
9376 variables. Currently behind the `thread_local` feature gate.
9377 * The `return` keyword may be used in closures.
9378 * Types that can be copied via a memcpy implement the `Pod` kind.
9379 * The `cfg` attribute can now be used on struct fields and enum variants.
9380
9381 * Libraries
9382 * std: The `option` and `result` API's have been overhauled to make them
9383 simpler, more consistent, and more composable.
9384 * std: The entire `std::io` module has been replaced with one that is
9385 more comprehensive and that properly interfaces with the underlying
9386 scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9387 implemented.
9388 * std: `io::util` contains a number of useful implementations of
9389 `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9390 `ZeroReader`, `TeeReader`.
9391 * std: The reference counted pointer type `extra::rc` moved into std.
9392 * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9393 just a wrapper around it).
9394 * std: The `Either` type has been removed.
9395 * std: `fmt::Default` can be implemented for any type to provide default
9396 formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9397 * std: The `rand` API continues to be tweaked.
9398 * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9399 on failure in gdb, is now named `rust_fail`.
9400 * std: The `each_key` and `each_value` methods on `HashMap` have been
9401 replaced by the `keys` and `values` iterators.
9402 * std: Functions dealing with type size and alignment have moved from the
9403 `sys` module to the `mem` module.
9404 * std: The `path` module was written and API changed.
9405 * std: `str::from_utf8` has been changed to cast instead of allocate.
9406 * std: `starts_with` and `ends_with` methods added to vectors via the
9407 `ImmutableEqVector` trait, which is in the prelude.
9408 * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9409 if the index is out of bounds.
9410 * std: Task failure no longer propagates between tasks, as the model was
9411 complex, expensive, and incompatible with thread-based tasks.
9412 * std: The `Any` type can be used for dynamic typing.
9413 * std: `~Any` can be passed to the `fail!` macro and retrieved via
9414 `task::try`.
9415 * std: Methods that produce iterators generally do not have an `_iter`
9416 suffix now.
9417 * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9418 roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9419 * std: `util::ignore` renamed to `prelude::drop`.
9420 * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9421 trait.
9422 * std: `vec::raw` has seen a lot of cleanup and API changes.
9423 * std: The standard library no longer includes any C++ code, and very
9424 minimal C, eliminating the dependency on libstdc++.
9425 * std: Runtime scheduling and I/O functionality has been factored out into
9426 extensible interfaces and is now implemented by two different crates:
9427 libnative, for native threading and I/O; and libgreen, for green threading
9428 and I/O. This paves the way for using the standard library in more limited
9429 embedded environments.
9430 * std: The `comm` module has been rewritten to be much faster, have a
9431 simpler, more consistent API, and to work for both native and green
9432 threading.
9433 * std: All libuv dependencies have been moved into the rustuv crate.
9434 * native: New implementations of runtime scheduling on top of OS threads.
9435 * native: New native implementations of TCP, UDP, file I/O, process spawning,
9436 and other I/O.
9437 * green: The green thread scheduler and message passing types are almost
9438 entirely lock-free.
9439 * extra: The `flatpipes` module had bitrotted and was removed.
9440 * extra: All crypto functions have been removed and Rust now has a policy of
9441 not reimplementing crypto in the standard library. In the future crypto
9442 will be provided by external crates with bindings to established libraries.
9443 * extra: `c_vec` has been modernized.
9444 * extra: The `sort` module has been removed. Use the `sort` method on
9445 mutable slices.
9446
9447 * Tooling
9448 * The `rust` and `rusti` commands have been removed, due to lack of
9449 maintenance.
9450 * `rustdoc` was completely rewritten.
9451 * `rustdoc` can test code examples in documentation.
9452 * `rustpkg` can test packages with the argument, 'test'.
9453 * `rustpkg` supports arbitrary dependencies, including C libraries.
9454 * `rustc`'s support for generating debug info is improved again.
9455 * `rustc` has better error reporting for unbalanced delimiters.
9456 * `rustc`'s JIT support was removed due to bitrot.
9457 * Executables and static libraries can be built with LTO (-Z lto)
9458 * `rustc` adds a `--dep-info` flag for communicating dependencies to
9459 build tools.
9460
62682a34 9461
b039eaaf 9462Version 0.8 (2013-09-26)
62682a34 9463============================
1a4d82fc
JJ
9464
9465 * ~2200 changes, numerous bugfixes
9466
9467 * Language
9468 * The `for` loop syntax has changed to work with the `Iterator` trait.
9469 * At long last, unwinding works on Windows.
9470 * Default methods are ready for use.
9471 * Many trait inheritance bugs fixed.
9472 * Owned and borrowed trait objects work more reliably.
9473 * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9474 * rustc can omit emission of code for the `debug!` macro if it is passed
9475 `--cfg ndebug`
9476 * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9477 for foo.rs, then foo/mod.rs, and will generate an error when both are
9478 present.
9479 * Strings no longer contain trailing nulls. The new `std::c_str` module
9480 provides new mechanisms for converting to C strings.
9481 * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9482 * The FFI has been overhauled such that foreign functions are called directly,
9483 instead of through a stack-switching wrapper.
9484 * Calling a foreign function must be done through a Rust function with the
9485 `#[fixed_stack_segment]` attribute.
9486 * The `externfn!` macro can be used to declare both a foreign function and
9487 a `#[fixed_stack_segment]` wrapper at once.
9488 * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9489 * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9490 * `priv` is disallowed everywhere except for struct fields and enum variants.
9491 * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9492 * `ref` bindings in irrefutable patterns work correctly now.
9493 * `char` is now prevented from containing invalid code points.
9494 * Casting to `bool` is no longer allowed.
9495 * `\0` is now accepted as an escape in chars and strings.
9496 * `yield` is a reserved keyword.
9497 * `typeof` is a reserved keyword.
9498 * Crates may be imported by URL with `extern mod foo = "url";`.
9499 * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9500 * Static vectors can be initialized with repeating elements,
9501 e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9502 * Static structs can be initialized with functional record update,
9503 e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9504 * `cfg!` can be used to conditionally execute code based on the crate
9505 configuration, similarly to `#[cfg(...)]`.
9506 * The `unnecessary_qualification` lint detects unneeded module
9507 prefixes (default: allow).
9508 * Arithmetic operations have been implemented on the SIMD types in
9509 `std::unstable::simd`.
9510 * Exchange allocation headers were removed, reducing memory usage.
9511 * `format!` implements a completely new, extensible, and higher-performance
9512 string formatting system. It will replace `fmt!`.
9513 * `print!` and `println!` write formatted strings (using the `format!`
9514 extension) to stdout.
9515 * `write!` and `writeln!` write formatted strings (using the `format!`
9516 extension) to the new Writers in `std::rt::io`.
9517 * The library section in which a function or static is placed may
9518 be specified with `#[link_section = "..."]`.
9519 * The `proto!` syntax extension for defining bounded message protocols
9520 was removed.
9521 * `macro_rules!` is hygienic for `let` declarations.
9522 * The `#[export_name]` attribute specifies the name of a symbol.
9523 * `unreachable!` can be used to indicate unreachable code, and fails
9524 if executed.
9525
9526 * Libraries
9527 * std: Transitioned to the new runtime, written in Rust.
9528 * std: Added an experimental I/O library, `rt::io`, based on the new
9529 runtime.
9530 * std: A new generic `range` function was added to the prelude, replacing
9531 `uint::range` and friends.
9532 * std: `range_rev` no longer exists. Since range is an iterator it can be
9533 reversed with `range(lo, hi).invert()`.
9534 * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9535 renamed to `unwrap_or`.
9536 * std: The `iterator` module was renamed to `iter`.
9537 * std: Integral types now support the `checked_add`, `checked_sub`, and
9538 `checked_mul` operations for detecting overflow.
9539 * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9540 consistency.
9541 * std: Methods are standardizing on conventions for casting methods:
9542 `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9543 and cheap casts.
9544 * std: The `CString` type in `c_str` provides new ways to convert to and
9545 from C strings.
9546 * std: `DoubleEndedIterator` can yield elements in two directions.
9547 * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9548 two splices.
9549 * std: `str::from_bytes` renamed to `str::from_utf8`.
9550 * std: `pop_opt` and `shift_opt` methods added to vectors.
9551 * std: The task-local data interface no longer uses @, and keys are
9552 no longer function pointers.
9553 * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9554 * std: Added `SharedPort` to `comm`.
9555 * std: `Eq` has a default method for `ne`; only `eq` is required
9556 in implementations.
9557 * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9558 is required in implementations.
9559 * std: `is_utf8` performance is improved, impacting many string functions.
9560 * std: `os::MemoryMap` provides cross-platform mmap.
9561 * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9562 are not 'in-bounds' are considered undefined.
9563 * std: Many freestanding functions in `vec` removed in favor of methods.
9564 * std: Many freestanding functions on scalar types removed in favor of
9565 methods.
9566 * std: Many options to task builders were removed since they don't make
9567 sense in the new scheduler design.
9568 * std: More containers implement `FromIterator` so can be created by the
9569 `collect` method.
9570 * std: More complete atomic types in `unstable::atomics`.
9571 * std: `comm::PortSet` removed.
9572 * std: Mutating methods in the `Set` and `Map` traits have been moved into
9573 the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9574 `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9575 default implementations.
9576 * std: Various `from_str` functions were removed in favor of a generic
9577 `from_str` which is available in the prelude.
9578 * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9579 * extra: `dlist`, the doubly-linked list was modernized.
9580 * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9581 * extra: Added `glob` module, replacing `std::os::glob`.
9582 * extra: `rope` was removed.
9583 * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9584 * extra: `net`, and `timer` were removed. The experimental replacements
9585 are `std::rt::io::net` and `std::rt::io::timer`.
9586 * extra: Iterators implemented for `SmallIntMap`.
9587 * extra: Iterators implemented for `Bitv` and `BitvSet`.
9588 * extra: `SmallIntSet` removed. Use `BitvSet`.
9589 * extra: Performance of JSON parsing greatly improved.
9590 * extra: `semver` updated to SemVer 2.0.0.
9591 * extra: `term` handles more terminals correctly.
9592 * extra: `dbg` module removed.
9593 * extra: `par` module removed.
9594 * extra: `future` was cleaned up, with some method renames.
9595 * extra: Most free functions in `getopts` were converted to methods.
9596
9597 * Other
9598 * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9599 * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9600 similarly to gcc's `--march` flag.
9601 * rustc's performance compiling small crates is much better.
9602 * rustpkg has received many improvements.
9603 * rustpkg supports git tags as package IDs.
9604 * rustpkg builds into target-specific directories so it can be used for
9605 cross-compiling.
9606 * The number of concurrent test tasks is controlled by the environment
9607 variable RUST_TEST_TASKS.
9608 * The test harness can now report metrics for benchmarks.
9609 * All tools have man pages.
9610 * Programs compiled with `--test` now support the `-h` and `--help` flags.
9611 * The runtime uses jemalloc for allocations.
9612 * Segmented stacks are temporarily disabled as part of the transition to
9613 the new runtime. Stack overflows are possible!
9614 * A new documentation backend, rustdoc_ng, is available for use. It is
9615 still invoked through the normal `rustdoc` command.
9616
62682a34 9617
b039eaaf 9618Version 0.7 (2013-07-03)
62682a34 9619=======================
1a4d82fc
JJ
9620
9621 * ~2000 changes, numerous bugfixes
9622
9623 * Language
9624 * `impl`s no longer accept a visibility qualifier. Put them on methods
9625 instead.
9626 * The borrow checker has been rewritten with flow-sensitivity, fixing
9627 many bugs and inconveniences.
9628 * The `self` parameter no longer implicitly means `&'self self`,
9629 and can be explicitly marked with a lifetime.
9630 * Overloadable compound operators (`+=`, etc.) have been temporarily
9631 removed due to bugs.
9632 * The `for` loop protocol now requires `for`-iterators to return `bool`
9633 so they compose better.
9634 * The `Durable` trait is replaced with the `'static` bounds.
9635 * Trait default methods work more often.
9636 * Structs with the `#[packed]` attribute have byte alignment and
9637 no padding between fields.
9638 * Type parameters bound by `Copy` must now be copied explicitly with
9639 the `copy` keyword.
9640 * It is now illegal to move out of a dereferenced unsafe pointer.
9641 * `Option<~T>` is now represented as a nullable pointer.
9642 * `@mut` does dynamic borrow checks correctly.
9643 * The `main` function is only detected at the topmost level of the crate.
9644 The `#[main]` attribute is still valid anywhere.
9645 * Struct fields may no longer be mutable. Use inherited mutability.
9646 * The `#[no_send]` attribute makes a type that would otherwise be
9647 `Send`, not.
9648 * The `#[no_freeze]` attribute makes a type that would otherwise be
9649 `Freeze`, not.
9650 * Unbounded recursion will abort the process after reaching the limit
9651 specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9652 * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9653 are never implicitly copyable.
9654 * `#[static_assert]` makes compile-time assertions about static bools.
9655 * At long last, 'argument modes' no longer exist.
9656 * The rarely used `use mod` statement no longer exists.
9657
9658 * Syntax extensions
9659 * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9660 argument list.
9661 * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9662 `Rand`, `Zero` and `ToStr` can all be automatically derived with
9663 `#[deriving(...)]`.
9664 * The `bytes!` macro returns a vector of bytes for string, u8, char,
9665 and unsuffixed integer literals.
9666
9667 * Libraries
9668 * The `core` crate was renamed to `std`.
9669 * The `std` crate was renamed to `extra`.
9670 * More and improved documentation.
9671 * std: `iterator` module for external iterator objects.
9672 * Many old-style (internal, higher-order function) iterators replaced by
9673 implementations of `Iterator`.
9674 * std: Many old internal vector and string iterators,
9675 incl. `any`, `all`. removed.
9676 * std: The `finalize` method of `Drop` renamed to `drop`.
9677 * std: The `drop` method now takes `&mut self` instead of `&self`.
2c00a5a8 9678 * std: The prelude no longer re-exports any modules, only types and traits.
1a4d82fc
JJ
9679 * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9680 `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9681 * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9682 `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9683 * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9684 `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9685 * std: Many types implement `Clone`.
9686 * std: `path` type renamed to `Path`.
9687 * std: `mut` module and `Mut` type removed.
9688 * std: Many standalone functions removed in favor of methods and iterators
9689 in `vec`, `str`. In the future methods will also work as functions.
9690 * std: `reinterpret_cast` removed. Use `transmute`.
9691 * std: ascii string handling in `std::ascii`.
9692 * std: `Rand` is implemented for ~/@.
9693 * std: `run` module for spawning processes overhauled.
9694 * std: Various atomic types added to `unstable::atomic`.
9695 * std: Various types implement `Zero`.
9696 * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9697 * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9698 * std: Added `os::mkdir_recursive`.
9699 * std: Added `os::glob` function performs filesystems globs.
9700 * std: `FuzzyEq` renamed to `ApproxEq`.
9701 * std: `Map` now defines `pop` and `swap` methods.
9702 * std: `Cell` constructors converted to static methods.
9703 * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9704 * extra: `flate` module moved from `std` to `extra`.
9705 * extra: `fileinput` module for iterating over a series of files.
9706 * extra: `Complex` number type and `complex` module.
9707 * extra: `Rational` number type and `rational` module.
9708 * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9709 * extra: `term` uses terminfo now, is more correct.
9710 * extra: `arc` functions converted to methods.
9711 * extra: Implementation of fixed output size variations of SHA-2.
9712
9713 * Tooling
60c5eb7d 9714 * `unused_variables` lint mode for unused variables (default: warn).
1a4d82fc
JJ
9715 * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9716 (default: warn).
9717 * `unused_mut` lint mode for identifying unused `mut` qualifiers
9718 (default: warn).
9719 * `dead_assignment` lint mode for unread variables (default: warn).
9720 * `unnecessary_allocation` lint mode detects some heap allocations that are
9721 immediately borrowed so could be written without allocating (default: warn).
9722 * `missing_doc` lint mode (default: allow).
9723 * `unreachable_code` lint mode (default: warn).
9724 * The `rusti` command has been rewritten and a number of bugs addressed.
9725 * rustc outputs in color on more terminals.
9726 * rustc accepts a `--link-args` flag to pass arguments to the linker.
9727 * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9728 * Compiling with `-g` will make the binary record information about
9729 dynamic borrowcheck failures for debugging.
9730 * rustdoc has a nicer stylesheet.
9731 * Various improvements to rustdoc.
9732 * Improvements to rustpkg (see the detailed release notes).
9733
62682a34 9734
b039eaaf 9735Version 0.6 (2013-04-03)
62682a34 9736========================
1a4d82fc
JJ
9737
9738 * ~2100 changes, numerous bugfixes
9739
9740 * Syntax changes
9741 * The self type parameter in traits is now spelled `Self`
9742 * The `self` parameter in trait and impl methods must now be explicitly
9743 named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9744 * Static methods no longer require the `static` keyword and instead
9745 are distinguished by the lack of a `self` parameter
9746 * Replaced the `Durable` trait with the `'static` lifetime
9747 * The old closure type syntax with the trailing sigil has been
9748 removed in favor of the more consistent leading sigil
9749 * `super` is a keyword, and may be prefixed to paths
9750 * Trait bounds are separated with `+` instead of whitespace
9751 * Traits are implemented with `impl Trait for Type`
9752 instead of `impl Type: Trait`
9753 * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9754 * The `export` keyword has finally been removed
9755 * The `move` keyword has been removed (see "Semantic changes")
9756 * The interior mutability qualifier on vectors, `[mut T]`, has been
9757 removed. Use `&mut [T]`, etc.
9758 * `mut` is no longer valid in `~mut T`. Use inherited mutability
9759 * `fail` is no longer a keyword. Use `fail!()`
9760 * `assert` is no longer a keyword. Use `assert!()`
9761 * `log` is no longer a keyword. use `debug!`, etc.
9762 * 1-tuples may be represented as `(T,)`
9763 * Struct fields may no longer be `mut`. Use inherited mutability,
9764 `@mut T`, `core::mut` or `core::cell`
9765 * `extern mod { ... }` is no longer valid syntax for foreign
9766 function modules. Use extern blocks: `extern { ... }`
9767 * Newtype enums removed. Use tuple-structs.
9768 * Trait implementations no longer support visibility modifiers
9769 * Pattern matching over vectors improved and expanded
9770 * `const` renamed to `static` to correspond to lifetime name,
9771 and make room for future `static mut` unsafe mutable globals.
9772 * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9773 * `Clone` implementations can be automatically generated with
9774 `#[deriving(Clone)]`
9775 * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9776 instead of `foo as Bar`.
9777 * Fixed length vector types are now written as `[int, .. 3]`
9778 instead of `[int * 3]`.
9779 * Fixed length vector types can express the length as a constant
9780 expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9781
9782 * Semantic changes
9783 * Types with owned pointers or custom destructors move by default,
9784 eliminating the `move` keyword
9785 * All foreign functions are considered unsafe
9786 * &mut is now unaliasable
9787 * Writes to borrowed @mut pointers are prevented dynamically
9788 * () has size 0
9789 * The name of the main function can be customized using #[main]
9790 * The default type of an inferred closure is &fn instead of @fn
9791 * `use` statements may no longer be "chained" - they cannot import
9792 identifiers imported by previous `use` statements
9793 * `use` statements are crate relative, importing from the "top"
9794 of the crate by default. Paths may be prefixed with `super::`
9795 or `self::` to change the search behavior.
9796 * Method visibility is inherited from the implementation declaration
9797 * Structural records have been removed
9798 * Many more types can be used in static items, including enums
9799 'static-lifetime pointers and vectors
9800 * Pattern matching over vectors improved and expanded
9801 * Typechecking of closure types has been overhauled to
9802 improve inference and eliminate unsoundness
9803 * Macros leave scope at the end of modules, unless that module is
9804 tagged with #[macro_escape]
9805
9806 * Libraries
9807 * Added big integers to `std::bigint`
9808 * Removed `core::oldcomm` module
9809 * Added pipe-based `core::comm` module
9810 * Numeric traits have been reorganized under `core::num`
9811 * `vec::slice` finally returns a slice
9812 * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9813 * Containers reorganized around traits in `core::container`
9814 * `core::dvec` removed, `~[T]` is a drop-in replacement
9815 * `core::send_map` renamed to `core::hashmap`
9816 * `std::map` removed; replaced with `core::hashmap`
9817 * `std::treemap` reimplemented as an owned balanced tree
9818 * `std::deque` and `std::smallintmap` reimplemented as owned containers
9819 * `core::trie` added as a fast ordered map for integer keys
9820 * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9821 * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9822 overload the comparison operators, whereas `TotalOrd` is used
9823 by certain container types
9824
9825 * Other
9826 * Replaced the 'cargo' package manager with 'rustpkg'
9827 * Added all-purpose 'rust' tool
9828 * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9829 * rustc now *attempts* to offer spelling suggestions
9830 * Improved support for ARM and Android
9831 * Preliminary MIPS backend
9832 * Improved foreign function ABI implementation for x86, x86_64
9833 * Various memory usage improvements
9834 * Rust code may be embedded in foreign code under limited circumstances
9835 * Inline assembler supported by new asm!() syntax extension.
9836
62682a34 9837
b039eaaf 9838Version 0.5 (2012-12-21)
62682a34 9839===========================
1a4d82fc
JJ
9840
9841 * ~900 changes, numerous bugfixes
9842
9843 * Syntax changes
9844 * Removed `<-` move operator
9845 * Completed the transition from the `#fmt` extension syntax to `fmt!`
9846 * Removed old fixed length vector syntax - `[T]/N`
9847 * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9848 * Macros may now expand to items and statements
9849 * `a.b()` is always parsed as a method call, never as a field projection
9850 * `Eq` and `IterBytes` implementations can be automatically generated
9851 with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9852 * Removed the special crate language for `.rc` files
9853 * Function arguments may consist of any irrefutable pattern
9854
9855 * Semantic changes
9856 * `&` and `~` pointers may point to objects
9857 * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9858 * Enum variants may be structs
9859 * Destructors can be added to all nominal types with the Drop trait
9860 * Structs and nullary enum variants may be constants
9861 * Values that cannot be implicitly copied are now automatically moved
9862 without writing `move` explicitly
9863 * `&T` may now be coerced to `*T`
9864 * Coercions happen in `let` statements as well as function calls
9865 * `use` statements now take crate-relative paths
9866 * The module and type namespaces have been merged so that static
9867 method names can be resolved under the trait in which they are
9868 declared
9869
9870 * Improved support for language features
9871 * Trait inheritance works in many scenarios
9872 * More support for explicit self arguments in methods - `self`, `&self`
9873 `@self`, and `~self` all generally work as expected
9874 * Static methods work in more situations
9875 * Experimental: Traits may declare default methods for the implementations
9876 to use
9877
9878 * Libraries
9879 * New condition handling system in `core::condition`
9880 * Timsort added to `std::sort`
9881 * New priority queue, `std::priority_queue`
9882 * Pipes for serializable types, `std::flatpipes'
9883 * Serialization overhauled to be trait-based
9884 * Expanded `getopts` definitions
9885 * Moved futures to `std`
9886 * More functions are pure now
9887 * `core::comm` renamed to `oldcomm`. Still deprecated
9888 * `rustdoc` and `cargo` are libraries now
9889
9890 * Misc
9891 * Added a preliminary REPL, `rusti`
9892 * License changed from MIT to dual MIT/APL2
9893
62682a34 9894
b039eaaf 9895Version 0.4 (2012-10-15)
62682a34 9896==========================
1a4d82fc
JJ
9897
9898 * ~2000 changes, numerous bugfixes
9899
9900 * Syntax
9901 * All keywords are now strict and may not be used as identifiers anywhere
9902 * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9903 'of', 'with', 'to', 'class'.
9904 * Classes are replaced with simpler structs
9905 * Explicit method self types
9906 * `ret` became `return` and `alt` became `match`
9907 * `import` is now `use`; `use is now `extern mod`
9908 * `extern mod { ... }` is now `extern { ... }`
9909 * `use mod` is the recommended way to import modules
9910 * `pub` and `priv` replace deprecated export lists
9911 * The syntax of `match` pattern arms now uses fat arrow (=>)
9912 * `main` no longer accepts an args vector; use `os::args` instead
9913
9914 * Semantics
9915 * Trait implementations are now coherent, ala Haskell typeclasses
9916 * Trait methods may be static
9917 * Argument modes are deprecated
9918 * Borrowed pointers are much more mature and recommended for use
9919 * Strings and vectors in the static region are stored in constant memory
9920 * Typestate was removed
9921 * Resolution rewritten to be more reliable
9922 * Support for 'dual-mode' data structures (freezing and thawing)
9923
9924 * Libraries
9925 * Most binary operators can now be overloaded via the traits in
9926 `core::ops'
9927 * `std::net::url` for representing URLs
9928 * Sendable hash maps in `core::send_map`
9929 * `core::task' gained a (currently unsafe) task-local storage API
9930
9931 * Concurrency
9932 * An efficient new intertask communication primitive called the pipe,
9933 along with a number of higher-level channel types, in `core::pipes`
9934 * `std::arc`, an atomically reference counted, immutable, shared memory
9935 type
9936 * `std::sync`, various exotic synchronization tools based on arcs and pipes
9937 * Futures are now based on pipes and sendable
9938 * More robust linked task failure
9939 * Improved task builder API
9940
9941 * Other
9942 * Improved error reporting
9943 * Preliminary JIT support
9944 * Preliminary work on precise GC
9945 * Extensive architectural improvements to rustc
9946 * Begun a transition away from buggy C++-based reflection (shape) code to
9947 Rust-based (visitor) code
9948 * All hash functions and tables converted to secure, randomized SipHash
9949
62682a34 9950
b039eaaf 9951Version 0.3 (2012-07-12)
62682a34 9952========================
1a4d82fc
JJ
9953
9954 * ~1900 changes, numerous bugfixes
9955
9956 * New coding conveniences
9957 * Integer-literal suffix inference
9958 * Per-item control over warnings, errors
9959 * #[cfg(windows)] and #[cfg(unix)] attributes
9960 * Documentation comments
9961 * More compact closure syntax
9962 * 'do' expressions for treating higher-order functions as
9963 control structures
9964 * *-patterns (wildcard extended to all constructor fields)
9965
9966 * Semantic cleanup
9967 * Name resolution pass and exhaustiveness checker rewritten
9968 * Region pointers and borrow checking supersede alias
9969 analysis
9970 * Init-ness checking is now provided by a region-based liveness
9971 pass instead of the typestate pass; same for last-use analysis
9972 * Extensive work on region pointers
9973
9974 * Experimental new language features
9975 * Slices and fixed-size, interior-allocated vectors
9976 * #!-comments for lang versioning, shell execution
9977 * Destructors and iface implementation for classes;
9978 type-parameterized classes and class methods
9979 * 'const' type kind for types that can be used to implement
9980 shared-memory concurrency patterns
9981
9982 * Type reflection
9983
9984 * Removal of various obsolete features
9985 * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9986 'crust', 'native' (now 'extern'), 'cont' (now 'again')
9987
9988 * Constructs: do-while loops ('do' repurposed), fn binding,
9989 resources (replaced by destructors)
9990
9991 * Compiler reorganization
9992 * Syntax-layer of compiler split into separate crate
9993 * Clang (from LLVM project) integrated into build
9994 * Typechecker split into sub-modules
9995
9996 * New library code
9997 * New time functions
9998 * Extension methods for many built-in types
9999 * Arc: atomic-refcount read-only / exclusive-use shared cells
10000 * Par: parallel map and search routines
10001 * Extensive work on libuv interface
10002 * Much vector code moved to libraries
10003 * Syntax extensions: #line, #col, #file, #mod, #stringify,
10004 #include, #include_str, #include_bin
10005
10006 * Tool improvements
10007 * Cargo automatically resolves dependencies
10008
62682a34 10009
b039eaaf 10010Version 0.2 (2012-03-29)
62682a34 10011=========================
1a4d82fc
JJ
10012
10013 * >1500 changes, numerous bugfixes
10014
10015 * New docs and doc tooling
10016
10017 * New port: FreeBSD x86_64
10018
10019 * Compilation model enhancements
10020 * Generics now specialized, multiply instantiated
10021 * Functions now inlined across separate crates
10022
10023 * Scheduling, stack and threading fixes
10024 * Noticeably improved message-passing performance
10025 * Explicit schedulers
10026 * Callbacks from C
10027 * Helgrind clean
10028
10029 * Experimental new language features
10030 * Operator overloading
10031 * Region pointers
10032 * Classes
10033
10034 * Various language extensions
10035 * C-callback function types: 'crust fn ...'
10036 * Infinite-loop construct: 'loop { ... }'
10037 * Shorten 'mutable' to 'mut'
10038 * Required mutable-local qualifier: 'let mut ...'
10039 * Basic glob-exporting: 'export foo::*;'
10040 * Alt now exhaustive, 'alt check' for runtime-checked
10041 * Block-function form of 'for' loop, with 'break' and 'ret'.
10042
10043 * New library code
10044 * AST quasi-quote syntax extension
10045 * Revived libuv interface
10046 * New modules: core::{future, iter}, std::arena
10047 * Merged per-platform std::{os*, fs*} to core::{libc, os}
10048 * Extensive cleanup, regularization in libstd, libcore
10049
62682a34 10050
b039eaaf 10051Version 0.1 (2012-01-20)
62682a34 10052===============================
1a4d82fc
JJ
10053
10054 * Most language features work, including:
10055 * Unique pointers, unique closures, move semantics
10056 * Interface-constrained generics
10057 * Static interface dispatch
10058 * Stack growth
10059 * Multithread task scheduling
10060 * Typestate predicates
10061 * Failure unwinding, destructors
10062 * Pattern matching and destructuring assignment
10063 * Lightweight block-lambda syntax
10064 * Preliminary macro-by-example
10065
10066 * Compiler works with the following configurations:
10067 * Linux: x86 and x86_64 hosts and targets
cc61c64b 10068 * macOS: x86 and x86_64 hosts and targets
1a4d82fc
JJ
10069 * Windows: x86 hosts and targets
10070
10071 * Cross compilation / multi-target configuration supported.
10072
10073 * Preliminary API-documentation and package-management tools included.
10074
10075Known issues:
10076
10077 * Documentation is incomplete.
10078
10079 * Performance is below intended target.
10080
10081 * Standard library APIs are subject to extensive change, reorganization.
10082
10083 * Language-level versioning is not yet operational - future code will
10084 break unexpectedly.