Java example source code file (README)

This example Java source code file (README) is included in the alvinalexander.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" ^TM.

Learn more about this Java project at its project page.

Java - Java tags/keywords

api, cleans, generates, ide, jconsole, jconsole\'s, netbeans, openjdk, project, runs, test, the, this, working

The README Java example source code

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/