Commit f4b5a6c0 authored by Alp Mestanogullari's avatar Alp Mestanogullari Committed by Marge Bot

Hadrian: document -a/--test-accept

parent 3c759ced
......@@ -123,6 +123,8 @@ time you fire up a build. This is not possible with the Make build system.
make test # (1)
make test TEST=plugins01 # (2)
make test TEST="plugins01 plugins02" # (3)
make accept # (4)
PLATFORM=YES OS=YES make accept # (5)
# Hadrian
......@@ -134,6 +136,12 @@ time you fire up a build. This is not possible with the Make build system.
build test --only="plugins01 plugins02" # equivalent to (3)
TEST="plugins01 plugins02" build test # equivalent to (3)
TEST=plugins01 build test --only=plugins02 # equivalent to (3)
build test -a # equivalent to (4)
build test --test-accept # equivalent to (4)
PLATFORM=YES OS=YES build test -a # equivalent to (5)
PLATFORM=YES OS=YES build test --test-accept # equivalent to (5)
```
As illustrated in the examples above, you can use the `TEST` environment
......
......@@ -40,6 +40,31 @@ TEST="test1 test2" build test
TEST="test1 test2" build test --only="test3 test4"
```
## Accepting new output
You can use the `-a` or `--test-accept` flag to "accept" the new
output of your tests. This has the effect of updating the expected
output of all the tests that fail due to mismatching output, so as to
consider the new output the correct one.
When the `PLATFORM` environment variable is set to `YES`, passing this flag has
the effect of accepting the new output for the current platform.
When the `OS` environment variable is set to `YES`, passing this flag has the
effect of accepting the new output for all word sizes on the current OS.
``` sh
# accept new output for all tests
build test -a
# just run and accept new output for 'test123' and 'test456'
build test -a --only="test123 test456"
# accept new output for current platform and all word sizes for
# the current OS, for all tests
PLATFORM=YES OS=YES build test -a
```
## Performance tests
You can use the `--only-perf` and `--skip-perf` flags to
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment