Skip to content

Commit 78dd6a4

Browse files
authored
Reorganize and expand the testing chapters. (rust-lang#1281)
* Reorganize and expand the testing chapters. * Update tests chapters for review comments. * Fix typo.
1 parent 4d46bd0 commit 78dd6a4

14 files changed

+2055
-1100
lines changed

book.toml

+3
Original file line numberDiff line numberDiff line change
@@ -24,3 +24,6 @@ follow-web-links = true
2424
exclude = [ "crates\\.io", "gcc\\.godbolt\\.org", "youtube\\.com", "youtu\\.be", "dl\\.acm\\.org", "cs\\.bgu\\.ac\\.il", "www\\.amazon\\.com", "www\\.rustaceans\\.org", "play\\.rust-lang\\.org" ]
2525
cache-timeout = 86400
2626
warning-policy = "error"
27+
28+
[output.html.redirect]
29+
"/compiletest.html" = "tests/compiletest.html"

src/SUMMARY.md

+8-2
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,16 @@
1515
- [Documenting Compiler](./building/compiler-documenting.md)
1616
- [Rustdoc overview](./rustdoc.md)
1717
- [Adding a new target](./building/new-target.md)
18-
- [The compiler testing framework](./tests/intro.md)
18+
- [Testing the compiler](./tests/intro.md)
1919
- [Running tests](./tests/running.md)
20+
- [Testing with Docker](./tests/docker.md)
21+
- [Testing with CI](./tests/ci.md)
2022
- [Adding new tests](./tests/adding.md)
21-
- [Using `compiletest` commands to control test execution](./compiletest.md)
23+
- [Compiletest](./tests/compiletest.md)
24+
- [UI tests](./tests/ui.md)
25+
- [Test headers](./tests/headers.md)
26+
- [Performance testing](./tests/perf.md)
27+
- [Crater](./tests/crater.md)
2228
- [Debugging the Compiler](./compiler-debugging.md)
2329
- [Using the tracing/logging instrumentation](./tracing.md)
2430
- [Profiling the compiler](./profiling.md)

src/compiletest.md

-223
This file was deleted.

src/profiling.md

+2-5
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,8 @@ This section talks about how to profile the compiler and find out where it spend
44

55
Depending on what you're trying to measure, there are several different approaches:
66

7-
- If you want to see if a PR improves or regresses compiler performance:
8-
- The [rustc-perf](https://github.com/rust-lang/rustc-perf) project makes this easy and can be triggered to run on a PR via the `@rust-timer` bot.
9-
The `@bors try @rust-timer queue` command, in a comment on the PR, will queue a try build and a
10-
benchmarking run.
11-
Note: you need `try` privileges to be able to do this. More details are available in the [perf collector documentation](https://github.com/rust-lang/rustc-perf/blob/master/collector/README.md).
7+
- If you want to see if a PR improves or regresses compiler performance,
8+
see the [rustc-perf chapter](tests/perf.md) for requesting a benchmarking run.
129

1310
- If you want a medium-to-high level overview of where `rustc` is spending its time:
1411
- The `-Z self-profile` flag and [measureme](https://github.com/rust-lang/measureme) tools offer a query-based approach to profiling.

0 commit comments

Comments
 (0)