doc/testing.md

@@ -23,10 +23,11 @@
     $ make test-jdk_lang JTREG="JOBS=8"
     $ make test TEST=jdk_lang
     $ make test-only TEST="gtest:LogTagSet gtest:LogTagSetDescriptions" GTEST="REPEAT=-1"
     $ make test TEST="hotspot:hotspot_gc" JTREG="JOBS=1;TIMEOUT=8;VM_OPTIONS=-XshowSettings -Xlog:gc+ref=debug"
     $ make test TEST="jtreg:test/hotspot:hotspot_gc test/hotspot/jtreg/native_sanity/JniVersion.java"
+    $ make test TEST="jtreg:test/hotspot/jtreg/runtime/containers/docker" JTREG="JAVA_OPTIONS=-Djdk.test.docker.image.name=ubuntu -Djdk.test.docker.image.version=latest"
     $ make test TEST="micro:java.lang.reflect" MICRO="FORK=1;WARMUP_ITER=2"
     $ make exploded-test TEST=tier2
 
 ### Configuration
 

@@ -313,10 +314,15 @@
 Use `JTREG="OPTIONS=--help all"` to see all available JTReg options.
 
 #### JAVA_OPTIONS
 Additional Java options to JTReg (`-javaoption`).
 
+This is useful for tests which may require additional parameters on specific platforms.
+For example, `make test TEST="jtreg:test/hotspot/jtreg/runtime/containers/docker"`
+passed on Ubuntu 16.04 but failed on Ubuntu 18.04. To run these tests correctly, the
+correct docker image parameters are required on Ubuntu 18.04 by using `JAVA_OPTIONS`.
+
 #### VM_OPTIONS
 Additional VM options to JTReg (`-vmoption`).
 
 #### AOT_MODULES