make/langtools/netbeans/README
changeset 47216 71c04702a3d5
parent 11864 116173ff7d77
child 48406 26b47ea4c77d
equal deleted inserted replaced
47215:4ebc2e2fb97c 47216:71c04702a3d5
       
     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     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.