From: Ben Soares <bsoares@dundee.ac.uk>
Date: Fri, 31 May 2019 12:22:25 +0000 (+0100)
Subject: JAL-3248 extra tl;dr
X-Git-Tag: Release_2_11_0~7^2~18
X-Git-Url: http://source.jalview.org/gitweb/?p=jalview.git;a=commitdiff_plain;h=e3c8595c4af05816fa7bf0859c052a97e3b875ea;hp=f7ee28904ba53bbc34858612a2598fbdf10b3049

JAL-3248 extra tl;dr
---

diff --git a/doc/building.md b/doc/building.md
index ae76ced..0453c23 100644
--- a/doc/building.md
+++ b/doc/building.md
@@ -5,12 +5,17 @@
 ```
 # download
 git clone http://source.jalview.org/git/jalview.git
-#compile
+# compile
 cd jalview
-gradle getdown
+gradle shadowJar
 # run
-cd getdown/files/11
-java -jar gradle-launcher.jar . jalview
+java -jar build/libs/jalview-all-11.jar
+
+# and/or create launcher
+gradle getdown
+# use launcher
+cd getdown/files
+java -jar getdown-launcher.jar . jalview
 ```
 
 
@@ -23,7 +28,7 @@ The method here is described in terms of using a command line.  You can easily d
 * git
 
 ### Java 11 JDK
-We recommend obtaining an OpenJDK JDK 11 from AdoptOpenJDK: <https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot>, either the *Installer* or `.zip`/`.tar.gz` variants whichever you prefer (if you're not sure, choose the *Installer*).
+We recommend obtaining an OpenJDK JDK 11 (since 11 is the long term support release) from AdoptOpenJDK: <https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot>, either the *Installer* or `.zip`/`.tar.gz` variants whichever you prefer (if you're not sure, choose the *Installer*).
 
 ### gradle and git
 You should be able to install the latest (or close to the latest) versions of gradle and git using your OS package manager.
@@ -55,7 +60,7 @@ run
 ```
 
 ##### for RPM-based distributions (e.g. Fedora, CentOS, RedHat)
-run (probably)
+run
 
 ```
 sudo yum install gradle git