Skip to content

Commit d53301b

Browse files
Rollup merge of #143630 - jieyouxu:drop-suggest, r=Mark-Simulacrum
Drop `./x suggest` This PR removes the current `./x suggest` implementation (rust-lang/rust#109933, rust-lang/rust#106249) and associated docs for several reasons: 1. Primarily, `./x suggest` is another "flow" in bootstrap that incurs extra complexity and more invariants that bootstrap has to maintain. This causes more friction when trying to investigate and fix staging problems. As far as I know, this flow has not been actively maintained in quite a while, and I'm not aware of interest in maintaining it. Bootstrap really could use less implementation complexity with a very limited maintenance bandwidth. 2. The current `./x suggest` implementation "bypasses" the usual stage defaults for the various check/build/test/etc. flows, and it's not really possible to have a stage default because `./x suggest --run` produces a *sequence* of suggestions like [`./x check`, `./x test library/std`, ..] and then tries to run all of them in sequence, based on which files are modified. 3. We've not seen a lot of interest both in using it or extending static/dynamic test suggestions. Last extensions were rust-lang/rust#117961 and rust-lang/rust#120763. I'm not convinced the extra implementation complexity is worth it. This was discussed in: - [#t-infra/bootstrap > Dropping the current `./x suggest` flow implementation](https://rust-lang.zulipchat.com/#narrow/channel/326414-t-infra.2Fbootstrap/topic/Dropping.20the.20current.20.60.2E.2Fx.20suggest.60.20flow.20implementation/with/527456699) - [#t-compiler > Dropping current `./x suggest` implementation](https://rust-lang.zulipchat.com/#narrow/channel/131828-t-compiler/topic/Dropping.20current.20.60.2E.2Fx.20suggest.60.20implementation/with/527528696) Closes rust-lang/rust#109933 (the current implementation is being removed). Closes rust-lang/rust#143569 (by removing `./x suggest` altogether).
2 parents c786ff0 + 2b862a0 commit d53301b

File tree

4 files changed

+0
-80
lines changed

4 files changed

+0
-80
lines changed

src/SUMMARY.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,6 @@
3535
- [Cranelift codegen backend](./tests/codegen-backend-tests/cg_clif.md)
3636
- [GCC codegen backend](./tests/codegen-backend-tests/cg_gcc.md)
3737
- [Performance testing](./tests/perf.md)
38-
- [Suggest tests tool](./tests/suggest-tests.md)
3938
- [Misc info](./tests/misc.md)
4039
- [Debugging the compiler](./compiler-debugging.md)
4140
- [Using the tracing/logging instrumentation](./tracing.md)

src/building/quickstart.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -61,9 +61,6 @@ and check the output.
6161
Use `--bless` if you've made a change and want to update the `.stderr` files
6262
with the new output.
6363

64-
> `./x suggest` can also be helpful for suggesting which tests to run after a
65-
> change.
66-
6764
Congrats, you are now ready to make a change to the compiler! If you have more
6865
questions, [the full chapter](./how-to-build-and-run.md) might contain the
6966
answers, and if it doesn't, feel free to ask for help on

src/building/suggested.md

Lines changed: 0 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -270,23 +270,6 @@ run the tests at some later time. You can then use `git bisect` to track down
270270
is that you are left with a fairly fine-grained set of commits at the end, all
271271
of which build and pass tests. This often helps reviewing.
272272

273-
## `x suggest`
274-
275-
The `x suggest` subcommand suggests (and runs) a subset of the extensive
276-
`rust-lang/rust` tests based on files you have changed. This is especially
277-
useful for new contributors who have not mastered the arcane `x` flags yet and
278-
more experienced contributors as a shorthand for reducing mental effort. In all
279-
cases it is useful not to run the full tests (which can take on the order of
280-
tens of minutes) and just run a subset which are relevant to your changes. For
281-
example, running `tidy` and `linkchecker` is useful when editing Markdown files,
282-
whereas UI tests are much less likely to be helpful. While `x suggest` is a
283-
useful tool, it does not guarantee perfect coverage (just as PR CI isn't a
284-
substitute for bors). See the [dedicated chapter](../tests/suggest-tests.md) for
285-
more information and contribution instructions.
286-
287-
Please note that `x suggest` is in a beta state currently and the tests that it
288-
will suggest are limited.
289-
290273
## Configuring `rustup` to use nightly
291274

292275
Some parts of the bootstrap process uses pinned, nightly versions of tools like

src/tests/suggest-tests.md

Lines changed: 0 additions & 59 deletions
This file was deleted.

0 commit comments

Comments
 (0)