rust-lang / rust-lang/rustc-dev-guide
Bug: Book build fails on Windows
Open
Nobody has claimed this yet.
C-bug
O-windows
WG-rustc-dev-guide
- Dominant language
- HTML
- Stars
- 1.9k
- Forks
- 613
- Avg merge
- 17h 24m
- Merged PRs (30d)
- 39
Description
When I cloned the project, I tried running mdbook build --open and it show:
> gh repo clone rust-lang/rustc-dev-guide
...
> cd rustc-dev-guide
> mdbook build --open
2025-01-10 23:07:31 [INFO] (mdbook::book): Book building has started
2025-01-10 23:07:32 [INFO] (mdbook::book): Running the html backend
2025-01-10 23:07:34 [INFO] (mdbook::book): Running the linkcheck backend
2025-01-10 23:07:34 [INFO] (mdbook::renderer): Invoking the "linkcheck" renderer
2025-01-10 23:07:34 [ERROR] (mdbook::utils): Error: Rendering failed
2025-01-10 23:07:34 [ERROR] (mdbook::utils): Caused By: Unable to start the backend
2025-01-10 23:07:34 [ERROR] (mdbook::utils): Caused By: %1 Not a valid Win32 application. (os error 193)
Book build failure!
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing mdbook build --open on Windows and inspect the html and linkcheck backend invocation shown in the build log. Determine why the linkcheck backend cannot start there; the issue is done when the book builds successfully on Windows without the Win32 application error.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- build-system, documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100