duke@1: Building the "langtools" workspace.
duke@1: 
duke@1: The "langtools" workspace can be built from the command line with Ant.
duke@1: The build file is make/build.xml, in conjunction with make/build.properties.
duke@1: Some additional user-specific properties files are also read, to allow
duke@1: you to customize selected properties as needed.
duke@1: 
duke@1: Individual tools within the workspace can also be built and worked on
duke@1: with NetBeans, using the projects in the make/netbeans directory.
duke@1: 
duke@1: The "langtools" workspace can also be built from the command line with
duke@1: GNU Make, although the Makefile is simply a wrapper around the Ant
duke@1: build file. This is provided for systems (such as the full OpenJDK build)
duke@1: that expect to be able to build this workspace with GNU Make.
duke@1: 
duke@1: System Requirements:
duke@1:   Ant:      version 1.6.5 or later
ohair@277:   NetBeans: version 6.0 or later (optional)
duke@1:   JDK:      currently version 1.5.0, although 1.6.0 is recommended
duke@1:   OS:       any system supporting the above tools
duke@1: 
duke@1: For more information:
duke@1:   Ant:      http://ant.apache.org/
duke@1:   GNU Make: http://www.gnu.org/software/make/
duke@1:   NetBeans: http://www.netbeans.org/
duke@1: 
duke@1: 
duke@1: Testing the "langtools" workspace.
duke@1: 
duke@1: The primary set of tests for the compiler is the compiler TCK. This
duke@1: tests that the compiler performs according to the specifications in
duke@1: JLS and JVMS.
duke@1: 
duke@1: In addition, there is a substantial collection of regression and unit
emc@2017: tests for all the tools in the main langtools test/ directory.
duke@1: 
duke@1: Finally, there is a small set of tests to do basic validation of a build
duke@1: of the langtools workspace for use by JDK. These tests check the contents
duke@1: of the dist/ directory generated by the build, and verify that the various
duke@1: tools can do basic "Hello World"-style processing. These tests should be
duke@1: run by jtreg, with the -jdk option set a version of JDK capable of running
duke@1: the default output of the javac compiler in this workspace. Currently, 
duke@1: this means JDK 6 or better.