| 1 | Using NetBeans to work on the langtools repository.
|
|---|
| 2 |
|
|---|
| 3 | Netbeans 6.0 or later is recommended.
|
|---|
| 4 |
|
|---|
| 5 | The "langtools" project in this directory allows you to
|
|---|
| 6 | edit, run, test and debug the tools in the OpenJDK langtools
|
|---|
| 7 | repository.
|
|---|
| 8 |
|
|---|
| 9 | The repository contains a number of tools:
|
|---|
| 10 | apt, javac, javadoc and its doclets, javah and javap.
|
|---|
| 11 |
|
|---|
| 12 | Build Properties.
|
|---|
| 13 |
|
|---|
| 14 | To build this repository, you must set some properties for Ant.
|
|---|
| 15 | You can set these properties in a number of ways:
|
|---|
| 16 |
|
|---|
| 17 | - Set the properties in the Properties panel under Tool> Options> Ant.
|
|---|
| 18 | Properties set this way will apply globally to all the langtools
|
|---|
| 19 | repositories you may be working on.
|
|---|
| 20 |
|
|---|
| 21 | - Create a file build.properties in the root directory of a
|
|---|
| 22 | langtools repository, and set the properties in that file.
|
|---|
| 23 | These properties will be specific to that repository.
|
|---|
| 24 |
|
|---|
| 25 | To build the repository, at a minimum you must set the "boot.java.home"
|
|---|
| 26 | property. To run the tools, you must also set "target.java.home". To
|
|---|
| 27 | run the regression tests, you must set "jtreg.home".
|
|---|
| 28 |
|
|---|
| 29 | By default, the build and test targets will build and test all
|
|---|
| 30 | of these tools. The run and debug targets will prompt you for the
|
|---|
| 31 | name of a tool to execute.
|
|---|
| 32 |
|
|---|
| 33 | As an alternative, you can focus on a single tool. When you do
|
|---|
| 34 | this, you will still see all the source code for all the tools,
|
|---|
| 35 | but the various Ant targets will now be focussed on the selected tool.
|
|---|
| 36 | To focus on a tool, bring up the context menu on the "langtools"
|
|---|
| 37 | project (i.e. right-click on the project) and select "Select Tool".
|
|---|
| 38 | This brings up a dialog which allows you to specify which tool you
|
|---|
| 39 | wish to work on, and the arguments to use if and when you run it.
|
|---|
