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