README revision 200
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeUsing NetBeans to work on the langtools repository.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeNetbeans 6.0 or later is recommended.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeThe "langtools" project in this directory allows you to
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbyeedit, run, test and debug the tools in the OpenJDK langtools
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeThe repository contains a number of tools:
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbye apt, javac, javadoc and its doclets, javah and javap.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeBuild Properties.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeTo build this repository, you must set some properties for Ant.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeYou can set these properties in a number of ways:
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbye- Set the properties in the Properties panel under Tool> Options> Ant.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbye Properties set this way will apply globally to all the langtools
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbye repositories you may be working on.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbye- Create a file build.properties in the root directory of a
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbye langtools repository, and set the properties in that file.
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbye These properties will be specific to that repository.
5e43c87216dfeda97c475a542b371b958b13fed5Patrick HigginsTo build the repository, at a minimum you must set the "boot.java.home"
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbyeproperty. To run the tools, you must also set "target.java.home". To
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbyerun the regression tests, you must set "jtreg.home".
ef604281b397eceb0d9f67b87378b7c0b751967dTrond NorbyeBy default, the build and test targets will build and test all
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbyeof these tools. The run and debug targets will prompt you for the
ef604281b397eceb0d9f67b87378b7c0b751967dTrond Norbyename of a tool to execute.
5e43c87216dfeda97c475a542b371b958b13fed5Patrick HigginsAs an alternative, you can focus on a single tool. When you do
5e43c87216dfeda97c475a542b371b958b13fed5Patrick Higginsthis, you will still see all the source code for all the tools,
5e43c87216dfeda97c475a542b371b958b13fed5Patrick Higginsbut the various Ant targets will now be focussed on the selected tool.
5e43c87216dfeda97c475a542b371b958b13fed5Patrick HigginsTo focus on a tool, bring up the context menu on the "langtools"
5e43c87216dfeda97c475a542b371b958b13fed5Patrick Higginsproject (i.e. right-click on the project) and select "Select Tool".
5e43c87216dfeda97c475a542b371b958b13fed5Patrick HigginsThis brings up a dialog which allows you to specify which tool you
5e43c87216dfeda97c475a542b371b958b13fed5Patrick Higginswish to work on, and the arguments to use if and when you run it.