Update books

[rustbot]

rust-lang/reference

15 commits in ec78de0ffe2f8344bd0e222b17ac7a7d32dc7a26..11f84ce150bed12af4331d2110c75590c7b46261
2025-12-19 04:11:52 UTC to 2025-12-16 18:21:13 UTC

• Document how closure capturing interacts with discriminant reads (Document how closure capturing interacts with discriminant reads reference#1837)
• operator-expr: remove stray word in footnote (operator-expr: remove stray word in footnote reference#2118)
• await-expr: add a missing space (await-expr: add a missing space reference#2120)
• attributes: add missing punctuation to instruction_set (attributes: add missing punctuation to instruction_set reference#2117)
• associated-items: add missing periods (associated-items: add missing periods reference#2116)
• Move tools into a consolidated cargo workspace (Move tools into a consolidated cargo workspace reference#2115)
• Unwrap all of the lexical chapters (Unwrap all of the lexical chapters reference#2113)
• Unwrap const_eval.md (Unwrap const_eval.md reference#2112)
• Add section on expansion-time (early) name resolution (Add section on expansion-time (early) name resolution reference#2055)
• const_eval.md: add missing word (const_eval.md: add missing word reference#2068)
• path-expr.md: use a more suitable punctuation (path-expr.md: use a more suitable punctuation reference#2082)
• items: clarify label for type-aliases documentation (items: clarify label for type-aliases documentation reference#2110)
• do not mix singular and plural (do not mix singular and plural reference#2101)
• external-blocks: add missing "and" in list (external-blocks: add missing "and" in list reference#2111)
• conditional-compilation: add a space in cfg.cfg_attr.attribute-list (conditional-compilation: add a space in cfg.cfg_attr.attribute-list reference#2109)

[rustbot]

r? @ehuss

rustbot has assigned @ehuss.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

[rustbot]

⚠️ Warning ⚠️

• Some commits in this PR modify submodules.

  If this was not intentional, see I changed a submodule on accident in the rustc dev guide.

[ehuss]

@bors r+ rollup

[bors]

📌 Commit 7e167d1 has been approved by ehuss

It is now in the queue for this repository.

[JonathanBrouwer]

@bors try jobs=x86_64-gnu-distcheck

[rust-bors]

💔 Test for 86ef94e failed: CI. Failed jobs:

• try - x86_64-gnu-distcheck (web logs, enhanced plaintext logs)

[JonathanBrouwer]

@bors r-

[rustbot]

This PR was rebased onto a different main commit. Here's a range-diff highlighting what actually changed.

Rebasing is a normal part of keeping PRs up to date, so no action is needed—this note is just to help reviewers.

[rust-log-analyzer]

The job tidy failed! Check out the build log: (web) (plain enhanced) (plain)

Click to see the possible cause of the failure (guessed by this bot)

fmt check
fmt: checked 6615 files
tidy check

thread 'deps (.)' (4189) panicked at src/tools/tidy/src/deps.rs:654:24:
cmd.exec() failed with `cargo metadata` exited with an error: error: failed to load manifest for dependency `mdbook-spec`

Caused by:
  failed to read `/checkout/src/doc/reference/mdbook-spec/Cargo.toml`

Caused by:
---
   5: std::thread::scoped::scope::<rust_tidy::main::{closure#4}, ()>
   6: rust_tidy::main
note: Some details are omitted, run with `RUST_BACKTRACE=full` for a verbose backtrace.
Bootstrap failed while executing `test src/tools/tidy tidyselftest --extra-checks=py,cpp,js,spellcheck`
Command `/checkout/obj/build/x86_64-unknown-linux-gnu/stage1-tools-bin/rust-tidy /checkout /checkout/obj/build/x86_64-unknown-linux-gnu/stage0/bin/cargo /checkout/obj/build 4 /node/bin/yarn --extra-checks=py,cpp,js,spellcheck` failed with exit code 101
Created at: src/bootstrap/src/core/build_steps/tool.rs:1612:23
Executed at: src/bootstrap/src/core/build_steps/test.rs:1357:29

Command has failed. Rerun with -v to see more details.
Build completed unsuccessfully in 0:01:07
  local time: Wed Dec 31 00:36:34 UTC 2025
  network time: Wed, 31 Dec 2025 00:36:34 GMT
##[error]Process completed with exit code 1.
##[group]Run echo "disk usage:"