]> git.proxmox.com Git - rustc.git/blame - RELEASES.md
New upstream version 1.48.0~beta.8+dfsg1
[rustc.git] / RELEASES.md
CommitLineData
6c58768f
XL
1Version 1.47.0 (2020-10-08)
2==========================
3
4Language
5--------
6- [Closures will now warn when not used.][74869]
7
8Compiler
9--------
10- [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
11 [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
12 platforms.
13- [Upgraded to LLVM 11.][73526]
14- [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
15- [Upgrade the FreeBSD toolchain to version 11.4][75204]
16- [`RUST_BACKTRACE`'s output is now more compact.][75048]
17
18\* Refer to Rust's [platform support page][forge-platform-support] for more
19information on Rust's tiered platform support.
20
21Libraries
22---------
23- [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
24- [Traits in `std`/`core` are now implemented for arrays of any length, not just
25 those of length less than 33.][74060]
26- [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
27- [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
28 `PartialEq`, and `PartialOrd`.][73583]
29
30Stabilized APIs
31---------------
32- [`Ident::new_raw`]
33- [`Range::is_empty`]
34- [`RangeInclusive::is_empty`]
35- [`Result::as_deref`]
36- [`Result::as_deref_mut`]
37- [`Vec::leak`]
38- [`pointer::offset_from`]
39- [`f32::TAU`]
40- [`f64::TAU`]
41
42The following previously stable APIs have now been made const.
43
44- [The `new` method for all `NonZero` integers.][73858]
45- [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
46 `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
47 methods for all integers.][73858]
48- [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum` for all
49 signed integers.][73858]
50- [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
51 `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
52 `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
53 `is_ascii_control` methods for `char` and `u8`.][73858]
54
55Cargo
56-----
57- [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
58 You can override this by setting the following in your `Cargo.toml`.
59 ```toml
60 [profile.release.build-override]
61 opt-level = 3
62 ```
63- [`cargo-help` will now display man pages for commands rather just the
64 `--help` text.][cargo/8456]
65- [`cargo-metadata` now emits a `test` field indicating if a target has
66 tests enabled.][cargo/8478]
67- [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
68- [`cargo-publish` will now use an alternative registry by default if it's the
69 only registry specified in `package.publish`.][cargo/8571]
70
71Misc
72----
73- [Added a help button beside Rustdoc's searchbar that explains rustdoc's
74 type based search.][75366]
75- [Added the Ayu theme to rustdoc.][71237]
76
77Compatibility Notes
78-------------------
79- [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
80- [Fixed a regression parsing `{} && false` in tail expressions.][74650]
81- [Added changes to how proc-macros are expanded in `macro_rules!` that should
82 help to preserve more span information.][73084] These changes may cause
83 compiliation errors if your macro was unhygenic or didn't correctly handle
84 `Delimiter::None`.
85- [Moved support for the CloudABI target to tier 3.][75568]
86- [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
6c58768f
XL
87- [Added the `rustc-docs` component.][75560] This allows you to install
88 and read the documentation for the compiler internal APIs. (Currently only
89 available for `x86_64-unknown-linux-gnu`.)
90
1b1a35ee
XL
91Internal Only
92--------
93- [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.
94
6c58768f 95[1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
6c58768f
XL
96[75048]: https://github.com/rust-lang/rust/pull/75048/
97[74163]: https://github.com/rust-lang/rust/pull/74163/
98[71237]: https://github.com/rust-lang/rust/pull/71237/
99[74869]: https://github.com/rust-lang/rust/pull/74869/
100[73858]: https://github.com/rust-lang/rust/pull/73858/
101[75716]: https://github.com/rust-lang/rust/pull/75716/
102[75908]: https://github.com/rust-lang/rust/pull/75908/
103[75516]: https://github.com/rust-lang/rust/pull/75516/
104[75560]: https://github.com/rust-lang/rust/pull/75560/
105[75568]: https://github.com/rust-lang/rust/pull/75568/
106[75366]: https://github.com/rust-lang/rust/pull/75366/
107[75204]: https://github.com/rust-lang/rust/pull/75204/
108[74650]: https://github.com/rust-lang/rust/pull/74650/
109[74419]: https://github.com/rust-lang/rust/pull/74419/
110[73964]: https://github.com/rust-lang/rust/pull/73964/
111[74021]: https://github.com/rust-lang/rust/pull/74021/
112[74060]: https://github.com/rust-lang/rust/pull/74060/
113[73893]: https://github.com/rust-lang/rust/pull/73893/
114[73526]: https://github.com/rust-lang/rust/pull/73526/
115[73583]: https://github.com/rust-lang/rust/pull/73583/
116[73084]: https://github.com/rust-lang/rust/pull/73084/
117[73197]: https://github.com/rust-lang/rust/pull/73197/
118[72488]: https://github.com/rust-lang/rust/pull/72488/
119[cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
120[cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
121[cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
122[cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
123[cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
124[`Ident::new_raw`]: https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
125[`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
126[`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
127[`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
128[`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
129[`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
130[`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
131[`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
132[`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
133[`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
134
135
f9652781
XL
136Version 1.46.0 (2020-08-27)
137==========================
138
139Language
140--------
141- [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
142- [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
143 const functions.][73862]
144- [The `#[track_caller]` attribute can now be added to functions to use the
145 function's caller's location information for panic messages.][72445]
146- [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
147 `x.0.0` over `(x.0).0`.
6c58768f 148- [`mem::transmute` can now be used in statics and constants.][72920] **Note**
f9652781
XL
149 You currently can't use `mem::transmute` in constant functions.
150
151Compiler
152--------
153- [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
154- [Enabled static "Position Independent Executables" by default
155 for `x86_64-unknown-linux-musl`.][70740]
156
157Libraries
158---------
159- [`mem::forget` is now a `const fn`.][73887]
160- [`String` now implements `From<char>`.][73466]
161- [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
162 integer types.][73032]
163- [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
164- [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
165 zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
166- [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
167- [`(String, u16)` now implements `ToSocketAddrs`.][73007]
168- [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
169
170Stabilized APIs
171---------------
172- [`Option::zip`]
173- [`vec::Drain::as_slice`]
174
175Cargo
176-----
177Added a number of new environment variables that are now available when
178compiling your crate.
179
180- [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
181 the specific binary being compiled and the name of the crate.
182- [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
183- [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
184
185Compatibility Notes
186-------------------
187- [The target configuration option `abi_blacklist` has been renamed
188 to `unsupported_abis`.][74150] The old name will still continue to work.
6c58768f 189- [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
f9652781
XL
190 This was previously accepted but will become a hard error in a future release.
191- [Rustc will fail to compile if you have a struct with
192 `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
193 allowed on `enum`s.
194- [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
195 ensure that spans have the correct information, and may cause breakage if you
196 were relying on receiving spans with dummy information.
197- [The InnoSetup installer for Windows is no longer available.][72569] This was
198 a legacy installer that was replaced by a MSI installer a few years ago but
199 was still being built.
200- [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
201- [Rustc will no longer accept overlapping trait implementations that only
202 differ in how the lifetime was bound.][72493]
203- [Rustc now correctly relates the lifetime of an existential associated
204 type.][71896] This fixes some edge cases where `rustc` would erroneously allow
205 you to pass a shorter lifetime than expected.
206- [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
207 The library will need to be installed for `rustc` to work, even though we
208 expect it to be already available on most systems.
209- [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
210 under QEMU.][74820]
211- [Pretty printing of some tokens in procedural macros changed.][75453] The
212 exact output returned by rustc's pretty printing is an unstable
213 implementation detail: we recommend any macro relying on it to switch to a
214 more robust parsing system.
215
216[75453]: https://github.com/rust-lang/rust/issues/75453/
217[74820]: https://github.com/rust-lang/rust/issues/74820/
218[74420]: https://github.com/rust-lang/rust/issues/74420/
219[74109]: https://github.com/rust-lang/rust/pull/74109/
220[74150]: https://github.com/rust-lang/rust/pull/74150/
221[73862]: https://github.com/rust-lang/rust/pull/73862/
222[73887]: https://github.com/rust-lang/rust/pull/73887/
223[73466]: https://github.com/rust-lang/rust/pull/73466/
224[73516]: https://github.com/rust-lang/rust/pull/73516/
225[73293]: https://github.com/rust-lang/rust/pull/73293/
226[73007]: https://github.com/rust-lang/rust/pull/73007/
227[73032]: https://github.com/rust-lang/rust/pull/73032/
228[72920]: https://github.com/rust-lang/rust/pull/72920/
229[72569]: https://github.com/rust-lang/rust/pull/72569/
230[72583]: https://github.com/rust-lang/rust/pull/72583/
231[72584]: https://github.com/rust-lang/rust/pull/72584/
232[72717]: https://github.com/rust-lang/rust/pull/72717/
233[72437]: https://github.com/rust-lang/rust/pull/72437/
234[72445]: https://github.com/rust-lang/rust/pull/72445/
235[72486]: https://github.com/rust-lang/rust/pull/72486/
236[72493]: https://github.com/rust-lang/rust/pull/72493/
237[72331]: https://github.com/rust-lang/rust/pull/72331/
238[71896]: https://github.com/rust-lang/rust/pull/71896/
239[71660]: https://github.com/rust-lang/rust/pull/71660/
240[71322]: https://github.com/rust-lang/rust/pull/71322/
241[70740]: https://github.com/rust-lang/rust/pull/70740/
242[cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
243[cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
244[cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
245[`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
246[`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
247
248
249Version 1.45.2 (2020-08-03)
250==========================
251
252* [Fix bindings in tuple struct patterns][74954]
253* [Fix track_caller integration with trait objects][74784]
254
255[74954]: https://github.com/rust-lang/rust/issues/74954
256[74784]: https://github.com/rust-lang/rust/issues/74784
257
258
259Version 1.45.1 (2020-07-30)
260==========================
261
262* [Fix const propagation with references.][73613]
263* [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
264* [Avoid spurious implicit region bound.][74509]
265* [Install clippy on x.py install][74457]
266
267[73613]: https://github.com/rust-lang/rust/pull/73613
268[73078]: https://github.com/rust-lang/rust/issues/73078
269[74509]: https://github.com/rust-lang/rust/pull/74509
270[74457]: https://github.com/rust-lang/rust/pull/74457
271
272
f9f354fc
XL
273Version 1.45.0 (2020-07-16)
274==========================
275
276Language
277--------
278- [Out of range float to int conversions using `as` has been defined as a saturating
279 conversion.][71269] This was previously undefined behaviour, but you can use the
280 `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
281 may be desirable in rare performance sensitive situations.
282- [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
283 using `u64`.][70705]
284- [Function like procedural macros can now be used in expression, pattern, and statement
285 positions.][68717] This means you can now use a function-like procedural macro
286 anywhere you can use a declarative (`macro_rules!`) macro.
287
288Compiler
289--------
290- [You can now override individual target features through the `target-feature`
291 flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
292 equivalent to `-C target-feature=+avx2,+fma`.
293- [Added the `force-unwind-tables` flag.][69984] This option allows
294 rustc to always generate unwind tables regardless of panic strategy.
295- [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
296 to include LLVM bitcode into generated `rlib`s (this is on by default).
297- [Added the `tiny` value to the `code-model` codegen flag.][72397]
298- [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
299- [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
300
301\* Refer to Rust's [platform support page][forge-platform-support] for more
302information on Rust's tiered platform support.
303
304
305Libraries
306---------
307- [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
308 and `Ord`.][72239]
309- [`proc_macro::TokenStream` now implements `Default`.][72234]
310- [You can now use `char` with
311 `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
312 a range of codepoints.][72413] E.g.
313 you can now write the following;
314 ```rust
315 for ch in 'a'..='z' {
316 print!("{}", ch);
317 }
318 println!();
319 // Prints "abcdefghijklmnopqrstuvwxyz"
320 ```
321- [`OsString` now implements `FromStr`.][71662]
f9652781 322- [The `saturating_neg` method has been added to all signed integer primitive
f9f354fc
XL
323 types, and the `saturating_abs` method has been added for all integer
324 primitive types.][71886]
325- [`Arc<T>`, `Rc<T>` now implement `From<Cow<'_, T>>`, and `Box` now
326 implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
327 or `Path`.][71447]
328- [`Box<[T]>` now implements `From<[T; N]>`.][71095]
329- [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
330 integer types.][69813]
331- [The `fetch_min`, and `fetch_max` methods have been added to all atomic
332 integer types.][72324]
333- [The `fetch_update` method has been added to all atomic integer types.][71843]
334
335Stabilized APIs
336---------------
337- [`Arc::as_ptr`]
338- [`BTreeMap::remove_entry`]
339- [`Rc::as_ptr`]
340- [`rc::Weak::as_ptr`]
341- [`rc::Weak::from_raw`]
342- [`rc::Weak::into_raw`]
343- [`str::strip_prefix`]
344- [`str::strip_suffix`]
345- [`sync::Weak::as_ptr`]
346- [`sync::Weak::from_raw`]
347- [`sync::Weak::into_raw`]
348- [`char::UNICODE_VERSION`]
349- [`Span::resolved_at`]
350- [`Span::located_at`]
351- [`Span::mixed_site`]
352- [`unix::process::CommandExt::arg0`]
353
354Cargo
355-----
356
f9652781
XL
357- [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
358 time.][cargo/8066]
359
f9f354fc
XL
360Misc
361----
362- [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
363 `~~outdated information~~` becomes "~~outdated information~~".
364- [Added an emoji to Rustdoc's deprecated API message.][72014]
365
366Compatibility Notes
367-------------------
368- [Trying to self initialize a static value (that is creating a value using
369 itself) is unsound and now causes a compile error.][71140]
370- [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
371 This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
372- [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
373 previously undocumented and not intended for public use. Rustdoc still provides
374 a non-zero exit code on errors.
f9652781
XL
375- [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
376 This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
377 flags while cargo is adding `embed-bitcode` itself. The recommended way to
378 control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
379 or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
f9f354fc
XL
380
381Internals Only
382--------------
383- [Make clippy a git subtree instead of a git submodule][70655]
384- [Unify the undo log of all snapshot types][69464]
385
f9652781 386[71848]: https://github.com/rust-lang/rust/issues/71848/
f9f354fc
XL
387[73420]: https://github.com/rust-lang/rust/issues/73420/
388[72324]: https://github.com/rust-lang/rust/pull/72324/
389[71843]: https://github.com/rust-lang/rust/pull/71843/
390[71886]: https://github.com/rust-lang/rust/pull/71886/
391[72234]: https://github.com/rust-lang/rust/pull/72234/
392[72239]: https://github.com/rust-lang/rust/pull/72239/
393[72397]: https://github.com/rust-lang/rust/pull/72397/
394[72413]: https://github.com/rust-lang/rust/pull/72413/
395[72014]: https://github.com/rust-lang/rust/pull/72014/
396[72062]: https://github.com/rust-lang/rust/pull/72062/
397[72094]: https://github.com/rust-lang/rust/pull/72094/
398[72133]: https://github.com/rust-lang/rust/pull/72133/
399[71900]: https://github.com/rust-lang/rust/pull/71900/
400[71928]: https://github.com/rust-lang/rust/pull/71928/
401[71662]: https://github.com/rust-lang/rust/pull/71662/
402[71716]: https://github.com/rust-lang/rust/pull/71716/
403[71447]: https://github.com/rust-lang/rust/pull/71447/
404[71269]: https://github.com/rust-lang/rust/pull/71269/
405[71095]: https://github.com/rust-lang/rust/pull/71095/
406[71140]: https://github.com/rust-lang/rust/pull/71140/
407[70655]: https://github.com/rust-lang/rust/pull/70655/
408[70705]: https://github.com/rust-lang/rust/pull/70705/
409[69984]: https://github.com/rust-lang/rust/pull/69984/
410[69813]: https://github.com/rust-lang/rust/pull/69813/
411[69464]: https://github.com/rust-lang/rust/pull/69464/
412[68717]: https://github.com/rust-lang/rust/pull/68717/
f9652781 413[cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
f9f354fc
XL
414[`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
415[`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
416[`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
417[`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
418[`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
419[`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
420[`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
421[`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
422[`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
423[`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
424[`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
425[`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
426[`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
427[`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
428[`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
429[`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
430
431
ba9703b0
XL
432Version 1.44.1 (2020-06-18)
433===========================
434
435* [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
436* [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
437* [Fix crashes when finding backtrace on macOS.][71397]
438* [Clippy applies lint levels into different files.][clippy/5356]
439
440[71397]: https://github.com/rust-lang/rust/issues/71397
441[73078]: https://github.com/rust-lang/rust/issues/73078
442[cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
443[clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
444
f9f354fc 445
ba9703b0
XL
446Version 1.44.0 (2020-06-04)
447==========================
448
449Language
450--------
451- [You can now use `async/.await` with `#[no_std]` enabled.][69033]
452- [Added the `unused_braces` lint.][70081]
453
454**Syntax-only changes**
455
456- [Expansion-driven outline module parsing][69838]
457```rust
458#[cfg(FALSE)]
459mod foo {
460 mod bar {
461 mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
462 }
463}
464```
465
466These are still rejected semantically, so you will likely receive an error but
467these changes can be seen and parsed by macros and conditional compilation.
468
469Compiler
470--------
471- [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
472 Additionally when in incremental mode rustc defaults to 256 codegen units.
f9f354fc 473- [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
ba9703b0
XL
474 a panic is thrown.][67502]
475- [Added tier 3\* support for the `aarch64-unknown-none` and
476 `aarch64-unknown-none-softfloat` targets.][68334]
477- [Added tier 3 support for `arm64-apple-tvos` and
478 `x86_64-apple-tvos` targets.][68191]
479
480
481Libraries
482---------
483- [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
484 `vec![]` to be able to be used in `const` contexts.
485- [`convert::Infallible` now implements `Hash`.][70281]
486- [`OsString` now implements `DerefMut` and `IndexMut` returning
487 a `&mut OsStr`.][70048]
488- [Unicode 13 is now supported.][69929]
489- [`String` now implements `From<&mut str>`.][69661]
490- [`IoSlice` now implements `Copy`.][69403]
f9f354fc 491- [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
ba9703b0
XL
492- [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
493- [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
494 `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
495 integer types.][69373]
496
497Stabilized APIs
498---------------
499- [`PathBuf::with_capacity`]
500- [`PathBuf::capacity`]
501- [`PathBuf::clear`]
502- [`PathBuf::reserve`]
503- [`PathBuf::reserve_exact`]
504- [`PathBuf::shrink_to_fit`]
505- [`f32::to_int_unchecked`]
506- [`f64::to_int_unchecked`]
507- [`Layout::align_to`]
508- [`Layout::pad_to_align`]
509- [`Layout::array`]
510- [`Layout::extend`]
511
512Cargo
513-----
514- [Added the `cargo tree` command which will print a tree graph of
515 your dependencies.][cargo/8062] E.g.
516 ```
517 mdbook v0.3.2 (/Users/src/rust/mdbook)
518 ├── ammonia v3.0.0
519 │ ├── html5ever v0.24.0
520 │ │ ├── log v0.4.8
521 │ │ │ └── cfg-if v0.1.9
522 │ │ ├── mac v0.1.1
523 │ │ └── markup5ever v0.9.0
524 │ │ ├── log v0.4.8 (*)
525 │ │ ├── phf v0.7.24
526 │ │ │ └── phf_shared v0.7.24
527 │ │ │ ├── siphasher v0.2.3
528 │ │ │ └── unicase v1.4.2
529 │ │ │ [build-dependencies]
530 │ │ │ └── version_check v0.1.5
531 ...
532 ```
533 You can also display dependencies on multiple versions of the same crate with
534 `cargo tree -d` (short for `cargo tree --duplicates`).
535
536Misc
537----
538- [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
539 the version in the sidebar.][69494]
540
541Compatibility Notes
542-------------------
543- [Rustc now correctly generates static libraries on Windows GNU targets with
544 the `.a` extension, rather than the previous `.lib`.][70937]
545- [Removed the `-C no_integrated_as` flag from rustc.][70345]
546- [The `file_name` property in JSON output of macro errors now points the actual
547 source file rather than the previous format of `<NAME macros>`.][70969]
f9f354fc 548 **Note:** this may not point to a file that actually exists on the user's system.
ba9703b0
XL
549- [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
550- [`mem::{zeroed, uninitialised}` will now panic when used with types that do
551 not allow zero initialization such as `NonZeroU8`.][66059] This was
552 previously a warning.
553- [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
554 operator has been defined as a saturating operation.][71269] This was previously
f9f354fc
XL
555 undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
556 continue using the current behaviour, which may be desirable in rare performance
ba9703b0
XL
557 sensitive situations.
558
559Internal Only
560-------------
561These changes provide no direct user facing benefits, but represent significant
562improvements to the internals and overall performance of rustc and
563related tools.
564
565- [dep_graph Avoid allocating a set on when the number reads are small.][69778]
566- [Replace big JS dict with JSON parsing.][71250]
567
568[69373]: https://github.com/rust-lang/rust/pull/69373/
569[66059]: https://github.com/rust-lang/rust/pull/66059/
570[68191]: https://github.com/rust-lang/rust/pull/68191/
571[68899]: https://github.com/rust-lang/rust/pull/68899/
572[71147]: https://github.com/rust-lang/rust/pull/71147/
573[71250]: https://github.com/rust-lang/rust/pull/71250/
574[70937]: https://github.com/rust-lang/rust/pull/70937/
575[70969]: https://github.com/rust-lang/rust/pull/70969/
576[70632]: https://github.com/rust-lang/rust/pull/70632/
577[70281]: https://github.com/rust-lang/rust/pull/70281/
578[70345]: https://github.com/rust-lang/rust/pull/70345/
579[70048]: https://github.com/rust-lang/rust/pull/70048/
580[70081]: https://github.com/rust-lang/rust/pull/70081/
581[70156]: https://github.com/rust-lang/rust/pull/70156/
582[71269]: https://github.com/rust-lang/rust/pull/71269/
583[69838]: https://github.com/rust-lang/rust/pull/69838/
584[69929]: https://github.com/rust-lang/rust/pull/69929/
585[69661]: https://github.com/rust-lang/rust/pull/69661/
586[69778]: https://github.com/rust-lang/rust/pull/69778/
587[69494]: https://github.com/rust-lang/rust/pull/69494/
588[69403]: https://github.com/rust-lang/rust/pull/69403/
589[69033]: https://github.com/rust-lang/rust/pull/69033/
590[68692]: https://github.com/rust-lang/rust/pull/68692/
591[68334]: https://github.com/rust-lang/rust/pull/68334/
592[67502]: https://github.com/rust-lang/rust/pull/67502/
593[cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
594[`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
595[`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
596[`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
597[`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
598[`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
599[`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
600[`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
601[`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
602[`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
603[`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
604[`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
605[`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
606
607
608Version 1.43.1 (2020-05-07)
609===========================
610
611* [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
612* [Fixed the stabilization of AVX-512 features.][71473]
613* [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
614
615[71430]: https://github.com/rust-lang/rust/pull/71430
616[71473]: https://github.com/rust-lang/rust/issues/71473
617[cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
618
619
74b04a01
XL
620Version 1.43.0 (2020-04-23)
621==========================
622
623Language
624--------
625- [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
626 the type inferred correctly.][68129]
627- [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
628
629**Syntax only changes**
630- [Allow `type Foo: Ord` syntactically.][69361]
631- [Fuse associated and extern items up to defaultness.][69194]
632- [Syntactically allow `self` in all `fn` contexts.][68764]
633- [Merge `fn` syntax + cleanup item parsing.][68728]
634- [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
635 For example, you may now write:
ba9703b0 636 ```rust
74b04a01
XL
637 macro_rules! mac_trait {
638 ($i:item) => {
639 trait T { $i }
640 }
641 }
642 mac_trait! {
643 fn foo() {}
644 }
645 ```
646
647These are still rejected *semantically*, so you will likely receive an error but
648these changes can be seen and parsed by macros and
649conditional compilation.
650
651
652Compiler
653--------
654- [You can now pass multiple lint flags to rustc to override the previous
655 flags.][67885] For example; `rustc -D unused -A unused-variables` denies
656 everything in the `unused` lint group except `unused-variables` which
657 is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
658 everything in the `unused` lint group **including** `unused-variables` since
659 the allow flag is specified before the deny flag (and therefore overridden).
660- [rustc will now prefer your system MinGW libraries over its bundled libraries
661 if they are available on `windows-gnu`.][67429]
662- [rustc now buffers errors/warnings printed in JSON.][69227]
663
664Libraries
665---------
666- [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
667 `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
668 respectively.][69538] **Note** These conversions are only available when `N`
669 is `0..=32`.
670- [You can now use associated constants on floats and integers directly, rather
671 than having to import the module.][68952] e.g. You can now write `u32::MAX` or
672 `f32::NAN` with no imports.
673- [`u8::is_ascii` is now `const`.][68984]
674- [`String` now implements `AsMut<str>`.][68742]
675- [Added the `primitive` module to `std` and `core`.][67637] This module
676 reexports Rust's primitive types. This is mainly useful in macros
677 where you want avoid these types being shadowed.
678- [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
679- [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
680
681Stabilized APIs
682---------------
683- [`Once::is_completed`]
684- [`f32::LOG10_2`]
685- [`f32::LOG2_10`]
686- [`f64::LOG10_2`]
687- [`f64::LOG2_10`]
688- [`iter::once_with`]
689
690Cargo
691-----
692- [You can now set config `[profile]`s in your `.cargo/config`, or through
693 your environment.][cargo/7823]
694- [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
695 executable path when running integration tests or benchmarks.][cargo/7697]
696 `<name>` is the name of your binary as-is e.g. If you wanted the executable
697 path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
698
699Misc
700----
701- [Certain checks in the `const_err` lint were deemed unrelated to const
702 evaluation][69185], and have been moved to the `unconditional_panic` and
703 `arithmetic_overflow` lints.
ba9703b0 704
74b04a01
XL
705Compatibility Notes
706-------------------
707
708- [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
709 has been a warning since 1.36.0.
710- [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
711 led to some instances being accepted, and now correctly emits a hard error.
712
713[69340]: https://github.com/rust-lang/rust/pull/69340
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- [All components are now built with `opt-level=3` instead of `2`.][67878]
722- [Improved how rustc generates drop code.][67332]
723- [Improved performance from `#[inline]`-ing certain hot functions.][69256]
724- [traits: preallocate 2 Vecs of known initial size][69022]
725- [Avoid exponential behaviour when relating types][68772]
726- [Skip `Drop` terminators for enum variants without drop glue][68943]
727- [Improve performance of coherence checks][68966]
728- [Deduplicate types in the generator witness][68672]
729- [Invert control in struct_lint_level.][68725]
730
731[67332]: https://github.com/rust-lang/rust/pull/67332/
732[67429]: https://github.com/rust-lang/rust/pull/67429/
733[67637]: https://github.com/rust-lang/rust/pull/67637/
734[67642]: https://github.com/rust-lang/rust/pull/67642/
735[67878]: https://github.com/rust-lang/rust/pull/67878/
736[67885]: https://github.com/rust-lang/rust/pull/67885/
737[68129]: https://github.com/rust-lang/rust/pull/68129/
738[68672]: https://github.com/rust-lang/rust/pull/68672/
739[68725]: https://github.com/rust-lang/rust/pull/68725/
740[68728]: https://github.com/rust-lang/rust/pull/68728/
741[68738]: https://github.com/rust-lang/rust/pull/68738/
742[68742]: https://github.com/rust-lang/rust/pull/68742/
743[68764]: https://github.com/rust-lang/rust/pull/68764/
744[68772]: https://github.com/rust-lang/rust/pull/68772/
745[68943]: https://github.com/rust-lang/rust/pull/68943/
746[68952]: https://github.com/rust-lang/rust/pull/68952/
747[68966]: https://github.com/rust-lang/rust/pull/68966/
748[68984]: https://github.com/rust-lang/rust/pull/68984/
749[69022]: https://github.com/rust-lang/rust/pull/69022/
750[69185]: https://github.com/rust-lang/rust/pull/69185/
751[69194]: https://github.com/rust-lang/rust/pull/69194/
752[69201]: https://github.com/rust-lang/rust/pull/69201/
753[69227]: https://github.com/rust-lang/rust/pull/69227/
754[69548]: https://github.com/rust-lang/rust/pull/69548/
755[69256]: https://github.com/rust-lang/rust/pull/69256/
756[69361]: https://github.com/rust-lang/rust/pull/69361/
757[69366]: https://github.com/rust-lang/rust/pull/69366/
758[69538]: https://github.com/rust-lang/rust/pull/69538/
759[cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
760[cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
761[`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
762[`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
763[`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
764[`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
765[`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
766[`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
767
768
dfeec247
XL
769Version 1.42.0 (2020-03-12)
770==========================
771
772Language
773--------
774- [You can now use the slice pattern syntax with subslices.][67712] e.g.
775 ```rust
776 fn foo(words: &[&str]) {
777 match words {
778 ["Hello", "World", "!", ..] => println!("Hello World!"),
779 ["Foo", "Bar", ..] => println!("Baz"),
780 rest => println!("{:?}", rest),
781 }
782 }
783 ```
784- [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
785 that you can create an enum that has the exact layout and ABI of the type
786 it contains.
787- [There are some *syntax-only* changes:][67131]
788 - `default` is syntactically allowed before items in `trait` definitions.
789 - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
790 leave out their bodies in favor of `;`.
791 - Bounds on associated types in `impl`s are now syntactically allowed
792 (e.g. `type Foo: Ord;`).
793 - `...` (the C-variadic type) may occur syntactically directly as the type of
794 any function parameter.
ba9703b0 795
dfeec247
XL
796 These are still rejected *semantically*, so you will likely receive an error
797 but these changes can be seen and parsed by procedural macros and
798 conditional compilation.
799
800Compiler
801--------
802- [Added tier 2\* support for `armv7a-none-eabi`.][68253]
803- [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
804- [`Option::{expect,unwrap}` and
805 `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
806 pointing to the location where they were called, rather than
807 `core`'s internals. ][67887]
808
809\* Refer to Rust's [platform support page][forge-platform-support] for more
810information on Rust's tiered platform support.
811
812Libraries
813---------
814- [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
815- [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
816 to implement `Sized`.][67935]
817- [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
818- [`Layout::new` is now `const`.][66254]
819- [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
820
821
822Stabilized APIs
823---------------
824- [`CondVar::wait_while`]
825- [`CondVar::wait_timeout_while`]
826- [`DebugMap::key`]
827- [`DebugMap::value`]
828- [`ManuallyDrop::take`]
829- [`matches!`]
830- [`ptr::slice_from_raw_parts_mut`]
831- [`ptr::slice_from_raw_parts`]
832
833Cargo
834-----
835- [You no longer need to include `extern crate proc_macro;` to be able to
836 `use proc_macro;` in the `2018` edition.][cargo/7700]
837
838Compatibility Notes
839-------------------
840- [`Error::description` has been deprecated, and its use will now produce a
841 warning.][66919] It's recommended to use `Display`/`to_string` instead.
74b04a01 842
dfeec247
XL
843[68253]: https://github.com/rust-lang/rust/pull/68253/
844[68348]: https://github.com/rust-lang/rust/pull/68348/
845[67935]: https://github.com/rust-lang/rust/pull/67935/
846[68339]: https://github.com/rust-lang/rust/pull/68339/
847[68122]: https://github.com/rust-lang/rust/pull/68122/
848[67712]: https://github.com/rust-lang/rust/pull/67712/
849[67887]: https://github.com/rust-lang/rust/pull/67887/
850[67131]: https://github.com/rust-lang/rust/pull/67131/
851[67233]: https://github.com/rust-lang/rust/pull/67233/
852[66899]: https://github.com/rust-lang/rust/pull/66899/
853[66919]: https://github.com/rust-lang/rust/pull/66919/
854[66254]: https://github.com/rust-lang/rust/pull/66254/
855[cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
856[`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
857[`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
858[`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
859[`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
860[`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
861[`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
862[`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
863[`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
864
865
60c5eb7d
XL
866Version 1.41.1 (2020-02-27)
867===========================
868
869* [Always check types of static items][69145]
870* [Always check lifetime bounds of `Copy` impls][69145]
871* [Fix miscompilation in callers of `Layout::repeat`][69225]
872
873[69225]: https://github.com/rust-lang/rust/issues/69225
874[69145]: https://github.com/rust-lang/rust/pull/69145
875
dfeec247 876
60c5eb7d
XL
877Version 1.41.0 (2020-01-30)
878===========================
879
880Language
881--------
882
883- [You can now pass type parameters to foreign items when implementing
884 traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
885- [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
886 now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
887 `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
888- [You can now use any valid identifier in a `format_args` macro.][66847]
889 Previously identifiers starting with an underscore were not allowed.
890- [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
891 enum variants.][66183] These are still rejected semantically, but
892 can be seen and parsed by procedural macros and conditional compilation.
893
894Compiler
895--------
896
897- [Rustc will now warn if you have unused loop `'label`s.][66325]
898- [Removed support for the `i686-unknown-dragonfly` target.][67255]
899- [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
900- [You can now pass an arguments file passing the `@path` syntax
901 to rustc.][66172] Note that the format differs somewhat from what is
902 found in other tooling; please see [the documentation][argfile-docs] for
903 more information.
904- [You can now provide `--extern` flag without a path, indicating that it is
905 available from the search path or specified with an `-L` flag.][64882]
906
907\* Refer to Rust's [platform support page][forge-platform-support] for more
908information on Rust's tiered platform support.
909
910[argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
911
912Libraries
913---------
914
915- [The `core::panic` module is now stable.][66771] It was already stable
916 through `std`.
917- [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
918 width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
919- [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
920
921Stabilized APIs
922---------------
923
924- [`Result::map_or`]
925- [`Result::map_or_else`]
926- [`std::rc::Weak::weak_count`]
927- [`std::rc::Weak::strong_count`]
928- [`std::sync::Weak::weak_count`]
929- [`std::sync::Weak::strong_count`]
930
931Cargo
932-----
933
934- [Cargo will now document all the private items for binary crates
935 by default.][cargo/7593]
936- [`cargo-install` will now reinstall the package if it detects that it is out
937 of date.][cargo/7560]
938- [Cargo.lock now uses a more git friendly format that should help to reduce
939 merge conflicts.][cargo/7579]
940- [You can now override specific dependencies's build settings][cargo/7591] E.g.
941 `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
942 optimisation level to `2` for debug builds. You can also use
943 `[profile.<profile>.build-override]` to override build scripts and
944 their dependencies.
945
946Misc
947----
948
949- [You can now specify `edition` in documentation code blocks to compile the block
950 for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
951 should be compiled the 2018 edition of Rust.
952- [You can now provide custom themes to rustdoc with `--theme`, and check the
953 current theme with `--check-theme`.][54733]
954- [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
955
956Compatibility Notes
957-------------------
958
959- [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
960 Apple targets.][apple-32bit-drop] This means that the source code is still
961 available to build, but the targets are no longer being tested and release
962 binaries for those platforms will no longer be distributed by the Rust project.
963 Please refer to the linked blog post for more information.
964
965[54733]: https://github.com/rust-lang/rust/pull/54733/
966[61351]: https://github.com/rust-lang/rust/pull/61351/
967[67255]: https://github.com/rust-lang/rust/pull/67255/
968[66661]: https://github.com/rust-lang/rust/pull/66661/
969[66771]: https://github.com/rust-lang/rust/pull/66771/
970[66847]: https://github.com/rust-lang/rust/pull/66847/
971[66238]: https://github.com/rust-lang/rust/pull/66238/
972[66277]: https://github.com/rust-lang/rust/pull/66277/
973[66325]: https://github.com/rust-lang/rust/pull/66325/
974[66172]: https://github.com/rust-lang/rust/pull/66172/
975[66183]: https://github.com/rust-lang/rust/pull/66183/
976[65879]: https://github.com/rust-lang/rust/pull/65879/
977[65013]: https://github.com/rust-lang/rust/pull/65013/
978[64882]: https://github.com/rust-lang/rust/pull/64882/
979[64325]: https://github.com/rust-lang/rust/pull/64325/
980[cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
981[cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
982[cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
983[cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
984[`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
985[`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
986[`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
987[`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
988[`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
989[`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
990[apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
991
992Version 1.40.0 (2019-12-19)
993===========================
994
995Language
996--------
997- [You can now use tuple `struct`s and tuple `enum` variant's constructors in
998 `const` contexts.][65188] e.g.
999
1000 ```rust
1001 pub struct Point(i32, i32);
1002
1003 const ORIGIN: Point = {
1004 let constructor = Point;
1005
1006 constructor(0, 0)
1007 };
1008 ```
1009
1010- [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1011 indicate that there may be variants or fields added in the future.][64639]
1012 For example this requires adding a wild-card branch (`_ => {}`) to any match
1013 statements on a non-exhaustive `enum`. [(RFC 2008)]
1014- [You can now use function-like procedural macros in `extern` blocks and in
1015 type positions.][63931] e.g. `type Generated = macro!();`
1016- [Function-like and attribute procedural macros can now emit
1017 `macro_rules!` items, so you can now have your macros generate macros.][64035]
1018- [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1019 attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1020 `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1021
1022Compiler
1023--------
1024- [Added tier 3 support\* for the
1025 `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1026- [Added tier 3 support for the
1027 `aarch64-unknown-none-softfloat` target.][64589]
1028- [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1029 `mips64el-unknown-linux-muslabi64` targets.][65843]
1030
1031\* Refer to Rust's [platform support page][forge-platform-support] for more
1032 information on Rust's tiered platform support.
1033
1034Libraries
1035---------
1036- [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1037
1038Stabilized APIs
1039---------------
1040- [`BTreeMap::get_key_value`]
1041- [`HashMap::get_key_value`]
1042- [`Option::as_deref_mut`]
1043- [`Option::as_deref`]
1044- [`Option::flatten`]
1045- [`UdpSocket::peer_addr`]
1046- [`f32::to_be_bytes`]
1047- [`f32::to_le_bytes`]
1048- [`f32::to_ne_bytes`]
1049- [`f64::to_be_bytes`]
1050- [`f64::to_le_bytes`]
1051- [`f64::to_ne_bytes`]
1052- [`f32::from_be_bytes`]
1053- [`f32::from_le_bytes`]
1054- [`f32::from_ne_bytes`]
1055- [`f64::from_be_bytes`]
1056- [`f64::from_le_bytes`]
1057- [`f64::from_ne_bytes`]
1058- [`mem::take`]
1059- [`slice::repeat`]
1060- [`todo!`]
1061
1062Cargo
1063-----
1064- [Cargo will now always display warnings, rather than only on
1065 fresh builds.][cargo/7450]
1066- [Feature flags (except `--all-features`) passed to a virtual workspace will
1067 now produce an error.][cargo/7507] Previously these flags were ignored.
1068- [You can now publish `dev-dependencies` without including
1069 a `version`.][cargo/7333]
1070
1071Misc
1072----
1073- [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1074 when running documentation tests with `rustdoc`.][63803]
1075
1076Compatibility Notes
1077-------------------
1078- [As previously announced, any previous NLL warnings in the 2015 edition are
1079 now hard errors.][64221]
1080- [The `include!` macro will now warn if it failed to include the
1081 entire file.][64284] The `include!` macro unintentionally only includes the
1082 first _expression_ in a file, and this can be unintuitive. This will become
1083 either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1084- [Using `#[inline]` on function prototypes and consts now emits a warning under
1085 `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1086 or `extern` blocks now correctly emits a hard error.
ba9703b0 1087
60c5eb7d
XL
1088[65294]: https://github.com/rust-lang/rust/pull/65294/
1089[66103]: https://github.com/rust-lang/rust/pull/66103/
1090[65843]: https://github.com/rust-lang/rust/pull/65843/
1091[65188]: https://github.com/rust-lang/rust/pull/65188/
1092[65092]: https://github.com/rust-lang/rust/pull/65092/
1093[64589]: https://github.com/rust-lang/rust/pull/64589/
1094[64639]: https://github.com/rust-lang/rust/pull/64639/
1095[64221]: https://github.com/rust-lang/rust/pull/64221/
1096[64284]: https://github.com/rust-lang/rust/pull/64284/
1097[63931]: https://github.com/rust-lang/rust/pull/63931/
1098[64035]: https://github.com/rust-lang/rust/pull/64035/
1099[63674]: https://github.com/rust-lang/rust/pull/63674/
1100[63803]: https://github.com/rust-lang/rust/pull/63803/
1101[cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1102[cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1103[cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1104[cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1105[(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1106[`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1107[`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1108[`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1109[`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1110[`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1111[`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1112[`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1113[`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1114[`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1115[`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1116[`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1117[`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1118[`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1119[`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1120[`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1121[`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1122[`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1123[`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1124[`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1125[`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1126[`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1127
1128
e1599b0c
XL
1129Version 1.39.0 (2019-11-07)
1130===========================
1131
1132Language
1133--------
1134- [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1135 `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1136- [You can now use certain attributes on function, closure, and function pointer
1137 parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1138 `deny`, `forbid` as well as inert helper attributes used by procedural macro
1139 attributes applied to items. e.g.
1140 ```rust
1141 fn len(
1142 #[cfg(windows)] slice: &[u16],
1143 #[cfg(not(windows))] slice: &[u8],
1144 ) -> usize {
1145 slice.len()
1146 }
1147 ```
1148- [You can now take shared references to bind-by-move patterns in the `if` guards
1149 of `match` arms.][63118] e.g.
1150 ```rust
1151 fn main() {
1152 let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1153
1154 match array {
1155 nums
1156 // ---- `nums` is bound by move.
1157 if nums.iter().sum::<u8>() == 10
1158 // ^------ `.iter()` implicitly takes a reference to `nums`.
1159 => {
1160 drop(nums);
1161 // ----------- Legal as `nums` was bound by move and so we have ownership.
1162 }
1163 _ => unreachable!(),
1164 }
1165 }
1166 ```
1167
1168
1169
1170Compiler
1171--------
1172- [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1173- [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1174- [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1175 **Note** Cargo currently doesn't use this feature. Refer to
1176 [cargo#7315][cargo/7315] to track this feature's progress.
1177- [You can now pass `--show-output` argument to test binaries to print the
1178 output of successful tests.][62600]
1179
1180
1181\* Refer to Rust's [platform support page][forge-platform-support] for more
1182information on Rust's tiered platform support.
1183
1184Libraries
1185---------
1186- [`Vec::new` and `String::new` are now `const` functions.][64028]
1187- [`LinkedList::new` is now a `const` function.][63684]
1188- [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1189- [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1190 now `const`.][63786]
1191
1192Stabilized APIs
1193---------------
1194- [`Pin::into_inner`]
1195- [`Instant::checked_duration_since`]
1196- [`Instant::saturating_duration_since`]
1197
1198Cargo
1199-----
1200- [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1201- [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1202 `--all` is now deprecated.
1203
1204Misc
1205----
1206- [You can now pass `-Clinker` to rustdoc to control the linker used
1207 for compiling doctests.][63834]
1208
1209Compatibility Notes
1210-------------------
1211- [Code that was previously accepted by the old borrow checker, but rejected by
1212 the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1213 previously a warning, and will also become a hard error in the Rust 2015
1214 edition in the 1.40.0 release.
1215- [`rustdoc` now requires `rustc` to be installed and in the same directory to
1216 run tests.][63827] This should improve performance when running a large
1217 amount of doctests.
1218- [The `try!` macro will now issue a deprecation warning.][62672] It is
1219 recommended to use the `?` operator instead.
1220- [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1221 returned `0.0`.
1222
1223[62600]: https://github.com/rust-lang/rust/pull/62600/
1224[62672]: https://github.com/rust-lang/rust/pull/62672/
1225[63118]: https://github.com/rust-lang/rust/pull/63118/
1226[63209]: https://github.com/rust-lang/rust/pull/63209/
1227[63402]: https://github.com/rust-lang/rust/pull/63402/
1228[63565]: https://github.com/rust-lang/rust/pull/63565/
1229[63595]: https://github.com/rust-lang/rust/pull/63595/
1230[63684]: https://github.com/rust-lang/rust/pull/63684/
1231[63698]: https://github.com/rust-lang/rust/pull/63698/
1232[63770]: https://github.com/rust-lang/rust/pull/63770/
1233[63786]: https://github.com/rust-lang/rust/pull/63786/
1234[63827]: https://github.com/rust-lang/rust/pull/63827/
1235[63834]: https://github.com/rust-lang/rust/pull/63834/
1236[63927]: https://github.com/rust-lang/rust/pull/63927/
1237[63933]: https://github.com/rust-lang/rust/pull/63933/
1238[63934]: https://github.com/rust-lang/rust/pull/63934/
1239[63938]: https://github.com/rust-lang/rust/pull/63938/
1240[63940]: https://github.com/rust-lang/rust/pull/63940/
1241[63941]: https://github.com/rust-lang/rust/pull/63941/
1242[63945]: https://github.com/rust-lang/rust/pull/63945/
1243[64010]: https://github.com/rust-lang/rust/pull/64010/
1244[64028]: https://github.com/rust-lang/rust/pull/64028/
1245[64334]: https://github.com/rust-lang/rust/pull/64334/
1246[cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1247[cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1248[cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1249[`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1250[`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
1251[`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
1252
416331ca
XL
1253Version 1.38.0 (2019-09-26)
1254==========================
1255
1256Language
1257--------
1258- [The `#[global_allocator]` attribute can now be used in submodules.][62735]
1259- [The `#[deprecated]` attribute can now be used on macros.][62042]
1260
1261Compiler
1262--------
1263- [Added pipelined compilation support to `rustc`.][62766] This will
1264 improve compilation times in some cases. For further information please refer
1265 to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
1266- [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
1267 `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
1268 `x86_64-uwp-windows-msvc` targets.][60260]
1269- [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
1270 `armv7-unknown-linux-musleabi` targets.][63107]
1271- [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1272- [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1273
1274\* Refer to Rust's [platform support page][forge-platform-support] for more
1275information on Rust's tiered platform support.
1276
1277Libraries
1278---------
1279- [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1280- [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1281 available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1282 is available at `std::clone::Clone`). This also makes all built-in macros
1283 available in `std`/`core` root. e.g. `std::include_bytes!`.
1284- [`str::Chars` now implements `Debug`.][63000]
1285- [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1286- [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1287- [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1288- [Added euclidean remainder and division operations (`div_euclid`,
1289 `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1290 `overflowing`, and `wrapping` versions are available for all
1291 integer primitives.
1292- [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1293 `PartialEq`.][61491]
1294- [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1295
1296Stabilized APIs
1297---------------
1298- [`<*const T>::cast`]
1299- [`<*mut T>::cast`]
1300- [`Duration::as_secs_f32`]
1301- [`Duration::as_secs_f64`]
416331ca
XL
1302- [`Duration::div_f32`]
1303- [`Duration::div_f64`]
1304- [`Duration::from_secs_f32`]
1305- [`Duration::from_secs_f64`]
1306- [`Duration::mul_f32`]
1307- [`Duration::mul_f64`]
1308- [`any::type_name`]
1309
1310Cargo
1311-----
1312- [Added pipelined compilation support to `cargo`.][cargo/7143]
1313- [You can now pass the `--features` option multiple times to enable
1314 multiple features.][cargo/7084]
1315
1316Misc
1317----
1318- [`rustc` will now warn about some incorrect uses of
1319 `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1320
1321Compatibility Notes
1322-------------------
e1599b0c
XL
1323- The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1324 1.38.0.
1325- The [`armv7-unknown-linux-gnueabihf` platform is known to have
1326 issues][62896] with certain crates such as libc.
416331ca
XL
1327
1328[60260]: https://github.com/rust-lang/rust/pull/60260/
1329[61457]: https://github.com/rust-lang/rust/pull/61457/
1330[61491]: https://github.com/rust-lang/rust/pull/61491/
1331[61884]: https://github.com/rust-lang/rust/pull/61884/
1332[61953]: https://github.com/rust-lang/rust/pull/61953/
1333[62042]: https://github.com/rust-lang/rust/pull/62042/
1334[62528]: https://github.com/rust-lang/rust/pull/62528/
1335[62583]: https://github.com/rust-lang/rust/pull/62583/
1336[62735]: https://github.com/rust-lang/rust/pull/62735/
1337[62766]: https://github.com/rust-lang/rust/pull/62766/
1338[62784]: https://github.com/rust-lang/rust/pull/62784/
1339[62785]: https://github.com/rust-lang/rust/issues/62785/
1340[62814]: https://github.com/rust-lang/rust/pull/62814/
1341[62896]: https://github.com/rust-lang/rust/issues/62896/
1342[63000]: https://github.com/rust-lang/rust/pull/63000/
1343[63056]: https://github.com/rust-lang/rust/pull/63056/
1344[63107]: https://github.com/rust-lang/rust/pull/63107/
1345[63346]: https://github.com/rust-lang/rust/pull/63346/
1346[63421]: https://github.com/rust-lang/rust/pull/63421/
1347[cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1348[cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1349[`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1350[`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1351[`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1352[`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
416331ca
XL
1353[`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1354[`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1355[`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1356[`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1357[`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1358[`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1359[`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
f9f354fc 1360[forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
416331ca
XL
1361[pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1362
dc9dc135
XL
1363Version 1.37.0 (2019-08-15)
1364==========================
1365
1366Language
1367--------
1368- `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1369 [`Box`][62228], or an [array][62235] and unused.
1370- [You can now use the `cfg` and `cfg_attr` attributes on
1371 generic parameters.][61547]
1372- [You can now use enum variants through type alias.][61682] e.g. You can
1373 write the following:
1374 ```rust
1375 type MyOption = Option<u8>;
1376
1377 fn increment_or_zero(x: MyOption) -> u8 {
1378 match x {
1379 MyOption::Some(y) => y + 1,
1380 MyOption::None => 0,
1381 }
1382 }
1383 ```
1384- [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1385 `const _: u32 = 5;`.
1386- [You can now use `#[repr(align(X)]` on enums.][61229]
416331ca 1387- [The `?` Kleene macro operator is now available in the
dc9dc135
XL
1388 2015 edition.][60932]
1389
1390Compiler
1391--------
1392- [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1393 and `-C profile-use` flags.][61268] For more information on how to use profile
1394 guided optimization, please refer to the [rustc book][rustc-book-pgo].
1395- [The `rust-lldb` wrapper script should now work again.][61827]
1396
1397Libraries
1398---------
1399- [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1400
1401Stabilized APIs
1402---------------
1403- [`BufReader::buffer`]
1404- [`BufWriter::buffer`]
1405- [`Cell::from_mut`]
1406- [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1407- [`DoubleEndedIterator::nth_back`]
1408- [`Option::xor`]
1409- [`Wrapping::reverse_bits`]
1410- [`i128::reverse_bits`]
1411- [`i16::reverse_bits`]
1412- [`i32::reverse_bits`]
1413- [`i64::reverse_bits`]
1414- [`i8::reverse_bits`]
1415- [`isize::reverse_bits`]
1416- [`slice::copy_within`]
1417- [`u128::reverse_bits`]
1418- [`u16::reverse_bits`]
1419- [`u32::reverse_bits`]
1420- [`u64::reverse_bits`]
1421- [`u8::reverse_bits`]
1422- [`usize::reverse_bits`]
1423
1424Cargo
1425-----
1426- [`Cargo.lock` files are now included by default when publishing executable crates
1427 with executables.][cargo/7026]
1428- [You can now specify `default-run="foo"` in `[package]` to specify the
1429 default executable to use for `cargo run`.][cargo/7056]
1430
1431Misc
1432----
1433
1434Compatibility Notes
1435-------------------
1436- [Using `...` for inclusive range patterns will now warn by default.][61342]
1437 Please transition your code to using the `..=` syntax for inclusive
1438 ranges instead.
1439- [Using a trait object without the `dyn` will now warn by default.][61203]
1440 Please transition your code to use `dyn Trait` for trait objects instead.
1441
1442[62228]: https://github.com/rust-lang/rust/pull/62228/
1443[62235]: https://github.com/rust-lang/rust/pull/62235/
1444[61802]: https://github.com/rust-lang/rust/pull/61802/
1445[61827]: https://github.com/rust-lang/rust/pull/61827/
1446[61547]: https://github.com/rust-lang/rust/pull/61547/
1447[61682]: https://github.com/rust-lang/rust/pull/61682/
1448[61268]: https://github.com/rust-lang/rust/pull/61268/
1449[61342]: https://github.com/rust-lang/rust/pull/61342/
1450[61347]: https://github.com/rust-lang/rust/pull/61347/
1451[61100]: https://github.com/rust-lang/rust/pull/61100/
1452[61203]: https://github.com/rust-lang/rust/pull/61203/
1453[61229]: https://github.com/rust-lang/rust/pull/61229/
1454[60932]: https://github.com/rust-lang/rust/pull/60932/
1455[cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1456[cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1457[`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1458[`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1459[`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1460[`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1461[`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1462[`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1463[`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1464[`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1465[`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1466[`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1467[`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1468[`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1469[`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1470[`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1471[`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1472[`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1473[`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1474[`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1475[`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1476[`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1477[`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1478[rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1479
1480
48663c56
XL
1481Version 1.36.0 (2019-07-04)
1482==========================
1483
1484Language
1485--------
1486- [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1487- [The order of traits in trait objects no longer affects the semantics of that
1488 object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1489 `dyn fmt::Debug + Send`, where this was previously not the case.
1490
1491Libraries
1492---------
1493- [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1494- [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1495- [`mem::needs_drop` is now available as a const fn.][60364]
1496- [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1497- [`String` now implements `BorrowMut<str>`.][60404]
1498- [`io::Cursor` now implements `Default`.][60234]
1499- [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1500- [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1501 of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1502 environment has access to heap memory allocation.
1503- [`String` now implements `From<&String>`.][59825]
1504- [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1505 return a tuple of each argument when there is multiple arguments.
1506- [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1507 not used.][59648]
1508
1509Stabilized APIs
1510---------------
1511- [`VecDeque::rotate_left`]
1512- [`VecDeque::rotate_right`]
1513- [`Iterator::copied`]
1514- [`io::IoSlice`]
1515- [`io::IoSliceMut`]
1516- [`Read::read_vectored`]
1517- [`Write::write_vectored`]
1518- [`str::as_mut_ptr`]
1519- [`mem::MaybeUninit`]
1520- [`pointer::align_offset`]
1521- [`future::Future`]
1522- [`task::Context`]
1523- [`task::RawWaker`]
1524- [`task::RawWakerVTable`]
1525- [`task::Waker`]
1526- [`task::Poll`]
1527
1528Cargo
1529-----
1530- [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1531- [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1532
1533You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1534
1535Clippy
1536------
1537There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1538
1539Misc
1540----
1541
1542Compatibility Notes
1543-------------------
48663c56 1544- With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
416331ca 1545 longer recommended, and will be deprecated in 1.39.0.
48663c56
XL
1546
1547[60318]: https://github.com/rust-lang/rust/pull/60318/
1548[60364]: https://github.com/rust-lang/rust/pull/60364/
1549[60370]: https://github.com/rust-lang/rust/pull/60370/
1550[60404]: https://github.com/rust-lang/rust/pull/60404/
1551[60234]: https://github.com/rust-lang/rust/pull/60234/
1552[60244]: https://github.com/rust-lang/rust/pull/60244/
1553[58623]: https://github.com/rust-lang/rust/pull/58623/
1554[59648]: https://github.com/rust-lang/rust/pull/59648/
1555[59675]: https://github.com/rust-lang/rust/pull/59675/
1556[59825]: https://github.com/rust-lang/rust/pull/59825/
1557[59826]: https://github.com/rust-lang/rust/pull/59826/
1558[59445]: https://github.com/rust-lang/rust/pull/59445/
1559[59114]: https://github.com/rust-lang/rust/pull/59114/
1560[cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1561[cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1562[`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1563[`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1564[`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1565[`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1566[`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1567[`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1568[`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1569[`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1570[`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1571[`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1572[`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1573[`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1574[`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1575[`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1576[`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1577[`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1578[clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1579[cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
416331ca 1580
48663c56 1581
532ac7d7
XL
1582Version 1.35.0 (2019-05-23)
1583==========================
1584
1585Language
1586--------
1587- [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1588 `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1589- [You can now coerce closures into unsafe function pointers.][59580] e.g.
1590 ```rust
1591 unsafe fn call_unsafe(func: unsafe fn()) {
1592 func()
1593 }
1594
1595 pub fn main() {
1596 unsafe { call_unsafe(|| {}); }
1597 }
1598 ```
1599
1600
1601Compiler
1602--------
1603- [Added the `armv6-unknown-freebsd-gnueabihf` and
1604 `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1605- [Added the `wasm32-unknown-wasi` target.][59464]
1606
1607
1608Libraries
1609---------
1610- [`Thread` will now show its ID in `Debug` output.][59460]
1611- [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1612- [`alloc::System` now implements `Default`.][59451]
1613- [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1614 last field.][59076]
1615- [`char::{ToLowercase, ToUppercase}` now
1616 implement `ExactSizeIterator`.][58778]
1617- [All `NonZero` numeric types now implement `FromStr`.][58717]
1618- [Removed the `Read` trait bounds
1619 on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1620- [You can now call the `dbg!` macro without any parameters to print the file
1621 and line where it is called.][57847]
1622- [In place ASCII case conversions are now up to 4× faster.][59283]
1623 e.g. `str::make_ascii_lowercase`
1624- [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1625 and `Send`.][58369]
1626
1627Stabilized APIs
1628---------------
1629- [`f32::copysign`]
1630- [`f64::copysign`]
1631- [`RefCell::replace_with`]
1632- [`RefCell::map_split`]
1633- [`ptr::hash`]
1634- [`Range::contains`]
1635- [`RangeFrom::contains`]
1636- [`RangeTo::contains`]
1637- [`RangeInclusive::contains`]
1638- [`RangeToInclusive::contains`]
1639- [`Option::copied`]
1640
1641Cargo
1642-----
1643- [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1644 linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1645 platform specific.
48663c56 1646
532ac7d7
XL
1647Misc
1648----
1649- [The Rust toolchain is now available natively for musl based distros.][58575]
1650
1651[59460]: https://github.com/rust-lang/rust/pull/59460/
1652[59464]: https://github.com/rust-lang/rust/pull/59464/
1653[59500]: https://github.com/rust-lang/rust/pull/59500/
1654[59512]: https://github.com/rust-lang/rust/pull/59512/
1655[59580]: https://github.com/rust-lang/rust/pull/59580/
1656[59283]: https://github.com/rust-lang/rust/pull/59283/
1657[59451]: https://github.com/rust-lang/rust/pull/59451/
1658[59076]: https://github.com/rust-lang/rust/pull/59076/
1659[58778]: https://github.com/rust-lang/rust/pull/58778/
1660[58717]: https://github.com/rust-lang/rust/pull/58717/
1661[58369]: https://github.com/rust-lang/rust/pull/58369/
1662[58423]: https://github.com/rust-lang/rust/pull/58423/
1663[58080]: https://github.com/rust-lang/rust/pull/58080/
1664[57847]: https://github.com/rust-lang/rust/pull/57847/
1665[58575]: https://github.com/rust-lang/rust/pull/58575
1666[cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1667[`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1668[`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1669[`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1670[`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1671[`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1672[`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1673[`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1674[`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1675[`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1676[`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1677[`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1678
9fa01778
XL
1679Version 1.34.2 (2019-05-14)
1680===========================
1681
1682* [Destabilize the `Error::type_id` function due to a security
532ac7d7 1683 vulnerability][60785] ([CVE-2019-12083])
9fa01778
XL
1684
1685[60785]: https://github.com/rust-lang/rust/pull/60785
532ac7d7 1686[CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
9fa01778
XL
1687
1688Version 1.34.1 (2019-04-25)
1689===========================
1690
1691* [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1692* [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1693* [Fix Clippy panic when checking some macros][clippy/3805]
1694
1695[clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1696[clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1697[clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1698
1699Version 1.34.0 (2019-04-11)
1700==========================
1701
1702Language
1703--------
1704- [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1705 `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1706 but had no effect.
1707- [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1708 `#[attr{}]` procedural macros.][57367]
1709- [You can now write `extern crate self as foo;`][57407] to import your
1710 crate's root into the extern prelude.
1711
1712
1713Compiler
1714--------
1715- [You can now target `riscv64imac-unknown-none-elf` and
1716 `riscv64gc-unknown-none-elf`.][58406]
1717- [You can now enable linker plugin LTO optimisations with
1718 `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1719 into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1720 boundaries.
1721- [You can now target `powerpc64-unknown-freebsd`.][57809]
1722
1723
1724Libraries
1725---------
1726- [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1727 `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1728 the `Hash` trait to create an iterator.
1729- [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1730 methods.][58421] Most notably you no longer require the `Ord` trait to create
1731 an iterator.
1732- [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1733 for all numeric types.][58044]
1734- [Indexing a `str` is now generic over all types that
1735 implement `SliceIndex<str>`.][57604]
1736- [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1737 `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1738 produce a warning if their returning type is unused.
1739- [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1740 `overflowing_pow` are now available for all numeric types.][57873] These are
dc9dc135 1741 equivalent to methods such as `wrapping_add` for the `pow` operation.
9fa01778
XL
1742
1743
1744Stabilized APIs
1745---------------
1746
1747#### std & core
1748* [`Any::type_id`]
1749* [`Error::type_id`]
1750* [`atomic::AtomicI16`]
1751* [`atomic::AtomicI32`]
1752* [`atomic::AtomicI64`]
1753* [`atomic::AtomicI8`]
1754* [`atomic::AtomicU16`]
1755* [`atomic::AtomicU32`]
1756* [`atomic::AtomicU64`]
1757* [`atomic::AtomicU8`]
1758* [`convert::Infallible`]
1759* [`convert::TryFrom`]
1760* [`convert::TryInto`]
1761* [`iter::from_fn`]
1762* [`iter::successors`]
1763* [`num::NonZeroI128`]
1764* [`num::NonZeroI16`]
1765* [`num::NonZeroI32`]
1766* [`num::NonZeroI64`]
1767* [`num::NonZeroI8`]
1768* [`num::NonZeroIsize`]
1769* [`slice::sort_by_cached_key`]
1770* [`str::escape_debug`]
1771* [`str::escape_default`]
1772* [`str::escape_unicode`]
1773* [`str::split_ascii_whitespace`]
1774
1775#### std
1776* [`Instant::checked_add`]
1777* [`Instant::checked_sub`]
1778* [`SystemTime::checked_add`]
1779* [`SystemTime::checked_sub`]
1780
1781Cargo
1782-----
1783- [You can now use alternative registries to crates.io.][cargo/6654]
1784
1785Misc
1786----
1787- [You can now use the `?` operator in your documentation tests without manually
1788 adding `fn main() -> Result<(), _> {}`.][56470]
1789
1790Compatibility Notes
1791-------------------
dc9dc135
XL
1792- [`Command::before_exec` is being replaced by the unsafe method
1793 `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1794- [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
9fa01778
XL
1795 can now use `const` functions in `static` variables.
1796
1797[58370]: https://github.com/rust-lang/rust/pull/58370/
1798[58406]: https://github.com/rust-lang/rust/pull/58406/
1799[58421]: https://github.com/rust-lang/rust/pull/58421/
1800[58166]: https://github.com/rust-lang/rust/pull/58166/
1801[58044]: https://github.com/rust-lang/rust/pull/58044/
1802[58057]: https://github.com/rust-lang/rust/pull/58057/
1803[58059]: https://github.com/rust-lang/rust/pull/58059/
1804[57809]: https://github.com/rust-lang/rust/pull/57809/
1805[57873]: https://github.com/rust-lang/rust/pull/57873/
1806[57604]: https://github.com/rust-lang/rust/pull/57604/
1807[57367]: https://github.com/rust-lang/rust/pull/57367/
1808[57407]: https://github.com/rust-lang/rust/pull/57407/
1809[57425]: https://github.com/rust-lang/rust/pull/57425/
1810[57106]: https://github.com/rust-lang/rust/pull/57106/
1811[56470]: https://github.com/rust-lang/rust/pull/56470/
1812[cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1813[`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1814[`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1815[`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1816[`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1817[`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1818[`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1819[`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1820[`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1821[`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1822[`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1823[`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1824[`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1825[`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1826[`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1827[`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1828[`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1829[`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1830[`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1831[`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1832[`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1833[`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1834[`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1835[`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1836[`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1837[`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1838[`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1839[`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1840[`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1841[`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1842[`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1843
1844
0731742a
XL
1845Version 1.33.0 (2019-02-28)
1846==========================
1847
1848Language
1849--------
1850- [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1851 `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1852- [Integer patterns such as in a match expression can now be exhaustive.][56362]
1853 E.g. You can have match statement on a `u8` that covers `0..=255` and
1854 you would no longer be required to have a `_ => unreachable!()` case.
1855- [You can now have multiple patterns in `if let` and `while let`
1856 expressions.][57532] You can do this with the same syntax as a `match`
1857 expression. E.g.
1858 ```rust
1859 enum Creature {
1860 Crab(String),
1861 Lobster(String),
1862 Person(String),
1863 }
1864
1865 fn main() {
1866 let state = Creature::Crab("Ferris");
1867
1868 if let Creature::Crab(name) | Creature::Person(name) = state {
1869 println!("This creature's name is: {}", name);
1870 }
1871 }
1872 ```
1873- [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1874 this feature will by default produce a warning as this behaviour can be
1875 unintuitive. E.g. `if let _ = 5 {}`
1876- [You can now use `let` bindings, assignments, expression statements,
1877 and irrefutable pattern destructuring in const functions.][57175]
1878- [You can now call unsafe const functions.][57067] E.g.
1879 ```rust
1880 const unsafe fn foo() -> i32 { 5 }
1881 const fn bar() -> i32 {
1882 unsafe { foo() }
1883 }
1884 ```
1885- [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1886 E.g. `#[cfg_attr(all(), must_use, optimize)]`
1887- [You can now specify a specific alignment with the `#[repr(packed)]`
1888 attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1889 with an alignment of 2 bytes and a size of 6 bytes.
1890- [You can now import an item from a module as an `_`.][56303] This allows you to
1891 import a trait's impls, and not have the name in the namespace. E.g.
1892 ```rust
1893 use std::io::Read as _;
1894
1895 // Allowed as there is only one `Read` in the module.
1896 pub trait Read {}
1897 ```
1898- [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1899
1900Compiler
1901--------
1902- [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1903 command line argument.][56351]
416331ca 1904- [The minimum required LLVM version has been bumped to 6.0.][56642]
0731742a
XL
1905- [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1906- [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1907 tier 2 support.][57130] Visit the [platform support][platform-support] page for
1908 information on Rust's platform support.
1909- [Added support for the `thumbv7neon-linux-androideabi` and
1910 `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1911- [Added support for the `x86_64-unknown-uefi` target.][56769]
1912
1913Libraries
1914---------
1915- [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1916 functions for all numeric types.][57566]
1917- [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1918 are now `const` functions for all numeric types.][57105]
1919- [The methods `is_positive` and `is_negative` are now `const` functions for
1920 all signed numeric types.][57105]
1921- [The `get` method for all `NonZero` types is now `const`.][57167]
1922- [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1923 `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1924 numeric types.][57234]
1925- [`Ipv4Addr::new` is now a `const` function][57234]
1926
1927Stabilized APIs
1928---------------
1929- [`unix::FileExt::read_exact_at`]
1930- [`unix::FileExt::write_all_at`]
1931- [`Option::transpose`]
1932- [`Result::transpose`]
1933- [`convert::identity`]
1934- [`pin::Pin`]
1935- [`marker::Unpin`]
1936- [`marker::PhantomPinned`]
1937- [`Vec::resize_with`]
1938- [`VecDeque::resize_with`]
1939- [`Duration::as_millis`]
1940- [`Duration::as_micros`]
1941- [`Duration::as_nanos`]
1942
1943
1944Cargo
1945-----
9fa01778
XL
1946- [You can now publish crates that require a feature flag to compile with
1947 `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
0731742a
XL
1948- [Cargo should now rebuild a crate if a file was modified during the initial
1949 build.][cargo/6484]
1950
1951Compatibility Notes
1952-------------------
1953- The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1954 are now deprecated in the standard library, and their usage will now produce a warning.
1955 Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1956 methods instead.
1957- The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1958 downcasting.
9fa01778
XL
1959- [Libtest no longer creates a new thread for each test when
1960 `--test-threads=1`. It also runs the tests in deterministic order][56243]
0731742a
XL
1961
1962[55982]: https://github.com/rust-lang/rust/pull/55982/
9fa01778 1963[56243]: https://github.com/rust-lang/rust/pull/56243
0731742a
XL
1964[56303]: https://github.com/rust-lang/rust/pull/56303/
1965[56351]: https://github.com/rust-lang/rust/pull/56351/
1966[56362]: https://github.com/rust-lang/rust/pull/56362
1967[56642]: https://github.com/rust-lang/rust/pull/56642/
1968[56769]: https://github.com/rust-lang/rust/pull/56769/
1969[56805]: https://github.com/rust-lang/rust/pull/56805
1970[56947]: https://github.com/rust-lang/rust/pull/56947/
1971[57049]: https://github.com/rust-lang/rust/pull/57049/
1972[57067]: https://github.com/rust-lang/rust/pull/57067/
1973[57105]: https://github.com/rust-lang/rust/pull/57105
1974[57130]: https://github.com/rust-lang/rust/pull/57130/
1975[57167]: https://github.com/rust-lang/rust/pull/57167/
1976[57175]: https://github.com/rust-lang/rust/pull/57175/
1977[57234]: https://github.com/rust-lang/rust/pull/57234/
1978[57332]: https://github.com/rust-lang/rust/pull/57332/
1979[57465]: https://github.com/rust-lang/rust/pull/57465/
1980[57532]: https://github.com/rust-lang/rust/pull/57532/
1981[57535]: https://github.com/rust-lang/rust/pull/57535/
1982[57566]: https://github.com/rust-lang/rust/pull/57566/
1983[57615]: https://github.com/rust-lang/rust/pull/57615/
9fa01778 1984[cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
0731742a
XL
1985[cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1986[`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1987[`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1988[`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1989[`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1990[`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1991[`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1992[`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1993[`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1994[`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1995[`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1996[`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1997[`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1998[`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1999[platform-support]: https://forge.rust-lang.org/platform-support.html
2000
69743fb6
XL
2001Version 1.32.0 (2019-01-17)
2002==========================
2003
2004Language
2005--------
2006#### 2018 edition
2007- [You can now use the `?` operator in macro definitions.][56245] The `?`
2008 operator allows you to specify zero or one repetitions similar to the `*` and
2009 `+` operators.
2010- [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2011 now always resolve to the item (`enum`, `struct`, etc.) available in the
2012 module if present, before resolving to a external crate or an item the prelude.][56759]
2013 E.g.
2014 ```rust
2015 enum Color { Red, Green, Blue }
2016
2017 use Color::*;
2018 ```
2019
2020#### All editions
2021- [You can now match against `PhantomData<T>` types.][55837]
2022- [You can now match against literals in macros with the `literal`
2023 specifier.][56072] This will match against a literal of any type.
2024 E.g. `1`, `'A'`, `"Hello World"`
0731742a 2025- [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
69743fb6
XL
2026 ```rust
2027 struct Point(i32, i32);
2028
2029 impl Point {
2030 pub fn new(x: i32, y: i32) -> Self {
2031 Self(x, y)
2032 }
2033
2034 pub fn is_origin(&self) -> bool {
2035 match self {
2036 Self(0, 0) => true,
2037 _ => false,
2038 }
2039 }
2040 }
2041 ```
2042- [Self can also now be used in type definitions.][56366] E.g.
2043 ```rust
2044 enum List<T>
2045 where
2046 Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2047 {
2048 Nil,
2049 Cons(T, Box<Self>) // likewise here
2050 }
2051 ```
2052- [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2053 a `impl Trait` or `dyn Trait` is returned and unused in the program.
2054
2055Compiler
2056--------
2057- [The default allocator has changed from jemalloc to the default allocator on
2058 your system.][55238] The compiler itself on Linux & macOS will still use
2059 jemalloc, but programs compiled with it will use the system allocator.
2060- [Added the `aarch64-pc-windows-msvc` target.][55702]
2061
2062Libraries
2063---------
2064- [`PathBuf` now implements `FromStr`.][55148]
2065- [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2066- [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2067 easily debug expressions in your rust program. E.g.
2068 ```rust
2069 let a = 2;
2070 let b = dbg!(a * 2) + 1;
2071 // ^-- prints: [src/main.rs:4] a * 2 = 4
2072 assert_eq!(b, 5);
2073 ```
2074
2075The following APIs are now `const` functions and can be used in a
2076`const` context.
2077
2078- [`Cell::as_ptr`]
2079- [`UnsafeCell::get`]
2080- [`char::is_ascii`]
2081- [`iter::empty`]
2082- [`ManuallyDrop::new`]
2083- [`ManuallyDrop::into_inner`]
2084- [`RangeInclusive::start`]
2085- [`RangeInclusive::end`]
2086- [`NonNull::as_ptr`]
2087- [`slice::as_ptr`]
2088- [`str::as_ptr`]
2089- [`Duration::as_secs`]
2090- [`Duration::subsec_millis`]
2091- [`Duration::subsec_micros`]
2092- [`Duration::subsec_nanos`]
2093- [`CStr::as_ptr`]
2094- [`Ipv4Addr::is_unspecified`]
2095- [`Ipv6Addr::new`]
2096- [`Ipv6Addr::octets`]
2097
2098Stabilized APIs
2099---------------
2100- [`i8::to_be_bytes`]
2101- [`i8::to_le_bytes`]
2102- [`i8::to_ne_bytes`]
2103- [`i8::from_be_bytes`]
2104- [`i8::from_le_bytes`]
2105- [`i8::from_ne_bytes`]
2106- [`i16::to_be_bytes`]
2107- [`i16::to_le_bytes`]
2108- [`i16::to_ne_bytes`]
2109- [`i16::from_be_bytes`]
2110- [`i16::from_le_bytes`]
2111- [`i16::from_ne_bytes`]
2112- [`i32::to_be_bytes`]
2113- [`i32::to_le_bytes`]
2114- [`i32::to_ne_bytes`]
2115- [`i32::from_be_bytes`]
2116- [`i32::from_le_bytes`]
2117- [`i32::from_ne_bytes`]
2118- [`i64::to_be_bytes`]
2119- [`i64::to_le_bytes`]
2120- [`i64::to_ne_bytes`]
2121- [`i64::from_be_bytes`]
2122- [`i64::from_le_bytes`]
2123- [`i64::from_ne_bytes`]
2124- [`i128::to_be_bytes`]
2125- [`i128::to_le_bytes`]
2126- [`i128::to_ne_bytes`]
2127- [`i128::from_be_bytes`]
2128- [`i128::from_le_bytes`]
2129- [`i128::from_ne_bytes`]
2130- [`isize::to_be_bytes`]
2131- [`isize::to_le_bytes`]
2132- [`isize::to_ne_bytes`]
2133- [`isize::from_be_bytes`]
2134- [`isize::from_le_bytes`]
2135- [`isize::from_ne_bytes`]
2136- [`u8::to_be_bytes`]
2137- [`u8::to_le_bytes`]
2138- [`u8::to_ne_bytes`]
2139- [`u8::from_be_bytes`]
2140- [`u8::from_le_bytes`]
2141- [`u8::from_ne_bytes`]
2142- [`u16::to_be_bytes`]
2143- [`u16::to_le_bytes`]
2144- [`u16::to_ne_bytes`]
2145- [`u16::from_be_bytes`]
2146- [`u16::from_le_bytes`]
2147- [`u16::from_ne_bytes`]
2148- [`u32::to_be_bytes`]
2149- [`u32::to_le_bytes`]
2150- [`u32::to_ne_bytes`]
2151- [`u32::from_be_bytes`]
2152- [`u32::from_le_bytes`]
2153- [`u32::from_ne_bytes`]
2154- [`u64::to_be_bytes`]
2155- [`u64::to_le_bytes`]
2156- [`u64::to_ne_bytes`]
2157- [`u64::from_be_bytes`]
2158- [`u64::from_le_bytes`]
2159- [`u64::from_ne_bytes`]
2160- [`u128::to_be_bytes`]
2161- [`u128::to_le_bytes`]
2162- [`u128::to_ne_bytes`]
2163- [`u128::from_be_bytes`]
2164- [`u128::from_le_bytes`]
2165- [`u128::from_ne_bytes`]
2166- [`usize::to_be_bytes`]
2167- [`usize::to_le_bytes`]
2168- [`usize::to_ne_bytes`]
2169- [`usize::from_be_bytes`]
2170- [`usize::from_le_bytes`]
2171- [`usize::from_ne_bytes`]
2172
2173Cargo
2174-----
2175- [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2176- [Usernames are now allowed in alt registry URLs.][cargo/6242]
2177
2178Misc
2179----
2180- [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2181
2182Compatibility Notes
2183-------------------
2184- [The argument types for AVX's
2185 `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2186 been changed from `*const` to `*mut` as the previous implementation
2187 was unsound.
2188
2189
2190[55148]: https://github.com/rust-lang/rust/pull/55148/
2191[55238]: https://github.com/rust-lang/rust/pull/55238/
2192[55280]: https://github.com/rust-lang/rust/pull/55280/
2193[55610]: https://github.com/rust-lang/rust/pull/55610/
2194[55663]: https://github.com/rust-lang/rust/pull/55663/
2195[55702]: https://github.com/rust-lang/rust/pull/55702/
2196[55837]: https://github.com/rust-lang/rust/pull/55837/
2197[55843]: https://github.com/rust-lang/rust/pull/55843/
2198[56072]: https://github.com/rust-lang/rust/pull/56072/
2199[56245]: https://github.com/rust-lang/rust/pull/56245/
2200[56365]: https://github.com/rust-lang/rust/pull/56365/
2201[56366]: https://github.com/rust-lang/rust/pull/56366/
2202[56395]: https://github.com/rust-lang/rust/pull/56395/
2203[56759]: https://github.com/rust-lang/rust/pull/56759/
2204[cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2205[cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2206[`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2207[`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2208[`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2209[`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2210[`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2211[`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2212[`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2213[`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2214[`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2215[`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2216[`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2217[`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2218[`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2219[`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2220[`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2221[`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2222[`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2223[`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2224[`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2225[`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2226[`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2227[`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2228[`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2229[`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2230[`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2231[`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2232[`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2233[`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2234[`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2235[`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2236[`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2237[`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2238[`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2239[`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2240[`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2241[`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2242[`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
2243[`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
2244[`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
2245[`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
2246[`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
2247[`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
2248[`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
2249[`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
2250[`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
2251[`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
2252[`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
2253[`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
2254[`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
2255[`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
2256[`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
2257[`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
2258[`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
2259[`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
2260[`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
2261[`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
2262[`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
2263[`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
2264[`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
2265[`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
2266[`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
2267[`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
2268[`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
2269[`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
2270[`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
2271[`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2272[`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2273[`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2274[`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2275[`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2276[`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2277[`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2278[`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2279[`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2280[`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2281[`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2282[`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2283[`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2284[`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2285[`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2286[`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2287[`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2288[`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2289[`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2290[`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2291[`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2292[`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2293[`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2294[`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2295[`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2296[`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2297
2298
2299Version 1.31.1 (2018-12-20)
2300===========================
2301
2302- [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2303- [Fix broken go-to-definition in RLS][rls/1171]
2304- [Fix infinite loop on hover in RLS][rls/1170]
2305
2306[56562]: https://github.com/rust-lang/rust/pull/56562
2307[rls/1171]: https://github.com/rust-lang/rls/issues/1171
2308[rls/1170]: https://github.com/rust-lang/rls/pull/1170
2309
13cf67c4
XL
2310Version 1.31.0 (2018-12-06)
2311==========================
2312
2313Language
2314--------
0731742a 2315- 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
13cf67c4
XL
2316- [New lifetime elision rules now allow for eliding lifetimes in functions and
2317 impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2318 `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2319 in structs.
2320- [You can now define and use `const` functions.][54835] These are currently
2321 a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2322 [language reference][const-reference] for what exactly is available.
2323- [You can now use tool lints, which allow you to scope lints from external
2324 tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2325- [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2326 a crate, not just in exported functions.][54451]
2327- [You can now use parentheses in pattern matches.][54497]
2328
2329Compiler
2330--------
2331- [Updated musl to 1.1.20][54430]
2332
2333Libraries
2334---------
416331ca 2335- [You can now convert `num::NonZero*` types to their raw equivalents using the
13cf67c4
XL
2336 `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2337- [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2338 into `Option<&mut T>` using the `From` trait.][53218]
2339- [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2340
2341
2342Stabilized APIs
2343---------------
2344- [`slice::align_to`]
2345- [`slice::align_to_mut`]
2346- [`slice::chunks_exact`]
2347- [`slice::chunks_exact_mut`]
2348- [`slice::rchunks`]
2349- [`slice::rchunks_mut`]
2350- [`slice::rchunks_exact`]
2351- [`slice::rchunks_exact_mut`]
2352- [`Option::replace`]
2353
2354Cargo
2355-----
2356- [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2357- [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2358 on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2359
2360[52813]: https://github.com/rust-lang/rust/pull/52813/
2361[53218]: https://github.com/rust-lang/rust/pull/53218/
2362[53555]: https://github.com/rust-lang/rust/issues/53555/
2363[54057]: https://github.com/rust-lang/rust/pull/54057/
2364[54240]: https://github.com/rust-lang/rust/pull/54240/
2365[54430]: https://github.com/rust-lang/rust/pull/54430/
2366[54451]: https://github.com/rust-lang/rust/pull/54451/
2367[54497]: https://github.com/rust-lang/rust/pull/54497/
2368[54778]: https://github.com/rust-lang/rust/pull/54778/
2369[54835]: https://github.com/rust-lang/rust/pull/54835/
2370[54870]: https://github.com/rust-lang/rust/pull/54870/
2371[RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2372[`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2373[`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2374[`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2375[`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2376[`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2377[`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2378[`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2379[`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2380[`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2381[cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2382[cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2383[cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2384[const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2385
2386Version 1.30.1 (2018-11-08)
2387===========================
2388
2389- [Fixed overflow ICE in rustdoc][54199]
2390- [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2391
2392[54199]: https://github.com/rust-lang/rust/pull/54199
2393[cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2394
4462d4a0
XL
2395Version 1.30.0 (2018-10-25)
2396==========================
2397
2398Language
2399--------
2400- [Procedural macros are now available.][52081] These kinds of macros allow for
2401 more powerful code generation. There is a [new chapter available][proc-macros]
2402 in the Rust Programming Language book that goes further in depth.
2403- [You can now use keywords as identifiers using the raw identifiers
2404 syntax (`r#`),][53236] e.g. `let r#for = true;`
2405- [Using anonymous parameters in traits is now deprecated with a warning and
2406 will be a hard error in the 2018 edition.][53272]
2407- [You can now use `crate` in paths.][54404] This allows you to refer to the
2408 crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2409- [Using a external crate no longer requires being prefixed with `::`.][54404]
2410 Previously, using a external crate in a module without a use statement
2411 required `let json = ::serde_json::from_str(foo);` but can now be written
2412 as `let json = serde_json::from_str(foo);`.
2413- [You can now apply the `#[used]` attribute to static items to prevent the
2414 compiler from optimising them away, even if they appear to be unused,][51363]
2415 e.g. `#[used] static FOO: u32 = 1;`
2416- [You can now import and reexport macros from other crates with the `use`
2417 syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2418 the root module of the crate. If your macro relies on calling other local
2419 macros, it is recommended to export with the
2420 `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2421 those macros.
2422- [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2423 using the `vis` specifier.][53370]
2424- [Non-macro attributes now allow all forms of literals, not just
2425 strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2426 write `#[attr(true)]`.
2427- [You can now specify a function to handle a panic in the Rust runtime with the
2428 `#[panic_handler]` attribute.][51366]
2429
2430Compiler
2431--------
2432- [Added the `riscv32imc-unknown-none-elf` target.][53822]
2433- [Added the `aarch64-unknown-netbsd` target][53165]
2434
2435Libraries
2436---------
2437- [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2438
2439Stabilized APIs
2440---------------
2441- [`Ipv4Addr::BROADCAST`]
2442- [`Ipv4Addr::LOCALHOST`]
2443- [`Ipv4Addr::UNSPECIFIED`]
2444- [`Ipv6Addr::LOCALHOST`]
2445- [`Ipv6Addr::UNSPECIFIED`]
2446- [`Iterator::find_map`]
2447
2448 The following methods are replacement methods for `trim_left`, `trim_right`,
2449 `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2450 in 1.33.0:
2451- [`str::trim_end_matches`]
2452- [`str::trim_end`]
2453- [`str::trim_start_matches`]
2454- [`str::trim_start`]
2455
2456Cargo
2457----
2458- [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2459- [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2460 equivalent to calling `rustdoc --error-format=json`.
4462d4a0
XL
2461- [Cargo will now provide a progress bar for builds.][cargo/5995]
2462
2463Misc
2464----
2465- [`rustdoc` allows you to specify what edition to treat your code as with the
2466 `--edition` option.][54057]
2467- [`rustdoc` now has the `--color` (specify whether to output color) and
2468 `--error-format` (specify error format, e.g. `json`) options.][53003]
2469- [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2470 debug symbols.][53774]
2471- [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2472 available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2473
2474[50911]: https://github.com/rust-lang/rust/pull/50911/
2475[51363]: https://github.com/rust-lang/rust/pull/51363/
2476[51366]: https://github.com/rust-lang/rust/pull/51366/
2477[52081]: https://github.com/rust-lang/rust/pull/52081/
2478[53003]: https://github.com/rust-lang/rust/pull/53003/
2479[53033]: https://github.com/rust-lang/rust/pull/53033/
2480[53044]: https://github.com/rust-lang/rust/pull/53044/
2481[53165]: https://github.com/rust-lang/rust/pull/53165/
2482[53213]: https://github.com/rust-lang/rust/pull/53213/
2483[53236]: https://github.com/rust-lang/rust/pull/53236/
2484[53272]: https://github.com/rust-lang/rust/pull/53272/
2485[53370]: https://github.com/rust-lang/rust/pull/53370/
2486[53459]: https://github.com/rust-lang/rust/pull/53459/
2487[53774]: https://github.com/rust-lang/rust/pull/53774/
2488[53822]: https://github.com/rust-lang/rust/pull/53822/
2489[54057]: https://github.com/rust-lang/rust/pull/54057/
2490[54146]: https://github.com/rust-lang/rust/pull/54146/
2491[54404]: https://github.com/rust-lang/rust/pull/54404/
2492[cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2493[cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4462d4a0 2494[cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
a1dfa0c6 2495[proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4462d4a0
XL
2496
2497[`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2498[`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2499[`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2500[`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2501[`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2502[`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2503[`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2504[`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2505[`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2506[`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2507
2508
2509Version 1.29.2 (2018-10-11)
2510===========================
2511
2512- [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2513- The `rls-preview` component on the windows-gnu targets has been restored.
2514
2515[54639]: https://github.com/rust-lang/rust/pull/54639
2516
2517
2518Version 1.29.1 (2018-09-25)
2519===========================
2520
2521Security Notes
2522--------------
2523
2524- The standard library's `str::repeat` function contained an out of bounds write
2525 caused by an integer overflow. This has been fixed by deterministically
2526 panicking when an overflow happens.
2527
416331ca 2528 Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4462d4a0
XL
2529 us.
2530
2531
8faf50e0
XL
2532Version 1.29.0 (2018-09-13)
2533==========================
2534
2535Compiler
2536--------
2537- [Bumped minimum LLVM version to 5.0.][51899]
2538- [Added `powerpc64le-unknown-linux-musl` target.][51619]
2539- [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2540
2541Libraries
2542---------
4462d4a0 2543- [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
8faf50e0
XL
2544- [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2545- [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2546- [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2547 for `&str`.][51178]
2548- [`Cell<T>` now allows `T` to be unsized.][50494]
2549- [`SocketAddr` is now stable on Redox.][52656]
2550
2551Stabilized APIs
2552---------------
2553- [`Arc::downcast`]
2554- [`Iterator::flatten`]
2555- [`Rc::downcast`]
2556
2557Cargo
2558-----
4462d4a0
XL
2559- [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2560 `--locked` to disable this behavior.
8faf50e0 2561- [`cargo-install` will now allow you to cross compile an install
4462d4a0 2562 using `--target`.][cargo/5614]
8faf50e0
XL
2563- [Added the `cargo-fix` subcommand to automatically move project code from
2564 2015 edition to 2018.][cargo/5723]
b7449926
XL
2565- [`cargo doc` can now optionally document private types using the
2566 `--document-private-items` flag.][cargo/5543]
8faf50e0
XL
2567
2568Misc
2569----
2570- [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2571 the specified level to that level.][52354] For example `--cap-lints warn`
2572 will demote `deny` and `forbid` lints to `warn`.
2573- [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4462d4a0 2574 fails and `101` if there is a panic.][52197]
8faf50e0 2575- [A preview of clippy has been made available through rustup.][51122]
4462d4a0 2576 You can install the preview with `rustup component add clippy-preview`.
8faf50e0
XL
2577
2578Compatibility Notes
2579-------------------
2580- [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2581 Use `str::get_unchecked(begin..end)` instead.
4462d4a0 2582- [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
8faf50e0
XL
2583 Consider using the `home_dir` function from
2584 https://crates.io/crates/dirs instead.
2585- [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4462d4a0
XL
2586- [`cfg` attributes and `--cfg` command line flags are now more
2587 strictly validated.][53893]
8faf50e0 2588
4462d4a0 2589[53893]: https://github.com/rust-lang/rust/pull/53893/
8faf50e0
XL
2590[52861]: https://github.com/rust-lang/rust/pull/52861/
2591[52656]: https://github.com/rust-lang/rust/pull/52656/
2592[52239]: https://github.com/rust-lang/rust/pull/52239/
2593[52330]: https://github.com/rust-lang/rust/pull/52330/
2594[52354]: https://github.com/rust-lang/rust/pull/52354/
2595[52402]: https://github.com/rust-lang/rust/pull/52402/
2596[52103]: https://github.com/rust-lang/rust/pull/52103/
2597[52197]: https://github.com/rust-lang/rust/pull/52197/
2598[51807]: https://github.com/rust-lang/rust/pull/51807/
2599[51899]: https://github.com/rust-lang/rust/pull/51899/
2600[51912]: https://github.com/rust-lang/rust/pull/51912/
2601[51511]: https://github.com/rust-lang/rust/pull/51511/
2602[51619]: https://github.com/rust-lang/rust/pull/51619/
2603[51656]: https://github.com/rust-lang/rust/pull/51656/
2604[51178]: https://github.com/rust-lang/rust/pull/51178/
2605[51122]: https://github.com/rust-lang/rust/pull/51122
2606[50494]: https://github.com/rust-lang/rust/pull/50494/
b7449926 2607[cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
8faf50e0
XL
2608[cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2609[cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2610[cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2611[`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2612[`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2613[`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2614
2615
94b46f34 2616Version 1.28.0 (2018-08-02)
5d61e2ac
XL
2617===========================
2618
94b46f34
XL
2619Language
2620--------
2621- [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2622 allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2623 the inner type across Foreign Function Interface (FFI) boundaries.
2624- [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2625 and can now be used as identifiers.][51196]
2626- [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2627 stable.][51241] This will allow users to specify a global allocator for
2628 their program.
2629- [Unit test functions marked with the `#[test]` attribute can now return
2630 `Result<(), E: Debug>` in addition to `()`.][51298]
2631- [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2632 allows macros to easily target lifetimes.
2633
2634Compiler
2635--------
2636- [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2637 prioritise making smaller binary sizes. `z` is the same as `s` with the
2638 exception that it does not vectorise loops, which typically results in an even
2639 smaller binary.
2640- [The short error format is now stable.][49546] Specified with
2641 `--error-format=short` this option will provide a more compressed output of
2642 rust error messages.
2643- [Added a lint warning when you have duplicated `macro_export`s.][50143]
2644- [Reduced the number of allocations in the macro parser.][50855] This can
2645 improve compile times of macro heavy crates on average by 5%.
2646
2647Libraries
2648---------
2649- [Implemented `Default` for `&mut str`.][51306]
2650- [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2651- [Implemented `Extend` for `()`.][50234]
2652- [The `Debug` implementation of `time::Duration` should now be more easily
2653 human readable.][50364] Previously a `Duration` of one second would printed as
2654 `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2655- [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2656 `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2657 for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2658 `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2659 for `PathBuf`.][50170]
2660- [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2661 and `Wrapping<i128>`.][50465]
2662- [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2663 possible.][51050] This can provide up to a 40% speed increase.
2664- [Improved error messages when using `format!`.][50610]
2665
2666Stabilized APIs
2667---------------
2668- [`Iterator::step_by`]
2669- [`Path::ancestors`]
74d20737
XL
2670- [`SystemTime::UNIX_EPOCH`]
2671- [`alloc::GlobalAlloc`]
2672- [`alloc::Layout`]
2673- [`alloc::LayoutErr`]
2674- [`alloc::System`]
2675- [`alloc::alloc`]
2676- [`alloc::alloc_zeroed`]
2677- [`alloc::dealloc`]
2678- [`alloc::realloc`]
2679- [`alloc::handle_alloc_error`]
94b46f34
XL
2680- [`btree_map::Entry::or_default`]
2681- [`fmt::Alignment`]
2682- [`hash_map::Entry::or_default`]
2683- [`iter::repeat_with`]
2684- [`num::NonZeroUsize`]
2685- [`num::NonZeroU128`]
2686- [`num::NonZeroU16`]
2687- [`num::NonZeroU32`]
2688- [`num::NonZeroU64`]
2689- [`num::NonZeroU8`]
2690- [`ops::RangeBounds`]
2691- [`slice::SliceIndex`]
2692- [`slice::from_mut`]
2693- [`slice::from_ref`]
2694- [`{Any + Send + Sync}::downcast_mut`]
2695- [`{Any + Send + Sync}::downcast_ref`]
2696- [`{Any + Send + Sync}::is`]
2697
2698Cargo
2699-----
2700- [Cargo will now no longer allow you to publish crates with build scripts that
2701 modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2702 considered to be immutable.
2703
2704Misc
2705----
2706- [The `suggestion_applicability` field in `rustc`'s json output is now
2707 stable.][50486] This will allow dev tools to check whether a code suggestion
2708 would apply to them.
2709
5d61e2ac
XL
2710Compatibility Notes
2711-------------------
8faf50e0
XL
2712- [Rust will consider trait objects with duplicated constraints to be the same
2713 type as without the duplicated constraint.][51276] For example the below code will
2714 now fail to compile.
94b46f34
XL
2715 ```rust
2716 trait Trait {}
2717
2718 impl Trait + Send {
2719 fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2720 }
5d61e2ac 2721
94b46f34
XL
2722 impl Trait + Send + Send {
2723 fn test(&self) { println!("two"); }
2724 }
2725 ```
5d61e2ac 2726
94b46f34
XL
2727[49546]: https://github.com/rust-lang/rust/pull/49546/
2728[50143]: https://github.com/rust-lang/rust/pull/50143/
2729[50170]: https://github.com/rust-lang/rust/pull/50170/
2730[50234]: https://github.com/rust-lang/rust/pull/50234/
2731[50265]: https://github.com/rust-lang/rust/pull/50265/
2732[50364]: https://github.com/rust-lang/rust/pull/50364/
2733[50385]: https://github.com/rust-lang/rust/pull/50385/
2734[50465]: https://github.com/rust-lang/rust/pull/50465/
2735[50486]: https://github.com/rust-lang/rust/pull/50486/
2736[50554]: https://github.com/rust-lang/rust/pull/50554/
2737[50610]: https://github.com/rust-lang/rust/pull/50610/
2738[50855]: https://github.com/rust-lang/rust/pull/50855/
2739[51050]: https://github.com/rust-lang/rust/pull/51050/
2740[51196]: https://github.com/rust-lang/rust/pull/51196/
2741[51200]: https://github.com/rust-lang/rust/pull/51200/
2742[51241]: https://github.com/rust-lang/rust/pull/51241/
2743[51276]: https://github.com/rust-lang/rust/pull/51276/
2744[51298]: https://github.com/rust-lang/rust/pull/51298/
2745[51306]: https://github.com/rust-lang/rust/pull/51306/
2746[51562]: https://github.com/rust-lang/rust/pull/51562/
2747[cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2748[`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2749[`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
74d20737
XL
2750[`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2751[`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2752[`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2753[`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2754[`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2755[`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2756[`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2757[`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2758[`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2759[`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
94b46f34
XL
2760[`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2761[`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
8faf50e0 2762[`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
94b46f34
XL
2763[`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2764[`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2765[`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2766[`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2767[`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2768[`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2769[`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2770[`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2771[`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2772[`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2773[`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2774[`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2775[`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2776[`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
5d61e2ac 2777
8faf50e0
XL
2778Version 1.27.2 (2018-07-20)
2779===========================
2780
2781Compatibility Notes
2782-------------------
2783
2784- The borrow checker was fixed to avoid potential unsoundness when using
2785 match ergonomics: [#52213][52213].
2786
2787[52213]: https://github.com/rust-lang/rust/issues/52213
2788
83c7162d
XL
2789Version 1.27.1 (2018-07-10)
2790===========================
2791
2792Security Notes
2793--------------
2794
2795- rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2796 when running, which enabled executing code as some other user on a
2797 given machine. This release fixes that vulnerability; you can read
94b46f34 2798 more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
83c7162d 2799
416331ca 2800 Thank you to Red Hat for responsibly disclosing this vulnerability to us.
83c7162d
XL
2801
2802Compatibility Notes
2803-------------------
2804
2805- The borrow checker was fixed to avoid an additional potential unsoundness when using
2806 match ergonomics: [#51415][51415], [#49534][49534].
2807
2808[51415]: https://github.com/rust-lang/rust/issues/51415
2809[49534]: https://github.com/rust-lang/rust/issues/49534
2810[rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
94b46f34 2811[CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
83c7162d
XL
2812
2813Version 1.27.0 (2018-06-21)
2814==========================
2815
2816Language
2817--------
2818- [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
8faf50e0 2819 be used as an identifier.
83c7162d
XL
2820- [The dyn syntax is now available.][49968] This syntax is equivalent to the
2821 bare `Trait` syntax, and should make it clearer when being used in tandem with
4462d4a0 2822 `impl Trait` because it is equivalent to the following syntax:
83c7162d
XL
2823 `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2824 `Box<Trait> == Box<dyn Trait>`.
2825- [Attributes on generic parameters such as types and lifetimes are
2826 now stable.][48851] e.g.
2827 `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2828- [The `#[must_use]` attribute can now also be used on functions as well as
2829 types.][48925] It provides a lint that by default warns users when the
2830 value returned by a function has not been used.
2831
2832Compiler
2833--------
b7449926 2834- [Added the `armv5te-unknown-linux-musleabi` target.][50423]
83c7162d
XL
2835
2836Libraries
2837---------
2838- [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2839 This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2840 SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2841 `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2842 the `cfg` attribute.
2843- [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2844 std are now available in core.][49896]
2845- [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2846 to `Self`.][49630]
2847- [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2848 that the operation isn't done in place.
2849- [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2850 the `#[must_use]` attribute][49533] to warn about unused potentially
2851 expensive allocations.
2852
2853Stabilized APIs
2854---------------
2855- [`DoubleEndedIterator::rfind`]
2856- [`DoubleEndedIterator::rfold`]
2857- [`DoubleEndedIterator::try_rfold`]
2858- [`Duration::from_micros`]
2859- [`Duration::from_nanos`]
2860- [`Duration::subsec_micros`]
2861- [`Duration::subsec_millis`]
2862- [`HashMap::remove_entry`]
2863- [`Iterator::try_fold`]
2864- [`Iterator::try_for_each`]
2865- [`NonNull::cast`]
2866- [`Option::filter`]
2867- [`String::replace_range`]
2868- [`Take::set_limit`]
2869- [`hint::unreachable_unchecked`]
2870- [`os::unix::process::parent_id`]
83c7162d
XL
2871- [`ptr::swap_nonoverlapping`]
2872- [`slice::rsplit_mut`]
2873- [`slice::rsplit`]
2874- [`slice::swap_with_slice`]
2875
2876Cargo
2877-----
2878- [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2879 `readme`, and `repository` fields.][cargo/5386]
94b46f34 2880- [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
83c7162d
XL
2881- [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2882 a different directory than `target` for placing compilation artifacts.
2883- [Cargo will be adding automatic target inference for binaries, benchmarks,
2884 examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4462d4a0 2885 specific targets, e.g. using `[[bin]]`, and have other binaries in locations
83c7162d 2886 where cargo would infer a binary, Cargo will produce a warning. You can
4462d4a0
XL
2887 disable this feature ahead of time by setting any of the following to false:
2888 `autobins`, `autobenches`, `autoexamples`, `autotests`.
83c7162d
XL
2889- [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2890 setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2891
2892Misc
2893----
2894- [Added “The Rustc book” into the official documentation.][49707]
2895 [“The Rustc book”] documents and teaches how to use the rustc compiler.
2896- [All books available on `doc.rust-lang.org` are now searchable.][49623]
2897
2898Compatibility Notes
2899-------------------
2900- [Calling a `CharExt` or `StrExt` method directly on core will no longer
2901 work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2902 compile, `"".is_empty()` will still compile.
2903- [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4462d4a0
XL
2904 will only print the inner type.][48553] E.g.
2905 `print!("{:?}", AtomicBool::new(true))` will print `true`,
83c7162d
XL
2906 not `AtomicBool(true)`.
2907- [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2908 could enter higher numbers but they were not supported by LLVM. Up to 512MB
2909 alignment should cover all use cases.
b7449926
XL
2910- The `.description()` method on the `std::error::Error` trait
2911 [has been soft-deprecated][50163]. It is no longer required to implement it.
83c7162d
XL
2912
2913[48553]: https://github.com/rust-lang/rust/pull/48553/
2914[48851]: https://github.com/rust-lang/rust/pull/48851/
2915[48925]: https://github.com/rust-lang/rust/pull/48925/
2916[49533]: https://github.com/rust-lang/rust/pull/49533/
2917[49623]: https://github.com/rust-lang/rust/pull/49623/
2918[49630]: https://github.com/rust-lang/rust/pull/49630/
2919[49664]: https://github.com/rust-lang/rust/pull/49664/
2920[49699]: https://github.com/rust-lang/rust/pull/49699/
2921[49707]: https://github.com/rust-lang/rust/pull/49707/
2922[49719]: https://github.com/rust-lang/rust/pull/49719/
2923[49896]: https://github.com/rust-lang/rust/pull/49896/
2924[49968]: https://github.com/rust-lang/rust/pull/49968/
b7449926 2925[50163]: https://github.com/rust-lang/rust/pull/50163
83c7162d
XL
2926[50177]: https://github.com/rust-lang/rust/pull/50177/
2927[50378]: https://github.com/rust-lang/rust/pull/50378/
2928[50398]: https://github.com/rust-lang/rust/pull/50398/
2929[50423]: https://github.com/rust-lang/rust/pull/50423/
2930[cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2931[cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2932[cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
94b46f34 2933[cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
83c7162d
XL
2934[cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2935[cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2936[`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2937[`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2938[`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2939[`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2940[`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2941[`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2942[`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2943[`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2944[`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2945[`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2946[`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2947[`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2948[`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2949[`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
94b46f34
XL
2950[`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2951[`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2952[`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2953[`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
83c7162d
XL
2954[`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2955[`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2956[`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2957[`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2958[`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
83c7162d
XL
2959[“The Rustc book”]: https://doc.rust-lang.org/rustc
2960
2961
2c912e08
XL
2962Version 1.26.2 (2018-06-05)
2963==========================
2964
2965Compatibility Notes
2966-------------------
2967
4462d4a0 2968- [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2c912e08
XL
2969
2970[51117]: https://github.com/rust-lang/rust/issues/51117
2971
83c7162d 2972
564c78a2
XL
2973Version 1.26.1 (2018-05-29)
2974==========================
2975
2976Tools
2977-----
2978
4462d4a0
XL
2979- [RLS now works on Windows.][50646]
2980- [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
564c78a2 2981
94b46f34 2982
564c78a2
XL
2983Compatibility Notes
2984--------
2985
2986- [`fn main() -> impl Trait` no longer works for non-Termination
4462d4a0 2987 trait.][50656]
564c78a2 2988 This reverts an accidental stabilization.
4462d4a0
XL
2989- [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2990- [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
564c78a2
XL
2991
2992[50646]: https://github.com/rust-lang/rust/issues/50646
2993[50656]: https://github.com/rust-lang/rust/pull/50656
2994[50812]: https://github.com/rust-lang/rust/pull/50812
2995[50950]: https://github.com/rust-lang/rust/issues/50950
2996[rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2997
2998Version 1.26.0 (2018-05-10)
2999==========================
3000
3001Language
3002--------
3003- [Closures now implement `Copy` and/or `Clone` if all captured variables
3004 implement either or both traits.][49299]
3005- [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4462d4a0 3006- [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
564c78a2
XL
3007 lifetime can be elided.][49458]
3008- [`impl Trait` is now stable allowing you to have abstract types in returns
4462d4a0 3009 or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
564c78a2
XL
3010 `fn open(path: impl AsRef<Path>)`.
3011- [Pattern matching will now automatically apply dereferences.][49394]
3012- [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3013- [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3014- [A lot of operations are now available in a const context.][46882] E.g. You
3015 can now index into constant arrays, reference and dereference into constants,
4462d4a0
XL
3016 and use tuple struct constructors.
3017- [Fixed entry slice patterns are now stable.][48516] E.g.
564c78a2
XL
3018 ```rust
3019 let points = [1, 2, 3, 4];
3020 match points {
3021 [1, 2, 3, 4] => println!("All points were sequential."),
3022 _ => println!("Not all points were sequential."),
3023 }
3024 ```
3025
3026
3027Compiler
3028--------
3029- [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3030- [Fixed exponential projection complexity on nested types.][48296]
3031 This can provide up to a ~12% reduction in compile times for certain crates.
3032- [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3033 to remap path prefixes outputted by the compiler.
3034- [Added `powerpc-unknown-netbsd` target.][48281]
3035
3036Libraries
3037---------
3038- [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3039- [Added hexadecimal formatting for integers with fmt::Debug][48978]
3040 e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3041- [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3042- [Optimized `str::repeat` being 8x faster in large cases.][48657]
3043- [`ascii::escape_default` is now available in libcore.][48735]
3044- [Trailing commas are now supported in std and core macros.][48056]
3045- [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3046- [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3047
3048Stabilized APIs
3049---------------
3050- [`*const T::add`]
3051- [`*const T::copy_to_nonoverlapping`]
3052- [`*const T::copy_to`]
3053- [`*const T::read_unaligned`]
3054- [`*const T::read_volatile`]
3055- [`*const T::read`]
3056- [`*const T::sub`]
3057- [`*const T::wrapping_add`]
3058- [`*const T::wrapping_sub`]
3059- [`*mut T::add`]
3060- [`*mut T::copy_to_nonoverlapping`]
3061- [`*mut T::copy_to`]
3062- [`*mut T::read_unaligned`]
3063- [`*mut T::read_volatile`]
3064- [`*mut T::read`]
3065- [`*mut T::replace`]
3066- [`*mut T::sub`]
3067- [`*mut T::swap`]
3068- [`*mut T::wrapping_add`]
3069- [`*mut T::wrapping_sub`]
3070- [`*mut T::write_bytes`]
3071- [`*mut T::write_unaligned`]
3072- [`*mut T::write_volatile`]
3073- [`*mut T::write`]
3074- [`Box::leak`]
3075- [`FromUtf8Error::as_bytes`]
3076- [`LocalKey::try_with`]
3077- [`Option::cloned`]
3078- [`btree_map::Entry::and_modify`]
3079- [`fs::read_to_string`]
3080- [`fs::read`]
3081- [`fs::write`]
3082- [`hash_map::Entry::and_modify`]
3083- [`iter::FusedIterator`]
3084- [`ops::RangeInclusive`]
3085- [`ops::RangeToInclusive`]
3086- [`process::id`]
3087- [`slice::rotate_left`]
3088- [`slice::rotate_right`]
3089- [`String::retain`]
3090
3091
3092Cargo
3093-----
3094- [Cargo will now output path to custom commands when `-v` is
3095 passed with `--list`][cargo/5041]
3096- [The Cargo binary version is now the same as the Rust version][cargo/5083]
564c78a2
XL
3097
3098Misc
3099----
3100- [The second edition of "The Rust Programming Language" book is now recommended
3101 over the first.][48404]
3102
3103Compatibility Notes
3104-------------------
3105
3106- [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3107 syntax is now invalid.
3108 ```
3109 use std::ops::Fn as dyn;
3110 fn g(_: Box<dyn(std::fmt::Debug)>) {}
3111 ```
3112- [The result of dereferences are no longer promoted to `'static`.][47408]
3113 e.g.
3114 ```rust
3115 fn main() {
3116 const PAIR: &(i32, i32) = &(0, 1);
3117 let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3118 }
3119 ```
3120- [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3121- [`".e0"` will now no longer parse as `0.0` and will instead cause
3122 an error.][48235]
3123- [Removed hoedown from rustdoc.][48274]
3124- [Bounds on higher-kinded lifetimes a hard error.][48326]
3125
3126[46882]: https://github.com/rust-lang/rust/pull/46882
3127[47379]: https://github.com/rust-lang/rust/pull/47379
3128[47408]: https://github.com/rust-lang/rust/pull/47408
3129[47813]: https://github.com/rust-lang/rust/pull/47813
3130[48056]: https://github.com/rust-lang/rust/pull/48056
3131[48125]: https://github.com/rust-lang/rust/pull/48125
3132[48166]: https://github.com/rust-lang/rust/pull/48166
3133[48235]: https://github.com/rust-lang/rust/pull/48235
3134[48274]: https://github.com/rust-lang/rust/pull/48274
3135[48281]: https://github.com/rust-lang/rust/pull/48281
3136[48296]: https://github.com/rust-lang/rust/pull/48296
3137[48326]: https://github.com/rust-lang/rust/pull/48326
3138[48359]: https://github.com/rust-lang/rust/pull/48359
3139[48404]: https://github.com/rust-lang/rust/pull/48404
3140[48481]: https://github.com/rust-lang/rust/pull/48481
3141[48516]: https://github.com/rust-lang/rust/pull/48516
3142[48628]: https://github.com/rust-lang/rust/pull/48628
3143[48629]: https://github.com/rust-lang/rust/pull/48629
3144[48657]: https://github.com/rust-lang/rust/pull/48657
3145[48735]: https://github.com/rust-lang/rust/pull/48735
3146[48978]: https://github.com/rust-lang/rust/pull/48978
3147[49101]: https://github.com/rust-lang/rust/pull/49101
3148[49109]: https://github.com/rust-lang/rust/pull/49109
3149[49121]: https://github.com/rust-lang/rust/pull/49121
3150[49162]: https://github.com/rust-lang/rust/pull/49162
3151[49184]: https://github.com/rust-lang/rust/pull/49184
3152[49234]: https://github.com/rust-lang/rust/pull/49234
3153[49255]: https://github.com/rust-lang/rust/pull/49255
3154[49299]: https://github.com/rust-lang/rust/pull/49299
3155[49305]: https://github.com/rust-lang/rust/pull/49305
3156[49394]: https://github.com/rust-lang/rust/pull/49394
3157[49458]: https://github.com/rust-lang/rust/pull/49458
3158[`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3159[`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3160[`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3161[`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3162[`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3163[`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3164[`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3165[`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3166[`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3167[`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3168[`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3169[`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3170[`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3171[`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3172[`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3173[`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3174[`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3175[`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3176[`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3177[`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3178[`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3179[`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3180[`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3181[`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3182[`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3183[`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3184[`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3185[`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3186[`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3187[`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3188[`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3189[`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3190[`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3191[`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3192[`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3193[`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3194[`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3195[`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3196[`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3197[`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3198[cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3199[cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
564c78a2
XL
3200
3201
0531ce1d
XL
3202Version 1.25.0 (2018-03-29)
3203==========================
3204
3205Language
3206--------
94b46f34 3207- [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
0531ce1d
XL
3208- [You can now use nested groups of imports.][47948]
3209 e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3210- [You can now have `|` at the start of a match arm.][47947] e.g.
3211```rust
3212enum Foo { A, B, C }
3213
3214fn main() {
3215 let x = Foo::A;
3216 match x {
3217 | Foo::A
3218 | Foo::B => println!("AB"),
3219 | Foo::C => println!("C"),
3220 }
3221}
3222```
3223
3224Compiler
3225--------
3226- [Upgraded to LLVM 6.][47828]
3227- [Added `-C lto=val` option.][47521]
3228- [Added `i586-unknown-linux-musl` target][47282]
3229
3230Libraries
3231---------
3232- [Impl Send for `process::Command` on Unix.][47760]
3233- [Impl PartialEq and Eq for `ParseCharError`.][47790]
3234- [`UnsafeCell::into_inner` is now safe.][47204]
3235- [Implement libstd for CloudABI.][47268]
3236- [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3237- [Implement `AsRef<Path>` for Component][46985]
3238- [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
3239- [Moved `Duration` to libcore.][46666]
3240
3241Stabilized APIs
3242---------------
3243- [`Location::column`]
3244- [`ptr::NonNull`]
3245
3246The following functions can now be used in a constant expression.
3247eg. `static MINUTE: Duration = Duration::from_secs(60);`
3248- [`Duration::new`][47300]
3249- [`Duration::from_secs`][47300]
3250- [`Duration::from_millis`][47300]
3251
3252Cargo
3253-----
3254- [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
3255- [`cargo new` now defaults to creating a binary crate, instead of a
3256 library crate.][cargo/5029]
3257
3258Misc
3259----
3260- [Rust by example is now shipped with new releases][46196]
3261
3262Compatibility Notes
3263-------------------
3264- [Deprecated `net::lookup_host`.][47510]
3265- [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
3266- The borrow checker was sometimes incorrectly permitting overlapping borrows
3267 around indexing operations (see [#47349][47349]). This has been fixed (which also
3268 enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
3269- [Removed deprecated unstable attribute `#[simd]`.][47251]
3270
3271[33903]: https://github.com/rust-lang/rust/pull/33903
3272[47947]: https://github.com/rust-lang/rust/pull/47947
3273[47948]: https://github.com/rust-lang/rust/pull/47948
3274[47760]: https://github.com/rust-lang/rust/pull/47760
3275[47790]: https://github.com/rust-lang/rust/pull/47790
3276[47828]: https://github.com/rust-lang/rust/pull/47828
3277[47398]: https://github.com/rust-lang/rust/pull/47398
3278[47510]: https://github.com/rust-lang/rust/pull/47510
3279[47521]: https://github.com/rust-lang/rust/pull/47521
3280[47204]: https://github.com/rust-lang/rust/pull/47204
3281[47251]: https://github.com/rust-lang/rust/pull/47251
3282[47268]: https://github.com/rust-lang/rust/pull/47268
3283[47282]: https://github.com/rust-lang/rust/pull/47282
3284[47300]: https://github.com/rust-lang/rust/pull/47300
3285[47349]: https://github.com/rust-lang/rust/pull/47349
3286[46931]: https://github.com/rust-lang/rust/pull/46931
3287[46985]: https://github.com/rust-lang/rust/pull/46985
3288[47006]: https://github.com/rust-lang/rust/pull/47006
3289[46830]: https://github.com/rust-lang/rust/pull/46830
3290[46095]: https://github.com/rust-lang/rust/pull/46095
3291[46666]: https://github.com/rust-lang/rust/pull/46666
3292[46196]: https://github.com/rust-lang/rust/pull/46196
3293[cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3294[cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3295[RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3296[`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3297[`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3298
3299
3300Version 1.24.1 (2018-03-01)
3301==========================
3302
3303 - [Do not abort when unwinding through FFI][48251]
3304 - [Emit UTF-16 files for linker arguments on Windows][48318]
3305 - [Make the error index generator work again][48308]
3306 - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3307
3308[48251]: https://github.com/rust-lang/rust/issues/48251
3309[48308]: https://github.com/rust-lang/rust/issues/48308
3310[48318]: https://github.com/rust-lang/rust/issues/48318
3311[cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3312
3313
ff7c6d11
XL
3314Version 1.24.0 (2018-02-15)
3315==========================
3316
3317Language
3318--------
3319- [External `sysv64` ffi is now available.][46528]
3320 eg. `extern "sysv64" fn foo () {}`
3321
3322Compiler
3323--------
3324- [rustc now uses 16 codegen units by default for release builds.][46910]
3325 For the fastest builds, utilize `codegen-units=1`.
3326- [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3327- [Add `aarch64-unknown-openbsd` support][46760]
3328
3329Libraries
3330---------
3331- [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3332 improvement in performance in the majority of cases.
3333- [`OsStr`'s `Debug` implementation is now lossless and consistent
3334 with Windows.][46798]
3335- [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3336- [impl `From<bool>` for `AtomicBool`][46293]
3337- [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3338- [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3339- [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3340- [float::from_bits now just uses transmute.][46012] This provides
3341 some optimisations from LLVM.
3342- [Copied `AsciiExt` methods onto `char`][46077]
3343- [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3344- [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
0531ce1d 3345- [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
ff7c6d11
XL
3346- [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3347
3348Stabilized APIs
3349---------------
3350- [`RefCell::replace`]
3351- [`RefCell::swap`]
3352- [`atomic::spin_loop_hint`]
3353
3354The following functions can now be used in a constant expression.
3355eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3356
3357- [`AtomicBool::new`][46287]
3358- [`AtomicUsize::new`][46287]
3359- [`AtomicIsize::new`][46287]
3360- [`AtomicPtr::new`][46287]
3361- [`Cell::new`][46287]
3362- [`{integer}::min_value`][46287]
3363- [`{integer}::max_value`][46287]
3364- [`mem::size_of`][46287]
3365- [`mem::align_of`][46287]
3366- [`ptr::null`][46287]
3367- [`ptr::null_mut`][46287]
3368- [`RefCell::new`][46287]
3369- [`UnsafeCell::new`][46287]
3370
3371Cargo
3372-----
3373- [Added a `workspace.default-members` config that
3374 overrides implied `--all` in virtual workspaces.][cargo/4743]
3375- [Enable incremental by default on development builds.][cargo/4817] Also added
3376 configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3377 per-project or global basis respectively.
3378
3379Misc
3380----
3381
3382Compatibility Notes
3383-------------------
3384- [Floating point types `Debug` impl now always prints a decimal point.][46831]
3385- [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3386 in accordance with IETF RFC 4291 §2.2.
3387- [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3388- [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3389 `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3390- [Leading zeros in tuple struct members is now an error][47084]
3391- [`column!()` macro is one-based instead of zero-based][46977]
3392- [`fmt::Arguments` can no longer be shared across threads][45198]
3393- [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
0531ce1d 3394- [Cargo sets a different working directory for the compiler][cargo/4788]
ff7c6d11
XL
3395
3396[44884]: https://github.com/rust-lang/rust/pull/44884
3397[45198]: https://github.com/rust-lang/rust/pull/45198
3398[45506]: https://github.com/rust-lang/rust/pull/45506
3399[45904]: https://github.com/rust-lang/rust/pull/45904
3400[45990]: https://github.com/rust-lang/rust/pull/45990
3401[46012]: https://github.com/rust-lang/rust/pull/46012
3402[46077]: https://github.com/rust-lang/rust/pull/46077
3403[46094]: https://github.com/rust-lang/rust/pull/46094
3404[46284]: https://github.com/rust-lang/rust/pull/46284
3405[46287]: https://github.com/rust-lang/rust/pull/46287
3406[46293]: https://github.com/rust-lang/rust/pull/46293
3407[46528]: https://github.com/rust-lang/rust/pull/46528
3408[46671]: https://github.com/rust-lang/rust/pull/46671
3409[46713]: https://github.com/rust-lang/rust/pull/46713
3410[46735]: https://github.com/rust-lang/rust/pull/46735
3411[46749]: https://github.com/rust-lang/rust/pull/46749
3412[46760]: https://github.com/rust-lang/rust/pull/46760
3413[46798]: https://github.com/rust-lang/rust/pull/46798
3414[46828]: https://github.com/rust-lang/rust/pull/46828
3415[46831]: https://github.com/rust-lang/rust/pull/46831
3416[46833]: https://github.com/rust-lang/rust/pull/46833
3417[46910]: https://github.com/rust-lang/rust/pull/46910
3418[46977]: https://github.com/rust-lang/rust/pull/46977
3419[47018]: https://github.com/rust-lang/rust/pull/47018
3420[47080]: https://github.com/rust-lang/rust/pull/47080
3421[47084]: https://github.com/rust-lang/rust/pull/47084
3422[cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
0531ce1d 3423[cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
ff7c6d11
XL
3424[cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3425[`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3426[`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3427[`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3428
3429
3430Version 1.23.0 (2018-01-04)
3431==========================
3432
3433Language
3434--------
3435- [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3436- [rustc now uses subtyping on the left hand side of binary operations.][45435]
3437 Which should fix some confusing errors in some operations.
3438
3439Compiler
3440--------
3441- [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4462d4a0 3442 undefined behavior.][45920]
ff7c6d11
XL
3443- [rustc now suggests renaming import if names clash.][45660]
3444- [Display errors/warnings correctly when there are zero-width or
3445 wide characters.][45711]
3446- [rustc now avoids unnecessary copies of arguments that are
3447 simple bindings][45380] This should improve memory usage on average by 5-10%.
3448- [Updated musl used to build musl rustc to 1.1.17][45393]
3449
3450Libraries
3451---------
3452- [Allow a trailing comma in `assert_eq/ne` macro][45887]
3453- [Implement Hash for raw pointers to unsized types][45483]
3454- [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3455- [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3456- [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3457- [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3458 and `<*mut T>::as_mut`][44932]
3459- [Optimized `Thread::{park, unpark}` implementation][45524]
3460- [Improved `SliceExt::binary_search` performance.][45333]
3461- [impl `FromIterator<()>` for `()`][45379]
3462- [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3463 is now deprecated.
3464
3465Stabilized APIs
3466---------------
3467
3468Cargo
3469-----
ff7c6d11
XL
3470- [Cargo now supports uninstallation of multiple packages][cargo/4561]
3471 eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3472- [Added unit test checking to `cargo check`][cargo/4592]
3473- [Cargo now lets you install a specific version
3474 using `cargo install --version`][cargo/4637]
3475
3476Misc
3477----
3478- [Releases now ship with the Cargo book documentation.][45692]
3479- [rustdoc now prints rendering warnings on every run.][45324]
ff7c6d11
XL
3480
3481Compatibility Notes
3482-------------------
3483- [Changes have been made to type equality to make it more correct,
3484 in rare cases this could break some code.][45853] [Tracking issue for
3485 further information][45852]
3486- [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3487- [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3488 Android 9, the minimum supported version is Android 14.
3489- [Bumped the minimum LLVM to 3.9][45326]
3490
3491[44042]: https://github.com/rust-lang/rust/pull/44042
3492[44932]: https://github.com/rust-lang/rust/pull/44932
3493[45267]: https://github.com/rust-lang/rust/pull/45267
3494[45324]: https://github.com/rust-lang/rust/pull/45324
3495[45326]: https://github.com/rust-lang/rust/pull/45326
3496[45333]: https://github.com/rust-lang/rust/pull/45333
3497[45379]: https://github.com/rust-lang/rust/pull/45379
3498[45380]: https://github.com/rust-lang/rust/pull/45380
3499[45393]: https://github.com/rust-lang/rust/pull/45393
3500[45435]: https://github.com/rust-lang/rust/pull/45435
3501[45483]: https://github.com/rust-lang/rust/pull/45483
3502[45524]: https://github.com/rust-lang/rust/pull/45524
3503[45571]: https://github.com/rust-lang/rust/pull/45571
3504[45580]: https://github.com/rust-lang/rust/pull/45580
3505[45610]: https://github.com/rust-lang/rust/pull/45610
3506[45660]: https://github.com/rust-lang/rust/pull/45660
3507[45692]: https://github.com/rust-lang/rust/pull/45692
3508[45711]: https://github.com/rust-lang/rust/pull/45711
3509[45772]: https://github.com/rust-lang/rust/pull/45772
3510[45852]: https://github.com/rust-lang/rust/issues/45852
3511[45853]: https://github.com/rust-lang/rust/pull/45853
3512[45887]: https://github.com/rust-lang/rust/pull/45887
ff7c6d11 3513[45920]: https://github.com/rust-lang/rust/pull/45920
ff7c6d11
XL
3514[cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3515[cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3516[cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3517
3518
3519Version 1.22.1 (2017-11-22)
3520==========================
3521
3522- [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3523
3524[46183]: https://github.com/rust-lang/rust/pull/46183
3525
3526Version 1.22.0 (2017-11-22)
abe05a73
XL
3527==========================
3528
3529Language
3530--------
3531- [`non_snake_case` lint now allows extern no-mangle functions][44966]
3532- [Now accepts underscores in unicode escapes][43716]
abe05a73
XL
3533- [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3534- [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3535
3536Compiler
3537--------
3538- [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3539- [rustc will no longer inline in codegen units when compiling for debug][45075]
3540 This should decrease compile times for debug builds.
3541- [strict memory alignment now enabled on ARMv6][45094]
3542- [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3543
3544Libraries
3545---------
3546- [Allow atomic operations up to 32 bits
3547 on `armv5te_unknown_linux_gnueabi`][44978]
3548- [`Box<Error>` now impls `From<Cow<str>>`][44466]
3549- [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3550- [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3551- [Properly detect overflow in `Instant += Duration`.][44220]
3552- [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3553- [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3554- [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3555
3556Stabilized APIs
3557---------------
3558
3559Cargo
3560-----
3561- [Cargo will now build multi file examples in subdirectories of the `examples`
3562 folder that have a `main.rs` file.][cargo/4496]
3563- [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3564 the old format will continue to work and can be updated with `cargo update`.
3565- [Now supports vendoring git repositories][cargo/3992]
3566
3567Misc
3568----
3569- [`libbacktrace` is now available on Apple platforms.][44251]
ff7c6d11
XL
3570- [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3571 This now lets you specify that a given code example will fail to compile.
abe05a73
XL
3572
3573Compatibility Notes
3574-------------------
3575- [The minimum Android version that rustc can build for has been bumped
3576 to `4.0` from `2.3`][45656]
3577- [Allowing `T op= &T` for numeric types has broken some type
3578 inference cases][45480]
3579
3580
3581[42526]: https://github.com/rust-lang/rust/pull/42526
3582[43017]: https://github.com/rust-lang/rust/pull/43017
3583[43716]: https://github.com/rust-lang/rust/pull/43716
3584[43949]: https://github.com/rust-lang/rust/pull/43949
3585[44015]: https://github.com/rust-lang/rust/pull/44015
3586[44220]: https://github.com/rust-lang/rust/pull/44220
3587[44251]: https://github.com/rust-lang/rust/pull/44251
3588[44287]: https://github.com/rust-lang/rust/pull/44287
3589[44303]: https://github.com/rust-lang/rust/pull/44303
3590[44456]: https://github.com/rust-lang/rust/pull/44456
3591[44466]: https://github.com/rust-lang/rust/pull/44466
3592[44895]: https://github.com/rust-lang/rust/pull/44895
3593[44966]: https://github.com/rust-lang/rust/pull/44966
3594[44978]: https://github.com/rust-lang/rust/pull/44978
3595[45041]: https://github.com/rust-lang/rust/pull/45041
3596[45064]: https://github.com/rust-lang/rust/pull/45064
3597[45075]: https://github.com/rust-lang/rust/pull/45075
3598[45094]: https://github.com/rust-lang/rust/pull/45094
3599[45095]: https://github.com/rust-lang/rust/pull/45095
3600[45480]: https://github.com/rust-lang/rust/issues/45480
3601[45656]: https://github.com/rust-lang/rust/pull/45656
3602[cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3603[cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3604[cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3605
3606
3607
3608
3609
3610
ea8adc8c
XL
3611Version 1.21.0 (2017-10-12)
3612==========================
3613
3614Language
3615--------
ea8adc8c
XL
3616- [You can now use static references for literals.][43838]
3617 Example:
3618 ```rust
3619 fn main() {
3620 let x: &'static u32 = &0;
3621 }
3622 ```
abe05a73
XL
3623- [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3624 Example:
3625 ```rust
3626 my_macro!(Vec<i32>::new); // Always worked
3627 my_macro!(Vec::<i32>::new); // Now works
3628 ```
ea8adc8c
XL
3629
3630Compiler
3631--------
3632- [Upgraded jemalloc to 4.5.0][43911]
3633- [Enabled unwinding panics on Redox][43917]
3634- [Now runs LLVM in parallel during translation phase.][43506]
3635 This should reduce peak memory usage.
3636
3637Libraries
3638---------
3639- [Generate builtin impls for `Clone` for all arrays and tuples that
3640 are `T: Clone`][43690]
3641- [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3642- [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3643 `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3644
3645Stabilized APIs
3646---------------
3647
3648[`std::mem::discriminant`]
3649
3650Cargo
3651-----
3652- [You can now call `cargo install` with multiple package names][cargo/4216]
3653- [Cargo commands inside a virtual workspace will now implicitly
3654 pass `--all`][cargo/4335]
3655- [Added a `[patch]` section to `Cargo.toml` to handle
3656 prepublication dependencies][cargo/4123] [RFC 1969]
3657- [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3658 like patterns][cargo/4270]
3659- [Added the `--all-targets` option][cargo/4400]
3660- [Using required dependencies as a feature is now deprecated and emits
3661 a warning][cargo/4364]
3662
3663
3664Misc
3665----
3666- [Cargo docs are moving][43916]
3667 to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3668- [The rustdoc book is now available][43863]
3669 at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3670- [Added a preview of RLS has been made available through rustup][44204]
3671 Install with `rustup component add rls-preview`
3672- [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3673 Previously only showed `std::os::unix`.
3674
3675Compatibility Notes
3676-------------------
3677- [Changes in method matching against higher-ranked types][43880] This may cause
3678 breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3679- [rustc's JSON error output's byte position start at top of file.][42973]
3680 Was previously relative to the rustc's internal `CodeMap` struct which
3681 required the unstable library `libsyntax` to correctly use.
3682- [`unused_results` lint no longer ignores booleans][43728]
3683
3684[42565]: https://github.com/rust-lang/rust/pull/42565
3685[42973]: https://github.com/rust-lang/rust/pull/42973
3686[43348]: https://github.com/rust-lang/rust/pull/43348
3687[43459]: https://github.com/rust-lang/rust/pull/43459
3688[43506]: https://github.com/rust-lang/rust/pull/43506
3689[43540]: https://github.com/rust-lang/rust/pull/43540
3690[43690]: https://github.com/rust-lang/rust/pull/43690
3691[43728]: https://github.com/rust-lang/rust/pull/43728
3692[43838]: https://github.com/rust-lang/rust/pull/43838
3693[43863]: https://github.com/rust-lang/rust/pull/43863
3694[43880]: https://github.com/rust-lang/rust/pull/43880
3695[43911]: https://github.com/rust-lang/rust/pull/43911
3696[43916]: https://github.com/rust-lang/rust/pull/43916
3697[43917]: https://github.com/rust-lang/rust/pull/43917
3698[44204]: https://github.com/rust-lang/rust/pull/44204
3699[cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3700[cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3701[cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3702[cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3703[cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3704[cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3705[RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3706[info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3707[`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3708
3b2f2976
XL
3709Version 1.20.0 (2017-08-31)
3710===========================
3711
3712Language
3713--------
ea8adc8c 3714- [Associated constants are now stabilised.][42809]
3b2f2976
XL
3715- [A lot of macro bugs are now fixed.][42913]
3716
3717Compiler
3718--------
3719
3720- [Struct fields are now properly coerced to the expected field type.][42807]
3721- [Enabled wasm LLVM backend][42571] WASM can now be built with the
3722 `wasm32-experimental-emscripten` target.
3723- [Changed some of the error messages to be more helpful.][42033]
3724- [Add support for RELRO(RELocation Read-Only) for platforms that support
3725 it.][43170]
3726- [rustc now reports the total number of errors on compilation failure][43015]
3727 previously this was only the number of errors in the pass that failed.
3728- [Expansion in rustc has been sped up 29x.][42533]
3729- [added `msp430-none-elf` target.][43099]
3730- [rustc will now suggest one-argument enum variant to fix type mismatch when
3731 applicable][43178]
3732- [Fixes backtraces on Redox][43228]
3733- [rustc now identifies different versions of same crate when absolute paths of
3734 different types match in an error message.][42826]
3735
3736Libraries
3737---------
3738
3739
3740- [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3741- [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3742 tuples.][43011]
3743- [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3744 `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3745- [Impl `Clone` for `DefaultHasher`.][42799]
3746- [Impl `Sync` for `SyncSender`.][42397]
3747- [Impl `FromStr` for `char`][42271]
3748- [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3749 NaN.][42431]
3750- [allow messages in the `unimplemented!()` macro.][42155]
3751 ie. `unimplemented!("Waiting for 1.21 to be stable")`
3752- [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3753- [Upgrade to Unicode 10.0.0][42999]
3754- [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3755- [Skip the main thread's manual stack guard on Linux][43072]
3756- [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3757- [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3758 previously 2^15.
3759- [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3760
3761Stabilized APIs
3762---------------
3763
3764- [`CStr::into_c_string`]
3765- [`CString::as_c_str`]
3766- [`CString::into_boxed_c_str`]
3767- [`Chain::get_mut`]
3768- [`Chain::get_ref`]
3769- [`Chain::into_inner`]
3770- [`Option::get_or_insert_with`]
3771- [`Option::get_or_insert`]
3772- [`OsStr::into_os_string`]
3773- [`OsString::into_boxed_os_str`]
3774- [`Take::get_mut`]
3775- [`Take::get_ref`]
3776- [`Utf8Error::error_len`]
3777- [`char::EscapeDebug`]
3778- [`char::escape_debug`]
3779- [`compile_error!`]
3780- [`f32::from_bits`]
3781- [`f32::to_bits`]
3782- [`f64::from_bits`]
3783- [`f64::to_bits`]
3784- [`mem::ManuallyDrop`]
3785- [`slice::sort_unstable_by_key`]
3786- [`slice::sort_unstable_by`]
3787- [`slice::sort_unstable`]
ea8adc8c 3788- [`str::from_boxed_utf8_unchecked`]
3b2f2976
XL
3789- [`str::as_bytes_mut`]
3790- [`str::as_bytes_mut`]
3791- [`str::from_utf8_mut`]
3792- [`str::from_utf8_unchecked_mut`]
3793- [`str::get_mut`]
3794- [`str::get_unchecked_mut`]
3795- [`str::get_unchecked`]
3796- [`str::get`]
3797- [`str::into_boxed_bytes`]
3798
3799
3800Cargo
3801-----
3802- [Cargo API token location moved from `~/.cargo/config` to
3803 `~/.cargo/credentials`.][cargo/3978]
3804- [Cargo will now build `main.rs` binaries that are in sub-directories of
3805 `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3806 `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3807- [You can now specify version of a binary when installed through
3808 `cargo install` using `--vers`.][cargo/4229]
3809- [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3810 failure.][cargo/4248]
3811- [Changed the convention around which file is the crate root.][cargo/4259]
3812- [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3813 instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3814
3815Compatibility Notes
3816-------------------
3817
3818- [Functions with `'static` in their return types will now not be as usable as
3819 if they were using lifetime parameters instead.][42417]
3820- [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
ea8adc8c 3821 takes the sign of NaN into account where previously didn't.][42430]
3b2f2976
XL
3822
3823[42033]: https://github.com/rust-lang/rust/pull/42033
3824[42155]: https://github.com/rust-lang/rust/pull/42155
3825[42271]: https://github.com/rust-lang/rust/pull/42271
3826[42397]: https://github.com/rust-lang/rust/pull/42397
3827[42417]: https://github.com/rust-lang/rust/pull/42417
3828[42430]: https://github.com/rust-lang/rust/pull/42430
3829[42431]: https://github.com/rust-lang/rust/pull/42431
3830[42533]: https://github.com/rust-lang/rust/pull/42533
3831[42571]: https://github.com/rust-lang/rust/pull/42571
3832[42613]: https://github.com/rust-lang/rust/pull/42613
3833[42799]: https://github.com/rust-lang/rust/pull/42799
3834[42807]: https://github.com/rust-lang/rust/pull/42807
3835[42809]: https://github.com/rust-lang/rust/pull/42809
3836[42822]: https://github.com/rust-lang/rust/pull/42822
3837[42826]: https://github.com/rust-lang/rust/pull/42826
3838[42854]: https://github.com/rust-lang/rust/pull/42854
3839[42913]: https://github.com/rust-lang/rust/pull/42913
3840[42999]: https://github.com/rust-lang/rust/pull/42999
3841[43011]: https://github.com/rust-lang/rust/pull/43011
3842[43015]: https://github.com/rust-lang/rust/pull/43015
3843[43072]: https://github.com/rust-lang/rust/pull/43072
3844[43077]: https://github.com/rust-lang/rust/pull/43077
3845[43097]: https://github.com/rust-lang/rust/pull/43097
3846[43099]: https://github.com/rust-lang/rust/pull/43099
3847[43170]: https://github.com/rust-lang/rust/pull/43170
3848[43178]: https://github.com/rust-lang/rust/pull/43178
3849[43185]: https://github.com/rust-lang/rust/pull/43185
3850[43228]: https://github.com/rust-lang/rust/pull/43228
3851[cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3852[cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3853[cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3854[cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3855[cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3856[cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3857[`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3858[`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3859[`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3860[`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3861[`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3862[`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3863[`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3864[`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3865[`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3866[`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3867[`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3868[`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3869[`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3870[`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3871[`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3872[`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3873[`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3874[`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3875[`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3876[`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3877[`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3878[`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3879[`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3880[`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
ea8adc8c 3881[`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3b2f2976
XL
3882[`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3883[`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3884[`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3885[`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3886[`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3887[`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3888[`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3889[`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3890
3891
3892Version 1.19.0 (2017-07-20)
3893===========================
3894
3895Language
3896--------
3897
3898- [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3899 For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3900- [Macro recursion limit increased to 1024 from 64.][41676]
3901- [Added lint for detecting unused macros.][41907]
3902- [`loop` can now return a value with `break`.][42016] [RFC 1624]
3903 For example: `let x = loop { break 7; };`
3904- [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3905 contain `Copy` types and cannot have a `Drop` implementation.
3906 Example: `union Foo { bar: u8, baz: usize }`
3907- [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3908 Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3909
3910Compiler
3911--------
3912
3913- [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3914- [Change `arm-linux-androideabi` to correspond to the `armeabi`
3915 official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3916 you should use `--target armv7-linux-androideabi`.
3917- [Fixed ICE when removing a source file between compilation sessions.][41873]
3918- [Minor optimisation of string operations.][42037]
3919- [Compiler error message is now `aborting due to previous error(s)` instead of
3920 `aborting due to N previous errors`][42150] This was previously inaccurate and
3921 would only count certain kinds of errors.
3922- [The compiler now supports Visual Studio 2017][42225]
3923- [The compiler is now built against LLVM 4.0.1 by default][42948]
3924- [Added a lot][42264] of [new error codes][42302]
3925- [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3926 libraries with C Run-time Libraries(CRT) to be statically linked.
3927- [Fixed various ARM codegen bugs][42740]
3928
3929Libraries
3930---------
3931
3932- [`String` now implements `FromIterator<Cow<'a, str>>` and
3933 `Extend<Cow<'a, str>>`][41449]
3934- [`Vec` now implements `From<&mut [T]>`][41530]
3935- [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3936- [`SplitWhitespace` now implements `Clone`][41659]
3937- [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3938 1.5x faster][41764]
3939- [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3940 macros, but for printing to stderr.
3941
3942Stabilized APIs
3943---------------
3944
3945- [`OsString::shrink_to_fit`]
3946- [`cmp::Reverse`]
3947- [`Command::envs`]
3948- [`thread::ThreadId`]
3949
3950Cargo
3951-----
3952
3953- [Build scripts can now add environment variables to the environment
3954 the crate is being compiled in.
3955 Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3956- [Subcommands now replace the current process rather than spawning a new
3957 child process][cargo/3970]
3958- [Workspace members can now accept glob file patterns][cargo/3979]
3959- [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3960 the members in a given workspace.][cargo/3988]
3961- [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3962- [Target directory path is now in the cargo metadata][cargo/4022]
3963- [Cargo no longer checks out a local working directory for the
3964 crates.io index][cargo/4026] This should provide smaller file size for the
3965 registry, and improve cloning times, especially on Windows machines.
3966- [Added an `--exclude` option for excluding certain packages when using the
3967 `--all` option][cargo/4031]
3968- [Cargo will now automatically retry when receiving a 5xx error
3969 from crates.io][cargo/4032]
3970- [The `--features` option now accepts multiple comma or space
3971 delimited values.][cargo/4084]
3972- [Added support for custom target specific runners][cargo/3954]
3973
3974Misc
3975----
3976
3977- [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3978 Windows Debugger.
3979- [Rust will now release XZ compressed packages][rust-installer/57]
3980- [rustup will now prefer to download rust packages with
3981 XZ compression][rustup/1100] over GZip packages.
3982- [Added the ability to escape `#` in rust documentation][41785] By adding
3983 additional `#`'s ie. `##` is now `#`
3984
3985Compatibility Notes
3986-------------------
3987
3988- [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3989- [`-Z` flags are now no longer allowed to be used on the stable
3990 compiler.][41751] This has been a warning for a year previous to this.
3991- [As a result of the `-Z` flag change, the `cargo-check` plugin no
3992 longer works][42844]. Users should migrate to the built-in `check`
3993 command, which has been available since 1.16.
3994- [Ending a float literal with `._` is now a hard error.
3995 Example: `42._` .][41946]
3996- [Any use of a private `extern crate` outside of its module is now a
3997 hard error.][36886] This was previously a warning.
3998- [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3999 relative while the `::` prefix makes a path absolute, but was ignored and the
4000 path was relative regardless.
4001- [Floating point constants in match patterns is now a hard error][36890]
4002 This was previously a warning.
4003- [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4004 match patterns is now a hard error][36891] This was previously a warning.
4005- [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4006 a warning.
4007- [From the pound escape, lines consisting of multiple `#`s are
4008 now visible][41785]
2c00a5a8 4009- [It is an error to re-export private enum variants][42460]. This is
3b2f2976
XL
4010 known to break a number of crates that depend on an older version of
4011 mustache.
4012- [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4013 to use it to find the linker, and the build will fail where it did
4014 not previously][42607]
4015
4016[36886]: https://github.com/rust-lang/rust/issues/36886
4017[36888]: https://github.com/rust-lang/rust/issues/36888
4018[36890]: https://github.com/rust-lang/rust/issues/36890
4019[36891]: https://github.com/rust-lang/rust/issues/36891
4020[36892]: https://github.com/rust-lang/rust/issues/36892
4021[37406]: https://github.com/rust-lang/rust/issues/37406
4022[39983]: https://github.com/rust-lang/rust/pull/39983
4023[41145]: https://github.com/rust-lang/rust/pull/41145
4024[41192]: https://github.com/rust-lang/rust/pull/41192
4025[41258]: https://github.com/rust-lang/rust/pull/41258
4026[41370]: https://github.com/rust-lang/rust/pull/41370
4027[41449]: https://github.com/rust-lang/rust/pull/41449
4028[41530]: https://github.com/rust-lang/rust/pull/41530
4029[41624]: https://github.com/rust-lang/rust/pull/41624
4030[41656]: https://github.com/rust-lang/rust/pull/41656
4031[41659]: https://github.com/rust-lang/rust/pull/41659
4032[41676]: https://github.com/rust-lang/rust/pull/41676
4033[41751]: https://github.com/rust-lang/rust/pull/41751
4034[41764]: https://github.com/rust-lang/rust/pull/41764
4035[41785]: https://github.com/rust-lang/rust/pull/41785
4036[41873]: https://github.com/rust-lang/rust/pull/41873
4037[41907]: https://github.com/rust-lang/rust/pull/41907
4038[41946]: https://github.com/rust-lang/rust/pull/41946
4039[42016]: https://github.com/rust-lang/rust/pull/42016
4040[42037]: https://github.com/rust-lang/rust/pull/42037
4041[42068]: https://github.com/rust-lang/rust/pull/42068
4042[42150]: https://github.com/rust-lang/rust/pull/42150
4043[42162]: https://github.com/rust-lang/rust/pull/42162
4044[42225]: https://github.com/rust-lang/rust/pull/42225
4045[42264]: https://github.com/rust-lang/rust/pull/42264
4046[42302]: https://github.com/rust-lang/rust/pull/42302
4047[42460]: https://github.com/rust-lang/rust/issues/42460
4048[42607]: https://github.com/rust-lang/rust/issues/42607
4049[42740]: https://github.com/rust-lang/rust/pull/42740
4050[42844]: https://github.com/rust-lang/rust/issues/42844
4051[42948]: https://github.com/rust-lang/rust/pull/42948
4052[RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4053[RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4054[RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4055[RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4056[RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4057[`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4058[`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4059[`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4060[`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4061[cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4062[cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4063[cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4064[cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4065[cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4066[cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4067[cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4068[cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4069[cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4070[cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4071[cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4072[rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4073[rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4074
4075
cc61c64b
XL
4076Version 1.18.0 (2017-06-08)
4077===========================
4078
4079Language
4080--------
4081
4082- [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4083 make the item visible to just that module tree. Also accepts the keyword
4084 `crate` to make something public to the whole crate but not users of the
4085 library. Example: `pub(crate) mod utils;`. [RFC 1422].
4086- [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4087 `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4088- [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4089 types like `Write + Send`, trailing `+` are now supported in trait objects,
4090 and better error reporting for trait objects starting with `?Sized`.
4091- [0e+10 is now a valid floating point literal][40589]
4092- [Now warns if you bind a lifetime parameter to 'static][40734]
4093- [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4094 `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4095 representation in some cases.][40377]
4096
4097Compiler
4098--------
4099
4100- [rustc can now emit mir with `--emit mir`][39891]
4101- [Improved LLVM IR for trivial functions][40367]
4102- [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4103- [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4104 opportunities found through profiling
4105- [Improved backtrace formatting when panicking][38165]
4106
4107Libraries
4108---------
4109
4110- [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4111 iterator hasn't been advanced the original `Vec` is reassembled with no actual
4112 iteration or reallocation.
4113- [Simplified HashMap Bucket interface][40561] provides performance
4114 improvements for iterating and cloning.
4115- [Specialize Vec::from_elem to use calloc][40409]
4116- [Fixed Race condition in fs::create_dir_all][39799]
4117- [No longer caching stdio on Windows][40516]
4118- [Optimized insertion sort in slice][40807] insertion sort in some cases
4119 2.50%~ faster and in one case now 12.50% faster.
4120- [Optimized `AtomicBool::fetch_nand`][41143]
4121
4122Stabilized APIs
4123---------------
4124
4125- [`Child::try_wait`]
4126- [`HashMap::retain`]
4127- [`HashSet::retain`]
4128- [`PeekMut::pop`]
4129- [`TcpStream::peek`]
4130- [`UdpSocket::peek`]
4131- [`UdpSocket::peek_from`]
4132
4133Cargo
4134-----
4135
4136- [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4137 You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4138- [Now always emits build script warnings for crates that fail to build][cargo/3847]
4139- [Added Android build support][cargo/3885]
4140- [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4141 of a certain type, for example `cargo build --bins` will build all
4142 binaries.
4143- [Added support for haiku][cargo/3952]
4144
4145Misc
4146----
4147
4148- [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
ff7c6d11 4149- [Added rust-windbg script for better debugging on Windows][39983]
cc61c64b
XL
4150- [Rust now uses the official cross compiler for NetBSD][40612]
4151- [rustdoc now accepts `#` at the start of files][40828]
4152- [Fixed jemalloc support for musl][41168]
4153
4154Compatibility Notes
4155-------------------
4156
4157- [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4158 always placed after the sign if it exists and before the digits. With the `#`
4159 flag the zeroes are placed after the prefix and before the digits.
4160- [Due to the struct field optimisation][40377], using `transmute` on structs
4161 that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4162 always been undefined behavior, but is now more likely to break in practice.
4163- [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4164 receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4165 `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4166- [Overlapping inherent `impl`s are now a hard error][40728]
4167- [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4168- [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4169 `out.asm` and `out.ll` instead of only one of the filetypes.
4170- [ calling a function that returns `Self` will no longer work][41805] when
4171 the size of `Self` cannot be statically determined.
4172- [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4173 this has caused a few regressions namely:
4174
4175 - Changed the link order of local static/dynamic libraries (respecting the
4176 order on given rather than having the compiler reorder).
4177 - Changed how MinGW is linked, native code linked to dynamic libraries
4178 may require manually linking to the gcc support library (for the native
4179 code itself)
4180
4181[38165]: https://github.com/rust-lang/rust/pull/38165
4182[39799]: https://github.com/rust-lang/rust/pull/39799
4183[39891]: https://github.com/rust-lang/rust/pull/39891
4184[39983]: https://github.com/rust-lang/rust/pull/39983
4185[40043]: https://github.com/rust-lang/rust/pull/40043
4186[40241]: https://github.com/rust-lang/rust/pull/40241
4187[40338]: https://github.com/rust-lang/rust/pull/40338
4188[40367]: https://github.com/rust-lang/rust/pull/40367
4189[40377]: https://github.com/rust-lang/rust/pull/40377
4190[40409]: https://github.com/rust-lang/rust/pull/40409
4191[40516]: https://github.com/rust-lang/rust/pull/40516
4192[40556]: https://github.com/rust-lang/rust/pull/40556
4193[40561]: https://github.com/rust-lang/rust/pull/40561
4194[40589]: https://github.com/rust-lang/rust/pull/40589
4195[40612]: https://github.com/rust-lang/rust/pull/40612
4196[40723]: https://github.com/rust-lang/rust/pull/40723
4197[40728]: https://github.com/rust-lang/rust/pull/40728
4198[40731]: https://github.com/rust-lang/rust/pull/40731
4199[40734]: https://github.com/rust-lang/rust/pull/40734
4200[40805]: https://github.com/rust-lang/rust/pull/40805
4201[40807]: https://github.com/rust-lang/rust/pull/40807
4202[40828]: https://github.com/rust-lang/rust/pull/40828
4203[40870]: https://github.com/rust-lang/rust/pull/40870
4204[41085]: https://github.com/rust-lang/rust/pull/41085
4205[41143]: https://github.com/rust-lang/rust/pull/41143
4206[41168]: https://github.com/rust-lang/rust/pull/41168
4207[41270]: https://github.com/rust-lang/rust/issues/41270
4208[41469]: https://github.com/rust-lang/rust/pull/41469
4209[41805]: https://github.com/rust-lang/rust/issues/41805
4210[RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4211[RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4212[`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4213[`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4214[`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4215[`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4216[`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4217[`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4218[`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4219[cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4220[cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4221[cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4222[cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4223[cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4224
4225
4226Version 1.17.0 (2017-04-27)
4227===========================
4228
4229Language
4230--------
4231
4232* [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4233* [Fields of structs may be initialized without duplicating the field/variable
4234 names][39761]. [RFC 1682]
4235* [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4236* [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4237 there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4238 coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
4239 `'b`. Soundness fix.
4240* [Values passed to the indexing operator, `[]`, automatically coerce][40166]
4241* [Static variables may contain references to other statics][40027]
4242
4243Compiler
4244--------
4245
4246* [Exit quickly on only `--emit dep-info`][40336]
4247* [Make `-C relocation-model` more correctly determine whether the linker
4248 creates a position-independent executable][40245]
4249* [Add `-C overflow-checks` to directly control whether integer overflow
4250 panics][40037]
4251* [The rustc type checker now checks items on demand instead of in a single
4252 in-order pass][40008]. This is mostly an internal refactoring in support of
4253 future work, including incremental type checking, but also resolves [RFC
4254 1647], allowing `Self` to appear in `impl` `where` clauses.
4255* [Optimize vtable loads][39995]
4256* [Turn off vectorization for Emscripten targets][39990]
4257* [Provide suggestions for unknown macros imported with `use`][39953]
4258* [Fix ICEs in path resolution][39939]
4259* [Strip exception handling code on Emscripten when `panic=abort`][39193]
4260* [Add clearer error message using `&str + &str`][39116]
4261
4262Stabilized APIs
4263---------------
4264
4265* [`Arc::into_raw`]
4266* [`Arc::from_raw`]
4267* [`Arc::ptr_eq`]
4268* [`Rc::into_raw`]
4269* [`Rc::from_raw`]
4270* [`Rc::ptr_eq`]
4271* [`Ordering::then`]
4272* [`Ordering::then_with`]
4273* [`BTreeMap::range`]
4274* [`BTreeMap::range_mut`]
4275* [`collections::Bound`]
4276* [`process::abort`]
4277* [`ptr::read_unaligned`]
4278* [`ptr::write_unaligned`]
4279* [`Result::expect_err`]
4280* [`Cell::swap`]
4281* [`Cell::replace`]
4282* [`Cell::into_inner`]
4283* [`Cell::take`]
4284
4285Libraries
4286---------
4287
4288* [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4289* [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4290* [`String` implements `FromIterator<&char>`][40028]
4291* `Box` [implements][40009] a number of new conversions:
4292 `From<Box<str>> for String`,
4293 `From<Box<[T]>> for Vec<T>`,
4294 `From<Box<CStr>> for CString`,
4295 `From<Box<OsStr>> for OsString`,
4296 `From<Box<Path>> for PathBuf`,
4297 `Into<Box<str>> for String`,
4298 `Into<Box<[T]>> for Vec<T>`,
4299 `Into<Box<CStr>> for CString`,
4300 `Into<Box<OsStr>> for OsString`,
4301 `Into<Box<Path>> for PathBuf`,
4302 `Default for Box<str>`,
4303 `Default for Box<CStr>`,
4304 `Default for Box<OsStr>`,
4305 `From<&CStr> for Box<CStr>`,
4306 `From<&OsStr> for Box<OsStr>`,
4307 `From<&Path> for Box<Path>`
4308* [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4309* [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4310* [Slightly optimize `slice::sort`][39538]
4311* [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4312* [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4313 `Box<str>` implements `From<&str>`][39438]
4314* [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4315 `From<(I, u16)> where I: Into<IpAddr>`][39372]
4316* [`format!` estimates the needed capacity before writing a string][39356]
4317* [Support unprivileged symlink creation in Windows][38921]
4318* [`PathBuf` implements `Default`][38764]
4319* [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4320* [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4321 and poor hash functions.
4322
4323Cargo
4324-----
4325
4326* [Add `cargo check --all`][cargo/3731]
4327* [Add an option to ignore SSL revocation checking][cargo/3699]
4328* [Add `cargo run --package`][cargo/3691]
4329* [Add `required_features`][cargo/3667]
4330* [Assume `build.rs` is a build script][cargo/3664]
4331* [Find workspace via `workspace_root` link in containing member][cargo/3562]
4332
4333Misc
4334----
4335
4336* [Documentation is rendered with mdbook instead of the obsolete, in-tree
4337 `rustbook`][39633]
4338* [The "Unstable Book" documents nightly-only features][ubook]
4339* [Improve the style of the sidebar in rustdoc output][40265]
4340* [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4341* [Fix MSP430 breakage due to `i128`][40257]
4342* [Preliminary Solaris/SPARCv9 support][39903]
4343* [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4344 run without installing the MSVC runtime.
4345* [`rustdoc --test` includes file names in test names][39788]
4346* This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4347 `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4348* [Initial support for `aarch64-unknown-freebsd`][39491]
4349* [Initial support for `i686-unknown-netbsd`][39426]
4350* [This release no longer includes the old makefile build system][39431]. Rust
4351 is built with a custom build system, written in Rust, and with Cargo.
4352* [Add Debug implementations for libcollection structs][39002]
4353* [`TypeId` implements `PartialOrd` and `Ord`][38981]
4354* [`--test-threads=0` produces an error][38945]
4355* [`rustup` installs documentation by default][40526]
4356* [The Rust source includes NatVis visualizations][39843]. These can be used by
4357 WinDbg and Visual Studio to improve the debugging experience.
4358
4359Compatibility Notes
4360-------------------
4361
4362* [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4363 workaround, either use MSVC 2015 or run vcvars.bat.
4364* [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4365 disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4366 `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4367 fix.
4368* [`format!` and `Display::to_string` panic if an underlying formatting
4369 implementation returns an error][40117]. Previously the error was silently
4370 ignored. It is incorrect for `write_fmt` to return an error when writing
4371 to a string.
4372* [In-tree crates are verified to be unstable][39851]. Previously, some minor
4373 crates were marked stable and could be accessed from the stable toolchain.
4374* [Rust git source no longer includes vendored crates][39728]. Those that need
4375 to build with vendored crates should build from release tarballs.
4376* [Fix inert attributes from `proc_macro_derives`][39572]
4377* [During crate resolution, rustc prefers a crate in the sysroot if two crates
4378 are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4379 build system.
4380* [Fixed bugs around how type inference interacts with dead-code][39485]. The
4381 existing code generally ignores the type of dead-code unless a type-hint is
4382 provided; this can cause surprising inference interactions particularly around
4383 defaulting. The new code uniformly ignores the result type of dead-code.
4384* [Tuple-struct constructors with private fields are no longer visible][38932]
4385* [Lifetime parameters that do not appear in the arguments are now considered
4386 early-bound][38897], resolving a soundness bug (#[32330]). The
4387 `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4388 April of 2016.
4389* [rustdoc: fix doctests with non-feature crate attributes][38161]
4390* [Make transmuting from fn item types to pointer-sized types a hard
4391 error][34198]
4392
4393[27787]: https://github.com/rust-lang/rust/issues/27787
4394[32330]: https://github.com/rust-lang/rust/issues/32330
4395[34198]: https://github.com/rust-lang/rust/pull/34198
4396[38161]: https://github.com/rust-lang/rust/pull/38161
4397[38368]: https://github.com/rust-lang/rust/pull/38368
4398[38584]: https://github.com/rust-lang/rust/issues/38584
4399[38661]: https://github.com/rust-lang/rust/pull/38661
4400[38764]: https://github.com/rust-lang/rust/pull/38764
4401[38864]: https://github.com/rust-lang/rust/issues/38864
4402[38897]: https://github.com/rust-lang/rust/pull/38897
4403[38921]: https://github.com/rust-lang/rust/pull/38921
4404[38932]: https://github.com/rust-lang/rust/pull/38932
4405[38945]: https://github.com/rust-lang/rust/pull/38945
4406[38981]: https://github.com/rust-lang/rust/pull/38981
4407[39002]: https://github.com/rust-lang/rust/pull/39002
4408[39116]: https://github.com/rust-lang/rust/pull/39116
4409[39193]: https://github.com/rust-lang/rust/pull/39193
4410[39265]: https://github.com/rust-lang/rust/pull/39265
4411[39356]: https://github.com/rust-lang/rust/pull/39356
4412[39372]: https://github.com/rust-lang/rust/pull/39372
4413[39426]: https://github.com/rust-lang/rust/pull/39426
4414[39431]: https://github.com/rust-lang/rust/pull/39431
4415[39438]: https://github.com/rust-lang/rust/pull/39438
4416[39440]: https://github.com/rust-lang/rust/pull/39440
4417[39485]: https://github.com/rust-lang/rust/pull/39485
4418[39491]: https://github.com/rust-lang/rust/pull/39491
4419[39518]: https://github.com/rust-lang/rust/pull/39518
4420[39538]: https://github.com/rust-lang/rust/pull/39538
4421[39572]: https://github.com/rust-lang/rust/pull/39572
4422[39633]: https://github.com/rust-lang/rust/pull/39633
4423[39642]: https://github.com/rust-lang/rust/pull/39642
4424[39728]: https://github.com/rust-lang/rust/pull/39728
4425[39761]: https://github.com/rust-lang/rust/pull/39761
4426[39788]: https://github.com/rust-lang/rust/pull/39788
4427[39793]: https://github.com/rust-lang/rust/pull/39793
4428[39837]: https://github.com/rust-lang/rust/pull/39837
4429[39843]: https://github.com/rust-lang/rust/pull/39843
4430[39851]: https://github.com/rust-lang/rust/pull/39851
4431[39903]: https://github.com/rust-lang/rust/pull/39903
4432[39939]: https://github.com/rust-lang/rust/pull/39939
4433[39953]: https://github.com/rust-lang/rust/pull/39953
4434[39960]: https://github.com/rust-lang/rust/pull/39960
4435[39990]: https://github.com/rust-lang/rust/pull/39990
4436[39995]: https://github.com/rust-lang/rust/pull/39995
4437[40008]: https://github.com/rust-lang/rust/pull/40008
4438[40009]: https://github.com/rust-lang/rust/pull/40009
4439[40027]: https://github.com/rust-lang/rust/pull/40027
4440[40028]: https://github.com/rust-lang/rust/pull/40028
4441[40037]: https://github.com/rust-lang/rust/pull/40037
4442[40117]: https://github.com/rust-lang/rust/pull/40117
4443[40166]: https://github.com/rust-lang/rust/pull/40166
4444[40245]: https://github.com/rust-lang/rust/pull/40245
4445[40257]: https://github.com/rust-lang/rust/pull/40257
4446[40261]: https://github.com/rust-lang/rust/pull/40261
4447[40265]: https://github.com/rust-lang/rust/pull/40265
4448[40319]: https://github.com/rust-lang/rust/pull/40319
4449[40336]: https://github.com/rust-lang/rust/pull/40336
4450[40526]: https://github.com/rust-lang/rust/pull/40526
4451[RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4452[RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4453[RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4454[RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4455[`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4456[`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4457[`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4458[`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4459[`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4460[`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4461[`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4462[`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4463[`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4464[`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4465[`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4466[`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4467[`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4468[`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4469[`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4470[`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4471[`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4472[`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4473[`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4474[cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4475[cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4476[cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4477[cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4478[cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4479[cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4480[mdbook]: https://crates.io/crates/mdbook
4481[ubook]: https://doc.rust-lang.org/unstable-book/
4482
4483
32a655c1
SL
4484Version 1.16.0 (2017-03-16)
4485===========================
4486
4487Language
4488--------
4489
32a655c1
SL
4490* [The compiler's `dead_code` lint now accounts for type aliases][38051].
4491* [Uninhabitable enums (those without any variants) no longer permit wildcard
4492 match patterns][38069]
4493* [Clean up semantics of `self` in an import list][38313]
4494* [`Self` may appear in `impl` headers][38920]
4495* [`Self` may appear in struct expressions][39282]
4496
4497Compiler
4498--------
4499
4500* [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4501 a `.rmeta` file containing only crate metadata][38571]. This can be
4502 used by tools like the Rust Language Service to perform
4503 metadata-only builds.
4504* [Levenshtein based typo suggestions now work in most places, while
4505 previously they worked only for fields and sometimes for local
4506 variables][38927]. Together with the overhaul of "no
4507 resolution"/"unexpected resolution" errors (#[38154]) they result in
4508 large and systematic improvement in resolution diagnostics.
4509* [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4510 `U`][38670]
4511* [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4512* [`rustc` no longer attempts to provide "consider using an explicit
4513 lifetime" suggestions][37057]. They were inaccurate.
4514
4515Stabilized APIs
4516---------------
4517
4518* [`VecDeque::truncate`]
4519* [`VecDeque::resize`]
4520* [`String::insert_str`]
4521* [`Duration::checked_add`]
4522* [`Duration::checked_sub`]
4523* [`Duration::checked_div`]
4524* [`Duration::checked_mul`]
4525* [`str::replacen`]
4526* [`str::repeat`]
4527* [`SocketAddr::is_ipv4`]
4528* [`SocketAddr::is_ipv6`]
4529* [`IpAddr::is_ipv4`]
4530* [`IpAddr::is_ipv6`]
4531* [`Vec::dedup_by`]
4532* [`Vec::dedup_by_key`]
4533* [`Result::unwrap_or_default`]
4534* [`<*const T>::wrapping_offset`]
4535* [`<*mut T>::wrapping_offset`]
4536* `CommandExt::creation_flags`
4537* [`File::set_permissions`]
4538* [`String::split_off`]
4539
4540Libraries
4541---------
4542
4543* [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4544 their argument by `Borrow` parameter][37761]
4545* [All public types in std implement `Debug`][38006]
4546* [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4547* [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4548* [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4549 Windows][38274]
4550* [std: Fix partial writes in `LineWriter`][38062]
4551* [std: Clamp max read/write sizes on Unix][38062]
4552* [Use more specific panic message for `&str` slicing errors][38066]
4553* [`TcpListener::set_only_v6` is deprecated][38304]. This
4554 functionality cannot be achieved in std currently.
4555* [`writeln!`, like `println!`, now accepts a form with no string
4556 or formatting arguments, to just print a newline][38469]
4557* [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4558* [Reduce the size of static data in `std_unicode::tables`][38781]
4559* [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4560 `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4561 `Display`][38909]
4562* [`Duration` implements `Sum`][38712]
4563* [`String` implements `ToSocketAddrs`][39048]
4564
4565Cargo
4566-----
4567
4568* [The `cargo check` command does a type check of a project without
4569 building it][cargo/3296]
4570* [crates.io will display CI badges from Travis and AppVeyor, if
4571 specified in Cargo.toml][cargo/3546]
4572* [crates.io will display categories listed in Cargo.toml][cargo/3301]
4573* [Compilation profiles accept integer values for `debug`, in addition
4574 to `true` and `false`. These are passed to `rustc` as the value to
4575 `-C debuginfo`][cargo/3534]
4576* [Implement `cargo --version --verbose`][cargo/3604]
4577* [All builds now output 'dep-info' build dependencies compatible with
4578 make and ninja][cargo/3557]
4579* [Build all workspace members with `build --all`][cargo/3511]
4580* [Document all workspace members with `doc --all`][cargo/3515]
4581* [Path deps outside workspace are not members][cargo/3443]
4582
4583Misc
4584----
4585
4586* [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4587 the path to the Rust implementation][38589]
4588* [The `armv7-linux-androideabi` target no longer enables NEON
4589 extensions, per Google's ABI guide][38413]
4590* [The stock standard library can be compiled for Redox OS][38401]
4591* [Rust has initial SPARC support][38726]. Tier 3. No builds
4592 available.
4593* [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4594 builds available.
4595* [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4596
4597Compatibility Notes
4598-------------------
4599
4600* [Uninhabitable enums (those without any variants) no longer permit wildcard
4601 match patterns][38069]
4602* In this release, references to uninhabited types can not be
4603 pattern-matched. This was accidentally allowed in 1.15.
4604* [The compiler's `dead_code` lint now accounts for type aliases][38051].
4605* [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4606 Windows][38274]
4607* [Clean up semantics of `self` in an import list][38313]
3b2f2976
XL
4608* Reimplemented lifetime elision. This change was almost entirely compatible
4609 with existing code, but it did close a number of small bugs and loopholes,
4610 as well as being more accepting in some other [cases][41105].
32a655c1
SL
4611
4612[37057]: https://github.com/rust-lang/rust/pull/37057
4613[37761]: https://github.com/rust-lang/rust/pull/37761
4614[38006]: https://github.com/rust-lang/rust/pull/38006
4615[38051]: https://github.com/rust-lang/rust/pull/38051
4616[38062]: https://github.com/rust-lang/rust/pull/38062
4617[38062]: https://github.com/rust-lang/rust/pull/38622
4618[38066]: https://github.com/rust-lang/rust/pull/38066
4619[38069]: https://github.com/rust-lang/rust/pull/38069
4620[38131]: https://github.com/rust-lang/rust/pull/38131
4621[38154]: https://github.com/rust-lang/rust/pull/38154
4622[38274]: https://github.com/rust-lang/rust/pull/38274
4623[38304]: https://github.com/rust-lang/rust/pull/38304
4624[38313]: https://github.com/rust-lang/rust/pull/38313
4625[38314]: https://github.com/rust-lang/rust/pull/38314
4626[38327]: https://github.com/rust-lang/rust/pull/38327
4627[38401]: https://github.com/rust-lang/rust/pull/38401
4628[38413]: https://github.com/rust-lang/rust/pull/38413
4629[38469]: https://github.com/rust-lang/rust/pull/38469
4630[38559]: https://github.com/rust-lang/rust/pull/38559
4631[38571]: https://github.com/rust-lang/rust/pull/38571
4632[38580]: https://github.com/rust-lang/rust/pull/38580
4633[38589]: https://github.com/rust-lang/rust/pull/38589
4634[38670]: https://github.com/rust-lang/rust/pull/38670
4635[38712]: https://github.com/rust-lang/rust/pull/38712
4636[38726]: https://github.com/rust-lang/rust/pull/38726
4637[38781]: https://github.com/rust-lang/rust/pull/38781
4638[38798]: https://github.com/rust-lang/rust/pull/38798
4639[38909]: https://github.com/rust-lang/rust/pull/38909
4640[38920]: https://github.com/rust-lang/rust/pull/38920
4641[38927]: https://github.com/rust-lang/rust/pull/38927
4642[39048]: https://github.com/rust-lang/rust/pull/39048
4643[39282]: https://github.com/rust-lang/rust/pull/39282
4644[39379]: https://github.com/rust-lang/rust/pull/39379
3b2f2976 4645[41105]: https://github.com/rust-lang/rust/issues/41105
32a655c1
SL
4646[`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4647[`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4648[`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4649[`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4650[`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4651[`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4652[`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4653[`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4654[`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4655[`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4656[`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4657[`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4658[`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4659[`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4660[`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4661[`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4662[`VecDeque::resize`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4663[`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4664[`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4665[`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4666[cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4667[cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4668[cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4669[cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4670[cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4671[cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4672[cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4673[cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4674[cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4675[RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4676
4677
e81b0574
SL
4678Version 1.15.1 (2017-02-09)
4679===========================
4680
4681* [Fix IntoIter::as_mut_slice's signature][39466]
4682* [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4683
4684[39466]: https://github.com/rust-lang/rust/pull/39466
4685[39523]: https://github.com/rust-lang/rust/pull/39523
4686
4687
476ff2be
SL
4688Version 1.15.0 (2017-02-02)
4689===========================
4690
4691Language
4692--------
4693
4694* Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4695 stable. This allows popular code-generating crates like Serde and Diesel to
4696 work ergonomically. [RFC 1681].
4697* [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4698 with curly braces][36868]. Part of [RFC 1506].
4699* [A number of minor changes to name resolution have been activated][37127].
4700 They add up to more consistent semantics, allowing for future evolution of
4701 Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4702 details of what is different. The breaking changes here have been transitioned
4703 through the [`legacy_imports`] lint since 1.14, with no known regressions.
4704* [In `macro_rules`, `path` fragments can now be parsed as type parameter
4705 bounds][38279]
4706* [`?Sized` can be used in `where` clauses][37791]
4707* [There is now a limit on the size of monomorphized types and it can be
4708 modified with the `#![type_size_limit]` crate attribute, similarly to
4709 the `#![recursion_limit]` attribute][37789]
4710
4711Compiler
4712--------
4713
4714* [On Windows, the compiler will apply dllimport attributes when linking to
4715 extern functions][37973]. Additional attributes and flags can control which
4716 library kind is linked and its name. [RFC 1717].
4717* [Rust-ABI symbols are no longer exported from cdylibs][38117]
4718* [The `--test` flag works with procedural macro crates][38107]
4719* [Fix `extern "aapcs" fn` ABI][37814]
4720* [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4721* [The `format!` expander recognizes incorrect `printf` and shell-style
4722 formatting directives and suggests the correct format][37613].
4723* [Only report one error for all unused imports in an import list][37456]
4724
4725Compiler Performance
4726--------------------
4727
4728* [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4729* [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4730* [Don't clone in `UnificationTable::probe`][37848]
4731* [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4732* [Use small vectors in type walker][37760]
4733* [Macro expansion performance was improved][37701]
4734* [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4735* [Replace FNV with a faster hash function][37229]
4736
4737Stabilized APIs
4738---------------
4739
4740* [`std::iter::Iterator::min_by`]
4741* [`std::iter::Iterator::max_by`]
4742* [`std::os::*::fs::FileExt`]
4743* [`std::sync::atomic::Atomic*::get_mut`]
4744* [`std::sync::atomic::Atomic*::into_inner`]
4745* [`std::vec::IntoIter::as_slice`]
4746* [`std::vec::IntoIter::as_mut_slice`]
4747* [`std::sync::mpsc::Receiver::try_iter`]
4748* [`std::os::unix::process::CommandExt::before_exec`]
4749* [`std::rc::Rc::strong_count`]
4750* [`std::rc::Rc::weak_count`]
4751* [`std::sync::Arc::strong_count`]
4752* [`std::sync::Arc::weak_count`]
4753* [`std::char::encode_utf8`]
4754* [`std::char::encode_utf16`]
4755* [`std::cell::Ref::clone`]
4756* [`std::io::Take::into_inner`]
4757
4758Libraries
4759---------
4760
4761* [The standard sorting algorithm has been rewritten for dramatic performance
4762 improvements][38192]. It is a hybrid merge sort, drawing influences from
4763 Timsort. Previously it was a naive merge sort.
4764* [`Iterator::nth` no longer has a `Sized` bound][38134]
4765* [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4766 performance.
4767* [`chars().count()` is much faster][37888] and so are [`chars().last()`
4768 and `char_indices().last()`][37882]
4769* [Fix ARM Objective-C ABI in `std::env::args`][38146]
4770* [Chinese characters display correctly in `fmt::Debug`][37855]
4771* [Derive `Default` for `Duration`][37699]
4772* [Support creation of anonymous pipes on WinXP/2k][37677]
4773* [`mpsc::RecvTimeoutError` implements `Error`][37527]
4774* [Don't pass overlapped handles to processes][38835]
4775
4776Cargo
4777-----
4778
4779* [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4780 environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4781 should instead check the variable at runtime with `std::env`. That the value
4782 was set at build time was a bug, and incorrect when cross-compiling. This
4783 change is known to cause breakage.
4784* [Add `--all` flag to `cargo test`][cargo/3221]
4785* [Compile statically against the MSVC CRT][cargo/3363]
4786* [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4787* [Link OpenSSL statically on OSX][cargo/3311]
4788* [Apply new fingerprinting to build dir outputs][cargo/3310]
4789* [Test for bad path overrides with summaries][cargo/3336]
4790* [Require `cargo install --vers` to take a semver version][cargo/3338]
4791* [Fix retrying crate downloads for network errors][cargo/3348]
4792* [Implement string lookup for `build.rustflags` config key][cargo/3356]
4793* [Emit more info on --message-format=json][cargo/3319]
4794* [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4795* [Don't ignore errors in workspace manifest][cargo/3409]
4796* [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4797
4798Tooling
4799-------
4800
4801* [Test runners (binaries built with `--test`) now support a `--list` argument
4802 that lists the tests it contains][38185]
4803* [Test runners now support a `--exact` argument that makes the test filter
4804 match exactly, instead of matching only a substring of the test name][38181]
4805* [rustdoc supports a `--playground-url` flag][37763]
4806* [rustdoc provides more details about `#[should_panic]` errors][37749]
4807
4808Misc
4809----
4810
4811* [The Rust build system is now written in Rust][37817]. The Makefiles may
4812 continue to be used in this release by passing `--disable-rustbuild` to the
4813 configure script, but they will be deleted soon. Note that the new build
4814 system uses a different on-disk layout that will likely affect any scripts
4815 building Rust.
4816* [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4817 releases.
4818* [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4819* [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4820 releases.
4821
4822Compatibility Notes
4823-------------------
4824
4825* [A number of minor changes to name resolution have been activated][37127].
4826 They add up to more consistent semantics, allowing for future evolution of
4827 Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4828 details of what is different. The breaking changes here have been transitioned
4829 through the [`legacy_imports`] lint since 1.14, with no known regressions.
4830* [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4831 environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4832 should instead check the variable at runtime with `std::env`. That the value
4833 was set at build time was a bug, and incorrect when cross-compiling. This
4834 change is known to cause breakage.
4835* [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4836 types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4837 1.10 and is now an error by default. It will become a hard error in the near
4838 future.
4839* [The semantics relating modules to file system directories are changing in
4840 minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4841 lint, which is a warning in this release, and will become a hard error in the
4842 future.
4843* [Rust-ABI symbols are no longer exported from cdylibs][38117]
4844* [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4845 the underlying iterator][37834]
4846
4847["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4848[33685]: https://github.com/rust-lang/rust/issues/33685
4849[36868]: https://github.com/rust-lang/rust/pull/36868
4850[37127]: https://github.com/rust-lang/rust/pull/37127
4851[37229]: https://github.com/rust-lang/rust/pull/37229
4852[37456]: https://github.com/rust-lang/rust/pull/37456
4853[37527]: https://github.com/rust-lang/rust/pull/37527
4854[37602]: https://github.com/rust-lang/rust/pull/37602
4855[37613]: https://github.com/rust-lang/rust/pull/37613
4856[37615]: https://github.com/rust-lang/rust/pull/37615
4857[37636]: https://github.com/rust-lang/rust/pull/37636
32a655c1 4858[37627]: https://github.com/rust-lang/rust/pull/37627
476ff2be
SL
4859[37642]: https://github.com/rust-lang/rust/pull/37642
4860[37677]: https://github.com/rust-lang/rust/pull/37677
4861[37699]: https://github.com/rust-lang/rust/pull/37699
4862[37701]: https://github.com/rust-lang/rust/pull/37701
4863[37705]: https://github.com/rust-lang/rust/pull/37705
4864[37749]: https://github.com/rust-lang/rust/pull/37749
4865[37760]: https://github.com/rust-lang/rust/pull/37760
4866[37763]: https://github.com/rust-lang/rust/pull/37763
4867[37764]: https://github.com/rust-lang/rust/pull/37764
4868[37789]: https://github.com/rust-lang/rust/pull/37789
4869[37791]: https://github.com/rust-lang/rust/pull/37791
4870[37814]: https://github.com/rust-lang/rust/pull/37814
4871[37817]: https://github.com/rust-lang/rust/pull/37817
4872[37834]: https://github.com/rust-lang/rust/pull/37834
4873[37848]: https://github.com/rust-lang/rust/pull/37848
4874[37855]: https://github.com/rust-lang/rust/pull/37855
4875[37882]: https://github.com/rust-lang/rust/pull/37882
4876[37888]: https://github.com/rust-lang/rust/pull/37888
4877[37973]: https://github.com/rust-lang/rust/pull/37973
4878[37979]: https://github.com/rust-lang/rust/pull/37979
4879[38086]: https://github.com/rust-lang/rust/pull/38086
4880[38107]: https://github.com/rust-lang/rust/pull/38107
4881[38117]: https://github.com/rust-lang/rust/pull/38117
4882[38134]: https://github.com/rust-lang/rust/pull/38134
4883[38146]: https://github.com/rust-lang/rust/pull/38146
4884[38181]: https://github.com/rust-lang/rust/pull/38181
4885[38182]: https://github.com/rust-lang/rust/pull/38182
4886[38185]: https://github.com/rust-lang/rust/pull/38185
4887[38192]: https://github.com/rust-lang/rust/pull/38192
4888[38279]: https://github.com/rust-lang/rust/pull/38279
4889[38835]: https://github.com/rust-lang/rust/pull/38835
4890[RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4891[RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4892[RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4893[RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4894[RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4895[`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4896[`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4897[cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4898[cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4899[cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4900[cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4901[cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4902[cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4903[cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4904[cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4905[cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4906[cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4907[cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4908[cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4909[cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4910[cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4911[`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4912[`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4913[`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4914[`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4915[`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4916[`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4917[`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4918[`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4919[`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4920[`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4921[`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4922[`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4923[`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4924[`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4925[`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4926[`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4927[`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4928
4929
4930Version 1.14.0 (2016-12-22)
4931===========================
4932
4933Language
4934--------
4935
4936* [`..` matches multiple tuple fields in enum variants, structs
4937 and tuples][36843]. [RFC 1492].
4938* [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4939* [`use *` and `use ::*` both glob-import from the crate root][37367]
4940* [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4941 dereferencing][36822]
4942
4943Compiler
4944--------
4945
4946* [Mark enums with non-zero discriminant as non-zero][37224]
4947* [Lower-case `static mut` names are linted like other
4948 statics and consts][37162]
4949* [Fix ICE on some macros in const integer positions
4950 (e.g. `[u8; m!()]`)][36819]
4951* [Improve error message and snippet for "did you mean `x`"][36798]
4952* [Add a panic-strategy field to the target specification][36794]
4953* [Include LLVM version in `--version --verbose`][37200]
4954
4955Compile-time Optimizations
4956--------------------------
4957
4958* [Improve macro expansion performance][37569]
4959* [Shrink `Expr_::ExprInlineAsm`][37445]
4960* [Replace all uses of SHA-256 with BLAKE2b][37439]
4961* [Reduce the number of bytes hashed by `IchHasher`][37427]
4962* [Avoid more allocations when compiling html5ever][37373]
4963* [Use `SmallVector` in `CombineFields::instantiate`][37322]
4964* [Avoid some allocations in the macro parser][37318]
4965* [Use a faster deflate setting][37298]
4966* [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4967 during interning of slices][37270]
4968* [Optimize `write_metadata`][37267]
4969* [Don't process obligation forest cycles when stalled][37231]
4970* [Avoid many `CrateConfig` clones][37161]
4971* [Optimize `Substs::super_fold_with`][37108]
4972* [Optimize `ObligationForest`'s `NodeState` handling][36993]
4973* [Speed up `plug_leaks`][36917]
4974
4975Libraries
4976---------
4977
4978* [`println!()`, with no arguments, prints newline][36825].
4979 Previously, an empty string was required to achieve the same.
4980* [`Wrapping` impls standard binary and unary operators, as well as
4981 the `Sum` and `Product` iterators][37356]
4982* [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4983 Vec<T>`][37326]
4984* [Improve `fold` performance for `chain`, `cloned`, `map`, and
4985 `VecDeque` iterators][37315]
4986* [Improve `SipHasher` performance on small values][37312]
4987* [Add Iterator trait TrustedLen to enable better FromIterator /
4988 Extend][37306]
4989* [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4990* [`ReadDir` implements `Debug`][37221]
4991* [Implement `RefUnwindSafe` for atomic types][37178]
4992* [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4993* [Avoid allocations in `Decoder::read_str`][37064]
4994* [`io::Error` implements `From<io::ErrorKind>`][37037]
4995* [Impl `Debug` for raw pointers to unsized data][36880]
4996* [Don't reuse `HashMap` random seeds][37470]
4997* [The internal memory layout of `HashMap` is more cache-friendly, for
4998 significant improvements in some operations][36692]
4999* [`HashMap` uses less memory on 32-bit architectures][36595]
5000* [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5001
5002Cargo
5003-----
5004
5005* [Expose rustc cfg values to build scripts][cargo/3243]
5006* [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5007* [Fix passing --features when testing multiple packages][cargo/3280]
5008* [Use a single profile set per workspace][cargo/3249]
5009* [Load `replace` sections from lock files][cargo/3220]
5010* [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5011
5012Tooling
5013-------
5014
5015* [rustup is the recommended Rust installation method][1.14rustup]
5016* This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5017 S390x. These are [tier 2] platforms and may have major defects. Follow the
5018 instructions on the website to install, or add the targets to an existing
5019 installation with `rustup target add`. The new target triples are:
5020 - `mips-unknown-linux-gnu`
5021 - `mipsel-unknown-linux-gnu`
5022 - `mips64-unknown-linux-gnuabi64`
5023 - `mips64el-unknown-linux-gnuabi64 `
5024 - `powerpc-unknown-linux-gnu`
5025 - `powerpc64-unknown-linux-gnu`
5026 - `powerpc64le-unknown-linux-gnu`
5027 - `s390x-unknown-linux-gnu `
5028* This release includes target (std) builds for ARM Linux running MUSL
5029 libc. These are [tier 2] platforms and may have major defects. Add the
5030 following triples to an existing rustup installation with `rustup target add`:
5031 - `arm-unknown-linux-musleabi`
5032 - `arm-unknown-linux-musleabihf`
5033 - `armv7-unknown-linux-musleabihf`
5034* This release includes [experimental support for WebAssembly][1.14wasm], via
5035 the `wasm32-unknown-emscripten` target. This target is known to have major
5036 defects. Please test, report, and fix.
5037* rustup no longer installs documentation by default. Run `rustup
5038 component add rust-docs` to install.
5039* [Fix line stepping in debugger][37310]
5040* [Enable line number debuginfo in releases][37280]
5041
5042Misc
5043----
5044
5045* [Disable jemalloc on aarch64/powerpc/mips][37392]
5046* [Add support for Fuchsia OS][37313]
5047* [Detect local-rebuild by only MAJOR.MINOR version][37273]
5048
5049Compatibility Notes
5050-------------------
5051
5052* [A number of forward-compatibility lints used by the compiler
5053 to gradually introduce language changes have been converted
5054 to deny by default][36894]:
5055 - ["use of inaccessible extern crate erroneously allowed"][36886]
5056 - ["type parameter default erroneously allowed in invalid location"][36887]
5057 - ["detects super or self keywords at the beginning of global path"][36888]
5058 - ["two overlapping inherent impls define an item with the same name
5059 were erroneously allowed"][36889]
5060 - ["floating-point constants cannot be used in patterns"][36890]
5061 - ["constants of struct or enum type can only be used in a pattern if
5062 the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5063 - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5064* [Prohibit patterns in trait methods without bodies][37378]
5065* [The atomic `Ordering` enum may not be matched exhaustively][37351]
5066* [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5067* [The `$crate` macro variable is accepted in fewer locations][37213]
5068* [Impls specifying extra region requirements beyond the trait
5069 they implement are rejected][37167]
5070* [Enums may not be unsized][37111]. Unsized enums are intended to
5071 work but never have. For now they are forbidden.
5072* [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5073
5074[tier 2]: https://forge.rust-lang.org/platform-support.html
5075[1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5076[1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5077[36430]: https://github.com/rust-lang/rust/pull/36430
5078[36595]: https://github.com/rust-lang/rust/pull/36595
5079[36595]: https://github.com/rust-lang/rust/pull/36595
5080[36692]: https://github.com/rust-lang/rust/pull/36692
5081[36767]: https://github.com/rust-lang/rust/pull/36767
5082[36794]: https://github.com/rust-lang/rust/pull/36794
5083[36798]: https://github.com/rust-lang/rust/pull/36798
5084[36819]: https://github.com/rust-lang/rust/pull/36819
5085[36822]: https://github.com/rust-lang/rust/pull/36822
5086[36825]: https://github.com/rust-lang/rust/pull/36825
5087[36843]: https://github.com/rust-lang/rust/pull/36843
5088[36880]: https://github.com/rust-lang/rust/pull/36880
5089[36886]: https://github.com/rust-lang/rust/issues/36886
5090[36887]: https://github.com/rust-lang/rust/issues/36887
5091[36888]: https://github.com/rust-lang/rust/issues/36888
5092[36889]: https://github.com/rust-lang/rust/issues/36889
5093[36890]: https://github.com/rust-lang/rust/issues/36890
5094[36891]: https://github.com/rust-lang/rust/issues/36891
5095[36892]: https://github.com/rust-lang/rust/issues/36892
5096[36894]: https://github.com/rust-lang/rust/pull/36894
5097[36917]: https://github.com/rust-lang/rust/pull/36917
5098[36993]: https://github.com/rust-lang/rust/pull/36993
5099[37037]: https://github.com/rust-lang/rust/pull/37037
5100[37064]: https://github.com/rust-lang/rust/pull/37064
5101[37094]: https://github.com/rust-lang/rust/pull/37094
5102[37108]: https://github.com/rust-lang/rust/pull/37108
5103[37111]: https://github.com/rust-lang/rust/pull/37111
5104[37161]: https://github.com/rust-lang/rust/pull/37161
5105[37162]: https://github.com/rust-lang/rust/pull/37162
5106[37167]: https://github.com/rust-lang/rust/pull/37167
5107[37178]: https://github.com/rust-lang/rust/pull/37178
5108[37200]: https://github.com/rust-lang/rust/pull/37200
5109[37213]: https://github.com/rust-lang/rust/pull/37213
5110[37221]: https://github.com/rust-lang/rust/pull/37221
5111[37224]: https://github.com/rust-lang/rust/pull/37224
5112[37230]: https://github.com/rust-lang/rust/pull/37230
5113[37231]: https://github.com/rust-lang/rust/pull/37231
5114[37247]: https://github.com/rust-lang/rust/pull/37247
5115[37267]: https://github.com/rust-lang/rust/pull/37267
5116[37270]: https://github.com/rust-lang/rust/pull/37270
5117[37273]: https://github.com/rust-lang/rust/pull/37273
5118[37280]: https://github.com/rust-lang/rust/pull/37280
5119[37298]: https://github.com/rust-lang/rust/pull/37298
5120[37306]: https://github.com/rust-lang/rust/pull/37306
5121[37310]: https://github.com/rust-lang/rust/pull/37310
5122[37312]: https://github.com/rust-lang/rust/pull/37312
5123[37313]: https://github.com/rust-lang/rust/pull/37313
5124[37315]: https://github.com/rust-lang/rust/pull/37315
5125[37318]: https://github.com/rust-lang/rust/pull/37318
5126[37322]: https://github.com/rust-lang/rust/pull/37322
5127[37326]: https://github.com/rust-lang/rust/pull/37326
5128[37351]: https://github.com/rust-lang/rust/pull/37351
5129[37356]: https://github.com/rust-lang/rust/pull/37356
5130[37367]: https://github.com/rust-lang/rust/pull/37367
5131[37373]: https://github.com/rust-lang/rust/pull/37373
5132[37378]: https://github.com/rust-lang/rust/pull/37378
5133[37389]: https://github.com/rust-lang/rust/pull/37389
5134[37392]: https://github.com/rust-lang/rust/pull/37392
5135[37427]: https://github.com/rust-lang/rust/pull/37427
5136[37439]: https://github.com/rust-lang/rust/pull/37439
5137[37445]: https://github.com/rust-lang/rust/pull/37445
5138[37470]: https://github.com/rust-lang/rust/pull/37470
5139[37569]: https://github.com/rust-lang/rust/pull/37569
5140[RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5141[cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5142[cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5143[cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5144[cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5145[cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5146[cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5147
5148
5149Version 1.13.0 (2016-11-10)
5150===========================
5151
5152Language
5153--------
5154
5155* [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5156 errors, like the `try!` macro, described in [RFC 0243].
5157* [Stabilize macros in type position][36014]. Described in [RFC 873].
5158* [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5159* [Fix `#[derive]` for empty tuple structs/variants][35728]
5160* [Fix lifetime rules for 'if' conditions][36029]
5161* [Avoid loading and parsing unconfigured non-inline modules][36482]
5162
5163Compiler
5164--------
5165
5166* [Add the `-C link-arg` argument][36574]
5167* [Remove the old AST-based backend from rustc_trans][35764]
5168* [Don't enable NEON by default on armv7 Linux][35814]
5169* [Fix debug line number info for macro expansions][35238]
5170* [Do not emit "class method" debuginfo for types that are not
5171 DICompositeType][36008]
5172* [Warn about multiple conflicting #[repr] hints][34623]
5173* [When sizing DST, don't double-count nested struct prefixes][36351]
5174* [Default RUST_MIN_STACK to 16MiB for now][36505]
5175* [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5176* [Reject macros with empty repetitions to avoid infinite loop][36721]
5177* [Expand macros without recursing to avoid stack overflows][36214]
5178
5179Diagnostics
5180-----------
5181
5182* [Replace macro backtraces with labeled local uses][35702]
ff7c6d11 5183* [Improve error message for misplaced doc comments][33922]
476ff2be
SL
5184* [Buffer unix and lock windows to prevent message interleaving][35975]
5185* [Update lifetime errors to specifically note temporaries][36171]
5186* [Special case a few colors for Windows][36178]
5187* [Suggest `use self` when such an import resolves][36289]
5188* [Be more specific when type parameter shadows primitive type][36338]
5189* Many minor improvements
5190
5191Compile-time Optimizations
5192--------------------------
5193
5194* [Compute and cache HIR hashes at beginning][35854]
5195* [Don't hash types in loan paths][36004]
5196* [Cache projections in trans][35761]
5197* [Optimize the parser's last token handling][36527]
5198* [Only instantiate #[inline] functions in codegen units referencing
5199 them][36524]. This leads to big improvements in cases where crates export
5200 define many inline functions without using them directly.
5201* [Lazily allocate TypedArena's first chunk][36592]
5202* [Don't allocate during default HashSet creation][36734]
5203
5204Stabilized APIs
5205---------------
5206
5207* [`checked_abs`]
5208* [`wrapping_abs`]
5209* [`overflowing_abs`]
5210* [`RefCell::try_borrow`]
5211* [`RefCell::try_borrow_mut`]
5212
5213Libraries
5214---------
5215
5216* [Add `assert_ne!` and `debug_assert_ne!`][35074]
5217* [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5218 covariant][35354]
5219* [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5220* [Implement `Debug` for `std::vec::IntoIter`][35707]
5221* [`CString`: avoid excessive growth just to 0-terminate][35871]
5222* [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5223* [Use arc4rand on FreeBSD][35884]
5224* [memrchr: Correct aligned offset computation][35969]
5225* [Improve Demangling of Rust Symbols][36059]
5226* [Use monotonic time in condition variables][35048]
5227* [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5228* [Implement conversion traits for `char`][35755]
5229* [Fix illegal instruction caused by overflow in channel cloning][36104]
5230* [Zero first byte of CString on drop][36264]
5231* [Inherit overflow checks for sum and product][36372]
5232* [Add missing Eq implementations][36423]
5233* [Implement `Debug` for `DirEntry`][36631]
5234* [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5235 `errno`][36754]
5236* [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5237* [Implement more traits for `std::io::ErrorKind`][35911]
5238* [Optimize BinaryHeap bounds checking][36072]
5239* [Work around pointer aliasing issue in `Vec::extend_from_slice`,
5240 `extend_with_element`][36355]
5241* [Fix overflow checking in unsigned pow()][34942]
5242
5243Cargo
5244-----
5245
5246* This release includes security fixes to both curl and OpenSSL.
5247* [Fix transitive doctests when panic=abort][cargo/3021]
5248* [Add --all-features flag to cargo][cargo/3038]
5249* [Reject path-based dependencies in `cargo package`][cargo/3060]
5250* [Don't parse the home directory more than once][cargo/3078]
5251* [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
5252* [Update OpenSSL to 1.0.2j][cargo/3121]
5253* [Add license and license_file to cargo metadata output][cargo/3110]
5254* [Make crates-io registry URL optional in config; ignore all changes to
5255 source.crates-io][cargo/3089]
5256* [Don't download dependencies from other platforms][cargo/3123]
5257* [Build transitive dev-dependencies when needed][cargo/3125]
5258* [Add support for per-target rustflags in .cargo/config][cargo/3157]
5259* [Avoid updating registry when adding existing deps][cargo/3144]
5260* [Warn about path overrides that won't work][cargo/3136]
5261* [Use workspaces during `cargo install`][cargo/3146]
5262* [Leak mspdbsrv.exe processes on Windows][cargo/3162]
5263* [Add --message-format flag][cargo/3000]
5264* [Pass target environment for rustdoc][cargo/3205]
5265* [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
5266* [Update curl and curl-sys][cargo/3241]
5267* [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
5268
5269Tooling
5270-------
5271
5272* [rustdoc: Add the `--sysroot` argument][36586]
5273* [rustdoc: Fix a couple of issues with the search results][35655]
5274* [rustdoc: remove the `!` from macro URLs and titles][35234]
5275* [gdb: Fix pretty-printing special-cased Rust types][35585]
5276* [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5277
5278Misc
5279----
5280
5281* [Remove unmaintained style guide][35124]
5282* [Add s390x support][36369]
5283* [Initial work at Haiku OS support][36727]
5284* [Add mips-uclibc targets][35734]
5285* [Crate-ify compiler-rt into compiler-builtins][35021]
5286* [Add rustc version info (git hash + date) to dist tarball][36213]
5287* Many documentation improvements
5288
5289Compatibility Notes
5290-------------------
5291
5292* [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5293* [Deny (by default) transmuting from fn item types to pointer-sized
5294 types][34923]. Continuing the long transition to zero-sized fn items,
5295 per [RFC 401].
5296* [Fix `#[derive]` for empty tuple structs/variants][35728].
5297 Part of [RFC 1506].
5298* [Issue deprecation warnings for safe accesses to extern statics][36173]
5299* [Fix lifetime rules for 'if' conditions][36029].
5300* [Inherit overflow checks for sum and product][36372].
5301* [Forbid user-defined macros named "macro_rules"][36730].
5302
5303[33922]: https://github.com/rust-lang/rust/pull/33922
5304[34623]: https://github.com/rust-lang/rust/pull/34623
5305[34923]: https://github.com/rust-lang/rust/pull/34923
5306[34942]: https://github.com/rust-lang/rust/pull/34942
5307[34982]: https://github.com/rust-lang/rust/pull/34982
5308[35021]: https://github.com/rust-lang/rust/pull/35021
5309[35048]: https://github.com/rust-lang/rust/pull/35048
5310[35074]: https://github.com/rust-lang/rust/pull/35074
5311[35124]: https://github.com/rust-lang/rust/pull/35124
5312[35234]: https://github.com/rust-lang/rust/pull/35234
5313[35238]: https://github.com/rust-lang/rust/pull/35238
5314[35354]: https://github.com/rust-lang/rust/pull/35354
5315[35559]: https://github.com/rust-lang/rust/pull/35559
5316[35585]: https://github.com/rust-lang/rust/pull/35585
5317[35627]: https://github.com/rust-lang/rust/pull/35627
5318[35655]: https://github.com/rust-lang/rust/pull/35655
5319[35702]: https://github.com/rust-lang/rust/pull/35702
5320[35707]: https://github.com/rust-lang/rust/pull/35707
5321[35728]: https://github.com/rust-lang/rust/pull/35728
5322[35734]: https://github.com/rust-lang/rust/pull/35734
5323[35755]: https://github.com/rust-lang/rust/pull/35755
5324[35761]: https://github.com/rust-lang/rust/pull/35761
5325[35764]: https://github.com/rust-lang/rust/pull/35764
5326[35814]: https://github.com/rust-lang/rust/pull/35814
5327[35854]: https://github.com/rust-lang/rust/pull/35854
5328[35871]: https://github.com/rust-lang/rust/pull/35871
5329[35884]: https://github.com/rust-lang/rust/pull/35884
5330[35911]: https://github.com/rust-lang/rust/pull/35911
5331[35969]: https://github.com/rust-lang/rust/pull/35969
5332[35975]: https://github.com/rust-lang/rust/pull/35975
5333[36004]: https://github.com/rust-lang/rust/pull/36004
5334[36008]: https://github.com/rust-lang/rust/pull/36008
5335[36014]: https://github.com/rust-lang/rust/pull/36014
5336[36029]: https://github.com/rust-lang/rust/pull/36029
5337[36059]: https://github.com/rust-lang/rust/pull/36059
5338[36072]: https://github.com/rust-lang/rust/pull/36072
5339[36101]: https://github.com/rust-lang/rust/pull/36101
5340[36104]: https://github.com/rust-lang/rust/pull/36104
5341[36171]: https://github.com/rust-lang/rust/pull/36171
5342[36173]: https://github.com/rust-lang/rust/pull/36173
5343[36178]: https://github.com/rust-lang/rust/pull/36178
5344[36213]: https://github.com/rust-lang/rust/pull/36213
5345[36214]: https://github.com/rust-lang/rust/pull/36214
5346[36264]: https://github.com/rust-lang/rust/pull/36264
5347[36266]: https://github.com/rust-lang/rust/pull/36266
5348[36289]: https://github.com/rust-lang/rust/pull/36289
5349[36338]: https://github.com/rust-lang/rust/pull/36338
5350[36351]: https://github.com/rust-lang/rust/pull/36351
5351[36355]: https://github.com/rust-lang/rust/pull/36355
5352[36369]: https://github.com/rust-lang/rust/pull/36369
5353[36372]: https://github.com/rust-lang/rust/pull/36372
5354[36423]: https://github.com/rust-lang/rust/pull/36423
5355[36482]: https://github.com/rust-lang/rust/pull/36482
5356[36505]: https://github.com/rust-lang/rust/pull/36505
5357[36524]: https://github.com/rust-lang/rust/pull/36524
5358[36527]: https://github.com/rust-lang/rust/pull/36527
5359[36551]: https://github.com/rust-lang/rust/pull/36551
5360[36574]: https://github.com/rust-lang/rust/pull/36574
5361[36586]: https://github.com/rust-lang/rust/pull/36586
5362[36592]: https://github.com/rust-lang/rust/pull/36592
5363[36631]: https://github.com/rust-lang/rust/pull/36631
5364[36639]: https://github.com/rust-lang/rust/pull/36639
5365[36721]: https://github.com/rust-lang/rust/pull/36721
5366[36727]: https://github.com/rust-lang/rust/pull/36727
5367[36730]: https://github.com/rust-lang/rust/pull/36730
5368[36734]: https://github.com/rust-lang/rust/pull/36734
5369[36754]: https://github.com/rust-lang/rust/pull/36754
5370[36995]: https://github.com/rust-lang/rust/pull/36995
5371[RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5372[RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5373[RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5374[RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5375[RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5376[cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5377[cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5378[cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5379[cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5380[cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5381[cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5382[cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5383[cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5384[cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5385[cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5386[cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5387[cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5388[cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5389[cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5390[cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5391[cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5392[cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5393[cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5394[cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5395[cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5396[rustup]: https://www.rustup.rs
5397[`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5398[`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5399[`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5400[`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5401[`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5402[`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5403[`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5404
5405
9e0c209e
SL
5406Version 1.12.1 (2016-10-20)
5407===========================
5408
5409Regression Fixes
5410----------------
5411
5412* [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5413* [Confusion with double negation and booleans][36856]
5414* [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5415* [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5416* [1.12.0: High memory usage when linking in release mode with debug info][36926]
5417* [Corrupted memory after updated to 1.12][36936]
5418* ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5419* [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5420* [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5421
5422[36381]: https://github.com/rust-lang/rust/issues/36381
5423[36856]: https://github.com/rust-lang/rust/issues/36856
5424[36875]: https://github.com/rust-lang/rust/issues/36875
5425[36924]: https://github.com/rust-lang/rust/issues/36924
5426[36926]: https://github.com/rust-lang/rust/issues/36926
5427[36936]: https://github.com/rust-lang/rust/issues/36936
5428[37026]: https://github.com/rust-lang/rust/issues/37026
5429[37112]: https://github.com/rust-lang/rust/issues/37112
5430[37153]: https://github.com/rust-lang/rust/issues/37153
5431
5432
5bcae85e
SL
5433Version 1.12.0 (2016-09-29)
5434===========================
5435
5436Highlights
5437----------
5438
7cac9316 5439* [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5bcae85e
SL
5440 This translation pass is far simpler than the previous AST->LLVM pass, and
5441 creates opportunities to perform new optimizations directly on the MIR. It
7cac9316 5442 was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5bcae85e 5443* [`rustc` presents a new, more readable error format, along with
7cac9316 5444 machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5bcae85e 5445 Most common editors supporting Rust have been updated to work with it. It was
7cac9316 5446 previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5bcae85e
SL
5447
5448Compiler
5449--------
5450
7cac9316 5451* [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5bcae85e
SL
5452 This translation pass is far simpler than the previous AST->LLVM pass, and
5453 creates opportunities to perform new optimizations directly on the MIR. It
7cac9316 5454 was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5bcae85e 5455* [Print the Rust target name, not the LLVM target name, with
7cac9316 5456 `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5bcae85e 5457* [The computation of `TypeId` is correct in some cases where it was previously
7cac9316
XL
5458 producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5459* [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5bcae85e
SL
5460* [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5461 `--print relocation-models`, and `--print code-models` print the available
5462 options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7cac9316 5463 `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5bcae85e 5464* [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7cac9316 5465 `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5bcae85e
SL
5466 These targets produce statically-linked binaries. There are no binary release
5467 builds yet though.
5468
5469Diagnostics
5470-----------
5471
5472* [`rustc` presents a new, more readable error format, along with
7cac9316 5473 machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5bcae85e 5474 Most common editors supporting Rust have been updated to work with it. It was
7cac9316 5475 previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
c30ab7b3 5476* [In error descriptions, references are now described in plain English,
7cac9316 5477 instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5bcae85e 5478* [In error type descriptions, unknown numeric types are named `{integer}` or
7cac9316
XL
5479 `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5480* [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5bcae85e
SL
5481
5482Language
5483--------
5484
7cac9316
XL
5485* [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5486* [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5bcae85e 5487* [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7cac9316 5488 useful](https://github.com/rust-lang/rust/pull/34908)
5bcae85e 5489* [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7cac9316 5490 inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
ff7c6d11 5491* [Semicolons are properly required as statement delimiters inside
7cac9316
XL
5492 `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5493* [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5bcae85e
SL
5494
5495Stabilized APIs
5496---------------
5497
7cac9316
XL
5498* [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5499* [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5500* [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5501* [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5502* [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5503* [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5504* [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5505* [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5506* [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5507* [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5bcae85e 5508 Both on Unix and Windows.
7cac9316
XL
5509* [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5510* [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5511* [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5512* [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5513* [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5514* [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5515* [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5516* [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5bcae85e
SL
5517
5518Libraries
5519---------
5520
5521* [The `format!` macro and friends now allow a single argument to be formatted
7cac9316 5522 in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5bcae85e 5523* [The lifetime bounds on `[T]::binary_search_by` and
7cac9316
XL
5524 `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5525* [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5526* [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5527* [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5528* [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5529* [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5530* [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5531* [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5bcae85e 5532* [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7cac9316 5533 implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5bcae85e 5534* [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7cac9316
XL
5535 implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5536* [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5bcae85e 5537* [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7cac9316
XL
5538 `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5539* [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5540* [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5bcae85e 5541* [`mpsc::sync_channel` `Receiver`s return any available message before
7cac9316
XL
5542 reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5543* [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5544* [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5bcae85e
SL
5545
5546Cargo
5547-----
5548
7cac9316
XL
5549* [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5550* [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5551* [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5552* [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5553* [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5554* [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5555* [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5556* [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5557* [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5558* [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5559* [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5560* [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5561* [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5562* [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5563* [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5564* [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5bcae85e
SL
5565
5566Performance
5567-----------
5568
7cac9316
XL
5569* [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5570* [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5bcae85e
SL
5571
5572Tooling
5573-------
5574
5575* [Test binaries now support a `--test-threads` argument to specify the number
5576 of threads used to run tests, and which acts the same as the
3b2f2976 5577 `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7cac9316
XL
5578* [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5579* [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5580* [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5bcae85e 5581* [Rust releases now come with source packages that can be installed by rustup
7cac9316 5582 via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5bcae85e
SL
5583 The resulting source code can be used by tools and IDES, located in the
5584 sysroot under `lib/rustlib/src`.
5585
5586Misc
5587----
5588
7cac9316 5589* [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5bcae85e 5590* Many minor improvements to the documentation.
7cac9316 5591* [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5bcae85e
SL
5592
5593Compatibility Notes
5594-------------------
5595
5596* [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7cac9316 5597 with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5bcae85e 5598* [When formatting strings, if "precision" is specified, the "fill",
7cac9316
XL
5599 "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5600* [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5bcae85e
SL
5601
5602
5603Version 1.11.0 (2016-08-18)
5604===========================
5605
5606Language
5607--------
5608
7cac9316
XL
5609* [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5610* [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5611* [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5612* [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5bcae85e
SL
5613
5614Stabilized APIs
5615---------------
5616
7cac9316
XL
5617* [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5618* [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5619* [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5620* [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5621* [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5622* [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5bcae85e 5623 (in libcore - previously stabilized in libstd)
7cac9316 5624* [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5bcae85e 5625 (in libcore - previously stabilized in libstd)
7cac9316 5626* [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5bcae85e 5627 (in libcore - previously stabilized in libstd)
7cac9316 5628* [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5bcae85e 5629 (in libcore - previously stabilized in libstd)
7cac9316
XL
5630* [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5631* [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5632* [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5633* [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5bcae85e
SL
5634
5635Libraries
5636---------
5637
5638* [The `thread_local!` macro supports multiple definitions in a single
7cac9316
XL
5639 invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5640* [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5bcae85e 5641* [`Wrapping` implements binary, octal, lower-hex and upper-hex
7cac9316
XL
5642 `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5643* [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5644* [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5645* [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5646* [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5bcae85e
SL
5647
5648Cargo
5649-----
5650
7cac9316
XL
5651* [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5652* [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5653* [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5654* [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5655* [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5bcae85e 5656 and `-vv` prints warnings for all crates.
7cac9316
XL
5657* [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5658* [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5bcae85e 5659 This provides room for expansion by arbitrary tools.
7cac9316
XL
5660* [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5661* [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5662* [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5663* [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5664* [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5665* [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5666* [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5bcae85e
SL
5667
5668Performance
5669-----------
5670
5671* [Caching projections speeds up type check dramatically for some
7cac9316
XL
5672 workloads](https://github.com/rust-lang/rust/pull/33816)
5673* [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5bcae85e
SL
5674 This hasher is faster, but is believed to provide sufficient
5675 protection from collision attacks.
7cac9316 5676* [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5bcae85e
SL
5677
5678Rustdoc
5679-------
5680
7cac9316 5681* [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
2c00a5a8 5682* [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7cac9316
XL
5683* [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5684* [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
2c00a5a8 5685* [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5bcae85e
SL
5686
5687Tooling
5688-------
5689
7cac9316 5690* [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5bcae85e 5691* [When emitting debug info, rustc emits frame pointers for closures,
7cac9316
XL
5692 shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5693* [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5bcae85e
SL
5694* Many more errors have been given error codes and extended
5695 explanations
5696* API documentation continues to be improved, with many new examples
5697
5698Misc
5699----
5700
5701* [rustc no longer hangs when dependencies recursively re-export
7cac9316
XL
5702 submodules](https://github.com/rust-lang/rust/pull/34542)
5703* [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5bcae85e 5704* [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7cac9316
XL
5705 rewritten](https://github.com/rust-lang/rust/pull/33895)
5706* [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5bcae85e
SL
5707 No targets use this yet, but it works toward AVR support.
5708
5709Compatibility Notes
5710-------------------
5711
7cac9316 5712* [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5bcae85e 5713* [The new follow-set rules that place restrictions on `macro_rules!`
7cac9316 5714 in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
ff7c6d11 5715 This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5bcae85e 5716 and has been a warning since 1.10.
7cac9316 5717* [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5bcae85e
SL
5718 This causes breakage in some corner cases.
5719
5720
a7813a04
XL
5721Version 1.10.0 (2016-07-07)
5722===========================
5723
5724Language
5725--------
5726
7cac9316 5727* [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
a7813a04 5728 [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7cac9316
XL
5729* [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5730* [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
a7813a04 5731* [`panic!` can be converted to a runtime abort with the
7cac9316 5732 `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
a7813a04 5733 [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7cac9316 5734* [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
a7813a04 5735 cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
8faf50e0 5736 [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
a7813a04
XL
5737 Note that Cargo does not yet directly support cdylibs.
5738
5739Stabilized APIs
5740---------------
5741
5742* `os::windows::fs::OpenOptionsExt::access_mode`
5743* `os::windows::fs::OpenOptionsExt::share_mode`
5744* `os::windows::fs::OpenOptionsExt::custom_flags`
5745* `os::windows::fs::OpenOptionsExt::attributes`
5746* `os::windows::fs::OpenOptionsExt::security_qos_flags`
5747* `os::unix::fs::OpenOptionsExt::custom_flags`
7cac9316 5748* [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
a7813a04 5749* `Default for sync::Weak`
7cac9316
XL
5750* [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5751* [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5752* [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5753* [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5754* [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5755* [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5756* [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5757* [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5758* [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5759* [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5760* [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5761* [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5762* [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5763* [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
a7813a04
XL
5764* `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5765* `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5766* `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5767* `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7cac9316
XL
5768* [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5769* [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5770* [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5771* [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5772* [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5773* [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5774* [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5775* [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5776* [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5777* [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5778* [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5779* [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5780* [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5781* [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
a7813a04 5782* Read/Write/RawFd impls for `UnixStream`
7cac9316
XL
5783* [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5784* [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5785* [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5786* [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5787* [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5788* [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5789* [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
a7813a04 5790* RawFd impls for `UnixListener`
7cac9316
XL
5791* [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5792* [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5793* [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5794* [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5795* [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5796* [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5797* [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5798* [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5799* [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5800* [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5801* [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5802* [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5803* [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5804* [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5805* [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5806* [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5807* [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5808* [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
a7813a04
XL
5809* RawFd impls for `UnixDatagram`
5810* `{BTree,Hash}Map::values_mut`
74d20737 5811* [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
a7813a04
XL
5812
5813Libraries
5814---------
5815
7cac9316 5816* [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
a7813a04
XL
5817 The semantics of this minor method are subtle and probably not what
5818 most people want.
7cac9316 5819* [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
a7813a04
XL
5820* [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5821 will fall back to `/dev/urandom` temporarily to avoid blocking
7cac9316
XL
5822 during early boot](https://github.com/rust-lang/rust/pull/33086).
5823* [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5824* [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5825* [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5826* [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5827* [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
a7813a04 5828* [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7cac9316 5829 `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
a7813a04
XL
5830
5831Cargo
5832-----
7cac9316 5833* [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
a7813a04
XL
5834 This controls the runtime behavior of the `panic!` macro
5835 and can be either "unwind" (the default), or "abort".
5836 [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7cac9316
XL
5837* [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5838* [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
a7813a04 5839* [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7cac9316
XL
5840 variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5841* [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5842* [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5843* [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
a7813a04
XL
5844 By default they are retried twice, which can be customized with the
5845 `net.retry` value in `.cargo/config`.
7cac9316
XL
5846* [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5847* [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5848* [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5849* [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
a7813a04 5850 Makes it possible to install multiple crates in parallel.
7cac9316
XL
5851* [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5852* [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5853* [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5854* [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5855* [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5856* [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
a7813a04
XL
5857
5858Performance
5859-----------
5860
5861* [rustc memory usage was reduced by refactoring the context used for
7cac9316 5862 type checking](https://github.com/rust-lang/rust/pull/33425).
a7813a04 5863* [Speed up creation of `HashMap`s by caching the random keys used
7cac9316
XL
5864 to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5865* [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5866* [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5867* [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
a7813a04 5868 10x faster than the previous lookup tables.
7cac9316 5869* [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
a7813a04
XL
5870
5871Usability
5872---------
5873
5874* Many incremental improvements to documentation and rustdoc.
7cac9316
XL
5875* [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5876* [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5877* [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5878* [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5879* [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5880* [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5881* [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
a7813a04
XL
5882
5883Misc
5884----
5885
7cac9316
XL
5886* [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5887* [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
a7813a04
XL
5888* [`std` no longer prints backtraces on platforms where the running
5889 module must be loaded with `env::current_exe`, which can't be relied
5890 on](https://github.com/rust-lang/rust/pull/33554).
5891* This release includes std binaries for the i586-unknown-linux-gnu,
5892 i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5893 i586 target is for old x86 hardware without SSE2, and the armv7
5894 target is for Android running on modern ARM architectures.
5895* [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5896 Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5897* [On Unix the runtime aborts by calling `libc::abort` instead of
7cac9316 5898 generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
a7813a04 5899* [Rust is now bootstrapped from the previous release of Rust,
7cac9316 5900 instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
a7813a04
XL
5901
5902Compatibility Notes
5903-------------------
5904
7cac9316 5905* [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
a7813a04 5906* [`target_env` for Linux ARM targets is just `gnu`, not
7cac9316
XL
5907 `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5908* [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5909* [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5910* [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
a7813a04 5911 Affects how macros are parsed.
7cac9316 5912* [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
a7813a04 5913* [Feature-gated attributes on macro-generated macro invocations are
7cac9316
XL
5914 now rejected](https://github.com/rust-lang/rust/pull/32791).
5915* [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
a7813a04
XL
5916 This caused some minor changes to type inference.
5917
5918
54a0048b
SL
5919Version 1.9.0 (2016-05-26)
5920==========================
5921
5922Language
5923--------
5924
5925* The `#[deprecated]` attribute when applied to an API will generate
5926 warnings when used. The warnings may be suppressed with
5927 `#[allow(deprecated)]`. [RFC 1270].
5928* [`fn` item types are zero sized, and each `fn` names a unique
5929 type][1.9fn]. This will break code that transmutes `fn`s, so calling
5930 `transmute` on a `fn` type will generate a warning for a few cycles,
5931 then will be converted to an error.
5932* [Field and method resolution understand visibility, so private
5933 fields and methods cannot prevent the proper use of public fields
5934 and methods][1.9fv].
5935* [The parser considers unicode codepoints in the
5936 `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5937
5938Stabilized APIs
5939---------------
5940
5941* [`std::panic`]
dfeec247
XL
5942* [`std::panic::catch_unwind`] (renamed from `recover`)
5943* [`std::panic::resume_unwind`] (renamed from `propagate`)
5944* [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5945* [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
54a0048b
SL
5946* [`str::is_char_boundary`]
5947* [`<*const T>::as_ref`]
5948* [`<*mut T>::as_ref`]
5949* [`<*mut T>::as_mut`]
5950* [`AsciiExt::make_ascii_uppercase`]
5951* [`AsciiExt::make_ascii_lowercase`]
5952* [`char::decode_utf16`]
5953* [`char::DecodeUtf16`]
5954* [`char::DecodeUtf16Error`]
5955* [`char::DecodeUtf16Error::unpaired_surrogate`]
5956* [`BTreeSet::take`]
5957* [`BTreeSet::replace`]
5958* [`BTreeSet::get`]
5959* [`HashSet::take`]
5960* [`HashSet::replace`]
5961* [`HashSet::get`]
5962* [`OsString::with_capacity`]
5963* [`OsString::clear`]
5964* [`OsString::capacity`]
5965* [`OsString::reserve`]
5966* [`OsString::reserve_exact`]
5967* [`OsStr::is_empty`]
5968* [`OsStr::len`]
5969* [`std::os::unix::thread`]
5970* [`RawPthread`]
5971* [`JoinHandleExt`]
5972* [`JoinHandleExt::as_pthread_t`]
5973* [`JoinHandleExt::into_pthread_t`]
5974* [`HashSet::hasher`]
5975* [`HashMap::hasher`]
5976* [`CommandExt::exec`]
5977* [`File::try_clone`]
5978* [`SocketAddr::set_ip`]
5979* [`SocketAddr::set_port`]
5980* [`SocketAddrV4::set_ip`]
5981* [`SocketAddrV4::set_port`]
5982* [`SocketAddrV6::set_ip`]
5983* [`SocketAddrV6::set_port`]
5984* [`SocketAddrV6::set_flowinfo`]
5985* [`SocketAddrV6::set_scope_id`]
5986* [`slice::copy_from_slice`]
5987* [`ptr::read_volatile`]
5988* [`ptr::write_volatile`]
5989* [`OpenOptions::create_new`]
5990* [`TcpStream::set_nodelay`]
5991* [`TcpStream::nodelay`]
5992* [`TcpStream::set_ttl`]
5993* [`TcpStream::ttl`]
5994* [`TcpStream::set_only_v6`]
5995* [`TcpStream::only_v6`]
5996* [`TcpStream::take_error`]
5997* [`TcpStream::set_nonblocking`]
5998* [`TcpListener::set_ttl`]
5999* [`TcpListener::ttl`]
6000* [`TcpListener::set_only_v6`]
6001* [`TcpListener::only_v6`]
6002* [`TcpListener::take_error`]
6003* [`TcpListener::set_nonblocking`]
6004* [`UdpSocket::set_broadcast`]
6005* [`UdpSocket::broadcast`]
6006* [`UdpSocket::set_multicast_loop_v4`]
6007* [`UdpSocket::multicast_loop_v4`]
6008* [`UdpSocket::set_multicast_ttl_v4`]
6009* [`UdpSocket::multicast_ttl_v4`]
6010* [`UdpSocket::set_multicast_loop_v6`]
6011* [`UdpSocket::multicast_loop_v6`]
6012* [`UdpSocket::set_multicast_ttl_v6`]
6013* [`UdpSocket::multicast_ttl_v6`]
6014* [`UdpSocket::set_ttl`]
6015* [`UdpSocket::ttl`]
6016* [`UdpSocket::set_only_v6`]
6017* [`UdpSocket::only_v6`]
6018* [`UdpSocket::join_multicast_v4`]
6019* [`UdpSocket::join_multicast_v6`]
6020* [`UdpSocket::leave_multicast_v4`]
6021* [`UdpSocket::leave_multicast_v6`]
6022* [`UdpSocket::take_error`]
6023* [`UdpSocket::connect`]
6024* [`UdpSocket::send`]
6025* [`UdpSocket::recv`]
6026* [`UdpSocket::set_nonblocking`]
6027
6028Libraries
6029---------
6030
6031* [`std::sync::Once` is poisoned if its initialization function
6032 fails][1.9o].
6033* [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6034* [Most types implement `fmt::Debug`][1.9db].
6035* [The default buffer size used by `BufReader` and `BufWriter` was
6036 reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6037 used by other languages.
6038* [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6039 `Duration` additionally implements `*=` and `/=`][1.9ta].
6040* [`Skip` is a `DoubleEndedIterator`][1.9sk].
6041* [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6042* [`Chain` implements `BufRead`][1.9ch].
6043* [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6044
6045Cargo
6046-----
6047
6048* [Cargo can now run concurrently][1.9cc].
6049* [Top-level overrides allow specific revisions of crates to be
6050 overridden through the entire crate graph][1.9ct]. This is intended
6051 to make upgrades easier for large projects, by allowing crates to be
6052 forked temporarily until they've been upgraded and republished.
6053* [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6054* [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6055 on the commandline][1.9cf]. `rustc` arguments can also be specified
6056 in the `build.rustflags` configuration key.
6057
6058Performance
6059-----------
6060
c30ab7b3 6061* [The time complexity of comparing variables for equivalence during type
a7813a04
XL
6062 unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6063 to major compilation time improvement in some scenarios.
54a0048b
SL
6064* [`ToString` is specialized for `str`, giving it the same performance
6065 as `to_owned`][1.9ts].
6066* [Spawning processes with `Command::output` no longer creates extra
6067 threads][1.9sp].
6068* [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6069 for C-like enums][1.9cl].
6070
6071Misc
6072----
6073
6074* [Passing the `--quiet` flag to a test runner will produce
6075 much-abbreviated output][1.9q].
6076* The Rust Project now publishes std binaries for the
6077 `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6078 `i586-pc-windows-msvc` targets.
6079
6080Compatibility Notes
6081-------------------
6082
6083* [`std::sync::Once` is poisoned if its initialization function
6084 fails][1.9o].
6085* [It is illegal to define methods with the same name in overlapping
6086 inherent `impl` blocks][1.9sn].
6087* [`fn` item types are zero sized, and each `fn` names a unique
6088 type][1.9fn]. This will break code that transmutes `fn`s, so calling
6089 `transmute` on a `fn` type will generate a warning for a few cycles,
6090 then will be converted to an error.
6091* [Improvements to const evaluation may trigger new errors when integer
6092 literals are out of range][1.9ce].
6093
6094
6095[1.9bf]: https://github.com/rust-lang/rust/pull/32695
6096[1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6097[1.9ce]: https://github.com/rust-lang/rust/pull/30587
6098[1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6099[1.9ch]: https://github.com/rust-lang/rust/pull/32541
6100[1.9cl]: https://github.com/rust-lang/rust/pull/31977
6101[1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6102[1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6103[1.9cu]: https://github.com/rust-lang/rust/pull/32652
6104[1.9db]: https://github.com/rust-lang/rust/pull/32054
6105[1.9fi]: https://github.com/rust-lang/rust/pull/32050
6106[1.9fn]: https://github.com/rust-lang/rust/pull/31710
6107[1.9fv]: https://github.com/rust-lang/rust/pull/31938
6108[1.9hc]: https://github.com/rust-lang/rust/pull/32635
6109[1.9o]: https://github.com/rust-lang/rust/pull/32325
6110[1.9q]: https://github.com/rust-lang/rust/pull/31887
6111[1.9sk]: https://github.com/rust-lang/rust/pull/31700
6112[1.9sn]: https://github.com/rust-lang/rust/pull/31925
6113[1.9sp]: https://github.com/rust-lang/rust/pull/31618
6114[1.9ta]: https://github.com/rust-lang/rust/pull/32448
6115[1.9ts]: https://github.com/rust-lang/rust/pull/32586
6116[1.9tu]: https://github.com/rust-lang/rust/pull/32062
6117[1.9ws]: https://github.com/rust-lang/rust/pull/29734
6118[RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6119[`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6120[`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6121[`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6122[`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6123[`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6124[`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6125[`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6126[`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6127[`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6128[`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6129[`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6130[`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6131[`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6132[`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6133[`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6134[`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6135[`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6136[`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6137[`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6138[`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6139[`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6140[`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6141[`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6142[`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6143[`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6144[`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6145[`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6146[`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6147[`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6148[`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6149[`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6150[`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6151[`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6152[`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6153[`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6154[`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6155[`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6156[`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6157[`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6158[`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6159[`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6160[`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6161[`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6162[`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6163[`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6164[`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6165[`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6166[`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6167[`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6168[`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6169[`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6170[`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6171[`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6172[`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6173[`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6174[`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6175[`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6176[`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6177[`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6178[`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6179[`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6180[`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6181[`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6182[`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6183[`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6184[`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6185[`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6186[`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6187[`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6188[`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6189[`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6190[`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6191[`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6192[`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6193[`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6194[`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6195[`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6196[`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6197[`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6198[`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6199[`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6200[`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6201[`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6202[`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6203[`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6204[`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6205
6206
7453a54e
SL
6207Version 1.8.0 (2016-04-14)
6208==========================
6209
6210Language
6211--------
6212
6213* Rust supports overloading of compound assignment statements like
6214 `+=` by implementing the [`AddAssign`], [`SubAssign`],
6215 [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6216 [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6217 traits. [RFC 953].
6218* Empty structs can be defined with braces, as in `struct Foo { }`, in
6219 addition to the non-braced form, `struct Foo;`. [RFC 218].
6220
6221Libraries
6222---------
6223
6224* Stabilized APIs:
dfeec247
XL
6225 * [`str::encode_utf16`] (renamed from `utf16_units`)
6226 * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7453a54e
SL
6227 * [`Ref::map`]
6228 * [`RefMut::map`]
6229 * [`ptr::drop_in_place`]
6230 * [`time::Instant`]
6231 * [`time::SystemTime`]
6232 * [`Instant::now`]
dfeec247 6233 * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7453a54e
SL
6234 * [`Instant::elapsed`]
6235 * [`SystemTime::now`]
dfeec247 6236 * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7453a54e
SL
6237 * [`SystemTime::elapsed`]
6238 * Various `Add`/`Sub` impls for `Time` and `SystemTime`
6239 * [`SystemTimeError`]
6240 * [`SystemTimeError::duration`]
6241 * Various impls for `SystemTimeError`
6242 * [`UNIX_EPOCH`]
6243 * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
6244 [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
6245 [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
6246* [The `write!` and `writeln!` macros correctly emit errors if any of
6247 their arguments can't be formatted][1.8w].
6248* [Various I/O functions support large files on 32-bit Linux][1.8l].
6249* [The Unix-specific `raw` modules, which contain a number of
6250 redefined C types are deprecated][1.8r], including `os::raw::unix`,
6251 `os::raw::macos`, and `os::raw::linux`. These modules defined types
6252 such as `ino_t` and `dev_t`. The inconsistency of these definitions
6253 across platforms was making it difficult to implement `std`
6254 correctly. Those that need these definitions should use the `libc`
6255 crate. [RFC 1415].
6256* The Unix-specific `MetadataExt` traits, including
6257 `os::unix::fs::MetadataExt`, which expose values such as inode
6258 numbers [no longer return platform-specific types][1.8r], but
6259 instead return widened integers. [RFC 1415].
6260* [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
6261* [Atomic loads and stores are not volatile][1.8a].
6262* [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
6263
6264Performance
6265-----------
6266
6267* [Inlining hash functions lead to a 3% compile-time improvement in
6268 some workloads][1.8h].
6269* When using jemalloc, its symbols are [unprefixed so that it
6270 overrides the libc malloc implementation][1.8h]. This means that for
6271 rustc, LLVM is now using jemalloc, which results in a 6%
6272 compile-time improvement on a specific workload.
6273* [Avoid quadratic growth in function size due to cleanups][1.8cu].
6274
6275Misc
6276----
6277
6278* [32-bit MSVC builds finally implement unwinding][1.8ms].
6279 i686-pc-windows-msvc is now considered a tier-1 platform.
6280* [The `--print targets` flag prints a list of supported targets][1.8t].
6281* [The `--print cfg` flag prints the `cfg`s defined for the current
6282 target][1.8cf].
6283* [`rustc` can be built with an new Cargo-based build system, written
6284 in Rust][1.8b]. It will eventually replace Rust's Makefile-based
6285 build system. To enable it configure with `configure --rustbuild`.
6286* [Errors for non-exhaustive `match` patterns now list up to 3 missing
6287 variants while also indicating the total number of missing variants
6288 if more than 3][1.8m].
6289* [Executable stacks are disabled on Linux and BSD][1.8nx].
6290* The Rust Project now publishes binary releases of the standard
6291 library for a number of tier-2 targets:
6292 `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6293 `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6294 `x86_64-rumprun-netbsd`. These can be installed with
6295 tools such as [multirust][1.8mr].
6296
6297Cargo
6298-----
6299
6300* [`cargo init` creates a new Cargo project in the current
6301 directory][1.8ci]. It is otherwise like `cargo new`.
6302* [Cargo has configuration keys for `-v` and
6303 `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6304 `[term]` section of `.cargo/config`.
6305* [Configuration keys that evaluate to strings or integers can be set
6306 via environment variables][1.8ce]. For example the `build.jobs` key
6307 can be set via `CARGO_BUILD_JOBS`. Environment variables take
6308 precedence over config files.
6309* [Target-specific dependencies support Rust `cfg` syntax for
6310 describing targets][1.8cfg] so that dependencies for multiple
6311 targets can be specified together. [RFC 1361].
6312* [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6313 `RUSTDOC` take precedence over the `build.target-dir`,
6314 `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6315* [The child process tree is killed on Windows when Cargo is
6316 killed][1.8ck].
6317* [The `build.target` configuration value sets the target platform,
6318 like `--target`][1.8ct].
6319
6320Compatibility Notes
6321-------------------
6322
6323* [Unstable compiler flags have been further restricted][1.8u]. Since
6324 1.0 `-Z` flags have been considered unstable, and other flags that
6325 were considered unstable additionally required passing `-Z
6326 unstable-options` to access. Unlike unstable language and library
6327 features though, these options have been accessible on the stable
6328 release channel. Going forward, *new unstable flags will not be
6329 available on the stable release channel*, and old unstable flags
6330 will warn about their usage. In the future, all unstable flags will
6331 be unavailable on the stable release channel.
6332* [It is no longer possible to `match` on empty enum variants using
6333 the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6334* The Unix-specific `MetadataExt` traits, including
6335 `os::unix::fs::MetadataExt`, which expose values such as inode
6336 numbers [no longer return platform-specific types][1.8r], but
6337 instead return widened integers. [RFC 1415].
6338* [Modules sourced from the filesystem cannot appear within arbitrary
a7813a04 6339 blocks, but only within other modules][1.8mf].
7453a54e
SL
6340* [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6341* On Unix, [stack overflow triggers a runtime abort instead of a
6342 SIGSEGV][1.8so].
6343* [`Command::spawn` and its equivalents return an error if any of
6344 its command-line arguments contain interior `NUL`s][1.8n].
6345* [Tuple and unit enum variants from other crates are in the type
6346 namespace][1.8tn].
6347* [On Windows `rustc` emits `.lib` files for the `staticlib` library
6348 type instead of `.a` files][1.8st]. Additionally, for the MSVC
6349 toolchain, `rustc` emits import libraries named `foo.dll.lib`
6350 instead of `foo.lib`.
6351
6352
6353[1.8a]: https://github.com/rust-lang/rust/pull/30962
6354[1.8b]: https://github.com/rust-lang/rust/pull/31123
6355[1.8c]: https://github.com/rust-lang/rust/pull/31530
6356[1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6357[1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6358[1.8cf]: https://github.com/rust-lang/rust/pull/31278
6359[1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6360[1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6361[1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6362[1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6363[1.8cu]: https://github.com/rust-lang/rust/pull/31390
6364[1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6365[1.8cv]: https://github.com/rust-lang/rust/pull/30998
6366[1.8h]: https://github.com/rust-lang/rust/pull/31460
6367[1.8l]: https://github.com/rust-lang/rust/pull/31668
6368[1.8m]: https://github.com/rust-lang/rust/pull/31020
a7813a04 6369[1.8mf]: https://github.com/rust-lang/rust/pull/31534
7453a54e
SL
6370[1.8mp]: https://github.com/rust-lang/rust/pull/30894
6371[1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6372[1.8ms]: https://github.com/rust-lang/rust/pull/30448
6373[1.8n]: https://github.com/rust-lang/rust/pull/31056
6374[1.8nx]: https://github.com/rust-lang/rust/pull/30859
6375[1.8r]: https://github.com/rust-lang/rust/pull/31551
6376[1.8so]: https://github.com/rust-lang/rust/pull/31333
6377[1.8st]: https://github.com/rust-lang/rust/pull/29520
6378[1.8t]: https://github.com/rust-lang/rust/pull/31358
6379[1.8tn]: https://github.com/rust-lang/rust/pull/30882
6380[1.8u]: https://github.com/rust-lang/rust/pull/31793
6381[1.8v]: https://github.com/rust-lang/rust/pull/31757
6382[1.8w]: https://github.com/rust-lang/rust/pull/31904
6383[RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6384[RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6385[RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6386[RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6387[`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6388[`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6389[`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6390[`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6391[`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6392[`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6393[`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6394[`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6395[`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6396[`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6397[`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6398[`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6399[`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6400[`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6401[`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6402[`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6403[`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6404[`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6405[`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6406[`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6407[`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6408[`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6409[`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6410[`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6411[`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6412[`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6413
6414
9cc50fc6
SL
6415Version 1.7.0 (2016-03-03)
6416==========================
6417
6418Libraries
6419---------
6420
6421* Stabilized APIs
6422 * `Path`
dfeec247
XL
6423 * [`Path::strip_prefix`] (renamed from relative_from)
6424 * [`path::StripPrefixError`] (new error type returned from strip_prefix)
9cc50fc6
SL
6425 * `Ipv4Addr`
6426 * [`Ipv4Addr::is_loopback`]
6427 * [`Ipv4Addr::is_private`]
6428 * [`Ipv4Addr::is_link_local`]
6429 * [`Ipv4Addr::is_multicast`]
6430 * [`Ipv4Addr::is_broadcast`]
6431 * [`Ipv4Addr::is_documentation`]
6432 * `Ipv6Addr`
6433 * [`Ipv6Addr::is_unspecified`]
6434 * [`Ipv6Addr::is_loopback`]
6435 * [`Ipv6Addr::is_multicast`]
6436 * `Vec`
6437 * [`Vec::as_slice`]
6438 * [`Vec::as_mut_slice`]
6439 * `String`
6440 * [`String::as_str`]
6441 * [`String::as_mut_str`]
6442 * Slices
6443 * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6444 be the same length
6445 * `<[T]>::`[`sort_by_key`]
6446 * checked, saturated, and overflowing operations
6447 * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6448 * [`i32::saturating_mul`]
6449 * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6450 * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6451 * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6452 * [`u32::saturating_mul`]
6453 * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6454 * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6455 * and checked, saturated, and overflowing operations for other primitive types
6456 * FFI
6457 * [`ffi::IntoStringError`]
6458 * [`CString::into_string`]
6459 * [`CString::into_bytes`]
6460 * [`CString::into_bytes_with_nul`]
6461 * `From<CString> for Vec<u8>`
6462 * `IntoStringError`
6463 * [`IntoStringError::into_cstring`]
6464 * [`IntoStringError::utf8_error`]
6465 * `Error for IntoStringError`
54a0048b
SL
6466 * Hashing
6467 * [`std::hash::BuildHasher`]
6468 * [`BuildHasher::Hasher`]
6469 * [`BuildHasher::build_hasher`]
6470 * [`std::hash::BuildHasherDefault`]
6471 * [`HashMap::with_hasher`]
6472 * [`HashMap::with_capacity_and_hasher`]
6473 * [`HashSet::with_hasher`]
6474 * [`HashSet::with_capacity_and_hasher`]
6475 * [`std::collections::hash_map::RandomState`]
6476 * [`RandomState::new`]
9cc50fc6
SL
6477* [Validating UTF-8 is faster by a factor of between 7 and 14x for
6478 ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6479 from bytes is faster.
6480* [The performance of `LineWriter` (and thus `io::stdout`) was
6481 improved by using `memchr` to search for newlines][1.7m].
6482* [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6483 `f64` variants were stabilized previously.
6484* [`BTreeMap` was rewritten to use less memory and improve the performance
6485 of insertion and iteration, the latter by as much as 5x][1.7bm].
6486* [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6487 covariant over their contained type][1.7bt].
6488* [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6489 over their contained type][1.7ll].
6490* [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6491 searching methods.
6492* [`Any` is implemented for unsized types][1.7a].
6493* [`Hash` is implemented for `Duration`][1.7h].
6494
6495Misc
6496----
6497
6498* [When running tests with `--test`, rustdoc will pass `--cfg`
6499 arguments to the compiler][1.7dt].
6500* [The compiler is built with RPATH information by default][1.7rpa].
6501 This means that it will be possible to run `rustc` when installed in
6502 unusual configurations without configuring the dynamic linker search
6503 path explicitly.
6504* [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6505 any RPATH entries (emitted with `-C rpath`) *not* take precedence
6506 over `LD_LIBRARY_PATH`.
6507
6508Cargo
6509-----
6510
6511* [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6512 any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6513* [The `rerun-if-changed` build script directive no longer causes the
6514 build script to incorrectly run twice in certain scenarios][1.7rr].
6515
6516Compatibility Notes
6517-------------------
6518
54a0048b
SL
6519* Soundness fixes to the interactions between associated types and
6520 lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6521 code that violates the new rules. This is a significant change that
6522 is known to break existing code, so it has emitted warnings for the
6523 new error cases since 1.4 to give crate authors time to adapt. The
6524 details of what is changing are subtle; read the RFC for more.
9cc50fc6
SL
6525* [Several bugs in the compiler's visibility calculations were
6526 fixed][1.7v]. Since this was found to break significant amounts of
6527 code, the new errors will be emitted as warnings for several release
6528 cycles, under the `private_in_public` lint.
6529* Defaulted type parameters were accidentally accepted in positions
6530 that were not intended. In this release, [defaulted type parameters
6531 appearing outside of type definitions will generate a
6532 warning][1.7d], which will become an error in future releases.
54a0048b
SL
6533* [Parsing "." as a float results in an error instead of 0][1.7p].
6534 That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
9cc50fc6
SL
6535* [Borrows of closure parameters may not outlive the closure][1.7bc].
6536
6537[1.7a]: https://github.com/rust-lang/rust/pull/30928
6538[1.7bc]: https://github.com/rust-lang/rust/pull/30341
6539[1.7bm]: https://github.com/rust-lang/rust/pull/30426
6540[1.7bt]: https://github.com/rust-lang/rust/pull/30998
6541[1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6542[1.7d]: https://github.com/rust-lang/rust/pull/30724
6543[1.7dt]: https://github.com/rust-lang/rust/pull/30372
6544[1.7dta]: https://github.com/rust-lang/rust/pull/30394
6545[1.7f]: https://github.com/rust-lang/rust/pull/30672
6546[1.7h]: https://github.com/rust-lang/rust/pull/30818
6547[1.7ll]: https://github.com/rust-lang/rust/pull/30663
6548[1.7m]: https://github.com/rust-lang/rust/pull/30381
6549[1.7p]: https://github.com/rust-lang/rust/pull/30681
6550[1.7rp]: https://github.com/rust-lang/rust/pull/29498
6551[1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6552[1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6553[1.7sf]: https://github.com/rust-lang/rust/pull/30389
6554[1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6555[1.7v]: https://github.com/rust-lang/rust/pull/29973
6556[RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
54a0048b
SL
6557[`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6558[`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
9cc50fc6
SL
6559[`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6560[`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6561[`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
54a0048b
SL
6562[`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6563[`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6564[`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6565[`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
9cc50fc6
SL
6566[`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6567[`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6568[`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6569[`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6570[`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6571[`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6572[`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6573[`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6574[`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6575[`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6576[`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6577[`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
54a0048b 6578[`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
9cc50fc6
SL
6579[`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6580[`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6581[`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6582[`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
54a0048b 6583[`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
9cc50fc6
SL
6584[`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6585[`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6586[`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6587[`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6588[`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6589[`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6590[`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6591[`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6592[`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6593[`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6594[`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6595[`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6596[`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6597[`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6598[`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
54a0048b
SL
6599[`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6600[`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6601[`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6602[`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
9cc50fc6
SL
6603[`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6604[`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
54a0048b 6605[`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
9cc50fc6
SL
6606[`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6607[`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6608[`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6609[`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6610[`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6611[`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6612[`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6613[`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6614[`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6615[`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6616
6617
92a42be0
SL
6618Version 1.6.0 (2016-01-21)
6619==========================
6620
6621Language
6622--------
6623
6624* The `#![no_std]` attribute causes a crate to not be linked to the
6625 standard library, but only the [core library][1.6co], as described
6626 in [RFC 1184]. The core library defines common types and traits but
6627 has no platform dependencies whatsoever, and is the basis for Rust
6628 software in environments that cannot support a full port of the
6629 standard library, such as operating systems. Most of the core
6630 library is now stable.
6631
6632Libraries
6633---------
6634
6635* Stabilized APIs:
9cc50fc6 6636 [`Read::read_exact`],
dfeec247 6637 [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
9cc50fc6 6638 [`fs::DirBuilder`], [`fs::DirBuilder::new`],
92a42be0
SL
6639 [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6640 [`os::unix::fs::DirBuilderExt`],
6641 [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6642 [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6643 [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6644 [`collections::hash_map::Drain`],
6645 [`collections::hash_map::HashMap::drain`],
6646 [`collections::hash_set::Drain`],
6647 [`collections::hash_set::HashSet::drain`],
6648 [`collections::binary_heap::Drain`],
6649 [`collections::binary_heap::BinaryHeap::drain`],
dfeec247 6650 [`Vec::extend_from_slice`] (renamed from `push_all`),
92a42be0 6651 [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
9cc50fc6 6652 [`RwLock::into_inner`],
dfeec247
XL
6653 [`Iterator::min_by_key`] (renamed from `min_by`),
6654 [`Iterator::max_by_key`] (renamed from `max_by`).
92a42be0
SL
6655* The [core library][1.6co] is stable, as are most of its APIs.
6656* [The `assert_eq!` macro supports arguments that don't implement
6657 `Sized`][1.6ae], such as arrays. In this way it behaves more like
6658 `assert!`.
6659* Several timer functions that take duration in milliseconds [are
6660 deprecated in favor of those that take `Duration`][1.6ms]. These
6661 include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
9cc50fc6 6662 `thread::park_timeout_ms`.
92a42be0
SL
6663* The algorithm by which `Vec` reserves additional elements was
6664 [tweaked to not allocate excessive space][1.6a] while still growing
6665 exponentially.
6666* `From` conversions are [implemented from integers to floats][1.6f]
6667 in cases where the conversion is lossless. Thus they are not
6668 implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6669 or `f64`. They are also not implemented for `isize` and `usize`
6670 because the implementations would be platform-specific. `From` is
6671 also implemented from `f32` to `f64`.
6672* `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6673* `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6674* `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6675* [`BinaryHeap` was refactored][1.6bh] for modest performance
6676 improvements.
6677* Sorting slices that are already sorted [is 50% faster in some
6678 cases][1.6s].
6679
6680Cargo
6681-----
6682
6683* Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6684* Cargo build scripts can specify their dependencies by emitting the
6685 [`rerun-if-changed`][1.6rr] key.
6686* crates.io will reject publication of crates with dependencies that
6687 have a wildcard version constraint. Crates with wildcard
6688 dependencies were seen to cause a variety of problems, as described
9cc50fc6
SL
6689 in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6690 warning.
92a42be0
SL
6691* `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6692 release folder. A variety of artifacts that Cargo failed to clean
6693 are now correctly deleted.
6694
6695Misc
6696----
6697
6698* The `unreachable_code` lint [warns when a function call's argument
6699 diverges][1.6dv].
6700* The parser indicates [failures that may be caused by
6701 confusingly-similar Unicode characters][1.6uc]
6702* Certain macro errors [are reported at definition time][1.6m], not
6703 expansion.
6704
6705Compatibility Notes
6706-------------------
6707
6708* The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6709 environment variable when locating crates. This was a pre-cargo
6710 feature for integrating with the package manager that was
6711 accidentally never removed.
6712* [A number of bugs were fixed in the privacy checker][1.6p] that
6713 could cause previously-accepted code to break.
6714* [Modules and unit/tuple structs may not share the same name][1.6ts].
9cc50fc6
SL
6715* [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6716 struct pattern syntax (`Foo(..)`) can no longer be used to match
6717 unit structs. This is a warning now, but will become an error in
6718 future releases. Patterns that share the same name as a const are
6719 now an error.
92a42be0
SL
6720* A bug was fixed that causes [rustc not to apply default type
6721 parameters][1.6xc] when resolving certain method implementations of
6722 traits defined in other crates.
6723
6724[1.6a]: https://github.com/rust-lang/rust/pull/29454
6725[1.6ae]: https://github.com/rust-lang/rust/pull/29770
6726[1.6bh]: https://github.com/rust-lang/rust/pull/29811
6727[1.6c]: https://github.com/rust-lang/cargo/pull/2192
6728[1.6cc]: https://github.com/rust-lang/cargo/pull/2131
74d20737 6729[1.6co]: http://doc.rust-lang.org/core/index.html
92a42be0
SL
6730[1.6dv]: https://github.com/rust-lang/rust/pull/30000
6731[1.6f]: https://github.com/rust-lang/rust/pull/29129
6732[1.6m]: https://github.com/rust-lang/rust/pull/29828
6733[1.6ms]: https://github.com/rust-lang/rust/pull/29604
6734[1.6p]: https://github.com/rust-lang/rust/pull/29726
6735[1.6rp]: https://github.com/rust-lang/rust/pull/30034
6736[1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6737[1.6s]: https://github.com/rust-lang/rust/pull/29675
6738[1.6ts]: https://github.com/rust-lang/rust/issues/21546
6739[1.6uc]: https://github.com/rust-lang/rust/pull/29837
6740[1.6us]: https://github.com/rust-lang/rust/pull/29383
6741[1.6xc]: https://github.com/rust-lang/rust/issues/30123
6742[RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6743[RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6744[`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6745[`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6746[`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6747[`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6748[`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6749[`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6750[`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6751[`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6752[`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6753[`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6754[`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6755[`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6756[`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6757[`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6758[`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6759[`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6760[`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6761[`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6762[`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6763[`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6764[`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6765[`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6766[`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6767[`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6768[`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6769[`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6770[`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6771
6772
b039eaaf
SL
6773Version 1.5.0 (2015-12-10)
6774==========================
6775
6776* ~700 changes, numerous bugfixes
6777
6778Highlights
6779----------
6780
6781* Stabilized APIs:
6782 [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6783 [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6784 [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6785 [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6786 [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6787 [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6788 [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6789 [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6790 [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6791 [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6792 [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6793 [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6794 [`Path::read_link`], [`Path::symlink_metadata`],
6795 [`Utf8Error::valid_up_to`], [`Vec::resize`],
6796 [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6797 [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6798 [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6799 [`slice::split_first_mut`], [`slice::split_first`],
6800 [`slice::split_last_mut`], [`slice::split_last`],
6801 [`char::from_u32_unchecked`], [`fs::canonicalize`],
6802 [`str::MatchIndices`], [`str::RMatchIndices`],
6803 [`str::match_indices`], [`str::rmatch_indices`],
6804 [`str::slice_mut_unchecked`], [`string::ParseError`].
6805* Rust applications hosted on crates.io can be installed locally to
6806 `~/.cargo/bin` with the [`cargo install`] command. Among other
6807 things this makes it easier to augment Cargo with new subcommands:
6808 when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6809 invoked as `cargo foo`.
6810* Crates with wildcard (`*`) dependencies will [emit warnings when
6811 published][1.5w]. In 1.6 it will no longer be possible to publish
6812 crates with wildcard dependencies.
6813
6814Breaking Changes
6815----------------
6816
6817* The rules determining when a particular lifetime must outlive
6818 a particular value (known as '[dropck]') have been [modified
6819 to not rely on parametricity][1.5p].
6820* [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6821 and `Arc`][1.5a]. Because these smart pointer types implement
6822 `Deref`, this causes breakage in cases where the interior type
6823 contains methods of the same name.
6824* [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6825 that they could drop their content. Soundness fix.
6826* All method invocations are [properly checked][1.5wf1] for
6827 [well-formedness][1.5wf2]. Soundness fix.
6828* Traits whose supertraits contain `Self` are [not object
6829 safe][1.5o]. Soundness fix.
6830* Target specifications support a [`no_default_libraries`][1.5nd]
6831 setting that controls whether `-nodefaultlibs` is passed to the
6832 linker, and in turn the `is_like_windows` setting no longer affects
6833 the `-nodefaultlibs` flag.
6834* `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6835* The `#[inline]` and `#[repr]` attributes [can only appear
6836 in valid locations][1.5at].
6837* Native libraries linked from the local crate are [passed to
6838 the linker before native libraries from upstream crates][1.5nl].
6839* Two rarely-used attributes, `#[no_debug]` and
6840 `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6841* Negation of unsigned integers, which has been a warning for
6842 several releases, [is now behind a feature gate and will
6843 generate errors][1.5nu].
6844* The parser accidentally accepted visibility modifiers on
6845 enum variants, a bug [which has been fixed][1.5ev].
6846* [A bug was fixed that allowed `use` statements to import unstable
6847 features][1.5use].
6848
6849Language
6850--------
6851
6852* When evaluating expressions at compile-time that are not
6853 compile-time constants (const-evaluating expressions in non-const
6854 contexts), incorrect code such as overlong bitshifts and arithmetic
6855 overflow will [generate a warning instead of an error][1.5ce],
6856 delaying the error until runtime. This will allow the
6857 const-evaluator to be expanded in the future backwards-compatibly.
6858* The `improper_ctypes` lint [no longer warns about using `isize` and
6859 `usize` in FFI][1.5ict].
6860
6861Libraries
6862---------
6863
6864* `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6865 invariant][1.5c].
6866* `Default` is [implemented for mutable slices][1.5d].
6867* `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6868* There are now `From` conversions [between floating point
6869 types][1.5f] where the conversions are lossless.
ff7c6d11 6870* There are now `From` conversions [between integer types][1.5i] where
b039eaaf
SL
6871 the conversions are lossless.
6872* [`fs::Metadata` implements `Clone`][1.5fs].
6873* The `parse` method [accepts a leading "+" when parsing
6874 integers][1.5pi].
6875* [`AsMut` is implemented for `Vec`][1.5am].
6876* The `clone_from` implementations for `String` and `BinaryHeap` [have
6877 been optimized][1.5cf] and no longer rely on the default impl.
6878* The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6879 `unsafe extern "C"` function types now [implement `Clone`,
6880 `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6881 `fmt::Debug` for up to 12 arguments][1.5fp].
6882* [Dropping `Vec`s is much faster in unoptimized builds when the
6883 element types don't implement `Drop`][1.5dv].
6884* A bug that caused in incorrect behavior when [combining `VecDeque`
6885 with zero-sized types][1.5vdz] was resolved.
6886* [`PartialOrd` for slices is faster][1.5po].
6887
6888Miscellaneous
6889-------------
6890
6891* [Crate metadata size was reduced by 20%][1.5md].
6892* [Improvements to code generation reduced the size of libcore by 3.3
6893 MB and rustc's memory usage by 18MB][1.5m].
6894* [Improvements to deref translation increased performance in
6895 unoptimized builds][1.5dr].
6896* Various errors in trait resolution [are deduplicated to only be
6897 reported once][1.5te].
6898* Rust has preliminary [support for rumprun kernels][1.5rr].
6899* Rust has preliminary [support for NetBSD on amd64][1.5na].
6900
6901[1.5use]: https://github.com/rust-lang/rust/pull/28364
6902[1.5po]: https://github.com/rust-lang/rust/pull/28436
6903[1.5ev]: https://github.com/rust-lang/rust/pull/28442
6904[1.5nu]: https://github.com/rust-lang/rust/pull/28468
6905[1.5dr]: https://github.com/rust-lang/rust/pull/28491
6906[1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6907[1.5md]: https://github.com/rust-lang/rust/pull/28521
6908[1.5fg]: https://github.com/rust-lang/rust/pull/28522
6909[1.5dv]: https://github.com/rust-lang/rust/pull/28531
6910[1.5na]: https://github.com/rust-lang/rust/pull/28543
6911[1.5fp]: https://github.com/rust-lang/rust/pull/28560
6912[1.5rr]: https://github.com/rust-lang/rust/pull/28593
6913[1.5cf]: https://github.com/rust-lang/rust/pull/28602
6914[1.5nl]: https://github.com/rust-lang/rust/pull/28605
6915[1.5te]: https://github.com/rust-lang/rust/pull/28645
6916[1.5at]: https://github.com/rust-lang/rust/pull/28650
6917[1.5am]: https://github.com/rust-lang/rust/pull/28663
6918[1.5m]: https://github.com/rust-lang/rust/pull/28778
6919[1.5ict]: https://github.com/rust-lang/rust/pull/28779
6920[1.5a]: https://github.com/rust-lang/rust/pull/28811
6921[1.5pi]: https://github.com/rust-lang/rust/pull/28826
6922[1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6923[1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6924[1.5i]: https://github.com/rust-lang/rust/pull/28921
6925[1.5fs]: https://github.com/rust-lang/rust/pull/29021
6926[1.5f]: https://github.com/rust-lang/rust/pull/29129
6927[1.5ds]: https://github.com/rust-lang/rust/pull/29148
6928[1.5s]: https://github.com/rust-lang/rust/pull/29190
6929[1.5d]: https://github.com/rust-lang/rust/pull/29245
6930[1.5o]: https://github.com/rust-lang/rust/pull/29259
6931[1.5nd]: https://github.com/rust-lang/rust/pull/28578
6932[1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6933[1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6934[dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6935[1.5c]: https://github.com/rust-lang/rust/pull/29110
6936[1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6937[`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6938[`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6939[`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6940[`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6941[`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6942[`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6943[`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6944[`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6945[`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6946[`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6947[`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6948[`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6949[`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6950[`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6951[`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6952[`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6953[`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6954[`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6955[`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6956[`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6957[`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6958[`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6959[`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6960[`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6961[`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6962[`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6963[`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6964[`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6965[`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6966[`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6967[`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6968[`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6969[`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6970[`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6971[`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6972[`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6973[`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6974[`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6975[`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6976[`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6977[`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6978[`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6979[`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6980[`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6981[`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6982[`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6983[`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6984[`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6985[`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6986[`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6987[`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6988[`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6989[`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6990
6991Version 1.4.0 (2015-10-29)
6992==========================
e9174d1e
SL
6993
6994* ~1200 changes, numerous bugfixes
6995
6996Highlights
6997----------
6998
6999* Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7000 GNU) are now supported and recommended for use.
7001
7002Breaking Changes
7003----------------
7004
7005* [Several changes have been made to fix type soundness and improve
7006 the behavior of associated types][sound]. See [RFC 1214]. Although
7007 we have mostly introduced these changes as warnings this release, to
7008 become errors next release, there are still some scenarios that will
7009 see immediate breakage.
7010* [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7011 line breaks in addition to `\n`][crlf].
7012* [Loans of `'static` lifetime extend to the end of a function][stat].
b039eaaf
SL
7013* [`str::parse` no longer introduces avoidable rounding error when
7014 parsing floating point numbers. Together with earlier changes to
7015 float formatting/output, "round trips" like f.to_string().parse()
7016 now preserve the value of f exactly. Additionally, leading plus
7017 signs are now accepted][fp3].
7018
e9174d1e
SL
7019
7020Language
7021--------
7022
7023* `use` statements that import multiple items [can now rename
7024 them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7025* [Binops work correctly on fat pointers][binfat].
7026* `pub extern crate`, which does not behave as expected, [issues a
7027 warning][pec] until a better solution is found.
7028
7029Libraries
7030---------
7031
7032* [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7033 [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7034 [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7035 [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7036 [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7037 `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7038 `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7039 [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7040 [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7041 [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7042 [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7043 [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7044 [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7045 [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7046 [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7047 [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7048 [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7049 [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7050 [`thread::sleep`].
7051* [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7052 `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7053 `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7054 `f64::from_str_radix`.
7055* [Reverse-searching strings is faster with the 'two-way'
7056 algorithm][s].
7057* [`std::io::copy` allows `?Sized` arguments][cc].
7058* The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7059 [override `count`, `nth` and `last` with an O(1)
7060 implementation][it].
7061* [`Default` is implemented for arrays up to `[T; 32]`][d].
7062* [`IntoRawFd` has been added to the Unix-specific prelude,
7063 `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7064 prelude][pr].
7065* [`Extend<String>` and `FromIterator<String` are both implemented for
7066 `String`][es].
b039eaaf
SL
7067* [`IntoIterator` is implemented for references to `Option` and
7068 `Result`][into2].
e9174d1e 7069* [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
ff7c6d11 7070 Copy`][ext] as part of [RFC 839]. This will cause type inference
b039eaaf 7071 breakage in rare situations.
e9174d1e
SL
7072* [`BinaryHeap` implements `Debug`][bh2].
7073* [`Borrow` and `BorrowMut` are implemented for fixed-size
7074 arrays][bm].
b039eaaf 7075* [`extern fn`s with the "Rust" and "C" ABIs implement common
e9174d1e
SL
7076 traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7077* [String comparison is faster][faststr].
b039eaaf
SL
7078* `&mut T` where `T: std::fmt::Write` [also implements
7079 `std::fmt::Write`][mutw].
7080* [A stable regression in `VecDeque::push_back` and other
ff7c6d11 7081 capacity-altering methods that caused panics for zero-sized types
b039eaaf 7082 was fixed][vd].
e9174d1e
SL
7083* [Function pointers implement traits for up to 12 parameters][fp2].
7084
7085Miscellaneous
7086-------------
7087
7088* The compiler [no longer uses the 'morestack' feature to prevent
7089 stack overflow][mm]. Instead it uses guard pages and stack
7090 probes (though stack probes are not yet implemented on any platform
7091 but Windows).
7092* [The compiler matches traits faster when projections are involved][p].
7093* The 'improper_ctypes' lint [no longer warns about use of `isize` and
7094 `usize`][ffi].
7095* [Cargo now displays useful information about what its doing during
7096 `cargo update`][cu].
7097
7098[`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7099[`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7100[`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7101[`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7102[`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7103[`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7104[`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7105[`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7106[`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7107[`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7108[`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7109[`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7110[`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7111[`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7112[`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7113[`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7114[`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7115[`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7116[`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7117[`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7118[`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7119[`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7120[`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7121[`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7122[`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7123[`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7124[`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7125[`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7126[`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7127[`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7128[`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7129[`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7130[`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7131[`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7132[`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7133[`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7134[`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7135[`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7136[`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7137[`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7138[`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7139[bh2]: https://github.com/rust-lang/rust/pull/28156
7140[binfat]: https://github.com/rust-lang/rust/pull/28270
7141[bm]: https://github.com/rust-lang/rust/pull/28197
7142[cc]: https://github.com/rust-lang/rust/pull/27531
7143[crlf]: https://github.com/rust-lang/rust/pull/28034
7144[cu]: https://github.com/rust-lang/cargo/pull/1931
7145[d]: https://github.com/rust-lang/rust/pull/27825
7146[dep]: https://github.com/rust-lang/rust/pull/28339
7147[es]: https://github.com/rust-lang/rust/pull/27956
7148[ext]: https://github.com/rust-lang/rust/pull/28094
7149[faststr]: https://github.com/rust-lang/rust/pull/28338
7150[ffi]: https://github.com/rust-lang/rust/pull/28779
7151[fp]: https://github.com/rust-lang/rust/pull/28268
7152[fp2]: https://github.com/rust-lang/rust/pull/28560
b039eaaf 7153[fp3]: https://github.com/rust-lang/rust/pull/27307
e9174d1e 7154[i]: https://github.com/rust-lang/rust/pull/27451
b039eaaf 7155[into2]: https://github.com/rust-lang/rust/pull/28039
e9174d1e
SL
7156[it]: https://github.com/rust-lang/rust/pull/27652
7157[mm]: https://github.com/rust-lang/rust/pull/27338
7158[mutw]: https://github.com/rust-lang/rust/pull/28368
7159[sound]: https://github.com/rust-lang/rust/pull/27641
7160[p]: https://github.com/rust-lang/rust/pull/27866
7161[pec]: https://github.com/rust-lang/rust/pull/28486
7162[pr]: https://github.com/rust-lang/rust/pull/27896
7163[RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7164[RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7165[s]: https://github.com/rust-lang/rust/pull/27474
7166[stab]: https://github.com/rust-lang/rust/pull/28339
7167[stat]: https://github.com/rust-lang/rust/pull/28321
7168[vd]: https://github.com/rust-lang/rust/pull/28494
7169
7170Version 1.3.0 (2015-09-17)
c1a9b12d
SL
7171==============================
7172
7173* ~900 changes, numerous bugfixes
7174
7175Highlights
7176----------
7177
7178* The [new object lifetime defaults][nold] have been [turned
7179 on][nold2] after a cycle of warnings about the change. Now types
7180 like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7181 being interpreted as `&'a Box<Trait+'a>` to `&'a
7182 Box<Trait+'static>`.
7183* [The Rustonomicon][nom] is a new book in the official documentation
7184 that dives into writing unsafe Rust.
7185* The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7186 timekeeping is employed by other std APIs, as well as out-of-tree
7187 time crates.
7188
7189Breaking Changes
7190----------------
7191
7192* The [new object lifetime defaults][nold] have been [turned
7193 on][nold2] after a cycle of warnings about the change.
7194* There is a known [regression][lr] in how object lifetime elision is
7195 interpreted, the proper solution for which is undetermined.
7196* The `#[prelude_import]` attribute, an internal implementation
7197 detail, was accidentally stabilized previously. [It has been put
7198 behind the `prelude_import` feature gate][pi]. This change is
7199 believed to break no existing code.
7200* The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7201 [more sane for dynamically sized types][dst3]. Code that relied on
7202 the previous behavior is thought to be broken.
7203* The `dropck` rules, which checks that destructors can't access
7204 destroyed values, [have been updated][dropck] to match the
7205 [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7206 cause some previously-compiling code to no longer build.
7207
7208Language
7209--------
7210
7211* The [new object lifetime defaults][nold] have been [turned
7212 on][nold2] after a cycle of warnings about the change.
7213* Semicolons may [now follow types and paths in
7214 macros](https://github.com/rust-lang/rust/pull/27000).
7215* The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7216 [more sane for dynamically sized types][dst3]. Code that relied on
7217 the previous behavior is not known to exist, and suspected to be
7218 broken.
7219* `'static` variables [may now be recursive][st].
7220* `ref` bindings choose between [`Deref`] and [`DerefMut`]
7221 implementations correctly.
7222* The `dropck` rules, which checks that destructors can't access
7223 destroyed values, [have been updated][dropck] to match the
7224 [RFC][dropckrfc].
7225
7226Libraries
7227---------
7228
7229* The [`Duration`] API, [has been stabilized][ds], as well as the
7230 `std::time` module, which presently contains only `Duration`.
7231* `Box<str>` and `Box<[T]>` both implement `Clone`.
7232* The owned C string, [`CString`], implements [`Borrow`] and the
7233 borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7234 these allow C strings to be borrowed and cloned in generic code.
7235* [`CStr`] implements [`Debug`].
7236* [`AtomicPtr`] implements [`Debug`].
7237* [`Error`] trait objects [can be downcast to their concrete types][e]
7238 in many common configurations, using the [`is`], [`downcast`],
7239 [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
7240 [`Any`] trait.
7241* Searching for substrings now [employs the two-way algorithm][search]
7242 instead of doing a naive search. This gives major speedups to a
7243 number of methods, including [`contains`][sc], [`find`][sf],
7244 [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
7245 [`ends_with`][sew] are also faster.
7246* The performance of `PartialEq` for slices is [much faster][ps].
7247* The [`Hash`] trait offers the default method, [`hash_slice`], which
7248 is overridden and optimized by the implementations for scalars.
7249* The [`Hasher`] trait now has a number of specialized `write_*`
7250 methods for primitive types, for efficiency.
7251* The I/O-specific error type, [`std::io::Error`][ie], gained a set of
7252 methods for accessing the 'inner error', if any: [`get_ref`][iegr],
7253 [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
7254 of [`std::error::Error::cause`][iec] also delegates to the inner
7255 error.
7256* [`process::Child`][pc] gained the [`id`] method, which returns a
7257 `u32` representing the platform-specific process identifier.
7258* The [`connect`] method on slices is deprecated, replaced by the new
7259 [`join`] method (note that both of these are on the *unstable*
7260 [`SliceConcatExt`] trait, but through the magic of the prelude are
7261 available to stable code anyway).
7262* The [`Div`] operator is implemented for [`Wrapping`] types.
7263* [`DerefMut` is implemented for `String`][dms].
7264* Performance of SipHash (the default hasher for `HashMap`) is
7265 [better for long data][sh].
7266* [`AtomicPtr`] implements [`Send`].
7267* The [`read_to_end`] implementations for [`Stdin`] and [`File`]
ff7c6d11 7268 are now [specialized to use uninitialized buffers for increased
c1a9b12d
SL
7269 performance][rte].
7270* Lifetime parameters of foreign functions [are now resolved
7271 properly][f].
7272
7273Misc
7274----
7275
7276* Rust can now, with some coercion, [produce programs that run on
7277 Windows XP][xp], though XP is not considered a supported platform.
7278* Porting Rust on Windows from the GNU toolchain to MSVC continues
7279 ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7280 recommended for use in 1.3, though should be fully-functional
7281 in the [64-bit 1.4 beta][b14].
7282* On Fedora-based systems installation will [properly configure the
7283 dynamic linker][fl].
7284* The compiler gained many new extended error descriptions, which can
7285 be accessed with the `--explain` flag.
7286* The `dropck` pass, which checks that destructors can't access
7287 destroyed values, [has been rewritten][dropck]. This fixes some
7288 soundness holes, and as such will cause some previously-compiling
7289 code to no longer build.
7290* `rustc` now uses [LLVM to write archive files where possible][ar].
7291 Eventually this will eliminate the compiler's dependency on the ar
7292 utility.
7293* Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7294 supported FreeBSD on x86_64).
7295* The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7296 [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7297 more strict.
7298* If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7299 will kill the process instead of leaking][nlp].
7300
7301[`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7302[`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7303[`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7304[`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7305[`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7306[`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7307[`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7308[`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7309[`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7310[`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7311[`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7312[`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7313[`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
e9174d1e 7314[`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
c1a9b12d
SL
7315[`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7316[`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7317[`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7318[`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7319[`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7320[`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7321[`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7322[`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7323[`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7324[`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7325[`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7326[`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7327[`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7328[`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7329[ar]: https://github.com/rust-lang/rust/pull/26926
7330[b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7331[dms]: https://github.com/rust-lang/rust/pull/26241
7332[dropck]: https://github.com/rust-lang/rust/pull/27261
7333[dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7334[ds]: https://github.com/rust-lang/rust/pull/26818
7335[dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7336[dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7337[dst3]: https://github.com/rust-lang/rust/pull/27351
7338[e]: https://github.com/rust-lang/rust/pull/24793
7339[f]: https://github.com/rust-lang/rust/pull/26588
7340[fb]: https://github.com/rust-lang/rust/pull/26959
7341[fl]: https://github.com/rust-lang/rust-installer/pull/41
7342[hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7343[ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7344[iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7345[iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7346[iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7347[ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7348[lic]: https://github.com/rust-lang/rust/pull/26583
7349[lnu]: https://github.com/rust-lang/rust/pull/27026
7350[lr]: https://github.com/rust-lang/rust/issues/27248
7351[lum]: https://github.com/rust-lang/rust/pull/26378
7352[lur]: https://github.com/rust-lang/rust/pull/26783
7353[nlp]: https://github.com/rust-lang/rust/pull/27176
7354[nold2]: https://github.com/rust-lang/rust/pull/27045
7355[nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7356[nom]: http://doc.rust-lang.org/nightly/nomicon/
7357[pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7358[pi]: https://github.com/rust-lang/rust/pull/26699
7359[ps]: https://github.com/rust-lang/rust/pull/26884
7360[rte]: https://github.com/rust-lang/rust/pull/26950
7361[sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7362[search]: https://github.com/rust-lang/rust/pull/26327
7363[sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7364[sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7365[sh]: https://github.com/rust-lang/rust/pull/27280
7366[srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7367[ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7368[ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7369[st]: https://github.com/rust-lang/rust/pull/26630
7370[win1]: https://github.com/rust-lang/rust/pull/26569
7371[win2]: https://github.com/rust-lang/rust/pull/26741
7372[win3]: https://github.com/rust-lang/rust/pull/26741
7373[win4]: https://github.com/rust-lang/rust/pull/27210
7374[xp]: https://github.com/rust-lang/rust/pull/26569
7375
e9174d1e
SL
7376Version 1.2.0 (2015-08-07)
7377==========================
62682a34
SL
7378
7379* ~1200 changes, numerous bugfixes
7380
7381Highlights
7382----------
7383
7384* [Dynamically-sized-type coercions][dst] allow smart pointer types
7385 like `Rc` to contain types without a fixed size, arrays and trait
7386 objects, finally enabling use of `Rc<[T]>` and completing the
7387 implementation of DST.
7388* [Parallel codegen][parcodegen] is now working again, which can
7389 substantially speed up large builds in debug mode; It also gets
7390 another ~33% speedup when bootstrapping on a 4 core machine (using 8
7391 jobs). It's not enabled by default, but will be "in the near
7392 future". It can be activated with the `-C codegen-units=N` flag to
7393 `rustc`.
7394* This is the first release with [experimental support for linking
7395 with the MSVC linker and lib C on Windows (instead of using the GNU
7396 variants via MinGW)][win]. It is yet recommended only for the most
ff7c6d11 7397 intrepid Rustaceans.
62682a34
SL
7398* Benchmark compilations are showing a 30% improvement in
7399 bootstrapping over 1.1.
7400
7401Breaking Changes
7402----------------
7403
7404* The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7405 unicode case mapping, which is a previously-planned change in
7406 behavior and considered a bugfix.
7407* [`mem::align_of`] now specifies [the *minimum alignment* for
7408 T][align], which is usually the alignment programs are interested
7409 in, and the same value reported by clang's
7410 `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7411 break real code.
7412* [The `#[packed]` attribute is no longer silently accepted by the
7413 compiler][packed]. This attribute did nothing and code that
7414 mentioned it likely did not work as intended.
7415* Associated type defaults are [now behind the
7416 `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7417 defaults *did not work*, but could be mentioned syntactically. As
7418 such this breakage has minimal impact.
7419
7420Language
7421--------
7422
7423* Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8faf50e0 7424 matching against dereferenceable values.
62682a34
SL
7425
7426Libraries
7427---------
7428
7429* The [`Extend`] trait, which grows a collection from an iterator, is
7430 implemented over iterators of references, for `String`, `Vec`,
7431 `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7432 `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7433* The [`iter::once`] function returns an iterator that yields a single
7434 element, and [`iter::empty`] returns an iterator that yields no
7435 elements.
7436* The [`matches`] and [`rmatches`] methods on `str` return iterators
7437 over substring matches.
7438* [`Cell`] and [`RefCell`] both implement `Eq`.
7439* A number of methods for wrapping arithmetic are added to the
7440 integral types, [`wrapping_div`], [`wrapping_rem`],
7441 [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7442 addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7443 [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7444 type.. It is illegal for the default arithmetic operations in Rust
7445 to overflow; the desire to wrap must be explicit.
7446* The `{:#?}` formatting specifier [displays the alternate,
7447 pretty-printed][debugfmt] form of the `Debug` formatter. This
7448 feature was actually introduced prior to 1.0 with little
7449 fanfare.
7450* [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7451 for writing data to formatted strings, similar to [`io::Write`].
7452* [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7453 [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7454 are used by code generators to emit implementations of [`Debug`].
7455* `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7456 methods that convert case, following Unicode case mapping.
7457* It is now easier to handle poisoned locks. The [`PoisonError`]
7458 type, returned by failing lock operations, exposes `into_inner`,
7459 `get_ref`, and `get_mut`, which all give access to the inner lock
7460 guard, and allow the poisoned lock to continue to operate. The
7461 `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7462 poisoned lock without attempting to take the lock.
7463* On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7464 [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7465 On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7466 and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7467 `ChildStderr`.
7468* [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7469 malformed input.
7470
7471Misc
7472----
7473
7474* `rustc` employs smarter heuristics for guessing at [typos].
7475* `rustc` emits more efficient code for [no-op conversions between
7476 unsafe pointers][nop].
7477* Fat pointers are now [passed in pairs of immediate arguments][fat],
7478 resulting in faster compile times and smaller code.
7479
e9174d1e 7480[`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
62682a34 7481[extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
e9174d1e
SL
7482[`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7483[`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7484[`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7485[`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7486[`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7487[`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7488[`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7489[`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7490[`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7491[`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7492[`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7493[`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7494[`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7495[`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7496[`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7497[`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7498[`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7499[`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7500[`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7501[`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7502[`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7503[`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7504[`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7505[`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7506[strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7507[strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7508[`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7509[`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7510[`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7511[`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7512[`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7513[`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7514[`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7515[`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7516[`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7517[`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7518[`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7519[`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
62682a34 7520[debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
e9174d1e
SL
7521[`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7522[`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
62682a34 7523[align]: https://github.com/rust-lang/rust/pull/25646
e9174d1e 7524[`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
62682a34
SL
7525[typos]: https://github.com/rust-lang/rust/pull/26087
7526[nop]: https://github.com/rust-lang/rust/pull/26336
7527[fat]: https://github.com/rust-lang/rust/pull/26411
7528[dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7529[parcodegen]: https://github.com/rust-lang/rust/pull/26018
7530[packed]: https://github.com/rust-lang/rust/pull/25541
7531[ad]: https://github.com/rust-lang/rust/pull/27382
7532[win]: https://github.com/rust-lang/rust/pull/25350
7533
e9174d1e 7534Version 1.1.0 (2015-06-25)
d9579d0f
AL
7535=========================
7536
7537* ~850 changes, numerous bugfixes
7538
7539Highlights
7540----------
7541
c1a9b12d 7542* The [`std::fs` module has been expanded][fs] to expand the set of
d9579d0f
AL
7543 functionality exposed:
7544 * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7545 don't incur a syscall on some platforms.
7546 * A `symlink_metadata` function has been added.
7547 * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7548 access to all underlying information.
c1a9b12d
SL
7549* The compiler now contains extended explanations of many errors. When an error
7550 with an explanation occurs the compiler suggests using the `--explain` flag
7551 to read the explanation. Error explanations are also [available online][err-index].
d9579d0f
AL
7552* Thanks to multiple [improvements][sk] to [type checking][pre], as
7553 well as other work, the time to bootstrap the compiler decreased by
7554 32%.
7555
7556Libraries
7557---------
7558
c1a9b12d 7559* The [`str::split_whitespace`] method splits a string on unicode
d9579d0f
AL
7560 whitespace boundaries.
7561* On both Windows and Unix, new extension traits provide conversion of
7562 I/O types to and from the underlying system handles. On Unix, these
c1a9b12d 7563 traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
d9579d0f
AL
7564 and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7565 `TcpListener`, and `UpdSocket`. Further implementations for
7566 `std::process` will be stabilized later.
7567* On Unix, [`std::os::unix::symlink`] creates symlinks. On
7568 Windows, symlinks can be created with
7569 `std::os::windows::symlink_dir` and
7570 `std::os::windows::symlink_file`.
7571* The `mpsc::Receiver` type can now be converted into an iterator with
7572 `into_iter` on the [`IntoIterator`] trait.
7573* `Ipv4Addr` can be created from `u32` with the `From<u32>`
7574 implementation of the [`From`] trait.
7575* The `Debug` implementation for `RangeFull` [creates output that is
7576 more consistent with other implementations][rf].
7577* [`Debug` is implemented for `File`][file].
7578* The `Default` implementation for `Arc` [no longer requires `Sync +
7579 Send`][arc].
7580* [The `Iterator` methods `count`, `nth`, and `last` have been
7581 overridden for slices to have O(1) performance instead of O(n)][si].
7582* Incorrect handling of paths on Windows has been improved in both the
7583 compiler and the standard library.
7584* [`AtomicPtr` gained a `Default` implementation][ap].
7585* In accordance with Rust's policy on arithmetic overflow `abs` now
7586 [panics on overflow when debug assertions are enabled][abs].
7587* The [`Cloned`] iterator, which was accidentally left unstable for
7588 1.0 [has been stabilized][c].
7589* The [`Incoming`] iterator, which iterates over incoming TCP
7590 connections, and which was accidentally unnamable in 1.0, [is now
7591 properly exported][inc].
7592* [`BinaryHeap`] no longer corrupts itself [when functions called by
7593 `sift_up` or `sift_down` panic][bh].
7594* The [`split_off`] method of `LinkedList` [no longer corrupts
7595 the list in certain scenarios][ll].
7596
7597Misc
7598----
7599
7600* Type checking performance [has improved notably][sk] with
7601 [multiple improvements][pre].
7602* The compiler [suggests code changes][ch] for more errors.
7603* rustc and it's build system have experimental support for [building
7604 toolchains against MUSL][m] instead of glibc on Linux.
7605* The compiler defines the `target_env` cfg value, which is used for
7606 distinguishing toolchains that are otherwise for the same
7607 platform. Presently this is set to `gnu` for common GNU Linux
7608 targets and for MinGW targets, and `musl` for MUSL Linux targets.
7609* The [`cargo rustc`][crc] command invokes a build with custom flags
7610 to rustc.
7611* [Android executables are always position independent][pie].
7612* [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7613 with `Drop`][drop].
7614
e9174d1e
SL
7615[`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7616[`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7617[`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7618[`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7619[`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7620[`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
d9579d0f 7621[rf]: https://github.com/rust-lang/rust/pull/24491
e9174d1e 7622[err-index]: https://doc.rust-lang.org/error-index.html
d9579d0f
AL
7623[sk]: https://github.com/rust-lang/rust/pull/24615
7624[pre]: https://github.com/rust-lang/rust/pull/25323
7625[file]: https://github.com/rust-lang/rust/pull/24598
7626[ch]: https://github.com/rust-lang/rust/pull/24683
7627[arc]: https://github.com/rust-lang/rust/pull/24695
7628[si]: https://github.com/rust-lang/rust/pull/24701
7629[ap]: https://github.com/rust-lang/rust/pull/24834
7630[m]: https://github.com/rust-lang/rust/pull/24777
7631[fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7632[crc]: https://github.com/rust-lang/cargo/pull/1568
7633[pie]: https://github.com/rust-lang/rust/pull/24953
7634[abs]: https://github.com/rust-lang/rust/pull/25441
7635[c]: https://github.com/rust-lang/rust/pull/25496
e9174d1e
SL
7636[`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7637[`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
d9579d0f
AL
7638[inc]: https://github.com/rust-lang/rust/pull/25522
7639[bh]: https://github.com/rust-lang/rust/pull/25856
e9174d1e 7640[`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
d9579d0f 7641[ll]: https://github.com/rust-lang/rust/pull/26022
e9174d1e 7642[`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
d9579d0f
AL
7643[drop]: https://github.com/rust-lang/rust/pull/24935
7644
e9174d1e 7645Version 1.0.0 (2015-05-15)
bd371182 7646========================
c34b1796 7647
bd371182 7648* ~1500 changes, numerous bugfixes
c34b1796 7649
bd371182
AL
7650Highlights
7651----------
7652
7653* The vast majority of the standard library is now `#[stable]`. It is
7654 no longer possible to use unstable features with a stable build of
7655 the compiler.
7656* Many popular crates on [crates.io] now work on the stable release
7657 channel.
7658* Arithmetic on basic integer types now [checks for overflow in debug
7659 builds][overflow].
7660
7661Language
7662--------
7663
7664* Several [restrictions have been added to trait coherence][coh] in
7665 order to make it easier for upstream authors to change traits
62682a34 7666 without breaking downstream code.
bd371182
AL
7667* Digits of binary and octal literals are [lexed more eagerly][lex] to
7668 improve error messages and macro behavior. For example, `0b1234` is
7669 now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
62682a34 7670* Trait bounds [are always invariant][inv], eliminating the need for
bd371182
AL
7671 the `PhantomFn` and `MarkerTrait` lang items, which have been
7672 removed.
7673* ["-" is no longer a valid character in crate names][cr], the `extern crate
7674 "foo" as bar` syntax has been replaced with `extern crate foo as
7675 bar`, and Cargo now automatically translates "-" in *package* names
7676 to underscore for the crate name.
7677* [Lifetime shadowing is an error][lt].
7678* [`Send` no longer implies `'static`][send-rfc].
7679* [UFCS now supports trait-less associated paths][moar-ufcs] like
7680 `MyType::default()`.
7681* Primitive types [now have inherent methods][prim-inherent],
7682 obviating the need for extension traits like `SliceExt`.
7683* Methods with `Self: Sized` in their `where` clause are [considered
7684 object-safe][self-sized], allowing many extension traits like
7685 `IteratorExt` to be merged into the traits they extended.
7686* You can now [refer to associated types][assoc-where] whose
7687 corresponding trait bounds appear only in a `where` clause.
7688* The final bits of [OIBIT landed][oibit-final], meaning that traits
7689 like `Send` and `Sync` are now library-defined.
7690* A [Reflect trait][reflect] was introduced, which means that
7691 downcasting via the `Any` trait is effectively limited to concrete
7692 types. This helps retain the potentially-important "parametricity"
7693 property: generic code cannot behave differently for different type
7694 arguments except in minor ways.
7695* The `unsafe_destructor` feature is now deprecated in favor of the
7696 [new `dropck`][dropck]. This change is a major reduction in unsafe
7697 code.
c34b1796 7698
bd371182
AL
7699Libraries
7700---------
c34b1796 7701
bd371182
AL
7702* The `thread_local` module [has been renamed to `std::thread`][th].
7703* The methods of `IteratorExt` [have been moved to the `Iterator`
7704 trait itself][ie].
7705* Several traits that implement Rust's conventions for type
7706 conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7707 [centralized in the `std::convert` module][con].
7708* The `FromError` trait [was removed in favor of `From`][fe].
7709* The basic sleep function [has moved to
7710 `std::thread::sleep_ms`][slp].
7711* The `splitn` function now takes an `n` parameter that represents the
7712 number of items yielded by the returned iterator [instead of the
7713 number of 'splits'][spl].
7714* [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7715* [Derived implementations of `PartialOrd` now order enums according
7716 to their explicitly-assigned discriminants][po].
7717* [Methods for searching strings are generic over `Pattern`s][pat],
7718 implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7719 some others.
7720* [In method resolution, object methods are resolved before inherent
7721 methods][meth].
7722* [`String::from_str` has been deprecated in favor of the `From` impl,
7723 `String::from`][sf].
7724* [`io::Error` implements `Sync`][ios].
7725* [The `words` method on `&str` has been replaced with
7726 `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7727 a word?'
7728* The new path and IO modules are complete and `#[stable]`. This
7729 was the major library focus for this cycle.
7730* The path API was [revised][path-normalize] to normalize `.`,
7731 adjusting the tradeoffs in favor of the most common usage.
7732* A large number of remaining APIs in `std` were also stabilized
7733 during this cycle; about 75% of the non-deprecated API surface
7734 is now stable.
7735* The new [string pattern API][string-pattern] landed, which makes
7736 the string slice API much more internally consistent and flexible.
7737* A new set of [generic conversion traits][conversion] replaced
7738 many existing ad hoc traits.
7739* Generic numeric traits were [completely removed][num-traits]. This
7740 was made possible thanks to inherent methods for primitive types,
7741 and the removal gives maximal flexibility for designing a numeric
7742 hierarchy in the future.
7743* The `Fn` traits are now related via [inheritance][fn-inherit]
7744 and provide ergonomic [blanket implementations][fn-blanket].
7745* The `Index` and `IndexMut` traits were changed to
7746 [take the index by value][index-value], enabling code like
7747 `hash_map["string"]` to work.
7748* `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7749 `Copy` data is known to be `Clone` as well.
7750
7751Misc
7752----
7753
7754* Many errors now have extended explanations that can be accessed with
7755 the `--explain` flag to `rustc`.
7756* Many new examples have been added to the standard library
7757 documentation.
7758* rustdoc has received a number of improvements focused on completion
7759 and polish.
7760* Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7761* Much headway was made on ecosystem-wide CI, making it possible
7762 to [compare builds for breakage][ci-compare].
7763
7764
7765[crates.io]: http://crates.io
7766[clo]: https://github.com/rust-lang/rust/pull/24034
7767[coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7768[con]: https://github.com/rust-lang/rust/pull/23875
7769[cr]: https://github.com/rust-lang/rust/pull/23419
7770[fe]: https://github.com/rust-lang/rust/pull/23879
7771[ie]: https://github.com/rust-lang/rust/pull/23300
7772[inv]: https://github.com/rust-lang/rust/pull/23938
7773[ios]: https://github.com/rust-lang/rust/pull/24133
7774[lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7775[lt]: https://github.com/rust-lang/rust/pull/24057
7776[meth]: https://github.com/rust-lang/rust/pull/24056
7777[pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7778[po]: https://github.com/rust-lang/rust/pull/24270
7779[sf]: https://github.com/rust-lang/rust/pull/24517
7780[slp]: https://github.com/rust-lang/rust/pull/23949
7781[spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7782[sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7783[th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
c34b1796 7784[send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
c34b1796
AL
7785[moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7786[prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7787[overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7788[metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7789[self-sized]: https://github.com/rust-lang/rust/pull/22301
7790[assoc-where]: https://github.com/rust-lang/rust/pull/22512
7791[string-pattern]: https://github.com/rust-lang/rust/pull/22466
7792[oibit-final]: https://github.com/rust-lang/rust/pull/21689
7793[reflect]: https://github.com/rust-lang/rust/pull/23712
c34b1796
AL
7794[conversion]: https://github.com/rust-lang/rfcs/pull/529
7795[num-traits]: https://github.com/rust-lang/rust/pull/23549
7796[index-value]: https://github.com/rust-lang/rust/pull/23601
7797[dropck]: https://github.com/rust-lang/rfcs/pull/769
c34b1796
AL
7798[ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7799[fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7800[fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7801[copy-clone]: https://github.com/rust-lang/rust/pull/23860
7802[path-normalize]: https://github.com/rust-lang/rust/pull/23229
7803
bd371182 7804
b039eaaf 7805Version 1.0.0-alpha.2 (2015-02-20)
62682a34 7806=====================================
85aaf69f
SL
7807
7808* ~1300 changes, numerous bugfixes
7809
7810* Highlights
7811
7812 * The various I/O modules were [overhauled][io-rfc] to reduce
62682a34 7813 unnecessary abstractions and provide better interoperation with
85aaf69f
SL
7814 the underlying platform. The old `io` module remains temporarily
7815 at `std::old_io`.
62682a34 7816 * The standard library now [participates in feature gating][feat],
85aaf69f
SL
7817 so use of unstable libraries now requires a `#![feature(...)]`
7818 attribute. The impact of this change is [described on the
7819 forum][feat-forum]. [RFC][feat-rfc].
7820
7821* Language
7822
7823 * `for` loops [now operate on the `IntoIterator` trait][into],
7824 which eliminates the need to call `.iter()`, etc. to iterate
7825 over collections. There are some new subtleties to remember
7826 though regarding what sort of iterators various types yield, in
7827 particular that `for foo in bar { }` yields values from a move
7828 iterator, destroying the original collection. [RFC][into-rfc].
7829 * Objects now have [default lifetime bounds][obj], so you don't
7830 have to write `Box<Trait+'static>` when you don't care about
7831 storing references. [RFC][obj-rfc].
7832 * In types that implement `Drop`, [lifetimes must outlive the
7833 value][drop]. This will soon make it possible to safely
7834 implement `Drop` for types where `#[unsafe_destructor]` is now
7835 required. Read the [gorgeous RFC][drop-rfc] for details.
7836 * The fully qualified <T as Trait>::X syntax lets you set the Self
7837 type for a trait method or associated type. [RFC][ufcs-rfc].
7838 * References to types that implement `Deref<U>` now [automatically
7839 coerce to references][deref] to the dereferenced type `U`,
7840 e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7841 should eliminate many unsightly uses of `&*`, as when converting
7842 from references to vectors into references to
7843 slices. [RFC][deref-rfc].
7844 * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7845 `|:|`) is obsolete and closure kind is inferred from context.
7846 * [`Self` is a keyword][Self].
7847
7848* Libraries
7849
7850 * The `Show` and `String` formatting traits [have been
7851 renamed][fmt] to `Debug` and `Display` to more clearly reflect
7852 their related purposes. Automatically getting a string
7853 conversion to use with `format!("{:?}", something_to_debug)` is
7854 now written `#[derive(Debug)]`.
7855 * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7856 OsStr}`, provide strings in platform-specific encodings for easier
7857 interop with system APIs. [RFC][osstr-rfc].
c34b1796 7858 * The `boxed::into_raw` and `Box::from_raw` functions [convert
85aaf69f
SL
7859 between `Box<T>` and `*mut T`][boxraw], a common pattern for
7860 creating raw pointers.
7861
7862* Tooling
7863
7864 * Certain long error messages of the form 'expected foo found bar'
7865 are now [split neatly across multiple
7866 lines][multiline]. Examples in the PR.
7867 * On Unix Rust can be [uninstalled][un] by running
7868 `/usr/local/lib/rustlib/uninstall.sh`.
7869 * The `#[rustc_on_unimplemented]` attribute, requiring the
7870 'on_unimplemented' feature, lets rustc [display custom error
7871 messages when a trait is expected to be implemented for a type
7872 but is not][onun].
7873
7874* Misc
7875
7876 * Rust is tested against a [LALR grammar][lalr], which parses
7877 almost all the Rust files that rustc does.
7878
7879[boxraw]: https://github.com/rust-lang/rust/pull/21318
7880[close]: https://github.com/rust-lang/rust/pull/21843
7881[deref]: https://github.com/rust-lang/rust/pull/21351
7882[deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7883[drop]: https://github.com/rust-lang/rust/pull/21972
7884[drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7885[feat]: https://github.com/rust-lang/rust/pull/21248
e9174d1e 7886[feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
85aaf69f
SL
7887[feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7888[fmt]: https://github.com/rust-lang/rust/pull/21457
7889[into]: https://github.com/rust-lang/rust/pull/20790
7890[into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7891[io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7892[lalr]: https://github.com/rust-lang/rust/pull/21452
7893[multiline]: https://github.com/rust-lang/rust/pull/19870
7894[obj]: https://github.com/rust-lang/rust/pull/22230
7895[obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7896[onun]: https://github.com/rust-lang/rust/pull/20889
7897[osstr]: https://github.com/rust-lang/rust/pull/21488
7898[osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7899[Self]: https://github.com/rust-lang/rust/pull/22158
85aaf69f
SL
7900[ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7901[un]: https://github.com/rust-lang/rust/pull/22256
7902
62682a34 7903
b039eaaf 7904Version 1.0.0-alpha (2015-01-09)
62682a34 7905==================================
1a4d82fc
JJ
7906
7907 * ~2400 changes, numerous bugfixes
7908
7909 * Highlights
7910
7911 * The language itself is considered feature complete for 1.0,
7912 though there will be many usability improvements and bugfixes
7913 before the final release.
7914 * Nearly 50% of the public API surface of the standard library has
7915 been declared 'stable'. Those interfaces are unlikely to change
7916 before 1.0.
7917 * The long-running debate over integer types has been
7918 [settled][ints]: Rust will ship with types named `isize` and
7919 `usize`, rather than `int` and `uint`, for pointer-sized
7920 integers. Guidelines will be rolled out during the alpha cycle.
7921 * Most crates that are not `std` have been moved out of the Rust
7922 distribution into the Cargo ecosystem so they can evolve
7923 separately and don't need to be stabilized as quickly, including
7924 'time', 'getopts', 'num', 'regex', and 'term'.
7925 * Documentation continues to be expanded with more API coverage, more
7926 examples, and more in-depth explanations. The guides have been
7927 consolidated into [The Rust Programming Language][trpl].
85aaf69f 7928 * "[Rust By Example][rbe]" is now maintained by the Rust team.
1a4d82fc
JJ
7929 * All official Rust binary installers now come with [Cargo], the
7930 Rust package manager.
7931
7932* Language
7933
7934 * Closures have been [completely redesigned][unboxed] to be
7935 implemented in terms of traits, can now be used as generic type
7936 bounds and thus monomorphized and inlined, or via an opaque
7937 pointer (boxed) as in the old system. The new system is often
7938 referred to as 'unboxed' closures.
7939 * Traits now support [associated types][assoc], allowing families
7940 of related types to be defined together and used generically in
7941 powerful ways.
7942 * Enum variants are [namespaced by their type names][enum].
7943 * [`where` clauses][where] provide a more versatile and attractive
7944 syntax for specifying generic bounds, though the previous syntax
7945 remains valid.
7946 * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7947 numeric types.
7948 * Rust [no longer has a runtime][rt] of any description, and only
7949 supports OS threads, not green threads.
7950 * At long last, Rust has been overhauled for 'dynamically-sized
7951 types' ([DST]), which integrates 'fat pointers' (object types,
7952 arrays, and `str`) more deeply into the type system, making it
7953 more consistent.
7954 * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7955 `..j` that produce range types and which, when combined with the
7956 `Index` operator and multidispatch, leads to a convenient slice
7957 notation, `[i..j]`.
7958 * The new range syntax revealed an ambiguity in the fixed-length
7959 array syntax, so now fixed length arrays [are written `[T;
7960 N]`][arrays].
7961 * The `Copy` trait is no longer implemented automatically. Unsafe
7962 pointers no longer implement `Sync` and `Send` so types
7963 containing them don't automatically either. `Sync` and `Send`
7964 are now 'unsafe traits' so one can "forcibly" implement them via
7965 `unsafe impl` if a type confirms to the requirements for them
7966 even though the internals do not (e.g. structs containing unsafe
7967 pointers like `Arc`). These changes are intended to prevent some
7968 footguns and are collectively known as [opt-in built-in
7969 traits][oibit] (though `Sync` and `Send` will soon become pure
7970 library types unknown to the compiler).
7971 * Operator traits now take their operands [by value][ops], and
7972 comparison traits can use multidispatch to compare one type
7973 against multiple other types, allowing e.g. `String` to be
7974 compared with `&str`.
7975 * `if let` and `while let` are no longer feature-gated.
7976 * Rust has adopted a more [uniform syntax for escaping unicode
7977 characters][unicode].
7978 * `macro_rules!` [has been declared stable][mac]. Though it is a
7979 flawed system it is sufficiently popular that it must be usable
7980 for 1.0. Effort has gone into [future-proofing][mac-future] it
7981 in ways that will allow other macro systems to be developed in
7982 parallel, and won't otherwise impact the evolution of the
7983 language.
7984 * The prelude has been [pared back significantly][prelude] such
7985 that it is the minimum necessary to support the most pervasive
7986 code patterns, and through [generalized where clauses][where]
7987 many of the prelude extension traits have been consolidated.
7988 * Rust's rudimentary reflection [has been removed][refl], as it
7989 incurred too much code generation for little benefit.
7990 * [Struct variants][structvars] are no longer feature-gated.
7991 * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7992 known as 'higher-ranked trait bounds', this crucially allows
7993 unboxed closures to work.
7994 * Macros invocations surrounded by parens or square brackets and
7995 not terminated by a semicolon are [parsed as
7996 expressions][macros], which makes expressions like `vec![1i32,
7997 2, 3].len()` work as expected.
7998 * Trait objects now implement their traits automatically, and
7999 traits that can be coerced to objects now must be [object
8000 safe][objsafe].
8001 * Automatically deriving traits is now done with `#[derive(...)]`
8002 not `#[deriving(...)]` for [consistency with other naming
8003 conventions][derive].
8004 * Importing the containing module or enum at the same time as
8005 items or variants they contain is [now done with `self` instead
8006 of `mod`][self], as in use `foo::{self, bar}`
8007 * Glob imports are no longer feature-gated.
8008 * The `box` operator and `box` patterns have been feature-gated
8009 pending a redesign. For now unique boxes should be allocated
8010 like other containers, with `Box::new`.
8011
8012* Libraries
8013
8014 * A [series][coll1] of [efforts][coll2] to establish
8015 [conventions][coll3] for collections types has resulted in API
8016 improvements throughout the standard library.
8017 * New [APIs for error handling][err] provide ergonomic interop
8018 between error types, and [new conventions][err-conv] describe
8019 more clearly the recommended error handling strategies in Rust.
8020 * The `fail!` macro has been renamed to [`panic!`][panic] so that
8021 it is easier to discuss failure in the context of error handling
8022 without making clarifications as to whether you are referring to
8023 the 'fail' macro or failure more generally.
8024 * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8025 syscall when available.
8026 * The 'serialize' crate has been renamed 'rustc-serialize' and
8027 moved out of the distribution to Cargo. Although it is widely
62682a34 8028 used now, it is expected to be superseded in the near future.
1a4d82fc
JJ
8029 * The `Show` formatter, typically implemented with
8030 `#[derive(Show)]` is [now requested with the `{:?}`
8031 specifier][show] and is intended for use by all types, for uses
8032 such as `println!` debugging. The new `String` formatter must be
8033 implemented by hand, uses the `{}` specifier, and is intended
8034 for full-fidelity conversions of things that can logically be
8035 represented as strings.
8036
8037* Tooling
8038
8039 * [Flexible target specification][flex] allows rustc's code
8040 generation to be configured to support otherwise-unsupported
8041 platforms.
8042 * Rust comes with rust-gdb and rust-lldb scripts that launch their
8043 respective debuggers with Rust-appropriate pretty-printing.
32a655c1 8044 * The Windows installation of Rust is distributed with the
1a4d82fc
JJ
8045 MinGW components currently required to link binaries on that
8046 platform.
8047
8048* Misc
8049
8050 * Nullable enum optimizations have been extended to more types so
8051 that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8052 space than the inner types themselves.
8053 * Work has begun on supporting AArch64.
8054
8055[Cargo]: https://crates.io
8056[unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8057[enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8058[flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8059[err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8060[err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8061[rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8062[mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8063[mac-future]: https://github.com/rust-lang/rfcs/pull/550
8064[DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8065[coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8066[coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8067[coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8068[ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8069[prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8070[where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8071[refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8072[panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8073[structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8074[hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8075[unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8076[oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8077[macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8078[range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8079[arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8080[show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8081[derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8082[self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8083[fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8084[objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8085[assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8086[ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
e9174d1e 8087[trpl]: https://doc.rust-lang.org/book/index.html
85aaf69f 8088[rbe]: http://rustbyexample.com/
1a4d82fc 8089
62682a34 8090
b039eaaf 8091Version 0.12.0 (2014-10-09)
62682a34 8092=============================
1a4d82fc
JJ
8093
8094 * ~1900 changes, numerous bugfixes
8095
8096 * Highlights
8097
8098 * The introductory documentation (now called The Rust Guide) has
8099 been completely rewritten, as have a number of supplementary
8100 guides.
8101 * Rust's package manager, Cargo, continues to improve and is
8102 sometimes considered to be quite awesome.
8103 * Many API's in `std` have been reviewed and updated for
8104 consistency with the in-development Rust coding
8105 guidelines. The standard library documentation tracks
8106 stabilization progress.
8107 * Minor libraries have been moved out-of-tree to the rust-lang org
8108 on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8109 be installed with Cargo.
8110 * Lifetime elision allows lifetime annotations to be left off of
8111 function declarations in many common scenarios.
8112 * Rust now works on 64-bit Windows.
8113
8114 * Language
8115 * Indexing can be overloaded with the `Index` and `IndexMut`
8116 traits.
8117 * The `if let` construct takes a branch only if the `let` pattern
8118 matches, currently behind the 'if_let' feature gate.
8119 * 'where clauses', a more flexible syntax for specifying trait
8120 bounds that is more aesthetic, have been added for traits and
8121 free functions. Where clauses will in the future make it
8122 possible to constrain associated types, which would be
8123 impossible with the existing syntax.
8124 * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8125 the 'slicing_syntax' feature gate, and can be overloaded with
8126 the `Slice` or `SliceMut` traits.
8127 * The syntax for matching of sub-slices has been changed to use a
8128 postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8129 consistency with other uses of `..` and to future-proof
8130 potential additional uses of the syntax.
8131 * The syntax for matching inclusive ranges in patterns has changed
8132 from `0..3` to `0...4` to be consistent with the exclusive range
8133 syntax for slicing.
8134 * Matching of sub-slices in non-tail positions (e.g. `[a.., b,
8135 c]`) has been put behind the 'advanced_slice_patterns' feature
8136 gate and may be removed in the future.
8137 * Components of tuples and tuple structs can be extracted using
8138 the `value.0` syntax, currently behind the `tuple_indexing`
8139 feature gate.
8140 * The `#[crate_id]` attribute is no longer supported; versioning
8141 is handled by the package manager.
8142 * Renaming crate imports are now written `extern crate foo as bar`
8143 instead of `extern crate bar = foo`.
8144 * Renaming use statements are now written `use foo as bar` instead
8145 of `use bar = foo`.
8146 * `let` and `match` bindings and argument names in macros are now
8147 hygienic.
8148 * The new, more efficient, closure types ('unboxed closures') have
8149 been added under a feature gate, 'unboxed_closures'. These will
8150 soon replace the existing closure types, once higher-ranked
8151 trait lifetimes are added to the language.
8152 * `move` has been added as a keyword, for indicating closures
8153 that capture by value.
8154 * Mutation and assignment is no longer allowed in pattern guards.
8155 * Generic structs and enums can now have trait bounds.
8156 * The `Share` trait is now called `Sync` to free up the term
8157 'shared' to refer to 'shared reference' (the default reference
8158 type.
8159 * Dynamically-sized types have been mostly implemented,
8160 unifying the behavior of fat-pointer types with the rest of the
8161 type system.
8162 * As part of dynamically-sized types, the `Sized` trait has been
8163 introduced, which qualifying types implement by default, and
8164 which type parameters expect by default. To specify that a type
8165 parameter does not need to be sized, write `<Sized? T>`. Most
8166 types are `Sized`, notable exceptions being unsized arrays
8167 (`[T]`) and trait types.
8168 * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8169 * Lifetime bounds can now be applied to type parameters and object
8170 types.
8171 * The old, reference counted GC type, `Gc<T>` which was once
8172 denoted by the `@` sigil, has finally been removed. GC will be
8173 revisited in the future.
8174
8175 * Libraries
8176 * Library documentation has been improved for a number of modules.
8177 * Bit-vectors, collections::bitv has been modernized.
8178 * The url crate is deprecated in favor of
8179 http://github.com/servo/rust-url, which can be installed with
8180 Cargo.
8181 * Most I/O stream types can be cloned and subsequently closed from
8182 a different thread.
8183 * A `std::time::Duration` type has been added for use in I/O
8184 methods that rely on timers, as well as in the 'time' crate's
8185 `Timespec` arithmetic.
8186 * The runtime I/O abstraction layer that enabled the green thread
8187 scheduler to do non-thread-blocking I/O has been removed, along
8188 with the libuv-based implementation employed by the green thread
8189 scheduler. This will greatly simplify the future I/O work.
8190 * `collections::btree` has been rewritten to have a more
8191 idiomatic and efficient design.
8192
8193 * Tooling
8194 * rustdoc output now indicates the stability levels of API's.
8195 * The `--crate-name` flag can specify the name of the crate
8196 being compiled, like `#[crate_name]`.
8197 * The `-C metadata` specifies additional metadata to hash into
8198 symbol names, and `-C extra-filename` specifies additional
8199 information to put into the output filename, for use by the
8200 package manager for versioning.
8201 * debug info generation has continued to improve and should be
8202 more reliable under both gdb and lldb.
8203 * rustc has experimental support for compiling in parallel
8204 using the `-C codegen-units` flag.
8205 * rustc no longer encodes rpath information into binaries by
8206 default.
8207
8208 * Misc
8209 * Stack usage has been optimized with LLVM lifetime annotations.
8210 * Official Rust binaries on Linux are more compatible with older
8211 kernels and distributions, built on CentOS 5.10.
8212
62682a34 8213
b039eaaf 8214Version 0.11.0 (2014-07-02)
62682a34 8215==========================
1a4d82fc
JJ
8216
8217 * ~1700 changes, numerous bugfixes
8218
8219 * Language
8220 * ~[T] has been removed from the language. This type is superseded by
8221 the Vec<T> type.
8222 * ~str has been removed from the language. This type is superseded by
8223 the String type.
8224 * ~T has been removed from the language. This type is superseded by the
8225 Box<T> type.
8226 * @T has been removed from the language. This type is superseded by the
8227 standard library's std::gc::Gc<T> type.
8228 * Struct fields are now all private by default.
8229 * Vector indices and shift amounts are both required to be a `uint`
8230 instead of any integral type.
8231 * Byte character, byte string, and raw byte string literals are now all
8232 supported by prefixing the normal literal with a `b`.
8233 * Multiple ABIs are no longer allowed in an ABI string
8234 * The syntax for lifetimes on closures/procedures has been tweaked
8235 slightly: `<'a>|A, B|: 'b + K -> T`
8236 * Floating point modulus has been removed from the language; however it
8237 is still provided by a library implementation.
8238 * Private enum variants are now disallowed.
8239 * The `priv` keyword has been removed from the language.
8240 * A closure can no longer be invoked through a &-pointer.
8241 * The `use foo, bar, baz;` syntax has been removed from the language.
8242 * The transmute intrinsic no longer works on type parameters.
8243 * Statics now allow blocks/items in their definition.
8244 * Trait bounds are separated from objects with + instead of : now.
8245 * Objects can no longer be read while they are mutably borrowed.
8246 * The address of a static is now marked as insignificant unless the
8247 #[inline(never)] attribute is placed it.
8248 * The #[unsafe_destructor] attribute is now behind a feature gate.
8249 * Struct literals are no longer allowed in ambiguous positions such as
8250 if, while, match, and for..in.
8251 * Declaration of lang items and intrinsics are now feature-gated by
8252 default.
8253 * Integral literals no longer default to `int`, and floating point
8254 literals no longer default to `f64`. Literals must be suffixed with an
8255 appropriate type if inference cannot determine the type of the
8256 literal.
8257 * The Box<T> type is no longer implicitly borrowed to &mut T.
8258 * Procedures are now required to not capture borrowed references.
8259
8260 * Libraries
8261 * The standard library is now a "facade" over a number of underlying
8262 libraries. This means that development on the standard library should
ff7c6d11 8263 be speedier due to smaller crates, as well as a clearer line between
1a4d82fc
JJ
8264 all dependencies.
8265 * A new library, libcore, lives under the standard library's facade
8266 which is Rust's "0-assumption" library, suitable for embedded and
8267 kernel development for example.
8268 * A regex crate has been added to the standard distribution. This crate
8269 includes statically compiled regular expressions.
8270 * The unwrap/unwrap_err methods on Result require a Show bound for
8271 better error messages.
8272 * The return types of the std::comm primitives have been centralized
8273 around the Result type.
8274 * A number of I/O primitives have gained the ability to time out their
8275 operations.
8276 * A number of I/O primitives have gained the ability to close their
8277 reading/writing halves to cancel pending operations.
8278 * Reverse iterator methods have been removed in favor of `rev()` on
8279 their forward-iteration counterparts.
8280 * A bitflags! macro has been added to enable easy interop with C and
8281 management of bit flags.
8282 * A debug_assert! macro is now provided which is disabled when
8283 `--cfg ndebug` is passed to the compiler.
8284 * A graphviz crate has been added for creating .dot files.
8285 * The std::cast module has been migrated into std::mem.
8286 * The std::local_data api has been migrated from freestanding functions
8287 to being based on methods.
8288 * The Pod trait has been renamed to Copy.
8289 * jemalloc has been added as the default allocator for types.
8290 * The API for allocating memory has been changed to use proper alignment
8291 and sized deallocation
8292 * Connecting a TcpStream or binding a TcpListener is now based on a
8293 string address and a u16 port. This allows connecting to a hostname as
8294 opposed to an IP.
8295 * The Reader trait now contains a core method, read_at_least(), which
8296 correctly handles many repeated 0-length reads.
8297 * The process-spawning API is now centered around a builder-style
8298 Command struct.
8299 * The :? printing qualifier has been moved from the standard library to
8300 an external libdebug crate.
8301 * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8302 have been renamed to Eq/Ord.
8303 * The select/plural methods have been removed from format!. The escapes
8304 for { and } have also changed from \{ and \} to {{ and }},
8305 respectively.
8306 * The TaskBuilder API has been re-worked to be a true builder, and
8307 extension traits for spawning native/green tasks have been added.
8308
8309 * Tooling
8310 * All breaking changes to the language or libraries now have their
8311 commit message annotated with `[breaking-change]` to allow for easy
8312 discovery of breaking changes.
8313 * The compiler will now try to suggest how to annotate lifetimes if a
8314 lifetime-related error occurs.
8315 * Debug info continues to be improved greatly with general bug fixes and
8316 better support for situations like link time optimization (LTO).
8317 * Usage of syntax extensions when cross-compiling has been fixed.
8318 * Functionality equivalent to GCC & Clang's -ffunction-sections,
8319 -fdata-sections and --gc-sections has been enabled by default
8320 * The compiler is now stricter about where it will load module files
8321 from when a module is declared via `mod foo;`.
8322 * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8323 Syntax extensions are now discovered via a "plugin registrar" type
8324 which will be extended in the future to other various plugins.
8325 * Lints have been restructured to allow for dynamically loadable lints.
8326 * A number of rustdoc improvements:
8327 * The HTML output has been visually redesigned.
8328 * Markdown is now powered by hoedown instead of sundown.
8329 * Searching heuristics have been greatly improved.
8330 * The search index has been reduced in size by a great amount.
8331 * Cross-crate documentation via `pub use` has been greatly improved.
8332 * Primitive types are now hyperlinked and documented.
8333 * Documentation has been moved from static.rust-lang.org/doc to
8334 doc.rust-lang.org
8335 * A new sandbox, play.rust-lang.org, is available for running and
8336 sharing rust code examples on-line.
8337 * Unused attributes are now more robustly warned about.
8338 * The dead_code lint now warns about unused struct fields.
8339 * Cross-compiling to iOS is now supported.
8340 * Cross-compiling to mipsel is now supported.
8341 * Stability attributes are now inherited by default and no longer apply
8342 to intra-crate usage, only inter-crate usage.
8343 * Error message related to non-exhaustive match expressions have been
8344 greatly improved.
8345
62682a34 8346
b039eaaf 8347Version 0.10 (2014-04-03)
62682a34 8348=========================
1a4d82fc
JJ
8349
8350 * ~1500 changes, numerous bugfixes
8351
8352 * Language
8353 * A new RFC process is now in place for modifying the language.
8354 * Patterns with `@`-pointers have been removed from the language.
8355 * Patterns with unique vectors (`~[T]`) have been removed from the
8356 language.
8357 * Patterns with unique strings (`~str`) have been removed from the
8358 language.
8359 * `@str` has been removed from the language.
8360 * `@[T]` has been removed from the language.
8361 * `@self` has been removed from the language.
8362 * `@Trait` has been removed from the language.
8363 * Headers on `~` allocations which contain `@` boxes inside the type for
8364 reference counting have been removed.
8365 * The semantics around the lifetimes of temporary expressions have changed,
8366 see #3511 and #11585 for more information.
8367 * Cross-crate syntax extensions are now possible, but feature gated. See
8368 #11151 for more information. This includes both `macro_rules!` macros as
8369 well as syntax extensions such as `format!`.
8370 * New lint modes have been added, and older ones have been turned on to be
8371 warn-by-default.
8372 * Unnecessary parentheses
8373 * Uppercase statics
8374 * Camel Case types
8375 * Uppercase variables
8376 * Publicly visible private types
8377 * `#[deriving]` with raw pointers
8378 * Unsafe functions can no longer be coerced to closures.
8379 * Various obscure macros such as `log_syntax!` are now behind feature gates.
8380 * The `#[simd]` attribute is now behind a feature gate.
8381 * Visibility is no longer allowed on `extern crate` statements, and
8382 unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8383 * Trailing commas are now allowed in argument lists and tuple patterns.
8384 * The `do` keyword has been removed, it is now a reserved keyword.
8385 * Default type parameters have been implemented, but are feature gated.
8386 * Borrowed variables through captures in closures are now considered soundly.
8387 * `extern mod` is now `extern crate`
8388 * The `Freeze` trait has been removed.
8389 * The `Share` trait has been added for types that can be shared among
8390 threads.
8391 * Labels in macros are now hygienic.
8392 * Expression/statement macro invocations can be delimited with `{}` now.
8393 * Treatment of types allowed in `static mut` locations has been tweaked.
8394 * The `*` and `.` operators are now overloadable through the `Deref` and
8395 `DerefMut` traits.
8396 * `~Trait` and `proc` no longer have `Send` bounds by default.
8397 * Partial type hints are now supported with the `_` type marker.
8398 * An `Unsafe` type was introduced for interior mutability. It is now
8399 considered undefined to transmute from `&T` to `&mut T` without using the
8400 `Unsafe` type.
8401 * The #[linkage] attribute was implemented for extern statics/functions.
8402 * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8403 * `Pod` was renamed to `Copy`.
8404
8405 * Libraries
8406 * The `libextra` library has been removed. It has now been decomposed into
8407 component libraries with smaller and more focused nuggets of
8408 functionality. The full list of libraries can be found on the
8409 documentation index page.
8410 * std: `std::condition` has been removed. All I/O errors are now propagated
8411 through the `Result` type. In order to assist with error handling, a
8412 `try!` macro for unwrapping errors with an early return and a lint for
8413 unused results has been added. See #12039 for more information.
8414 * std: The `vec` module has been renamed to `slice`.
8415 * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8416 This will become the only growable vector in the future.
2c00a5a8 8417 * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
1a4d82fc
JJ
8418 are now found at `std::io::BufferedReader` instead of
8419 `std::io::buffered::BufferedReader`.
8420 * std: `print` and `println` are no longer in the prelude, the `print!` and
8421 `println!` macros are intended to be used instead.
8422 * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8423 attempts to statically prevent cycles.
8424 * std: The standard distribution is adopting the policy of pushing failure
8425 to the user rather than failing in libraries. Many functions (such as
8426 `slice::last()`) now return `Option<T>` instead of `T` + failing.
8427 * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8428 deriving mode: `#[deriving(Show)]`.
8429 * std: `ToStr` is now implemented for all types implementing `Show`.
8430 * std: The formatting trait methods now take `&self` instead of `&T`
8431 * std: The `invert()` method on iterators has been renamed to `rev()`
8432 * std: `std::num` has seen a reduction in the genericity of its traits,
8433 consolidating functionality into a few core traits.
8434 * std: Backtraces are now printed on task failure if the environment
8435 variable `RUST_BACKTRACE` is present.
8436 * std: Naming conventions for iterators have been standardized. More details
8437 can be found on the wiki's style guide.
8438 * std: `eof()` has been removed from the `Reader` trait. Specific types may
8439 still implement the function.
8440 * std: Networking types are now cloneable to allow simultaneous reads/writes.
8441 * std: `assert_approx_eq!` has been removed
8442 * std: The `e` and `E` formatting specifiers for floats have been added to
8443 print them in exponential notation.
8444 * std: The `Times` trait has been removed
8445 * std: Indications of variance and opting out of builtin bounds is done
8446 through marker types in `std::kinds::marker` now
8447 * std: `hash` has been rewritten, `IterBytes` has been removed, and
8448 `#[deriving(Hash)]` is now possible.
8449 * std: `SharedChan` has been removed, `Sender` is now cloneable.
8450 * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8451 * std: `Chan::new` is now `channel()`.
8452 * std: A new synchronous channel type has been implemented.
8453 * std: A `select!` macro is now provided for selecting over `Receiver`s.
8454 * std: `hashmap` and `trie` have been moved to `libcollections`
8455 * std: `run` has been rolled into `io::process`
8456 * std: `assert_eq!` now uses `{}` instead of `{:?}`
8457 * std: The equality and comparison traits have seen some reorganization.
8458 * std: `rand` has moved to `librand`.
8459 * std: `to_{lower,upper}case` has been implemented for `char`.
8460 * std: Logging has been moved to `liblog`.
8461 * collections: `HashMap` has been rewritten for higher performance and less
8462 memory usage.
8463 * native: The default runtime is now `libnative`. If `libgreen` is desired,
8464 it can be booted manually. The runtime guide has more information and
8465 examples.
8466 * native: All I/O functionality except signals has been implemented.
8467 * green: Task spawning with `libgreen` has been optimized with stack caching
8468 and various trimming of code.
8469 * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8470 * sync: The `extra::sync` module has been updated to modern rust (and moved
8471 to the `sync` library), tweaking and improving various interfaces while
8472 dropping redundant functionality.
8473 * sync: A new `Barrier` type has been added to the `sync` library.
8474 * sync: An efficient mutex for native and green tasks has been implemented.
8475 * serialize: The `base64` module has seen some improvement. It treats
8476 newlines better, has non-string error values, and has seen general
8477 cleanup.
8478 * fourcc: A `fourcc!` macro was introduced
8479 * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8480 hexadecimal literal.
8481
8482 * Tooling
8483 * `rustpkg` has been deprecated and removed from the main repository. Its
8484 replacement, `cargo`, is under development.
8485 * Nightly builds of rust are now available
8486 * The memory usage of rustc has been improved many times throughout this
8487 release cycle.
8488 * The build process supports disabling rpath support for the rustc binary
8489 itself.
8490 * Code generation has improved in some cases, giving more information to the
8491 LLVM optimization passes to enable more extensive optimizations.
8492 * Debuginfo compatibility with lldb on OSX has been restored.
8493 * The master branch is now gated on an android bot, making building for
8494 android much more reliable.
8495 * Output flags have been centralized into one `--emit` flag.
8496 * Crate type flags have been centralized into one `--crate-type` flag.
8497 * Codegen flags have been consolidated behind a `-C` flag.
8498 * Linking against outdated crates now has improved error messages.
8499 * Error messages with lifetimes will often suggest how to annotate the
8500 function to fix the error.
8501 * Many more types are documented in the standard library, and new guides
8502 were written.
8503 * Many `rustdoc` improvements:
8504 * code blocks are syntax highlighted.
8505 * render standalone markdown files.
8506 * the --test flag tests all code blocks by default.
8507 * exported macros are displayed.
2c00a5a8
XL
8508 * re-exported types have their documentation inlined at the location of the
8509 first re-export.
1a4d82fc
JJ
8510 * search works across crates that have been rendered to the same output
8511 directory.
8512
62682a34 8513
b039eaaf 8514Version 0.9 (2014-01-09)
62682a34 8515==========================
1a4d82fc
JJ
8516
8517 * ~1800 changes, numerous bugfixes
8518
8519 * Language
8520 * The `float` type has been removed. Use `f32` or `f64` instead.
8521 * A new facility for enabling experimental features (feature gating) has
8522 been added, using the crate-level `#[feature(foo)]` attribute.
8523 * Managed boxes (@) are now behind a feature gate
8524 (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8525 standard library's `Gc` or `Rc` types instead.
8526 * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8527 * Jumping back to the top of a loop is now done with `continue` instead of
8528 `loop`.
8529 * Strings can no longer be mutated through index assignment.
8530 * Raw strings can be created via the basic `r"foo"` syntax or with matched
8531 hash delimiters, as in `r###"foo"###`.
8532 * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8533 called once.
8534 * The `&fn` type is now written `|args| -> ret` to match the literal form.
8535 * `@fn`s have been removed.
8536 * `do` only works with procs in order to make it obvious what the cost
8537 of `do` is.
8538 * Single-element tuple-like structs can no longer be dereferenced to
8539 obtain the inner value. A more comprehensive solution for overloading
8540 the dereference operator will be provided in the future.
8541 * The `#[link(...)]` attribute has been replaced with
8542 `#[crate_id = "name#vers"]`.
8543 * Empty `impl`s must be terminated with empty braces and may not be
8544 terminated with a semicolon.
8545 * Keywords are no longer allowed as lifetime names; the `self` lifetime
8546 no longer has any special meaning.
8547 * The old `fmt!` string formatting macro has been removed.
8548 * `printf!` and `printfln!` (old-style formatting) removed in favor of
8549 `print!` and `println!`.
8550 * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8551 * The `extern mod foo (name = "bar")` syntax has been removed. Use
8552 `extern mod foo = "bar"` instead.
8553 * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8554 * Macros can have attributes.
8555 * Macros can expand to items with attributes.
8556 * Macros can expand to multiple items.
8557 * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8558 * Comments may be nested.
8559 * Values automatically coerce to trait objects they implement, without
8560 an explicit `as`.
8561 * Enum discriminants are no longer an entire word but as small as needed to
8562 contain all the variants. The `repr` attribute can be used to override
8563 the discriminant size, as in `#[repr(int)]` for integer-sized, and
8564 `#[repr(C)]` to match C enums.
8565 * Non-string literals are not allowed in attributes (they never worked).
8566 * The FFI now supports variadic functions.
8567 * Octal numeric literals, as in `0o7777`.
8568 * The `concat!` syntax extension performs compile-time string concatenation.
8569 * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8570 removed as Rust no longer uses segmented stacks.
8571 * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8572 * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8573 not `*`; ignoring remaining fields of a struct is also done with `..`,
8574 not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8575 * `rustc` supports the "win64" calling convention via `extern "win64"`.
8576 * `rustc` supports the "system" calling convention, which defaults to the
8577 preferred convention for the target platform, "stdcall" on 32-bit Windows,
8578 "C" elsewhere.
8579 * The `type_overflow` lint (default: warn) checks literals for overflow.
8580 * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8581 * The `attribute_usage` lint (default: warn) warns about unknown
8582 attributes.
8583 * The `unknown_features` lint (default: warn) warns about unknown
8584 feature gates.
8585 * The `dead_code` lint (default: warn) checks for dead code.
8586 * Rust libraries can be linked statically to one another
8587 * `#[link_args]` is behind the `link_args` feature gate.
8588 * Native libraries are now linked with `#[link(name = "foo")]`
8589 * Native libraries can be statically linked to a rust crate
8590 (`#[link(name = "foo", kind = "static")]`).
8591 * Native OS X frameworks are now officially supported
8592 (`#[link(name = "foo", kind = "framework")]`).
8593 * The `#[thread_local]` attribute creates thread-local (not task-local)
8594 variables. Currently behind the `thread_local` feature gate.
8595 * The `return` keyword may be used in closures.
8596 * Types that can be copied via a memcpy implement the `Pod` kind.
8597 * The `cfg` attribute can now be used on struct fields and enum variants.
8598
8599 * Libraries
8600 * std: The `option` and `result` API's have been overhauled to make them
8601 simpler, more consistent, and more composable.
8602 * std: The entire `std::io` module has been replaced with one that is
8603 more comprehensive and that properly interfaces with the underlying
8604 scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8605 implemented.
8606 * std: `io::util` contains a number of useful implementations of
8607 `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8608 `ZeroReader`, `TeeReader`.
8609 * std: The reference counted pointer type `extra::rc` moved into std.
8610 * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8611 just a wrapper around it).
8612 * std: The `Either` type has been removed.
8613 * std: `fmt::Default` can be implemented for any type to provide default
8614 formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8615 * std: The `rand` API continues to be tweaked.
8616 * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8617 on failure in gdb, is now named `rust_fail`.
8618 * std: The `each_key` and `each_value` methods on `HashMap` have been
8619 replaced by the `keys` and `values` iterators.
8620 * std: Functions dealing with type size and alignment have moved from the
8621 `sys` module to the `mem` module.
8622 * std: The `path` module was written and API changed.
8623 * std: `str::from_utf8` has been changed to cast instead of allocate.
8624 * std: `starts_with` and `ends_with` methods added to vectors via the
8625 `ImmutableEqVector` trait, which is in the prelude.
8626 * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8627 if the index is out of bounds.
8628 * std: Task failure no longer propagates between tasks, as the model was
8629 complex, expensive, and incompatible with thread-based tasks.
8630 * std: The `Any` type can be used for dynamic typing.
8631 * std: `~Any` can be passed to the `fail!` macro and retrieved via
8632 `task::try`.
8633 * std: Methods that produce iterators generally do not have an `_iter`
8634 suffix now.
8635 * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8636 roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8637 * std: `util::ignore` renamed to `prelude::drop`.
8638 * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8639 trait.
8640 * std: `vec::raw` has seen a lot of cleanup and API changes.
8641 * std: The standard library no longer includes any C++ code, and very
8642 minimal C, eliminating the dependency on libstdc++.
8643 * std: Runtime scheduling and I/O functionality has been factored out into
8644 extensible interfaces and is now implemented by two different crates:
8645 libnative, for native threading and I/O; and libgreen, for green threading
8646 and I/O. This paves the way for using the standard library in more limited
8647 embedded environments.
8648 * std: The `comm` module has been rewritten to be much faster, have a
8649 simpler, more consistent API, and to work for both native and green
8650 threading.
8651 * std: All libuv dependencies have been moved into the rustuv crate.
8652 * native: New implementations of runtime scheduling on top of OS threads.
8653 * native: New native implementations of TCP, UDP, file I/O, process spawning,
8654 and other I/O.
8655 * green: The green thread scheduler and message passing types are almost
8656 entirely lock-free.
8657 * extra: The `flatpipes` module had bitrotted and was removed.
8658 * extra: All crypto functions have been removed and Rust now has a policy of
8659 not reimplementing crypto in the standard library. In the future crypto
8660 will be provided by external crates with bindings to established libraries.
8661 * extra: `c_vec` has been modernized.
8662 * extra: The `sort` module has been removed. Use the `sort` method on
8663 mutable slices.
8664
8665 * Tooling
8666 * The `rust` and `rusti` commands have been removed, due to lack of
8667 maintenance.
8668 * `rustdoc` was completely rewritten.
8669 * `rustdoc` can test code examples in documentation.
8670 * `rustpkg` can test packages with the argument, 'test'.
8671 * `rustpkg` supports arbitrary dependencies, including C libraries.
8672 * `rustc`'s support for generating debug info is improved again.
8673 * `rustc` has better error reporting for unbalanced delimiters.
8674 * `rustc`'s JIT support was removed due to bitrot.
8675 * Executables and static libraries can be built with LTO (-Z lto)
8676 * `rustc` adds a `--dep-info` flag for communicating dependencies to
8677 build tools.
8678
62682a34 8679
b039eaaf 8680Version 0.8 (2013-09-26)
62682a34 8681============================
1a4d82fc
JJ
8682
8683 * ~2200 changes, numerous bugfixes
8684
8685 * Language
8686 * The `for` loop syntax has changed to work with the `Iterator` trait.
8687 * At long last, unwinding works on Windows.
8688 * Default methods are ready for use.
8689 * Many trait inheritance bugs fixed.
8690 * Owned and borrowed trait objects work more reliably.
8691 * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8692 * rustc can omit emission of code for the `debug!` macro if it is passed
8693 `--cfg ndebug`
8694 * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8695 for foo.rs, then foo/mod.rs, and will generate an error when both are
8696 present.
8697 * Strings no longer contain trailing nulls. The new `std::c_str` module
8698 provides new mechanisms for converting to C strings.
8699 * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8700 * The FFI has been overhauled such that foreign functions are called directly,
8701 instead of through a stack-switching wrapper.
8702 * Calling a foreign function must be done through a Rust function with the
8703 `#[fixed_stack_segment]` attribute.
8704 * The `externfn!` macro can be used to declare both a foreign function and
8705 a `#[fixed_stack_segment]` wrapper at once.
8706 * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8707 * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8708 * `priv` is disallowed everywhere except for struct fields and enum variants.
8709 * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8710 * `ref` bindings in irrefutable patterns work correctly now.
8711 * `char` is now prevented from containing invalid code points.
8712 * Casting to `bool` is no longer allowed.
8713 * `\0` is now accepted as an escape in chars and strings.
8714 * `yield` is a reserved keyword.
8715 * `typeof` is a reserved keyword.
8716 * Crates may be imported by URL with `extern mod foo = "url";`.
8717 * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8718 * Static vectors can be initialized with repeating elements,
8719 e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8720 * Static structs can be initialized with functional record update,
8721 e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8722 * `cfg!` can be used to conditionally execute code based on the crate
8723 configuration, similarly to `#[cfg(...)]`.
8724 * The `unnecessary_qualification` lint detects unneeded module
8725 prefixes (default: allow).
8726 * Arithmetic operations have been implemented on the SIMD types in
8727 `std::unstable::simd`.
8728 * Exchange allocation headers were removed, reducing memory usage.
8729 * `format!` implements a completely new, extensible, and higher-performance
8730 string formatting system. It will replace `fmt!`.
8731 * `print!` and `println!` write formatted strings (using the `format!`
8732 extension) to stdout.
8733 * `write!` and `writeln!` write formatted strings (using the `format!`
8734 extension) to the new Writers in `std::rt::io`.
8735 * The library section in which a function or static is placed may
8736 be specified with `#[link_section = "..."]`.
8737 * The `proto!` syntax extension for defining bounded message protocols
8738 was removed.
8739 * `macro_rules!` is hygienic for `let` declarations.
8740 * The `#[export_name]` attribute specifies the name of a symbol.
8741 * `unreachable!` can be used to indicate unreachable code, and fails
8742 if executed.
8743
8744 * Libraries
8745 * std: Transitioned to the new runtime, written in Rust.
8746 * std: Added an experimental I/O library, `rt::io`, based on the new
8747 runtime.
8748 * std: A new generic `range` function was added to the prelude, replacing
8749 `uint::range` and friends.
8750 * std: `range_rev` no longer exists. Since range is an iterator it can be
8751 reversed with `range(lo, hi).invert()`.
8752 * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8753 renamed to `unwrap_or`.
8754 * std: The `iterator` module was renamed to `iter`.
8755 * std: Integral types now support the `checked_add`, `checked_sub`, and
8756 `checked_mul` operations for detecting overflow.
8757 * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8758 consistency.
8759 * std: Methods are standardizing on conventions for casting methods:
8760 `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8761 and cheap casts.
8762 * std: The `CString` type in `c_str` provides new ways to convert to and
8763 from C strings.
8764 * std: `DoubleEndedIterator` can yield elements in two directions.
8765 * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8766 two splices.
8767 * std: `str::from_bytes` renamed to `str::from_utf8`.
8768 * std: `pop_opt` and `shift_opt` methods added to vectors.
8769 * std: The task-local data interface no longer uses @, and keys are
8770 no longer function pointers.
8771 * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8772 * std: Added `SharedPort` to `comm`.
8773 * std: `Eq` has a default method for `ne`; only `eq` is required
8774 in implementations.
8775 * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8776 is required in implementations.
8777 * std: `is_utf8` performance is improved, impacting many string functions.
8778 * std: `os::MemoryMap` provides cross-platform mmap.
8779 * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8780 are not 'in-bounds' are considered undefined.
8781 * std: Many freestanding functions in `vec` removed in favor of methods.
8782 * std: Many freestanding functions on scalar types removed in favor of
8783 methods.
8784 * std: Many options to task builders were removed since they don't make
8785 sense in the new scheduler design.
8786 * std: More containers implement `FromIterator` so can be created by the
8787 `collect` method.
8788 * std: More complete atomic types in `unstable::atomics`.
8789 * std: `comm::PortSet` removed.
8790 * std: Mutating methods in the `Set` and `Map` traits have been moved into
8791 the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8792 `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8793 default implementations.
8794 * std: Various `from_str` functions were removed in favor of a generic
8795 `from_str` which is available in the prelude.
8796 * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8797 * extra: `dlist`, the doubly-linked list was modernized.
8798 * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8799 * extra: Added `glob` module, replacing `std::os::glob`.
8800 * extra: `rope` was removed.
8801 * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8802 * extra: `net`, and `timer` were removed. The experimental replacements
8803 are `std::rt::io::net` and `std::rt::io::timer`.
8804 * extra: Iterators implemented for `SmallIntMap`.
8805 * extra: Iterators implemented for `Bitv` and `BitvSet`.
8806 * extra: `SmallIntSet` removed. Use `BitvSet`.
8807 * extra: Performance of JSON parsing greatly improved.
8808 * extra: `semver` updated to SemVer 2.0.0.
8809 * extra: `term` handles more terminals correctly.
8810 * extra: `dbg` module removed.
8811 * extra: `par` module removed.
8812 * extra: `future` was cleaned up, with some method renames.
8813 * extra: Most free functions in `getopts` were converted to methods.
8814
8815 * Other
8816 * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8817 * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8818 similarly to gcc's `--march` flag.
8819 * rustc's performance compiling small crates is much better.
8820 * rustpkg has received many improvements.
8821 * rustpkg supports git tags as package IDs.
8822 * rustpkg builds into target-specific directories so it can be used for
8823 cross-compiling.
8824 * The number of concurrent test tasks is controlled by the environment
8825 variable RUST_TEST_TASKS.
8826 * The test harness can now report metrics for benchmarks.
8827 * All tools have man pages.
8828 * Programs compiled with `--test` now support the `-h` and `--help` flags.
8829 * The runtime uses jemalloc for allocations.
8830 * Segmented stacks are temporarily disabled as part of the transition to
8831 the new runtime. Stack overflows are possible!
8832 * A new documentation backend, rustdoc_ng, is available for use. It is
8833 still invoked through the normal `rustdoc` command.
8834
62682a34 8835
b039eaaf 8836Version 0.7 (2013-07-03)
62682a34 8837=======================
1a4d82fc
JJ
8838
8839 * ~2000 changes, numerous bugfixes
8840
8841 * Language
8842 * `impl`s no longer accept a visibility qualifier. Put them on methods
8843 instead.
8844 * The borrow checker has been rewritten with flow-sensitivity, fixing
8845 many bugs and inconveniences.
8846 * The `self` parameter no longer implicitly means `&'self self`,
8847 and can be explicitly marked with a lifetime.
8848 * Overloadable compound operators (`+=`, etc.) have been temporarily
8849 removed due to bugs.
8850 * The `for` loop protocol now requires `for`-iterators to return `bool`
8851 so they compose better.
8852 * The `Durable` trait is replaced with the `'static` bounds.
8853 * Trait default methods work more often.
8854 * Structs with the `#[packed]` attribute have byte alignment and
8855 no padding between fields.
8856 * Type parameters bound by `Copy` must now be copied explicitly with
8857 the `copy` keyword.
8858 * It is now illegal to move out of a dereferenced unsafe pointer.
8859 * `Option<~T>` is now represented as a nullable pointer.
8860 * `@mut` does dynamic borrow checks correctly.
8861 * The `main` function is only detected at the topmost level of the crate.
8862 The `#[main]` attribute is still valid anywhere.
8863 * Struct fields may no longer be mutable. Use inherited mutability.
8864 * The `#[no_send]` attribute makes a type that would otherwise be
8865 `Send`, not.
8866 * The `#[no_freeze]` attribute makes a type that would otherwise be
8867 `Freeze`, not.
8868 * Unbounded recursion will abort the process after reaching the limit
8869 specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8870 * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8871 are never implicitly copyable.
8872 * `#[static_assert]` makes compile-time assertions about static bools.
8873 * At long last, 'argument modes' no longer exist.
8874 * The rarely used `use mod` statement no longer exists.
8875
8876 * Syntax extensions
8877 * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8878 argument list.
8879 * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8880 `Rand`, `Zero` and `ToStr` can all be automatically derived with
8881 `#[deriving(...)]`.
8882 * The `bytes!` macro returns a vector of bytes for string, u8, char,
8883 and unsuffixed integer literals.
8884
8885 * Libraries
8886 * The `core` crate was renamed to `std`.
8887 * The `std` crate was renamed to `extra`.
8888 * More and improved documentation.
8889 * std: `iterator` module for external iterator objects.
8890 * Many old-style (internal, higher-order function) iterators replaced by
8891 implementations of `Iterator`.
8892 * std: Many old internal vector and string iterators,
8893 incl. `any`, `all`. removed.
8894 * std: The `finalize` method of `Drop` renamed to `drop`.
8895 * std: The `drop` method now takes `&mut self` instead of `&self`.
2c00a5a8 8896 * std: The prelude no longer re-exports any modules, only types and traits.
1a4d82fc
JJ
8897 * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8898 `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8899 * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8900 `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8901 * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8902 `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8903 * std: Many types implement `Clone`.
8904 * std: `path` type renamed to `Path`.
8905 * std: `mut` module and `Mut` type removed.
8906 * std: Many standalone functions removed in favor of methods and iterators
8907 in `vec`, `str`. In the future methods will also work as functions.
8908 * std: `reinterpret_cast` removed. Use `transmute`.
8909 * std: ascii string handling in `std::ascii`.
8910 * std: `Rand` is implemented for ~/@.
8911 * std: `run` module for spawning processes overhauled.
8912 * std: Various atomic types added to `unstable::atomic`.
8913 * std: Various types implement `Zero`.
8914 * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8915 * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8916 * std: Added `os::mkdir_recursive`.
8917 * std: Added `os::glob` function performs filesystems globs.
8918 * std: `FuzzyEq` renamed to `ApproxEq`.
8919 * std: `Map` now defines `pop` and `swap` methods.
8920 * std: `Cell` constructors converted to static methods.
8921 * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8922 * extra: `flate` module moved from `std` to `extra`.
8923 * extra: `fileinput` module for iterating over a series of files.
8924 * extra: `Complex` number type and `complex` module.
8925 * extra: `Rational` number type and `rational` module.
8926 * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8927 * extra: `term` uses terminfo now, is more correct.
8928 * extra: `arc` functions converted to methods.
8929 * extra: Implementation of fixed output size variations of SHA-2.
8930
8931 * Tooling
60c5eb7d 8932 * `unused_variables` lint mode for unused variables (default: warn).
1a4d82fc
JJ
8933 * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8934 (default: warn).
8935 * `unused_mut` lint mode for identifying unused `mut` qualifiers
8936 (default: warn).
8937 * `dead_assignment` lint mode for unread variables (default: warn).
8938 * `unnecessary_allocation` lint mode detects some heap allocations that are
8939 immediately borrowed so could be written without allocating (default: warn).
8940 * `missing_doc` lint mode (default: allow).
8941 * `unreachable_code` lint mode (default: warn).
8942 * The `rusti` command has been rewritten and a number of bugs addressed.
8943 * rustc outputs in color on more terminals.
8944 * rustc accepts a `--link-args` flag to pass arguments to the linker.
8945 * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8946 * Compiling with `-g` will make the binary record information about
8947 dynamic borrowcheck failures for debugging.
8948 * rustdoc has a nicer stylesheet.
8949 * Various improvements to rustdoc.
8950 * Improvements to rustpkg (see the detailed release notes).
8951
62682a34 8952
b039eaaf 8953Version 0.6 (2013-04-03)
62682a34 8954========================
1a4d82fc
JJ
8955
8956 * ~2100 changes, numerous bugfixes
8957
8958 * Syntax changes
8959 * The self type parameter in traits is now spelled `Self`
8960 * The `self` parameter in trait and impl methods must now be explicitly
8961 named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8962 * Static methods no longer require the `static` keyword and instead
8963 are distinguished by the lack of a `self` parameter
8964 * Replaced the `Durable` trait with the `'static` lifetime
8965 * The old closure type syntax with the trailing sigil has been
8966 removed in favor of the more consistent leading sigil
8967 * `super` is a keyword, and may be prefixed to paths
8968 * Trait bounds are separated with `+` instead of whitespace
8969 * Traits are implemented with `impl Trait for Type`
8970 instead of `impl Type: Trait`
8971 * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8972 * The `export` keyword has finally been removed
8973 * The `move` keyword has been removed (see "Semantic changes")
8974 * The interior mutability qualifier on vectors, `[mut T]`, has been
8975 removed. Use `&mut [T]`, etc.
8976 * `mut` is no longer valid in `~mut T`. Use inherited mutability
8977 * `fail` is no longer a keyword. Use `fail!()`
8978 * `assert` is no longer a keyword. Use `assert!()`
8979 * `log` is no longer a keyword. use `debug!`, etc.
8980 * 1-tuples may be represented as `(T,)`
8981 * Struct fields may no longer be `mut`. Use inherited mutability,
8982 `@mut T`, `core::mut` or `core::cell`
8983 * `extern mod { ... }` is no longer valid syntax for foreign
8984 function modules. Use extern blocks: `extern { ... }`
8985 * Newtype enums removed. Use tuple-structs.
8986 * Trait implementations no longer support visibility modifiers
8987 * Pattern matching over vectors improved and expanded
8988 * `const` renamed to `static` to correspond to lifetime name,
8989 and make room for future `static mut` unsafe mutable globals.
8990 * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8991 * `Clone` implementations can be automatically generated with
8992 `#[deriving(Clone)]`
8993 * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8994 instead of `foo as Bar`.
8995 * Fixed length vector types are now written as `[int, .. 3]`
8996 instead of `[int * 3]`.
8997 * Fixed length vector types can express the length as a constant
8998 expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8999
9000 * Semantic changes
9001 * Types with owned pointers or custom destructors move by default,
9002 eliminating the `move` keyword
9003 * All foreign functions are considered unsafe
9004 * &mut is now unaliasable
9005 * Writes to borrowed @mut pointers are prevented dynamically
9006 * () has size 0
9007 * The name of the main function can be customized using #[main]
9008 * The default type of an inferred closure is &fn instead of @fn
9009 * `use` statements may no longer be "chained" - they cannot import
9010 identifiers imported by previous `use` statements
9011 * `use` statements are crate relative, importing from the "top"
9012 of the crate by default. Paths may be prefixed with `super::`
9013 or `self::` to change the search behavior.
9014 * Method visibility is inherited from the implementation declaration
9015 * Structural records have been removed
9016 * Many more types can be used in static items, including enums
9017 'static-lifetime pointers and vectors
9018 * Pattern matching over vectors improved and expanded
9019 * Typechecking of closure types has been overhauled to
9020 improve inference and eliminate unsoundness
9021 * Macros leave scope at the end of modules, unless that module is
9022 tagged with #[macro_escape]
9023
9024 * Libraries
9025 * Added big integers to `std::bigint`
9026 * Removed `core::oldcomm` module
9027 * Added pipe-based `core::comm` module
9028 * Numeric traits have been reorganized under `core::num`
9029 * `vec::slice` finally returns a slice
9030 * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9031 * Containers reorganized around traits in `core::container`
9032 * `core::dvec` removed, `~[T]` is a drop-in replacement
9033 * `core::send_map` renamed to `core::hashmap`
9034 * `std::map` removed; replaced with `core::hashmap`
9035 * `std::treemap` reimplemented as an owned balanced tree
9036 * `std::deque` and `std::smallintmap` reimplemented as owned containers
9037 * `core::trie` added as a fast ordered map for integer keys
9038 * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9039 * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9040 overload the comparison operators, whereas `TotalOrd` is used
9041 by certain container types
9042
9043 * Other
9044 * Replaced the 'cargo' package manager with 'rustpkg'
9045 * Added all-purpose 'rust' tool
9046 * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9047 * rustc now *attempts* to offer spelling suggestions
9048 * Improved support for ARM and Android
9049 * Preliminary MIPS backend
9050 * Improved foreign function ABI implementation for x86, x86_64
9051 * Various memory usage improvements
9052 * Rust code may be embedded in foreign code under limited circumstances
9053 * Inline assembler supported by new asm!() syntax extension.
9054
62682a34 9055
b039eaaf 9056Version 0.5 (2012-12-21)
62682a34 9057===========================
1a4d82fc
JJ
9058
9059 * ~900 changes, numerous bugfixes
9060
9061 * Syntax changes
9062 * Removed `<-` move operator
9063 * Completed the transition from the `#fmt` extension syntax to `fmt!`
9064 * Removed old fixed length vector syntax - `[T]/N`
9065 * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9066 * Macros may now expand to items and statements
9067 * `a.b()` is always parsed as a method call, never as a field projection
9068 * `Eq` and `IterBytes` implementations can be automatically generated
9069 with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9070 * Removed the special crate language for `.rc` files
9071 * Function arguments may consist of any irrefutable pattern
9072
9073 * Semantic changes
9074 * `&` and `~` pointers may point to objects
9075 * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9076 * Enum variants may be structs
9077 * Destructors can be added to all nominal types with the Drop trait
9078 * Structs and nullary enum variants may be constants
9079 * Values that cannot be implicitly copied are now automatically moved
9080 without writing `move` explicitly
9081 * `&T` may now be coerced to `*T`
9082 * Coercions happen in `let` statements as well as function calls
9083 * `use` statements now take crate-relative paths
9084 * The module and type namespaces have been merged so that static
9085 method names can be resolved under the trait in which they are
9086 declared
9087
9088 * Improved support for language features
9089 * Trait inheritance works in many scenarios
9090 * More support for explicit self arguments in methods - `self`, `&self`
9091 `@self`, and `~self` all generally work as expected
9092 * Static methods work in more situations
9093 * Experimental: Traits may declare default methods for the implementations
9094 to use
9095
9096 * Libraries
9097 * New condition handling system in `core::condition`
9098 * Timsort added to `std::sort`
9099 * New priority queue, `std::priority_queue`
9100 * Pipes for serializable types, `std::flatpipes'
9101 * Serialization overhauled to be trait-based
9102 * Expanded `getopts` definitions
9103 * Moved futures to `std`
9104 * More functions are pure now
9105 * `core::comm` renamed to `oldcomm`. Still deprecated
9106 * `rustdoc` and `cargo` are libraries now
9107
9108 * Misc
9109 * Added a preliminary REPL, `rusti`
9110 * License changed from MIT to dual MIT/APL2
9111
62682a34 9112
b039eaaf 9113Version 0.4 (2012-10-15)
62682a34 9114==========================
1a4d82fc
JJ
9115
9116 * ~2000 changes, numerous bugfixes
9117
9118 * Syntax
9119 * All keywords are now strict and may not be used as identifiers anywhere
9120 * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9121 'of', 'with', 'to', 'class'.
9122 * Classes are replaced with simpler structs
9123 * Explicit method self types
9124 * `ret` became `return` and `alt` became `match`
9125 * `import` is now `use`; `use is now `extern mod`
9126 * `extern mod { ... }` is now `extern { ... }`
9127 * `use mod` is the recommended way to import modules
9128 * `pub` and `priv` replace deprecated export lists
9129 * The syntax of `match` pattern arms now uses fat arrow (=>)
9130 * `main` no longer accepts an args vector; use `os::args` instead
9131
9132 * Semantics
9133 * Trait implementations are now coherent, ala Haskell typeclasses
9134 * Trait methods may be static
9135 * Argument modes are deprecated
9136 * Borrowed pointers are much more mature and recommended for use
9137 * Strings and vectors in the static region are stored in constant memory
9138 * Typestate was removed
9139 * Resolution rewritten to be more reliable
9140 * Support for 'dual-mode' data structures (freezing and thawing)
9141
9142 * Libraries
9143 * Most binary operators can now be overloaded via the traits in
9144 `core::ops'
9145 * `std::net::url` for representing URLs
9146 * Sendable hash maps in `core::send_map`
9147 * `core::task' gained a (currently unsafe) task-local storage API
9148
9149 * Concurrency
9150 * An efficient new intertask communication primitive called the pipe,
9151 along with a number of higher-level channel types, in `core::pipes`
9152 * `std::arc`, an atomically reference counted, immutable, shared memory
9153 type
9154 * `std::sync`, various exotic synchronization tools based on arcs and pipes
9155 * Futures are now based on pipes and sendable
9156 * More robust linked task failure
9157 * Improved task builder API
9158
9159 * Other
9160 * Improved error reporting
9161 * Preliminary JIT support
9162 * Preliminary work on precise GC
9163 * Extensive architectural improvements to rustc
9164 * Begun a transition away from buggy C++-based reflection (shape) code to
9165 Rust-based (visitor) code
9166 * All hash functions and tables converted to secure, randomized SipHash
9167
62682a34 9168
b039eaaf 9169Version 0.3 (2012-07-12)
62682a34 9170========================
1a4d82fc
JJ
9171
9172 * ~1900 changes, numerous bugfixes
9173
9174 * New coding conveniences
9175 * Integer-literal suffix inference
9176 * Per-item control over warnings, errors
9177 * #[cfg(windows)] and #[cfg(unix)] attributes
9178 * Documentation comments
9179 * More compact closure syntax
9180 * 'do' expressions for treating higher-order functions as
9181 control structures
9182 * *-patterns (wildcard extended to all constructor fields)
9183
9184 * Semantic cleanup
9185 * Name resolution pass and exhaustiveness checker rewritten
9186 * Region pointers and borrow checking supersede alias
9187 analysis
9188 * Init-ness checking is now provided by a region-based liveness
9189 pass instead of the typestate pass; same for last-use analysis
9190 * Extensive work on region pointers
9191
9192 * Experimental new language features
9193 * Slices and fixed-size, interior-allocated vectors
9194 * #!-comments for lang versioning, shell execution
9195 * Destructors and iface implementation for classes;
9196 type-parameterized classes and class methods
9197 * 'const' type kind for types that can be used to implement
9198 shared-memory concurrency patterns
9199
9200 * Type reflection
9201
9202 * Removal of various obsolete features
9203 * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9204 'crust', 'native' (now 'extern'), 'cont' (now 'again')
9205
9206 * Constructs: do-while loops ('do' repurposed), fn binding,
9207 resources (replaced by destructors)
9208
9209 * Compiler reorganization
9210 * Syntax-layer of compiler split into separate crate
9211 * Clang (from LLVM project) integrated into build
9212 * Typechecker split into sub-modules
9213
9214 * New library code
9215 * New time functions
9216 * Extension methods for many built-in types
9217 * Arc: atomic-refcount read-only / exclusive-use shared cells
9218 * Par: parallel map and search routines
9219 * Extensive work on libuv interface
9220 * Much vector code moved to libraries
9221 * Syntax extensions: #line, #col, #file, #mod, #stringify,
9222 #include, #include_str, #include_bin
9223
9224 * Tool improvements
9225 * Cargo automatically resolves dependencies
9226
62682a34 9227
b039eaaf 9228Version 0.2 (2012-03-29)
62682a34 9229=========================
1a4d82fc
JJ
9230
9231 * >1500 changes, numerous bugfixes
9232
9233 * New docs and doc tooling
9234
9235 * New port: FreeBSD x86_64
9236
9237 * Compilation model enhancements
9238 * Generics now specialized, multiply instantiated
9239 * Functions now inlined across separate crates
9240
9241 * Scheduling, stack and threading fixes
9242 * Noticeably improved message-passing performance
9243 * Explicit schedulers
9244 * Callbacks from C
9245 * Helgrind clean
9246
9247 * Experimental new language features
9248 * Operator overloading
9249 * Region pointers
9250 * Classes
9251
9252 * Various language extensions
9253 * C-callback function types: 'crust fn ...'
9254 * Infinite-loop construct: 'loop { ... }'
9255 * Shorten 'mutable' to 'mut'
9256 * Required mutable-local qualifier: 'let mut ...'
9257 * Basic glob-exporting: 'export foo::*;'
9258 * Alt now exhaustive, 'alt check' for runtime-checked
9259 * Block-function form of 'for' loop, with 'break' and 'ret'.
9260
9261 * New library code
9262 * AST quasi-quote syntax extension
9263 * Revived libuv interface
9264 * New modules: core::{future, iter}, std::arena
9265 * Merged per-platform std::{os*, fs*} to core::{libc, os}
9266 * Extensive cleanup, regularization in libstd, libcore
9267
62682a34 9268
b039eaaf 9269Version 0.1 (2012-01-20)
62682a34 9270===============================
1a4d82fc
JJ
9271
9272 * Most language features work, including:
9273 * Unique pointers, unique closures, move semantics
9274 * Interface-constrained generics
9275 * Static interface dispatch
9276 * Stack growth
9277 * Multithread task scheduling
9278 * Typestate predicates
9279 * Failure unwinding, destructors
9280 * Pattern matching and destructuring assignment
9281 * Lightweight block-lambda syntax
9282 * Preliminary macro-by-example
9283
9284 * Compiler works with the following configurations:
9285 * Linux: x86 and x86_64 hosts and targets
cc61c64b 9286 * macOS: x86 and x86_64 hosts and targets
1a4d82fc
JJ
9287 * Windows: x86 hosts and targets
9288
9289 * Cross compilation / multi-target configuration supported.
9290
9291 * Preliminary API-documentation and package-management tools included.
9292
9293Known issues:
9294
9295 * Documentation is incomplete.
9296
9297 * Performance is below intended target.
9298
9299 * Standard library APIs are subject to extensive change, reorganization.
9300
9301 * Language-level versioning is not yet operational - future code will
9302 break unexpectedly.