See the documentation page, especially the GNU
Classpath Hacker’s Guide, and pick up a
from the list!
If you are going to contribute source code to GNU Classpath we must
make sure that you have not studied the source code of the JDK/JRE or
decompiled any of its classes. Furthermore you must not have signed
any non-disclosure agreements with Sun or other companies in regard
with java technology that might cover the core class libaries or
tools. The reason for this requirement is that we want to make sure
that Sun or any other company cannot rightfully claim that GNU
Classpath infringes their copyright. You are therefore questioned
about your experience with other implementations of similar source
code and any agreements with companies you might have signed when you
request to contribute to GNU Classpath.
Please note that this does not mean you cannot help GNU Classpath at
all in such a case. Here is a list of things you can do instead:
- write Mauve test cases
- write example applications demonstrating the usage of the packages
- writing/fixing helper programs (like japitools) and scripts
- report bugs
- help fixing the documentation
- help in other related Free software projects
(e.g. virtual machine development,
Here are some rough guidelines for deciding whether or not it would be
wise to accept a contribution from someone that studied source code
for another implementation of the core libraries or is under contract
with some company covering implementations of core library classes.
If the developer got access to the source code by signing some
contract (like the SCSL) with Sun then it would be best to examine
that contract (by FSF legal) before deciding.
If the developer just accidentally saw some of the source code and had
no intention (and didn't actually) study the implementation (with the
intention of contributing to GNU Classpath) there is no problem.
Studying a proprietary implementation with the intention of
implementing it (better) for GNU Classpath is a clear no-no.
The general rule is that if you have looked at or studied any
(proprietary) implementation of a package you should not work on that
package for GNU Classpath. That is because it would be
difficult to proof that you really did an independent
implementation. Since what you create might look very similar (which
is not unlikely). Working on something completely unrelated is OK (as
long as there are no contractual obligations with Sun or some other
company to not do this of course).
The important thing is that we want to be clear on the fact that we
created an independent implementation. We don't want to get into
tricky legal situations. We want to avoid risking to go to court over
reverse engineering or clean room situation questions if not
absolutely necessary. That is why we in general just say "please don't
contribute if you looked at other implementations". If someone thinks
that their actions might be explained as copying directly or
indirectly another (proprietary) implementation then that could be a
problem that we want to avoid.
FSF Legal will always advise not to take any unnecessary risks that
might endanger the (perceived) free software status of a GNU
project. (If we might need to go to court to proof that what we did
was OK, then don't!)
This isn't a GNU Classpath project specific issue.
GNU: Reading Non-Free Code
Even if you have seen Sun's source and you cannot contribute code to GNU Classpath, there are still many way you can help us.
Here's a few examples of contributions you can make that would greatly help us:
In general, if you just accidentally saw some of the source code and had no intention (and didn't actually) study the implementation (with the intention of contributing to GNU Classpath), there is no problem.
In case of doubt, please refer to FSF legal.
- Mauve test cases
- Example programs for GNU Classpath
- Documentation fixes
- Help programs (e.g. japitools) and scripts
Some contributors of Classpath might be annoyed if their work was being
used under conditions that are not according to the terms of the license.
However, enforcing the license in court (if this was ever needed) would
be easier if the Free Software Foundation can claim to speak in the name
of all authors. For this reason, and for others that are specific to the
intellectual property system of the United States, GNU projects tend to
be a bit picky about getting signatures from all contributors. Please do
not see this as a personal offence.
Giving the copyright to the FSF also gives us a clear paper trail where changes come from, which confirms our clean-room status.
The assignment contract commits the foundation to setting distribution terms
that permit free redistribution.
The assignment contract we normally use has a clause that permits you to
use your code in proprietary programs, on 30 days' notice.
(The 30 days' notice is there because, through a legal technicality,
it would improve our position in a suit against a hoarder.)
Although we believe that proprietary software is wrong, we include this
clause because it would serve no purpose to ask you to promise not to do
it. You're giving us a gift in the first place.
You don't need to invoke this clause in order to distribute
copies as free software under the GNU GPL, since everyone is
allowed to do that.
See also http://www.gnu.org/licenses/why-assign.html.
For getting the assignment form, please send an e-mail with your name (as
it appears in your passport) and your current postal address to the
maintainer of GNU Classpath, Mark Wielaard .
Follow these steps to install GNU Classpath. Please note that you need this only if you want to work directly with it; usually JVMs contain a pre-packaged version of GNU Classpath.
Please check the exact version of the prerequisites from your release's INSTALL file.
In every case, you need:
For building the Java bytecode (.class files), one of these compilers are required. You can select which compiler using --with-jikes, --with-gcj or --with-kjc as argument to configure; the present default is gcj.
- GNU gmake
- GNU autoconf
- GNU automake
- GNU libtool
For building the JNI native libraries, the following are required unless --disable-gtk-peer is used as an argument to configure.
For building the documentation you will need:
Install from CVS
- GCJ (part of GNU GCC)
- IBM Jikes
Install a release
Download the current release
tar zxf classpath-version.tar.gz
make sure you have all pre-requirements
configure the distribution; use |
--help to get the list of options: you will usually need
--disable-gtk-peer if you don't use gtk+/gnome.
make; make install
|password is anoncvs|
cvs checkout mauve
The main thing this does is creating the gnu/testlet/config.java. You could also do this by hand from the config.java.in file
Edit the script 'batch_runner' to set the variable COMPILER correctly
(there are a couple of example settings)
Edit script 'runner' to set the variable RUNTIME correctly
(there are a couple of example settings)
run ./batch_run and look at the results. You can also run individual tests with|
- echo gnu.testlet.java.lang.String.getBytes | jamvm
(Option flags are -verbose and -debug)
When developing a JVM that uses GNU Classpath, a copy of GNU Classpath local to the JVM is often used. To keep the Classpath sources synchronized with the main development, a few approaches are possible (we assume here that you are keeping the local copy of Classpath in your JVM revision control software):
- Use CVS import and CVS update as explained in
Section 13: Tracking Thirdparty sources
of the CVS manual. This works well for minor changes, but has the disadvantage of a limited control on the update / merge of the sources. In fact, most of the developers prefer merging the changes by hand.
- libgcj, which is almost always trying to be
as synchronized as possible with GNU Classpath CVS, has a script
that runs daily which produces a (colored) differences overview
(including patch/diffs). They also put in special markers into the
source for gcj specific changes that the script recognizes.
lib/standard.omit controls which files are omitted from the compilation. Add a regex with the files to be omitted and rebuild classpath.
To modify and upload GNU Classpath's web pages, you need write access to the CVS. First, checkout the modules "classpath" and "website".
The web pages are stored in doc/www.gnu.org and are written in wml (Web Meta Language, see
A typical page usually looks like this:
<subject "here goes the page title">
<boxtitle>Section 1 Title<\boxtitle>
section 1 contents
Invoking "make" creates the html pages in the same directory. To copy those pages to another directory, use
> export CLASSPATH_WEBROOT=...destination...
> make publish
The steps to publish the pages are:
- Update ChangeLog
- Commit your changes in module Classpath to the CVS
- cd doc/www.gnu.org
- copy the modified / new pages to the website module
- commit the changes in the website module
Note that it takes up to an hour for the pages to appear on the GNU website after an upload.
Only the proprietary VM's vendor can make it work with GNU Classpath, by the nature of the VM being proprietary. GNU Classpath provides well documented and widely used interfaces for interfacing with runtimes. It's up to proprietary VM vendors to make their products work with GNU Classpath, if they wish to do so. If you, as a customer, want the runtime to use GNU Classpath, please talk to your proprietary software vendor.
You can also try using a free runtime that supports GNU Classpath out-of-the-box instead.