langtools/make/README
changeset 3033 005c4e992893
parent 3032 ffadbf4b17f6
parent 2902 dbb955b1ee59
child 3034 8dba826afc2c
equal deleted inserted replaced
3032:ffadbf4b17f6 3033:005c4e992893
     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 6.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.