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

[Jonathan Gibbons]

Volker,

I have incorporated your suggestions into the main build.html.
Thank you for taking the trouble to contribute a very specific
set of suggestions and improvements.

-- Jon


On 12/10/2013 08:22 AM, Jonathan Gibbons wrote:
> Volker,
>
> Thank you for your suggestions. I will work on incorporating them
> into the main build.html file.
>
> -- Jon
>
> On 12/10/2013 02:12 AM, Volker Simonis wrote:
>> 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
>