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