Skip to content

Update parallel compilation status for August 2026 - #2950

Draft
eeminionn wants to merge 1 commit into
rust-lang:mainfrom
eeminionn:agent/update-parallel-rustc-status
Draft

Update parallel compilation status for August 2026#2950
eeminionn wants to merge 1 commit into
rust-lang:mainfrom
eeminionn:agent/update-parallel-rustc-status

Conversation

@eeminionn

@eeminionn eeminionn commented Aug 2, 2026

Copy link
Copy Markdown

What changed

I went through the four date markers in src/parallel-rustc.md and checked the surrounding text against the current compiler source instead of only changing the month.

This updates the markers to August 2026 and also:

  • documents the current --jobs* options and the one-job front-end default;
  • replaces the removed parallel-compiler split with the current runtime synchronization behavior;
  • updates WorkerLocal, the parallel helper names, and representative call sites;
  • points from the completed query-parallelization tracker to the active parallel front-end tracker; and
  • records that rustdoc HTML rendering is still serial.

Why

Several claims around the dates had fallen behind the implementation. In particular, -Z threads now directs users to --jobs-frontend, par_iter is no longer exported, the HIR helper names changed, and the old query-parallelization tracker was completed in June 2026. Updating only the dates would have made the page look freshly verified while leaving those details wrong.

The result should give compiler contributors current flags and source names while keeping the existing warning that this area is still evolving.

Verification

This addresses the four src/parallel-rustc.md entries in #2948.

@jyn514, I rewrote the description in my own words and included the checks I used for each dated claim. Thanks again for pointing out that the verification needed to be explicit.

@jyn514 jyn514 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@eeminionn thank you for writing the description in your own words, this is a lot better now! i do want to note that we try to discourage LLM-generated documentation — i've read through it and in practice i think it's fine, but please write documentation in your own words going forwards.

View changes since this review

Comment thread src/parallel-rustc.md
Comment on lines +12 to +14
the generation of backend IR. It uses one job by default; `-j`/`--jobs` or
`--jobs-frontend` can be used to request more. See the
[compiler job options][compiler-job-options] for details.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could you note that these flags (and the ones below) are unstable?

Comment thread src/parallel-rustc.md
Comment on lines +49 to +50
The compiler no longer has separate `parallel-compiler` and non-parallel build
configurations. Instead, `Lock<T>` selects its synchronization mode at runtime.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please write this in terms of how things work now, not compared to how they used to be.

Comment thread src/parallel-rustc.md
As of <!-- date-check --> August 2026, the parallel front-end remains under
active development, so implementation details on this page may change.

Tracking issue: <https://github.com/rust-lang/rust/issues/113349>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could you change this to reuse the new [tracking] link you added?

@rustbot rustbot added the S-waiting-on-author Status: this PR is waiting for additional action by the OP label Aug 2, 2026
@rustbot

rustbot commented Aug 2, 2026

Copy link
Copy Markdown
Collaborator

Reminder, once the PR becomes ready for a review, use @rustbot ready.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

S-waiting-on-author Status: this PR is waiting for additional action by the OP

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants