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