make/langtools/netbeans/README
author erikj
Tue, 12 Sep 2017 19:03:39 +0200
changeset 47216 71c04702a3d5
parent 11864 langtools/make/netbeans/README@116173ff7d77
child 48406 26b47ea4c77d
permissions -rw-r--r--
8187443: Forest Consolidation: Move files to unified layout Reviewed-by: darcy, ihse
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
     1
Using NetBeans to work on the langtools repository.
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
     2
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
     3
Netbeans 6.0 or later is recommended.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
     4
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
     5
The "langtools" project in this directory allows you to
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
     6
edit, run, test and debug the tools in the OpenJDK langtools
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
     7
repository.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
     8
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
     9
The repository contains a number of tools:
11864
116173ff7d77 7041249: Remove apt tool and API from the JDK
darcy
parents: 1873
diff changeset
    10
    javac, javadoc and its doclets, javah and javap.
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    11
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    12
Build Properties.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    13
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    14
To build this repository, you must set some properties for Ant.
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    15
You can set these properties in a number of ways:
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    16
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    17
- Set the properties in the Properties panel under Tool> Options> Ant.
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    18
  Properties set this way will apply globally to all the langtools 
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    19
  repositories you may be working on.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    20
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    21
- Create a file build.properties in the root directory of a
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    22
  langtools repository, and set the properties in that file.
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    23
  These properties will be specific to that repository.
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    24
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    25
To build the repository, at a minimum you must set the "boot.java.home"
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    26
property.  To run the tools, you must also set "target.java.home". To
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    27
run the regression tests, you must set "jtreg.home".
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    28
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    29
By default, the build and test targets will build and test all
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    30
of these tools. The run and debug targets will prompt you for the
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    31
name of a tool to execute.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    32
1873
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    33
As an alternative, you can focus on a single tool.  When you do
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    34
this, you will still see all the source code for all the tools,
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    35
but the various Ant targets will now be focussed on the selected tool.
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    36
To focus on a tool, bring up the context menu on the "langtools"
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    37
project (i.e. right-click on the project) and select "Select Tool".
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    38
This brings up a dialog which allows you to specify which tool you
658385834998 6795365: NetBeans projects in langtools repository are not NB6.5-friendly
jjg
parents: 10
diff changeset
    39
wish to work on, and the arguments to use if and when you run it.