--- old/make/jdk/netbeans/jmx/README 2020-04-29 12:12:03.768610295 +0200 +++ /dev/null 2020-02-11 10:29:13.086348146 +0100 @@ -1,90 +0,0 @@ -Working On Java[TM] Management Extensions (JMX[TM)) Using NetBeans IDE - -README FIRST - - make/netbeans/README for getting started with NetBeans IDE and OpenJDK, - and workings with OpenJDK NetBeans projects. - -This README focusses on working on the OpenJDK JMX API using NetBeans IDE. - - This NetBeans project for OpenJDK JMX allows you to modify, build, and test - the JMX API in a standalone manner. It can also be used to generate - the JMX API documentation for preview. - - The JMX API does not contain native code. It is a pure java library. - You do not need to install all the Java SE sources to work on JMX, - you only need the following subset: - - make/netbeans/ - src/share/classes/com/sun/jmx/ - src/share/classes/javax/management/ - test/TEST.ROOT - test/com/sun/management/ - test/java/lang/management/ - test/javax/management/ - - If you don't want to build the whole JDK, you will also need a - pre-built version of OpenJDK (or JDK 7). Edit your - - $HOME/.openjdk/build.properties - - file (create it if you don't have one yet) and set the bootstrap.jdk variable - point to that JDK: - - bootstrap.jdk= - - Then from within NetBeans IDE open the JMX project, and invoke the - "Build Project" and "Test Project" target. Note that running all the - tests for JMX takes a while. The build may also fail if it doesn't - find a directory named src/${platform}. This may happen if you haven't - installed all OpenJDK sources. In this case, you can simply - create an empty directory with the name expected by the build mechanism. - - Which tests are run are defined by the jtreg.test variable declared - in make/netbeans/jmx/build.properties. Note that JMX tests are all - placed under test/javax/management/. test/java/lang/management/ - and test/com/sun/management/ contain some tests that happen to - use JMX and we therefore recommend to run these tests too. - - If you are working on a JMX fix, don't forget to create a - corresponding jtreg unit test under test/javax/management/. - You can look at existing tests to see how this is done. - -The set of actions defined in this project are: - -* Build Project: - - - Compiles JMX API source files and puts the class files under - build/${platform}-${arch}/classes. - - - Generates a JMX jar file under dist/lib/jmx.jar. To use your modified - JMX classes instead of the built-in JDK classes you will need - to put this jar file in front of the bootclasspath: - - java -Xbootclasspath/p:dist/lib/jmx.jar mytestapp.MyAppMainClass - -* Generate Javadoc for Project - - - Generates the JMX API Documentation under - - build/${platform}-${arch}/javadoc/jmx. - -* Test Project - - - Runs the JMX and Management and Monitoring jtreg unit tests. - - - The results are written under build/${platform}-${arch}/jtreg/jmx - and the HTML test report can be found at - build/${platform}-${arch}/jtreg/jmx/JTreport/report.html. - -* Clean Project - - - Cleans the files created by this projet under build/ - Some files may remain. - - -IMPORTANT NOTE - - Please make sure to follow carefully the governance rules documented at - http://openjdk.dev.java.net/ - --- /dev/null 2020-02-11 10:29:13.086348146 +0100 +++ new/make/ide/netbeans/jdk/jmx/README 2020-04-29 12:12:03.360610298 +0200 @@ -0,0 +1,90 @@ +Working On Java[TM] Management Extensions (JMX[TM)) Using NetBeans IDE + +README FIRST + + make/netbeans/README for getting started with NetBeans IDE and OpenJDK, + and workings with OpenJDK NetBeans projects. + +This README focusses on working on the OpenJDK JMX API using NetBeans IDE. + + This NetBeans project for OpenJDK JMX allows you to modify, build, and test + the JMX API in a standalone manner. It can also be used to generate + the JMX API documentation for preview. + + The JMX API does not contain native code. It is a pure java library. + You do not need to install all the Java SE sources to work on JMX, + you only need the following subset: + + make/netbeans/ + src/share/classes/com/sun/jmx/ + src/share/classes/javax/management/ + test/TEST.ROOT + test/com/sun/management/ + test/java/lang/management/ + test/javax/management/ + + If you don't want to build the whole JDK, you will also need a + pre-built version of OpenJDK (or JDK 7). Edit your + + $HOME/.openjdk/build.properties + + file (create it if you don't have one yet) and set the bootstrap.jdk variable + point to that JDK: + + bootstrap.jdk= + + Then from within NetBeans IDE open the JMX project, and invoke the + "Build Project" and "Test Project" target. Note that running all the + tests for JMX takes a while. The build may also fail if it doesn't + find a directory named src/${platform}. This may happen if you haven't + installed all OpenJDK sources. In this case, you can simply + create an empty directory with the name expected by the build mechanism. + + Which tests are run are defined by the jtreg.test variable declared + in make/netbeans/jmx/build.properties. Note that JMX tests are all + placed under test/javax/management/. test/java/lang/management/ + and test/com/sun/management/ contain some tests that happen to + use JMX and we therefore recommend to run these tests too. + + If you are working on a JMX fix, don't forget to create a + corresponding jtreg unit test under test/javax/management/. + You can look at existing tests to see how this is done. + +The set of actions defined in this project are: + +* Build Project: + + - Compiles JMX API source files and puts the class files under + build/${platform}-${arch}/classes. + + - Generates a JMX jar file under dist/lib/jmx.jar. To use your modified + JMX classes instead of the built-in JDK classes you will need + to put this jar file in front of the bootclasspath: + + java -Xbootclasspath/p:dist/lib/jmx.jar mytestapp.MyAppMainClass + +* Generate Javadoc for Project + + - Generates the JMX API Documentation under + + build/${platform}-${arch}/javadoc/jmx. + +* Test Project + + - Runs the JMX and Management and Monitoring jtreg unit tests. + + - The results are written under build/${platform}-${arch}/jtreg/jmx + and the HTML test report can be found at + build/${platform}-${arch}/jtreg/jmx/JTreport/report.html. + +* Clean Project + + - Cleans the files created by this projet under build/ + Some files may remain. + + +IMPORTANT NOTE + + Please make sure to follow carefully the governance rules documented at + http://openjdk.dev.java.net/ +