| 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/ |