7074264: Switches to packages tree view and adds unit tests to sources
Reviewed-by: igor
This commit is contained in:
parent
4d4a89de9b
commit
b9c11d661e
@ -5,7 +5,7 @@ Working on OpenJDK using NetBeans
|
|||||||
|
|
||||||
Getting Started
|
Getting Started
|
||||||
In addition to the source bundle for Open JDK, you'll need to download
|
In addition to the source bundle for Open JDK, you'll need to download
|
||||||
and install copies of the JDK and of NetBeans 6. And if you want to run
|
and install copies of the JDK and of NetBeans. And if you want to run
|
||||||
tests on the JDK (you do want to run tests, right?), you'll need to
|
tests on the JDK (you do want to run tests, right?), you'll need to
|
||||||
install the jtreg test harness.
|
install the jtreg test harness.
|
||||||
|
|
||||||
@ -20,30 +20,28 @@ Getting Started
|
|||||||
|
|
||||||
Downloading the JDK
|
Downloading the JDK
|
||||||
You've probably done this a million times. Download and install it
|
You've probably done this a million times. Download and install it
|
||||||
from http://java.sun.com/javase
|
from http://www.oracle.com/technetwork/java/javase/overview/index.html
|
||||||
|
|
||||||
Downloading the OpenJDK sources
|
Downloading the OpenJDK sources
|
||||||
Since you're reading this, d you've already downloaded the OpenJDK
|
Since you're reading this, d you've already downloaded the OpenJDK
|
||||||
source bundle. Later in this document we'll refer to the location
|
source bundle. Later in this document we'll refer to the location
|
||||||
where you installed the Open JDK sources as *install-dir*.
|
where you installed the Open JDK sources as *install-dir*.
|
||||||
|
|
||||||
Downloading a pre-built, JDK 7
|
Downloading a pre-built, JDK 8
|
||||||
This will be necessary to do builds of some of the projects. In
|
This will be necessary to do builds of some of the projects. In
|
||||||
general, you want to download and install a pre-built JDK that
|
general, you want to download and install a pre-built JDK that
|
||||||
corresponds to the OpenJDK sources you download. Building the entire
|
corresponds to the OpenJDK sources you download. Building the entire
|
||||||
OpenJDK depends on a few parts of the pre-built JDK. Get this from
|
OpenJDK depends on a few parts of the pre-built JDK. Get this from
|
||||||
http://download.java.net/jdk7/binaries
|
http://download.java.net/jdk8/binaries
|
||||||
|
|
||||||
Note: For working on certain projects, like JMX and JConsole, you
|
Note: For working on certain projects, like JMX and JConsole, you
|
||||||
may find convenient to use a pre-built version of JDK 7 (or
|
may find convenient to use a pre-built version of JDK 8 (or
|
||||||
OpenJDK) rather than building your own. This will allow you
|
OpenJDK) rather than building your own. This will allow you
|
||||||
to build only that part of the OpenJDK sources which correspond
|
to build only that part of the OpenJDK sources which correspond
|
||||||
to that project.
|
to that project.
|
||||||
|
|
||||||
NetBeans 6
|
NetBeans 7.0 or later
|
||||||
Yep, NetBeans *6*. Nope, not FCS'd yet. We're on the edge here,
|
Older versions may also work but are unsupported.
|
||||||
enjoy it! Get the latest working development build of NetBeans 6
|
|
||||||
from http://netbeans.org
|
|
||||||
|
|
||||||
jtreg
|
jtreg
|
||||||
"jtreg" is the test harness for running OpenJDK's regression tests.
|
"jtreg" is the test harness for running OpenJDK's regression tests.
|
||||||
@ -51,7 +49,7 @@ Getting Started
|
|||||||
|
|
||||||
Ant
|
Ant
|
||||||
NetBeans comes with ant, but if you use a separately-installed copy
|
NetBeans comes with ant, but if you use a separately-installed copy
|
||||||
please make sure that it is at least version 1.7.0.
|
please make sure that it is at least version 1.8.1.
|
||||||
|
|
||||||
Configuring
|
Configuring
|
||||||
Building OpenJDK is hard and complex. No, strike that. While it's not
|
Building OpenJDK is hard and complex. No, strike that. While it's not
|
||||||
@ -92,8 +90,8 @@ Configuring
|
|||||||
situation:
|
situation:
|
||||||
|
|
||||||
make.options=\
|
make.options=\
|
||||||
ALT_BOOTDIR=/home/me/bin/jdk1.6.0 \
|
ALT_BOOTDIR=/home/me/bin/jdk1.7.0 \
|
||||||
ALT_JDK_IMPORT_PATH=/home/me/bin/jdk1.7.0 \
|
ALT_JDK_IMPORT_PATH=/home/me/bin/jdk1.8.0 \
|
||||||
OPENJDK=true
|
OPENJDK=true
|
||||||
|
|
||||||
The trailing '\' are important, so that make gets the above as a
|
The trailing '\' are important, so that make gets the above as a
|
||||||
@ -141,7 +139,7 @@ Configuring
|
|||||||
editor.
|
editor.
|
||||||
|
|
||||||
Locale Requirements
|
Locale Requirements
|
||||||
To build the Open JDK sources, be certain that you are using the "C"
|
To build the OpenJDK sources, be certain that you are using the "C"
|
||||||
locale on Unix (R) platforms, or "English (United States)" locale on
|
locale on Unix (R) platforms, or "English (United States)" locale on
|
||||||
Windows.
|
Windows.
|
||||||
|
|
||||||
@ -603,13 +601,6 @@ Appendix 1: Customizations
|
|||||||
* -clean-make
|
* -clean-make
|
||||||
|
|
||||||
Known Issues
|
Known Issues
|
||||||
Tests won't run: waiting for lock
|
|
||||||
Occasionally when running tests, there will be a delay, followed by a
|
|
||||||
message like this:
|
|
||||||
Waiting to lock test result cache for
|
|
||||||
/tmp/jdk/build/linux-i586/jtreg/jconsole/JTwork for 20 seconds
|
|
||||||
The workaround is to stop the tests, rm -rf the offending jtreg/<project>
|
|
||||||
directory by hand, and re-run the tests.
|
|
||||||
|
|
||||||
Can't run nor debug a single test in the JConsole test
|
Can't run nor debug a single test in the JConsole test
|
||||||
In most projects, you can run a single test by opening it in the editor,
|
In most projects, you can run a single test by opening it in the editor,
|
||||||
|
@ -31,8 +31,8 @@
|
|||||||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<source-folder style="packages">
|
<source-folder style="tree">
|
||||||
<label>Closed-Source Packages</label>
|
<label>Closed Sources</label>
|
||||||
<location>${root}/src/closed/share/classes</location>
|
<location>${root}/src/closed/share/classes</location>
|
||||||
<includes>${includes}</includes>
|
<includes>${includes}</includes>
|
||||||
<excludes>${excludes}</excludes>
|
<excludes>${excludes}</excludes>
|
||||||
|
@ -38,7 +38,12 @@
|
|||||||
<package-root>${root}/src/solaris/classes</package-root>
|
<package-root>${root}/src/solaris/classes</package-root>
|
||||||
<classpath mode="boot">${bootstrap.jdk}/jre/lib/rt.jar</classpath>
|
<classpath mode="boot">${bootstrap.jdk}/jre/lib/rt.jar</classpath>
|
||||||
<built-to>${root}/build/${platform}-${arch}/classes</built-to>
|
<built-to>${root}/build/${platform}-${arch}/classes</built-to>
|
||||||
<javadoc-built-to>${root}/build/javadoc/${name}</javadoc-built-to>
|
<javadoc-built-to>${root}/build/${platform}-${arch}/docs/api</javadoc-built-to>
|
||||||
|
<source-level>1.7</source-level>
|
||||||
|
</compilation-unit>
|
||||||
|
<compilation-unit>
|
||||||
|
<package-root>${root}/test</package-root>
|
||||||
|
<unit-tests/>
|
||||||
<source-level>1.7</source-level>
|
<source-level>1.7</source-level>
|
||||||
</compilation-unit>
|
</compilation-unit>
|
||||||
</java-data>
|
</java-data>
|
||||||
|
@ -36,7 +36,12 @@
|
|||||||
<package-root>${root}/src/share/classes</package-root>
|
<package-root>${root}/src/share/classes</package-root>
|
||||||
<classpath mode="boot">${bootstrap.jdk}/jre/lib/rt.jar</classpath>
|
<classpath mode="boot">${bootstrap.jdk}/jre/lib/rt.jar</classpath>
|
||||||
<built-to>${root}/build/${platform}-${arch}/classes</built-to>
|
<built-to>${root}/build/${platform}-${arch}/classes</built-to>
|
||||||
<javadoc-built-to>${root}/build/javadoc/${name}</javadoc-built-to>
|
<javadoc-built-to>${root}/build/${platform}-${arch}/docs/api</javadoc-built-to>
|
||||||
|
<source-level>1.7</source-level>
|
||||||
|
</compilation-unit>
|
||||||
|
<compilation-unit>
|
||||||
|
<package-root>${root}/test</package-root>
|
||||||
|
<unit-tests/>
|
||||||
<source-level>1.7</source-level>
|
<source-level>1.7</source-level>
|
||||||
</compilation-unit>
|
</compilation-unit>
|
||||||
</java-data>
|
</java-data>
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<source-folder style="packages">
|
<source-folder style="tree">
|
||||||
<label>Tests</label>
|
<label>Tests</label>
|
||||||
<location>${root}/test</location>
|
<location>${root}/test</location>
|
||||||
<includes>${jtreg.tests}</includes>
|
<includes>${jtreg.tests}</includes>
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<source-folder style="packages">
|
<source-folder style="tree">
|
||||||
<label>Samples</label>
|
<label>Samples</label>
|
||||||
<location>${root}/src/share/sample</location>
|
<location>${root}/src/share/sample</location>
|
||||||
<includes>${samples}</includes>
|
<includes>${samples}</includes>
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<source-folder style="packages">
|
<source-folder style="tree">
|
||||||
<label>Sources for All Platforms</label>
|
<label>Sources for All Platforms</label>
|
||||||
<location>${root}/src/share/classes</location>
|
<location>${root}/src/share/classes</location>
|
||||||
<includes>${includes}</includes>
|
<includes>${includes}</includes>
|
||||||
|
@ -35,7 +35,7 @@
|
|||||||
UNIX is a registered trademark in the United States and other countries,
|
UNIX is a registered trademark in the United States and other countries,
|
||||||
exclusively licensed through X/Open Company, Ltd.
|
exclusively licensed through X/Open Company, Ltd.
|
||||||
-->
|
-->
|
||||||
<source-folder style="packages">
|
<source-folder style="tree">
|
||||||
<label>Sources for Unix® Platform</label>
|
<label>Sources for Unix® Platform</label>
|
||||||
<location>${root}/src/solaris/classes</location>
|
<location>${root}/src/solaris/classes</location>
|
||||||
<includes>${includes}</includes>
|
<includes>${includes}</includes>
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<source-folder style="packages">
|
<source-folder style="tree">
|
||||||
<label>Sources for Windows Platform</label>
|
<label>Sources for Windows Platform</label>
|
||||||
<location>${root}/src/windows/classes</location>
|
<location>${root}/src/windows/classes</location>
|
||||||
<includes>${includes}</includes>
|
<includes>${includes}</includes>
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
Copyright (c) 2007, Oracle and/or its affiliates. All rights reserved.
|
Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||||
|
|
||||||
Redistribution and use in source and binary forms, with or without
|
Redistribution and use in source and binary forms, with or without
|
||||||
modification, are permitted provided that the following conditions
|
modification, are permitted provided that the following conditions
|
||||||
@ -36,11 +36,13 @@
|
|||||||
<!ENTITY share-sources SYSTEM "../../common/share-sources.ent">
|
<!ENTITY share-sources SYSTEM "../../common/share-sources.ent">
|
||||||
<!ENTITY unix-sources SYSTEM "../../common/unix-sources.ent">
|
<!ENTITY unix-sources SYSTEM "../../common/unix-sources.ent">
|
||||||
<!ENTITY windows-sources SYSTEM "../../common/windows-sources.ent">
|
<!ENTITY windows-sources SYSTEM "../../common/windows-sources.ent">
|
||||||
|
<!ENTITY jtreg-sources SYSTEM "../../common/jtreg-sources.ent">
|
||||||
<!ENTITY build-folder SYSTEM "../../common/build-folder.ent">
|
<!ENTITY build-folder SYSTEM "../../common/build-folder.ent">
|
||||||
<!ENTITY standard-bindings SYSTEM "../../common/standard-bindings.ent">
|
<!ENTITY standard-bindings SYSTEM "../../common/standard-bindings.ent">
|
||||||
<!ENTITY share-view SYSTEM "../../common/share-view.ent">
|
<!ENTITY share-view SYSTEM "../../common/share-view.ent">
|
||||||
<!ENTITY unix-view SYSTEM "../../common/unix-view.ent">
|
<!ENTITY unix-view SYSTEM "../../common/unix-view.ent">
|
||||||
<!ENTITY windows-view SYSTEM "../../common/windows-view.ent">
|
<!ENTITY windows-view SYSTEM "../../common/windows-view.ent">
|
||||||
|
<!ENTITY jtreg-view SYSTEM "../../common/jtreg-view.ent">
|
||||||
<!ENTITY file-view SYSTEM "../../common/file-view.ent">
|
<!ENTITY file-view SYSTEM "../../common/file-view.ent">
|
||||||
<!ENTITY standard-actions SYSTEM "../../common/standard-actions.ent">
|
<!ENTITY standard-actions SYSTEM "../../common/standard-actions.ent">
|
||||||
<!ENTITY java-data-native SYSTEM "../../common/java-data-native.ent">
|
<!ENTITY java-data-native SYSTEM "../../common/java-data-native.ent">
|
||||||
@ -59,6 +61,7 @@
|
|||||||
&unix-sources;
|
&unix-sources;
|
||||||
&windows-sources;
|
&windows-sources;
|
||||||
&build-folder;
|
&build-folder;
|
||||||
|
&jtreg-sources;
|
||||||
</folders>
|
</folders>
|
||||||
<ide-actions>
|
<ide-actions>
|
||||||
<action name="build">
|
<action name="build">
|
||||||
@ -82,6 +85,7 @@
|
|||||||
&share-view;
|
&share-view;
|
||||||
&unix-view;
|
&unix-view;
|
||||||
&windows-view;
|
&windows-view;
|
||||||
|
&jtreg-view;
|
||||||
&file-view;
|
&file-view;
|
||||||
</items>
|
</items>
|
||||||
<context-menu>
|
<context-menu>
|
||||||
|
Loading…
x
Reference in New Issue
Block a user