jdk/make/netbeans/jconsole/README

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/