Working on JConsole Using the NetBeans IDE

This JConsole NetBeans project allows a developer interested in making changes

to and/or fixing bugs in the jconsole tool to modify, build, run and test

jconsole in a standalone manner as well as generating the javadoc for the

JConsole plugin API.

README FIRST

make/netbeans/README to get started with NetBeans IDE and OpenJDK, and

working with the OpenJDK NetBeans projects.

WORKING WITH JCONSOLE

JConsole doesn't contain native code. It's a pure java tool. You don't need to

have all the Java SE sources to work on JConsole but just the following subset:

make/netbeans/

src/share/classes/com/sun/tools/jconsole/

src/share/classes/sun/tools/jconsole/

test/TEST.ROOT

test/sun/tools/jconsole/

The set of actions supported by this project are:

* Build Project:

- Compiles JConsole's source files and puts the class files under

build/${platform}-${arch}/classes.

- Generates JConsole's jar file under dist/lib/jconsole.jar

This new jar file could be used to patch an existing JDK installation

by replacing the jar file at <jdk-home>/lib/jconsole.jar, then calling

<jdk-home>/bin/jconsole will make use of the new jar file.

* Generate Javadoc for Project

- Generates the javadoc for the JConsole Plugin API source files,

i.e. the ones under src/share/classes/com/sun/tools/jconsole.

- The javadoc is generated under build/${platform}-${arch}/javadoc/jconsole.

* Test Project

- Runs the JConsole jtreg unit tests located under test/sun/tools/jconsole.

- The test results are written under

build/${platform}-${arch}/jtreg/jconsole

and the HTML test report can be found at

build/${platform}-${arch}/jtreg/jconsole/JTreport/report.html

* Run Project

- Runs the newly built JConsole tool.

* Clean Project

- Cleans the files created by this projet under build and dist.

IMPORTANT NOTE

Please make sure to follow carefully the governance rules documented at

http://openjdk.dev.java.net/