README

Sat, 24 Oct 2020 16:44:00 +0800

author
aoqi
date
Sat, 24 Oct 2020 16:44:00 +0800
changeset 3932
b8a6df910f59
parent 2525
2eb010b6cb22
permissions
-rw-r--r--

Merge

aoqi@0 1 Building the "langtools" workspace.
aoqi@0 2
aoqi@0 3 The "langtools" workspace can be built from the command line with Ant.
aoqi@0 4 The build file is make/build.xml, in conjunction with make/build.properties.
aoqi@0 5 Some additional user-specific properties files are also read, to allow
aoqi@0 6 you to customize selected properties as needed.
aoqi@0 7
aoqi@0 8 Individual tools within the workspace can also be built and worked on
aoqi@0 9 with NetBeans, using the projects in the make/netbeans directory.
aoqi@0 10
aoqi@0 11 The "langtools" workspace can also be built from the command line with
aoqi@0 12 GNU Make, although the Makefile is simply a wrapper around the Ant
aoqi@0 13 build file. This is provided for systems (such as the full OpenJDK build)
aoqi@0 14 that expect to be able to build this workspace with GNU Make.
aoqi@0 15
aoqi@0 16 System Requirements:
aoqi@0 17 Ant: version 1.6.5 or later
aoqi@0 18 NetBeans: version 6.0 or later (optional)
aoqi@0 19 JDK: currently version 1.5.0, although 1.6.0 is recommended
aoqi@0 20 OS: any system supporting the above tools
aoqi@0 21
aoqi@0 22 For more information:
aoqi@0 23 Ant: http://ant.apache.org/
aoqi@0 24 GNU Make: http://www.gnu.org/software/make/
aoqi@0 25 NetBeans: http://www.netbeans.org/
aoqi@0 26
aoqi@0 27
aoqi@0 28 Testing the "langtools" workspace.
aoqi@0 29
aoqi@0 30 The primary set of tests for the compiler is the compiler TCK. This
aoqi@0 31 tests that the compiler performs according to the specifications in
aoqi@0 32 JLS and JVMS.
aoqi@0 33
aoqi@0 34 In addition, there is a substantial collection of regression and unit
aoqi@0 35 tests for all the tools in the main langtools test/ directory.
aoqi@0 36
aoqi@0 37 Finally, there is a small set of tests to do basic validation of a build
aoqi@0 38 of the langtools workspace for use by JDK. These tests check the contents
aoqi@0 39 of the dist/ directory generated by the build, and verify that the various
aoqi@0 40 tools can do basic "Hello World"-style processing. These tests should be
aoqi@0 41 run by jtreg, with the -jdk option set a version of JDK capable of running
aoqi@0 42 the default output of the javac compiler in this workspace. Currently,
aoqi@0 43 this means JDK 6 or better.

mercurial