diff options
author | Jussi Pakkanen <jpakkane@gmail.com> | 2021-01-30 09:52:43 +0000 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-01-30 09:52:43 +0000 |
commit | f0fbb31ccfa78ca1d7b7f9cedfbb090bf36d3e64 (patch) | |
tree | bb4a528ba77676a90fe8e57fd0a736adf3dbe8f5 /docs | |
parent | 0626465ea8aa65b10776d5c4064e881fe0d6fa25 (diff) | |
parent | ec02753fbf9c15389f953d9cfd040635f84779d9 (diff) | |
download | meson-f0fbb31ccfa78ca1d7b7f9cedfbb090bf36d3e64.zip meson-f0fbb31ccfa78ca1d7b7f9cedfbb090bf36d3e64.tar.gz meson-f0fbb31ccfa78ca1d7b7f9cedfbb090bf36d3e64.tar.bz2 |
Merge pull request #8200 from bonzini/mtest-asyncio-logs
mtest: improvements to logging
Diffstat (limited to 'docs')
-rw-r--r-- | docs/markdown/snippets/meson_test_logs.md | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/markdown/snippets/meson_test_logs.md b/docs/markdown/snippets/meson_test_logs.md new file mode 100644 index 0000000..b3f5a16 --- /dev/null +++ b/docs/markdown/snippets/meson_test_logs.md @@ -0,0 +1,29 @@ +## New logging format for `meson test` + +The console output format for `meson test` has changed in several ways. +The major changes are: + +* if stdout is a tty, `meson` includes a progress report. + +* if `--print-errorlogs` is specified, the logs are printed as test runs +rather than afterwards. All the error logs are printed rather than only +the first ten. + +* if `--verbose` is specified and `--num-processes` specifies more than +one concurrent test, test output is buffered and printed after the +test finishes + +* the console logs include a reproducer command. If `--verbose` is +specified, the command is printed for all tests at the time they starts; +otherwise, it is printed for failing tests at the time the test finishes + +* for TAP tests, Meson is able to report individual subtests. If +`--verbose` is specified, all tests are reported. If `--print-errorlogs` +is specified, only failures are. + +In addition, if `--verbose` was specified, Meson used not to generate +logs. This limitation has now been removed. + +These changes make the default `ninja test` output more readable, while +`--verbose` output is provides detailed but human-readable logs that +are well suited to CI environments. |