feat: openjdk11 update INSTALL docs
@@ -23,23 +23,19 @@ TornadoVM has been succefully tested on the following platforms:
## Installation
### 1. Install GraalVM Community Edition 19.3.0
-TornadoVM is built by using GraalVM Community Edition 19.3.0. The directory which contains the Java binary is used the JAVA_HOME (Step 2).
+TornadoVM is built by using GraalVM Community Edition 19.3.0. The directory which contains the Java binary is used by the JAVA_HOME env variable (Step 2).
-### 1.1 Steps for a Linux-based OS
+GraalVM Community Edition 19.3.0 supports both JDK8 and JDK11. This means that Tornado is able to run on top of both versions.
-```bash
- $ wget https://github.com/graalvm/graalvm-ce-builds/releases/download/vm-19.3.0/graalvm-ce-java11-linux-amd64-19.3.0.tar.gz
- $ tar -xf graalvm-ce-java11-linux-amd64-19.3.0.tar.gz
-```
-
-### 1.2 Steps for Apple Mac OS X
+### 1.1 Download GraalVM Community Edition 19.3.0
+GraalVM 19.3.0 builds are available to download at ```https://github.com/graalvm/graalvm-ce-builds/releases```.
+You can then extract the ``gunzip file``.
```bash
- $ wget https://github.com/graalvm/graalvm-ce-builds/releases/download/vm-19.3.0/graalvm-ce-java11-darwin-amd64-19.3.0.tar.gz
- $ tar -xf graalvm-ce-java11-darwin-amd64-19.3.0.tar.gz
+ $ tar -xf graalvm-ce-java{JDK_VERSION}-{OS}-{ARCHITECTURE}-19.3.0.tar.gz
```
-The Java binary will be found in the `graalvm-ce-java11-19.3.0`. This directory is used as the JAVA_HOME (Step 2).
+The Java binary will be found in the `graalvm-ce-java{JDK_VERSION}-19.3.0`. This directory is used as the JAVA_HOME (Step 2).
### 2. Download TornadoVM
@@ -117,10 +113,18 @@ $ apt-get install ocl-icd-opencl-dev
## Running Examples
+**The examples and benchmarks of Tornado live in two different modules (`tornado.examples` and `tornado.benchmarks`). If using the JDK11 version of GraalVM 19.3.0, then you have to specify the module and package in a similar manner with `java`.**
+
```bash
$ tornado -m tornado.examples/uk.ac.manchester.tornado.examples.HelloWorld
```
+When using GraalVM with JDK8 it is enough to specify the package only.
+```bash
+$ tornado uk.ac.manchester.tornado.examples.HelloWorld
+```
+**For simplicity, we will only provide examples of running `tornado` with GraalVM on top of JDK11. It is straightforward to adapt the command line arguments to JDK8.**
+
Use the following command to identify the ids of the Tornado-compatible heterogeneous devices:
```bash
@@ -271,5 +275,3 @@ Notice that, for running with TornadoVM, you will need either the docker images
* 0.3
* 0.2
* 0.1.0
-
-
