Update to mdbook 0.5

[ehuss]

This updates to mdbook 0.5.2 from mdbook 0.4.52. A primary aspect of this change is that it splits the mdbook crate into multiple crates, and various API changes and cleanup.

There's full release notes and a migration guide at https://github.com/rust-lang/mdBook/blob/master/CHANGELOG.md#mdbook-050.

This also includes submodule updates:

book

1 commits in 8c0eacd5c4acbb650497454f3a58c9e8083202a4..9c9104e8a82430f97f42e738051bda718919211c
2025-11-18 10:36:41 -0500 to 2025-12-10 11:33:49 -0500

• Update to mdbook 0.5

edition-guide

1 commits in 9cf5443d632673c4d41edad5e8ed8be86eeb3b8f..c3c0f0b3da26610138b7ba7663f60cd2c68cf184
2025-11-15 21:51:11 +0000 to 2025-11-28 18:54:18 +0000

• Update to mdbook 0.5 (Update to mdbook 0.5 edition-guide#381)

nomicon

2 commits in 0fe83ab28985b99aba36a1f0dbde3e08286fefda..9fe8fa599ad228dda74f240cc32b54bc5c1aa3e6
2025-11-15 00:03:14 +0000 to 2025-12-03 11:54:04 +0000

• Remove references to outdated unsafe code guidelines (Remove references to outdated unsafe code guidelines nomicon#512)
• Update to mdbook 0.5 (Update to mdbook 0.5 nomicon#511)

reference

5 commits in b14b4e40f53ca468beaf2f5d0dfb4f4c4ba6bc7b..50c5de90487b68d429a30cc9466dc8f5b410128f
2025-12-02 21:17:44 +0000 to 2025-12-09 22:19:05 +0000

• UB: update the extra clause for provenance UB during const evaluation (UB: update the extra clause for provenance UB during const evaluation reference#2091)
• Remove [no-mentions] handler in our triagebot config (Remove [no-mentions] handler in our triagebot config reference#2102)
• Clarify that omitting nostack is a promise from the compiler to the programmer (Clarify that omitting nostack is a promise from the compiler to the programmer reference#1999)
• Specify that range patterns must be nonempty. (Specify that range patterns must be nonempty. reference#2093)
• Update to mdbook 0.5 (Update to mdbook 0.5 reference#2096)

rust-by-example

1 commits in 111cfae2f9c3a43f7b0ff8fa68c51cc8f930637c..7d21279e40e8f0e91c2a22c5148dd2d745aef8b6
2025-11-27 17:16:42 -0300 to 2025-12-01 15:02:09 -0300

• Update to mdbook 0.5 (Update to mdbook 0.5 rust-by-example#1977)

[rustbot]

The list of allowed third-party dependencies may have been modified! You must ensure that any new dependencies have compatible licenses before merging.

cc @davidtwco, @wesleywiser

Some changes occurred in src/doc/style-guide

cc @rust-lang/style

[rustbot]

r? @Mark-Simulacrum

rustbot has assigned @Mark-Simulacrum.
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

[Mark-Simulacrum]

I think this is the first case of CC-BY... I'm not too familiar with that license family, do we think there's any legal review or scrutiny warranted?

[ehuss]

Good question. My understanding is that CC-BY-4.0 is quite permissive, primarily needing attribution. The embedded SVG in the output includes a comment with all of the license and copyright information. According to FontAwesome's documentation, that's all that's needed to comply.

Some other details for clarity:

• Previously mdbook was using FontAwesome 4.7 which was licensed under SIL OFL 1.1 and MIT. That was untracked in our system.
• font-awesome-as-a-crate is maintained by the Rust project in https://github.com/rust-lang/docs.rs.

[Mark-Simulacrum]

Thanks, that sounds good to me.

[ehuss]

Oops, I forgot to test a particular configuration (no cargo in PATH). Posted rust-lang/book#4605 to try to fix things.

[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.

• There are issue links (such as #123) in the commit messages of the following commits.
  Please move them to the PR description, to avoid spamming the issues with references to the commit, and so this bot can automatically canonicalize them to avoid issues with subtree.

  • 29f688a

[ehuss]

I think this should be ready to go now, I have updated the book submodule to fix the build error.

[Mark-Simulacrum]

@bors r+

[bors]

📌 Commit 29f688a has been approved by Mark-Simulacrum

It is now in the queue for this repository.