about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide/src/building
AgeCommit message (Collapse)AuthorLines
2025-09-22reduce overlong linesTshepang Mbambo-3/+8
2025-09-08Fix broken Microsoft URL missing slashAli Nazzal-1/+1
2025-09-08readabilityTshepang Mbambo-1/+1
2025-09-08fix markupTshepang Mbambo-0/+3
2025-09-08sembrTshepang Mbambo-5/+11
2025-09-03Rename `ToolRustc` to `ToolRustcPrivate`Jakub Beránek-5/+2
2025-08-25Merge ref 'a1dbb443527b' from rust-lang/rustThe rustc-josh-sync Cronjob Bot-3/+5
Pull recent changes from https://github.com/rust-lang/rust via Josh. Upstream ref: a1dbb443527bd126452875eb5d5860c1d001d761 Filtered ref: c2339048a82c55166f9b9ee83fd618be252a6e23 This merge was created using https://github.com/rust-lang/josh-sync.
2025-08-20Merge pull request #2546 from lolbinarycat/patch-7nora-3/+3
Update bootstrapping docs to account for new stage meanings
2025-08-18Trace some basic I/O operations in bootstrapJakub Beránek-3/+5
2025-08-14Rollup merge of #145261 - Kobzol:bootstrap-tracing, r=jieyouxuJakub Beránek-99/+49
Improve tracing in bootstrap I was annoyed that bootstrap had like 5 separate ways of debugging/tracing/profiling, and it was hard for me to understand how are individual steps executed. This PR tries to unify severla things behind `BOOTSTRAP_TRACING`, and improve tracing/profiling in general: - All generated tracing outputs are now stored in a single directory to make it easier to examine them, plus bootstrap prepares a `latest` symlink to the latest generated tracing output directory for convenience. - All executed spans are now logged automatically (without requiring usage of `#[tracing::instrument]`). - A custom span/event formatter was implemented, to provide domain-specific output (like location of executed commands or spans) and hopefully also to reduce visual clutter. - `tracing_forest` was removed. While it did some useful postprocessing, it didn't expose enough information for making the dynamic step spans work. - You can now explicitly log steps (`STEP=info`) and/or commands (`COMMAND=info`), to have more granular control over what gets logged. - `print-step-timings` also show when a step starts its execution (not just when it ends it), so that when some step fails in CI, we can actually see what step it was (before we would only see the end of the previous step). - The rustc-dev-guide page on debugging/profiling bootstrap was updated. There are still some things that work outside of tracing (`print-step-timings` and `dump-bootstrap-shims`), but I think that for now this improvement is good enough. I removed the `> step`, `< step` verbose output, because I found it unusable, as verbose bootstrap output also enables verbose Cargo output, and then you simply drown in too much data, and because I think that the new tracing system makes it obsolete (although it does require recompilation with the `tracing` feature). If you want to keep it, happy to revert 690c781475acb890f33d928186bdaea9ef179330. And the information about cached steps is now also shown in the Graphviz step dependency graph. We can modify the tracing output however we want, as we now implement it ourselves. Notably, we could also show exit logs for step spans, currently I only show enter spans. Maybe creating indents for each executed nested command is also not needed. Happy to hear feedback! Some further improvements could be to print step durations, if we decide to also log step exit events. We could also try to enable tracing in CI logs, but it might be too verbose. Best reviewed commit-by-commit. r? ``@jieyouxu`` CC ``@Shourya742``
2025-08-12Replace `stage0-tools-bin` with `stage1-tools-bin`Jakub Beránek-1/+1
2025-08-11Update bootstrapping docs to account for new stage meaningslolbinarycat-3/+3
see https://github.com/rust-lang/rust/pull/145253 for reference.
2025-08-11Update debugging/profiling bootstrap pageJakub Beránek-99/+49
2025-08-05Rollup merge of #144905 - tshepang:rdg-sync, r=jieyouxuSamuel Tardieu-10/+0
rustc-dev-guide subtree update Subtree update of `rustc-dev-guide` to https://github.com/rust-lang/rustc-dev-guide/commit/1263fc23672325c1d2e3d6bba8a7dd89e986245c. Created using https://github.com/rust-lang/josh-sync. r? ``@ghost``
2025-08-04Implement debugging output of the bootstrap Step graph into a DOT fileJakub Beránek-0/+6
2025-07-28remove the markersTshepang Mbambo-10/+0
2025-07-21fix some typosTshepang Mbambo-1/+1
2025-07-15Remove mentions of `./x suggest` and `suggest-tests` in rustc-dev-guideJieyou Xu-20/+0
2025-07-10update rust-dev-guide to point about new command execution summary report ↵bit-aloo-2/+9
under bootstrap profiling section
2025-06-29Add broken `./x test library/std` advisoryJieyou Xu-0/+18
2025-06-19Merge from rustcThe rustc-dev-guide Cronjob Bot-1/+1
2025-06-19fix markupTshepang Mbambo-2/+2
That was intended to be a list. Also, the order is not relevant.
2025-06-18Fix compiletest and rustc-dev-guideJakub Beránek-1/+1
2025-06-09Merge from rustcThe rustc-dev-guide Cronjob Bot-0/+8
2025-06-04document `skip-std-check-if-no-download-rustc` in rustc-dev-guideonur-ozkan-0/+8
Signed-off-by: onur-ozkan <work@onurozkan.dev>
2025-06-04Fix incorrect use of "recommend" over "recommended"Rageking8-1/+1
2025-06-02Rollup merge of #141894 - tshepang:rdg-push, r=jieyouxuYukang-6/+3
rustc-dev-guide subtree update r? `@ghost`
2025-05-31Merge pull request #2432 from rust-lang/tshepang-patch-1nora-5/+2
suggest build/rust-analyzer instead of build-rust-analyzer
2025-05-31replace a broken sentenceTshepang Mbambo-1/+1
2025-05-31suggest build/rust-analyzer instead of build-rust-analyzerTshepang Mbambo-5/+2
This is better because - `./x clean` also removes it, without needing extra text to explain it - Does not need an extra .gitignore entry
2025-05-30improve comments and docsonur-ozkan-59/+21
Signed-off-by: onur-ozkan <work@onurozkan.dev>
2025-05-30update dev guidelinesonur-ozkan-60/+40
Signed-off-by: onur-ozkan <work@onurozkan.dev>
2025-05-01adds commasMartin Ombura Jr.-2/+2
2025-05-01adds 'with' to help clarify how to build a new compilerMartin Ombura Jr.-2/+2
2025-04-25typoTshepang Mbambo-2/+2
2025-04-20Rollup merge of #140044 - tshepang:rdg-push, r=jieyouxuChris Denton-1/+54
rustc-dev-guide subtree update r? ``@ghost``
2025-04-19Merge pull request #2346 from folkertdev/bootstrap-in-dependencies许杰友 Jieyou Xu (Joe)-0/+53
2025-04-19document `#[cfg(bootstrap)]` in dependenciesFolkert de Vries-0/+53
2025-04-19Merge from rustcThe rustc-dev-guide Cronjob Bot-2/+7
2025-04-15document `include` in `bootstrap.example.toml`onur-ozkan-2/+3
Signed-off-by: onur-ozkan <work@onurozkan.dev>
2025-04-15document config extensionsonur-ozkan-0/+36
Signed-off-by: onur-ozkan <work@onurozkan.dev>
2025-04-12use consistent title capitalizationTshepang Mbambo-1/+1
2025-04-11Document that `opt-dist` requires metrics to be enabledJakub Beránek-2/+7
2025-03-30Fix partial clone linkclubby789-1/+1
2025-03-23doc: fix reference to #create-a-configtomlChiichen-1/+1
2025-03-18Merge from rustcJieyou Xu-23/+23
2025-03-17replace config.toml to bootstrap.toml in src:doc:rustc-dev-guidebit-aloo-23/+23
2025-03-16expand ${workspaceFolder} in sample vim configjyn-1/+25
2025-03-13Merge from rustc许杰友 Jieyou Xu (Joe)-1/+1
2025-03-13less text for same effectTshepang Mbambo-3/+2