Please update http://openjdk.java.net/jtreg/build.html

[Volker Simonis]

Hi,

yesterday I've build jtreg from source as described at:
http://openjdk.java.net/jtreg/build.html

While I succeed in the end, I found that some of the information on
that page could be improved to make the build process easier.
Following my proposals for updating the instructions:

JavaHelp

- add the follwing: "Unzip the javahelp zip file (e.g.
javahelp2_0_05.zip) and set JAVAHELP_HOME to point to the resulting
jh2.0/javahelp directory."

JT Harness

- add the following: "Notice that unpacking the jtharness harness will
not implicitly create a directory. It is advised to first explicitly
create a jtharness directory and unzip the jtharness archive therein.
JTHARNESS_HOME should point to that directory."

Xalan

- add the following after the link to Xalan: "Go to the
"Download/Build" section and follow the "xalan-j distribution
directory" link. From there choose "Xalan java download area" and
download "xalan-j_2_7_1-bin.zip" from the "binaries/" direcotry. Set
XALANHOME to the directory which will be created when you unzip the
xalan zip archive."

JUnit

- add the following: "Notice that only version smaller than 4.11 are
supported. JUnit 4.11 and above do not contain the required
org.hamcrest any more (they are now contained in their own jar file
hamcrest-core.jar but jtreg/jtharness isn’t currently prepared to
handle this). Set JUNIT_JAR to the junit jar file."

TestNG

- add the follwing: "For TestNG it is not enough to just download the
testng jar file. Instead you have to download the complete testng
archive from the link for ANT users in the download section. Unzip the
archive and set TESTNG_HOME to point to the created directory and
TESTNG_JAR to point to the testng jar file in that directory."

- Because JUnit and TestNG are required for running the jdk regression
test I'd suggest to move the JUnit and TestNG sections from the
optional to the required dependencies.

Ant

- I also found that I did need to have ANTHOME defined. Otherwise I
got build errors like:

../src/share/classes/com/sun/javatest/regtest/Main.java:61: package
org.apache.tools.ant does not exist
import org.apache.tools.ant.BuildException;

- so please move the "Ant" section from optional to the required
section and remove the sentence "It need not be set if you are just
building jtreg."

I havn't installed and used HTMLCheck/LinkLint but without these two,
a complete build command line may look as follows:

JDK15HOME=/share/software/Java/jdk1.6.0_26
JAVAHELP_HOME=/share/software/Java/JTREG_from_source/deps/jh2.0/javahelp
JTHARNESS_HOME=/share/software/Java/JTREG_from_source/deps/jtharness-4_4_1-MR1-bin-b13-20_dec_2011
XALANHOME=/share/software/Java/JTREG_from_source/deps/xalan-j_2_7_1
TESTNG_HOME=/share/software/Java/JTREG_from_source/deps/testng-6.8
JUNIT_JAR=/share/software/Java/JTREG_from_source/deps/junit-4.10.jar
TESTNG_JAR=/share/software/Java/JTREG_from_source/deps/testng-6.8/testng-6.8.jar
ANTHOME=/share/software/Java/JTREG_from_source/deps/apache-ant-1.9.2
make -C make

The resulting jtreg image can be found under build/images.

It may be good to add such a line as example on how to build JTreg.

Please feel free to correct and improve my proposal.

Regards,
Volker