-
Notifications
You must be signed in to change notification settings - Fork 12.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update the book to fix some edition-related bugs #56615
Conversation
(rust_highfive has picked a reviewer for you, use r? to override) |
|
Thanks! @bors: r+ rollup |
📌 Commit 9d75198 has been approved by |
Update the book to fix some edition-related bugs I'd love to have this included in a point release if one happens, but the changes aren't worth doing a point release on their own IMO. I'd definitely like to see this backported to beta. The most urgent changes included here are: - Chapter 19.6, on macros (including the macro changes that just stabilized), [is cut off](rust-lang/book#1668) because of an ill-placed newline in a comment that [pulldown-cmark interprets incorrectly](pulldown-cmark/pulldown-cmark#124). - [The `Cargo.toml` shown in the Guessing Game example in Chapter 2 (and one in Chapter 14) doesn't have `edition="2018"`](rust-lang/book#1671), which can be confusing depending on whether the readers have it in theirs or not, think they should remove it if they have it, and the rest of the chapter assumes it's there and the code doesn't compile if you don't have it. - The redirects implemented as part of only shipping the 2018 edition of the book sometimes lead to [having to click through 2 redirect pages](rust-lang/book#1667) when it could be just one. There are other small corrections included that were made since the last time the book was updated, but those aren't urgent. cc @steveklabnik
☀️ Test successful - status-appveyor, status-travis |
Thanks @GuillaumeGomez! Should I open another PR for backporting to beta, @Mark-Simulacrum ? And are the labels sufficient to get this picked up if a stable point release happens? |
@carols10cents The release team will roll this up into both stable and beta backports (beta for sure, stable if indeed we release a point release). However, this PR does need to be marked |
cc @rust-lang/docs, should this PR be backported to beta and stable (1.31.1)? |
Based on the issues mentioned in the PR description, i think this should be backported. I know i've seen people get confused by them already. |
[beta] Rollup backports PRs accepted for backport: * #56781: Update LLVM submodule * #56615: Update the book to fix some edition-related bugs * #56562: Update libc version required by rustc * #56282: Fix #56237: normalize type before deferred sizedness checking. * Release notes for Rust 1.31.1 Approved PRs targeting beta: * #56819: [beta] rustdoc: fix line numbers display for [src] pages * #56893: [beta] Revert "Update CI-clang to 7.0.0 for Linux dists." r? @ghost
[stable] 1.31.1 point release Rust 1.31.1 is scheduled to be released on Thursday 20th, with the following changes: * #56562: Update libc version required by rustc *(different patch made by me)* * #56615: Update the book to fix some edition-related bugs * rls submodule update to [`b379ef7`](rust-lang/rls@b379ef7), including: * rust-lang/rls#1170: Fix for common infinte loop regression * rust-lang/rls#1171: Can't jump to std defs r? @Mark-Simulacrum cc @rust-lang/core @rust-lang/release
I'd love to have this included in a point release if one happens, but the changes aren't worth doing a point release on their own IMO. I'd definitely like to see this backported to beta.
The most urgent changes included here are:
Cargo.toml
shown in the Guessing Game example in Chapter 2 (and one in Chapter 14) doesn't haveedition="2018"
, which can be confusing depending on whether the readers have it in theirs or not, think they should remove it if they have it, and the rest of the chapter assumes it's there and the code doesn't compile if you don't have it.There are other small corrections included that were made since the last time the book was updated, but those aren't urgent.
cc @steveklabnik