JAL-3562 exclude testNG groups from a build via -PtestngExcludedGroups=Not-bamboo

[jalview.git] / doc / building.md

diff --git a/doc/building.md b/doc/building.md
index 33e1fec..0f5ea4c 100644 (file)
--- a/doc/building.md
+++ b/doc/building.md
@@ -333,7 +333,17 @@ You can run different defined groups of tests with
 gradle test -PtestngGroups=Network
 ```
 
-Available groups are Functional (default), Network, External.
+Available groups include Functional (default), Network, External. 
+
+#### Excluding some tests
+
+Some of Jalview's Functional tests don't pass reliably in all environments. We tag these tests with a group like 'Not-bamboo' to mark them for exclusion when we run tests as part of continuous integration.
+
+To exclude one or more groups of tests, add them as a comma separated list in testngExcludedGroups.
+
+```bash
+gradle test -PtestngExcludedGroups=Not-bamboo
+```
 
 
 ### Installer packaging with *install4j*