summaryrefslogtreecommitdiffstats
path: root/jack-tests
diff options
context:
space:
mode:
authorJean-Marie Henaff <jmhenaff@google.com>2015-03-11 09:53:37 +0100
committerJean-Marie Henaff <jmhenaff@google.com>2015-03-11 09:53:37 +0100
commit2fcbacc3e316220bea6344b2cc54d95291576a78 (patch)
treea6cea3fa5e84eba64c3e76b6d8502138e2997984 /jack-tests
parent7e918723139b6d9fe18fb81b0557411e678a51e6 (diff)
downloadtoolchain_jack-2fcbacc3e316220bea6344b2cc54d95291576a78.zip
toolchain_jack-2fcbacc3e316220bea6344b2cc54d95291576a78.tar.gz
toolchain_jack-2fcbacc3e316220bea6344b2cc54d95291576a78.tar.bz2
Update tests README and configuration template file
Change-Id: I2a6c9667446dce284329de5de3b7d29804dfe7ca
Diffstat (limited to 'jack-tests')
-rw-r--r--jack-tests/README23
-rw-r--r--jack-tests/tests.properties.template2
2 files changed, 22 insertions, 3 deletions
diff --git a/jack-tests/README b/jack-tests/README
index 571f5bf..6b060fd 100644
--- a/jack-tests/README
+++ b/jack-tests/README
@@ -21,7 +21,17 @@ It can be passed by setting the property "tests.config" (with -D) with the path
To be able to use jack-tests to run the tests, the configuration file
must define following properties:
* jack.home: absolute path to Jack directory
- * runtime.location.<runtime environment name>: location of host android runtime environments
+ * candidate.toolchain: the toolchain to pass the tests on
+ * reference.toolchain: the toolchain to compare the candidate toolchain against
+ the available values for these toolchains are:
+ - jack-api-vXX: Jack is used through version XX of its api (example: jack-api-v01)
+ - jack-cli: Jack is used through its command line interface
+ - jill-legacy: sources are first compiled with the legacy compiler, then the result is passed to Jill to create a .jack library to be imported into Jack to produce the binary output
+ - legacy: full legacy toolchain. Usually this toolchain is used as reference.toolchain
+
+ * runtime.list: comma-separated list of runtime environment names
+ * runtime.location.<runtime environment name>: location of host android runtime environments. you
+ must specify those which are listed in runtime.list.
The following values are supported:
* runtime.location.dalvik-fast-host
@@ -35,4 +45,13 @@ In Eclipse: define a run configuration with -Dtests.config as a VM argument.
On the command line:
* use run-jack-tests script with the config file path as first parameter, and the test suite to
run as the second parameter
- * use Ant tasks (e.g. test-jack) to run common sets of tests.
+ * use Ant tasks to run common sets of tests.
+ test-jack : tests that must pass in order to submit a CL
+ test-jack-long : tests too long to be passed in the previous case
+ test-jack-all : all tests
+ test-sched : schedlib tests
+ Example:
+ ant -Dtests.config=/path/to/config test-jack
+
+These Ant tasks generate an HTML report in test-results/ by default. This value can be overridden by setting the jack.tests.output property:
+ ant -Dtests.config=/path/to/config -Djack.tests.output=/path/to/report/dir test-jack
diff --git a/jack-tests/tests.properties.template b/jack-tests/tests.properties.template
index 1c6bb25..af210e7 100644
--- a/jack-tests/tests.properties.template
+++ b/jack-tests/tests.properties.template
@@ -1,6 +1,6 @@
jack.home=
-# Toolchain names among legacy, jill-legacy, jack-api, jack-cli
+# Toolchain names among legacy, jill-legacy, jack-api-vXX, jack-cli
reference.toolchain=
candidate.toolchain=