README
1Building the "langtools" workspace.
2
3The "langtools" workspace can be built from the command line with Ant.
4The build file is make/build.xml, in conjunction with make/build.properties.
5Some additional user-specific properties files are also read, to allow
6you to customize selected properties as needed.
7
8Individual tools within the workspace can also be built and worked on
9with NetBeans, using the projects in the make/netbeans directory.
10
11The "langtools" workspace can also be built from the command line with
12GNU Make, although the Makefile is simply a wrapper around the Ant
13build file. This is provided for systems (such as the full OpenJDK build)
14that expect to be able to build this workspace with GNU Make.
15
16System 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
22For 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
28Testing the "langtools" workspace.
29
30The primary set of tests for the compiler is the compiler TCK. This
31tests that the compiler performs according to the specifications in
32JLS and JVMS.
33
34In addition, there is a substantial collection of regression and unit
35tests for all the tools in the main langtools test/ directory.
36
37Finally, there is a small set of tests to do basic validation of a build
38of the langtools workspace for use by JDK. These tests check the contents
39of the dist/ directory generated by the build, and verify that the various
40tools can do basic "Hello World"-style processing. These tests should be
41run by jtreg, with the -jdk option set a version of JDK capable of running
42the default output of the javac compiler in this workspace. Currently,
43this means JDK 6 or better.
44