Add 'log4j2' domain tests to the Log4j 2.x agent

[lttng-ust-java-tests.git] / README.md

diff --git a/README.md b/README.md
index 6d1f5fa785918628757e2c4f1e19c7ff6b411c8b..cf1c566693b8c8af35620ba31a9028c01de7c3a4 100644 (file)
--- a/README.md
+++ b/README.md
@@ -98,6 +98,20 @@ the first test set that is empty. See [2] for more info.
 [1] http://maven.apache.org/surefire/maven-failsafe-plugin/index.html
 [2] http://maven.apache.org/surefire/maven-failsafe-plugin/examples/single-test.html
 
+Running tests by tags
+---------------------
+
+Tests can also be filtered by Junit tags or tag expressions [1], for example to
+run only the Log4 1.x agent tests:
+
+    mvn clean verify -Dgroups='agent:log4j'
+
+Or to exclude the tests of the Log4j2 domain:
+
+   mvn clean verify -Dgroups='!domain:log4j2'
+
+[1] https://junit.org/junit5/docs/current/user-guide/#running-tests-tags
+
 Debugging a test
 ----------------------