X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=doc%2Fbuilding.md;fp=doc%2Fbuilding.md;h=81700ac30600816de27e45235200cc3daee92ee8;hb=c8d80485038ab96fb06bd0885c323803646d8e57;hp=34d5d67f672a370a4f86b130e607beca872d9c13;hpb=1b1f995b3eb83dc3496510bfc2278f1f72fcfd8a;p=jalview.git

diff --git a/doc/building.md b/doc/building.md
index 34d5d67..81700ac 100644
--- a/doc/building.md
+++ b/doc/building.md
@@ -5,9 +5,9 @@
 ```
 # download
 git clone http://source.jalview.org/git/jalview.git
-# compile
+# compile - needs java 11 JDK
 cd ./jalview
-gradle shadowJar
+gradle shadowJar  # needs to be gradle 7.6.3 or above (but not gradle 8)
 # run
 java -jar build/libs/jalview-all-*-j11.jar
 
@@ -23,10 +23,10 @@ java -jar getdown-launcher.jar . jalview
 
 > To get set up using _only_ the Eclipse IDE (<https://www.eclipse.org/>) then please see the section [Setting up in Eclipse IDE](#setting-up-in-eclipse-ide) 
 
-The method here is described in terms of using a command line.  You can easily do this on linux or in a Terminal window in macOS.  You can do it in Windows.
+The method here is described assumes using a command line.  You can easily do this on linux or in a Terminal window in macOS.  You can do it in Windows.
 
 * Java 11 compliant JDK
-* gradle 5.2 or above *(NB gradle 6.6 and above currently produces NullPointerExceptions during the build. This is non-fatal and does not affect the build. Use gradle 6.5.1 to avoid this)*
+* gradle 7.6.3 or above, but not gradle 8 
 * git
 
 > The versions and installation methods here are just suggestions (which we have tested 
@@ -336,7 +336,7 @@ the `tests/` folder.  A summary of results should appear in your console.
 You can run different defined groups of tests with
 
 ```bash
-gradle test -PtestngGroups=Network
+gradle test -Ptestng_groups=Network
 ```
 
 Available groups include Functional (default), Network, External. 
@@ -348,9 +348,15 @@ Some of Jalview's Functional tests don't pass reliably in all environments. We t
 To exclude one or more groups of tests, add them as a comma separated list in testngExcludedGroups.
 
 ```bash
-gradle test -PtestngExcludedGroups=Not-bamboo
+gradle test -Ptestng_excluded_groups=Not-bamboo
 ```
+#### Viewing stdout and stderr for tests
+
+By default, gradle doesn't report any of the output or error streams produced by tests. You can enable output by setting the following:
 
+```bash
+gradle test -Ptest_output=1
+```
 
 ### Installer packaging with *install4j*