Skip to content

Commit 98afeb8

Browse files
committed
fix text describing edition range testing
1 parent 73c8bfa commit 98afeb8

File tree

1 file changed

+8
-3
lines changed

1 file changed

+8
-3
lines changed

src/doc/rustc-dev-guide/src/tests/directives.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -264,11 +264,16 @@ Consider writing the test as a proper incremental test instead.
264264

265265
#### The edition directive
266266

267-
The `//@ edition` directive can take an exact edition, a bounded half-open range of editions or a left-bounded half-open range of editions, this affects which edition is used by `./x test` to run the test. For example:
267+
The `//@ edition` directive can take an exact edition, a bounded range of editions, or a left-bounded half-open range of editions.
268+
This affects which edition is used by `./x test` to run the test.
269+
270+
For example:
268271

269272
- A test with the `//@ edition: 2018` directive will only run under the 2018 edition.
270-
- A test with the `//@ edition: 2015..2021` directive can be run under both the 2015 and 2018 editions. However, CI will only run the test with the lowest edition possible (2015 in this case).
271-
- A test with the `//@ edition: 2018..` directive will run under any edition greater or equal than 2018. However, CI will only run the test with the lowest edition possible (2018 in this case).
273+
- A test with the `//@ edition: 2015..2021` directive can be run under the 2015, 2018, and 2021 editions.
274+
However, CI will only run the test with the lowest edition in the range (which is 2015 in this example).
275+
- A test with the `//@ edition: 2018..` directive will run under 2018 edition or greater.
276+
However, CI will only run the test with the lowest edition in the range (which is 2018 in this example).
272277

273278
You can also force `./x test` to use a specific edition by passing the `-- --edition=` argument. However, tests with the `//@ edition` directive will clamp the value passed to the argument. For example, if we run `./x test -- --edition=2015`:
274279

0 commit comments

Comments
 (0)