improve suite of meson test (#3369)

2 files changed, 14 insertions, 0 deletions

diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md
index 0d3d1aa..da4c92b 100644
--- a/docs/markdown/Reference-manual.md
+++ b/docs/markdown/Reference-manual.md
@@ -1243,6 +1243,12 @@ Keyword arguments are the following:
 - `should_fail` when true the test is considered passed if the
   executable returns a non-zero return value (i.e. reports an error)
 
+- `suite` `'label'` (or list of labels `['label1', 'label2']`)
+  attached to this test. The suite name is qualified by a (sub)project
+  name resulting in `(sub)project_name:label`. In the case of a list
+  of strings, the suite names will be `(sub)project_name:label1`,
+  `(sub)project_name:label2`, etc.
+
 - `timeout` the amount of seconds the test is allowed to run, a test
   that exceeds its time limit is always considered failed, defaults to
   30 seconds
diff --git a/docs/markdown/Unit-tests.md b/docs/markdown/Unit-tests.md
index 53ce9ec..e5e4107 100644
--- a/docs/markdown/Unit-tests.md
+++ b/docs/markdown/Unit-tests.md
@@ -71,6 +71,14 @@ You can also run only a single test by giving its name:
 $ meson test testname
 ```
 
+Tests belonging to a suite `suite` can be run as follows
+
+```console
+$ meson test --suite (sub)project_name:suite
+```
+
+Since version *0.46*, `(sub)project_name` can be omitted if it is the top-level project.
+
 Sometimes you need to run the tests multiple times, which is done like this:
 
 ```console