1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/make/netbeans/README Wed Apr 27 01:34:52 2016 +0800
1.3 @@ -0,0 +1,39 @@
1.4 +Using NetBeans to work on the langtools repository.
1.5 +
1.6 +Netbeans 6.0 or later is recommended.
1.7 +
1.8 +The "langtools" project in this directory allows you to
1.9 +edit, run, test and debug the tools in the OpenJDK langtools
1.10 +repository.
1.11 +
1.12 +The repository contains a number of tools:
1.13 + javac, javadoc and its doclets, javah and javap.
1.14 +
1.15 +Build Properties.
1.16 +
1.17 +To build this repository, you must set some properties for Ant.
1.18 +You can set these properties in a number of ways:
1.19 +
1.20 +- Set the properties in the Properties panel under Tool> Options> Ant.
1.21 + Properties set this way will apply globally to all the langtools
1.22 + repositories you may be working on.
1.23 +
1.24 +- Create a file build.properties in the root directory of a
1.25 + langtools repository, and set the properties in that file.
1.26 + These properties will be specific to that repository.
1.27 +
1.28 +To build the repository, at a minimum you must set the "boot.java.home"
1.29 +property. To run the tools, you must also set "target.java.home". To
1.30 +run the regression tests, you must set "jtreg.home".
1.31 +
1.32 +By default, the build and test targets will build and test all
1.33 +of these tools. The run and debug targets will prompt you for the
1.34 +name of a tool to execute.
1.35 +
1.36 +As an alternative, you can focus on a single tool. When you do
1.37 +this, you will still see all the source code for all the tools,
1.38 +but the various Ant targets will now be focussed on the selected tool.
1.39 +To focus on a tool, bring up the context menu on the "langtools"
1.40 +project (i.e. right-click on the project) and select "Select Tool".
1.41 +This brings up a dialog which allows you to specify which tool you
1.42 +wish to work on, and the arguments to use if and when you run it.
