1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/README Wed Apr 27 01:34:52 2016 +0800
1.3 @@ -0,0 +1,43 @@
1.4 +Building the "langtools" workspace.
1.5 +
1.6 +The "langtools" workspace can be built from the command line with Ant.
1.7 +The build file is make/build.xml, in conjunction with make/build.properties.
1.8 +Some additional user-specific properties files are also read, to allow
1.9 +you to customize selected properties as needed.
1.10 +
1.11 +Individual tools within the workspace can also be built and worked on
1.12 +with NetBeans, using the projects in the make/netbeans directory.
1.13 +
1.14 +The "langtools" workspace can also be built from the command line with
1.15 +GNU Make, although the Makefile is simply a wrapper around the Ant
1.16 +build file. This is provided for systems (such as the full OpenJDK build)
1.17 +that expect to be able to build this workspace with GNU Make.
1.18 +
1.19 +System Requirements:
1.20 + Ant: version 1.6.5 or later
1.21 + NetBeans: version 6.0 or later (optional)
1.22 + JDK: currently version 1.5.0, although 1.6.0 is recommended
1.23 + OS: any system supporting the above tools
1.24 +
1.25 +For more information:
1.26 + Ant: http://ant.apache.org/
1.27 + GNU Make: http://www.gnu.org/software/make/
1.28 + NetBeans: http://www.netbeans.org/
1.29 +
1.30 +
1.31 +Testing the "langtools" workspace.
1.32 +
1.33 +The primary set of tests for the compiler is the compiler TCK. This
1.34 +tests that the compiler performs according to the specifications in
1.35 +JLS and JVMS.
1.36 +
1.37 +In addition, there is a substantial collection of regression and unit
1.38 +tests for all the tools in the main langtools test/ directory.
1.39 +
1.40 +Finally, there is a small set of tests to do basic validation of a build
1.41 +of the langtools workspace for use by JDK. These tests check the contents
1.42 +of the dist/ directory generated by the build, and verify that the various
1.43 +tools can do basic "Hello World"-style processing. These tests should be
1.44 +run by jtreg, with the -jdk option set a version of JDK capable of running
1.45 +the default output of the javac compiler in this workspace. Currently,
1.46 +this means JDK 6 or better.
