Skip to content

Commit bdc634e

Browse files
committed
Document that the default test run order is now random
1 parent 2a8a8a7 commit bdc634e

File tree

1 file changed

+9
-3
lines changed

1 file changed

+9
-3
lines changed

docs/command-line.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -398,18 +398,24 @@ use test specs to filter this list down to what you want first.
398398
Test cases are ordered one of three ways:
399399

400400
### decl
401-
Declaration order (this is the default order if no --order argument is provided).
401+
Declaration order.
402+
402403
Tests in the same translation unit are sorted using their declaration orders,
403404
different TUs are sorted in an implementation (linking) dependent order.
404405

405406

406407
### lex
407-
Lexicographic order. Tests are sorted by their name, their tags are ignored.
408+
Lexicographic order.
409+
410+
Tests are sorted by their name, their tags are ignored.
408411

409412

410413
### rand
414+
Randomized order. The default order.
415+
416+
> Randomized order has been made default in Catch2 X.Y.Z
411417
412-
Randomly ordered. The order is dependent on Catch2's random seed (see
418+
The order is dependent on Catch2's random seed (see
413419
[`--rng-seed`](#rng-seed)), and is subset invariant. What this means
414420
is that as long as the random seed is fixed, running only some tests
415421
(e.g. via tag) does not change their relative order.

0 commit comments

Comments
 (0)