jdk-24/langtools
Chris Hegarty 2b80c4715f 8054834: Modular Source Code
Co-authored-by: Alan Bateman <alan.bateman@oracle.com>
Co-authored-by: Alex Buckley <alex.buckley@oracle.com>
Co-authored-by: Erik Joelsson <erik.joelsson@oracle.com>
Co-authored-by: Jonathan Gibbons <jonathan.gibbons@oracle.com>
Co-authored-by: Karen Kinnear <karen.kinnear@oracle.com>
Co-authored-by: Magnus Ihse Bursie <magnus.ihse.bursie@oracle.com>
Co-authored-by: Mandy Chung <mandy.chung@oracle.com>
Co-authored-by: Mark Reinhold <mark.reinhold@oracle.com>
Co-authored-by: Paul Sandoz <paul.sandoz@oracle.com>
Reviewed-by: alanb, chegar, ihse, mduigou
2014-08-17 15:52:32 +01:00
..
.jcheck 8030068: Update .jcheck/conf files for JDK 9 2013-12-13 09:36:24 -08:00
make 8054834: Modular Source Code 2014-08-17 15:52:32 +01:00
src 8054834: Modular Source Code 2014-08-17 15:52:32 +01:00
test 8054834: Modular Source Code 2014-08-17 15:52:32 +01:00
.hgignore 8046451: Add basic IntelliJ support for langtools 2014-06-24 16:04:46 +01:00
.hgtags Added tag jdk9-b26 for changeset 5cc16d71dc7a 2014-08-10 19:39:06 -07:00
ASSEMBLY_EXCEPTION
LICENSE
README 8015322: Javac template test framework 2013-09-09 17:11:55 -04:00
THIRD_PARTY_README 8032816: THIRDPARTYREADME LittleCMS preamble missing JRE 8 & JDK 8 2014-01-28 20:10:19 +00:00

Building the "langtools" workspace.

The "langtools" workspace can be built from the command line with Ant.
The build file is make/build.xml, in conjunction with make/build.properties.
Some additional user-specific properties files are also read, to allow
you to customize selected properties as needed.

Individual tools within the workspace can also be built and worked on
with NetBeans, using the projects in the make/netbeans directory.

The "langtools" workspace can also be built from the command line with
GNU Make, although the Makefile is simply a wrapper around the Ant
build file. This is provided for systems (such as the full OpenJDK build)
that expect to be able to build this workspace with GNU Make.

System Requirements:
  Ant:      version 1.6.5 or later
  NetBeans: version 6.0 or later (optional)
  JDK:      currently version 1.5.0, although 1.6.0 is recommended
  OS:       any system supporting the above tools

For more information:
  Ant:      http://ant.apache.org/
  GNU Make: http://www.gnu.org/software/make/
  NetBeans: http://www.netbeans.org/


Testing the "langtools" workspace.

The primary set of tests for the compiler is the compiler TCK. This
tests that the compiler performs according to the specifications in
JLS and JVMS.

In addition, there is a substantial collection of regression and unit
tests for all the tools in the main langtools test/ directory.

Finally, there is a small set of tests to do basic validation of a build
of the langtools workspace for use by JDK. These tests check the contents
of the dist/ directory generated by the build, and verify that the various
tools can do basic "Hello World"-style processing. These tests should be
run by jtreg, with the -jdk option set a version of JDK capable of running
the default output of the javac compiler in this workspace. Currently, 
this means JDK 6 or better.