aoqi@0: Using NetBeans to work on the langtools repository.
aoqi@0: 
aoqi@0: Netbeans 6.0 or later is recommended.
aoqi@0: 
aoqi@0: The "langtools" project in this directory allows you to
aoqi@0: edit, run, test and debug the tools in the OpenJDK langtools
aoqi@0: repository.
aoqi@0: 
aoqi@0: The repository contains a number of tools:
aoqi@0:     javac, javadoc and its doclets, javah and javap.
aoqi@0: 
aoqi@0: Build Properties.
aoqi@0: 
aoqi@0: To build this repository, you must set some properties for Ant.
aoqi@0: You can set these properties in a number of ways:
aoqi@0: 
aoqi@0: - Set the properties in the Properties panel under Tool> Options> Ant.
aoqi@0:   Properties set this way will apply globally to all the langtools 
aoqi@0:   repositories you may be working on.
aoqi@0: 
aoqi@0: - Create a file build.properties in the root directory of a
aoqi@0:   langtools repository, and set the properties in that file.
aoqi@0:   These properties will be specific to that repository.
aoqi@0: 
aoqi@0: To build the repository, at a minimum you must set the "boot.java.home"
aoqi@0: property.  To run the tools, you must also set "target.java.home". To
aoqi@0: run the regression tests, you must set "jtreg.home".
aoqi@0: 
aoqi@0: By default, the build and test targets will build and test all
aoqi@0: of these tools. The run and debug targets will prompt you for the
aoqi@0: name of a tool to execute.
aoqi@0: 
aoqi@0: As an alternative, you can focus on a single tool.  When you do
aoqi@0: this, you will still see all the source code for all the tools,
aoqi@0: but the various Ant targets will now be focussed on the selected tool.
aoqi@0: To focus on a tool, bring up the context menu on the "langtools"
aoqi@0: project (i.e. right-click on the project) and select "Select Tool".
aoqi@0: This brings up a dialog which allows you to specify which tool you
aoqi@0: wish to work on, and the arguments to use if and when you run it.