1 Building the "langtools" workspace.

     2 

     3 The "langtools" workspace can be built from the command line with Ant.

     4 The build file is make/build.xml, in conjunction with make/build.properties.

     5 Some additional user-specific properties files are also read, to allow

     6 you to customize selected properties as needed.

     7 

     8 Individual tools within the workspace can also be built and worked on

     9 with NetBeans, using the projects in the make/netbeans directory.

    10 

    11 The "langtools" workspace can also be built from the command line with

    12 GNU Make, although the Makefile is simply a wrapper around the Ant

    13 build file. This is provided for systems (such as the full OpenJDK build)

    14 that expect to be able to build this workspace with GNU Make.

    15 

    16 System Requirements:

    17   Ant:      version 1.6.5 or later

    18   NetBeans: version 5.0 or later (optional)

    19   JDK:      currently version 1.5.0, although 1.6.0 is recommended

    20   OS:       any system supporting the above tools

    21 

    22 For more information:

    23   Ant:      http://ant.apache.org/

    24   GNU Make: http://www.gnu.org/software/make/

    25   NetBeans: http://www.netbeans.org/

    26 

    27 

    28 Testing the "langtools" workspace.

    29 

    30 The primary set of tests for the compiler is the compiler TCK. This

    31 tests that the compiler performs according to the specifications in

    32 JLS and JVMS.

    33 

    34 In addition, there is a substantial collection of regression and unit

    35 tests for all the tools in the maain langtools test/ directory.

    36 

    37 Finally, there is a small set of tests to do basic validation of a build

    38 of the langtools workspace for use by JDK. These tests check the contents

    39 of the dist/ directory generated by the build, and verify that the various

    40 tools can do basic "Hello World"-style processing. These tests should be

    41 run by jtreg, with the -jdk option set a version of JDK capable of running

    42 the default output of the javac compiler in this workspace. Currently, 

    43 this means JDK 6 or better.