Documentation on how to run ghc tests is out of date and misleading to newcomers
Summary
-
On this page: https://gitlab.haskell.org/ghc/ghc/-/wikis/building/running-tests/running that describes how to run the testsuite it is stated that: "By default the testsuite uses the stage2 compiler." This is simply not true (at least it is not true if you build ghc with hadrian). In fact if you do nothing, the ghc version found in your path is used which is never what you want.
-
I have heard from developers that it is possible to run the testsuite via hadrian instead of make, but I have not found any documentation on how to do it. This page needs to be updated with that information.
-
Also having two ways to run the tests is strange. We should pick one and get rid of the other.