--
+If you plan to modify a .java file, you will need to configure with
+--enable-java-maintainer-mode. In order to make this work properly,
+you will need to have 'ecj1' and 'gjavah' executables in your PATH at
+build time.
+
+One way to do this is to download ecj.jar (see contrib/download_ecj)
+and write a simple wrapper script like:
+
+ #! /bin/sh
+ gij -cp /home/tromey/gnu/Generics/trunk/ecj.jar \
+ org.eclipse.jdt.internal.compiler.batch.GCCMain \
+ ${1+"$@"}
+
+For gjavah, you can make a tools.zip from the classes in
+classpath/lib/tools/ and write a gjavah script like:
+
+ #! /bin/sh
+ dir=/home/tromey/gnu/Generics/Gcjh
+ gij -cp $dir/tools.zip \
+ gnu.classpath.tools.javah.Main \
+ ${1+"$@"}
+
+Another way to get a version of gjavah is to first do a
+non-maintainer-mode build and use the newly installed gjavah.
+
+--
+
libgcj uses GNU Classpath as an upstream provider. Snapshots of
Classpath are imported into the libgcj source tree. Some classes are
overridden by local versions; these files still appear in the libgcj
To import a new release:
-- Check out a classpath snapshot
+- Check out a classpath snapshot or take a release tar.gz file.
I use 'cvs export' for this. Make a tag to ensure future hackers
know exactly what revision was checked out; tags are of the form
- 'libgcj-import-DATE'.
+ 'libgcj-import-DATE' (when using a tagged checkout do:
+ - ./autogen.sh && ./configure && make dist
+ to get a proper .tar.gz for importing below).
+- Get a svn checkout of
+ svn+ssh://gcc.gnu.org/svn/gcc/branches/CLASSPATH/libjava/classpath
+ this contains "pure" GNU Classpath inside the GCC tree.
+- Clean it up and get the files from a new version:
+ - find classpath -type f | grep -v /\.svn | grep -v /\.cvs | xargs rm
+ - tar zxf classpath-x.tar.gz
+ - cp -r classpath-x/* classpath
+- Add/Remove files:
+ - svn status classpath | grep ^\! | cut -c8- | xargs svn remove
+ - svn status classpath | grep ^\? | cut -c8- | xargs svn add
+- If there are any empty directories now they can be removed. You can find
+ candidates (dirs with files removed) with:
+ - for i in `svn status classpath | grep ^D | cut -c8-`; \
+ do ls -d `dirname $i`; done | uniq
+- Update vendor branch
+ - svn commit classpath
+- Note the new revision number (Xrev)
+- Get a fresh svn trunk checkout and cd gcc/libjava
+- Merge the changes between classpath versions into the trunk.
+ svn merge -rXrev-1:Xrev \
+ svn+ssh://gcc.gnu.org/svn/gcc/branches/CLASSPATH/libjava/classpath \
+ classpath
+- Resolve any conflicts pointed out by svn status classpath | grep ^C
+ - Makefile.in files will be regenerated in the next step.
+ - Other files should have a "GCJ LOCAL" comment, and/or are mentioned
+ in the classpath/ChangeLog.gcj file.
+ (Don't forget to svn resolved files.)
- Use auto* to create configure, Makefile.in, etc
+ Make sure you have Automake 1.9.6 installed. Exactly that version!
You have to make sure to use the gcc libtool.m4 and gcc lt* scripts
cd .../classpath
cp ../../lt* .
cp ../../config.sub ../../config.guess .
- aclocal -I m4 -I ../..
+ aclocal -I m4 -I ../.. -I ../../config
autoconf
autoheader
automake
rm -rf autom4te.cache
-- Test everything first. The simplest way to do this is by overlaying
- the checked out classpath on your gcc tree and then doing a build.
-- Use 'cvs import' to import. The vendor tag is 'CLASSPATH'. For the
- release tag, if this is a released classpath version, use something
- like 'classpath-import-VERSION'; otherwise something like
- 'classpath-import-DATE'.
- Be sure to use -ko and -I\!
-- Remove any files that were deleted in Classpath
-- Run 'scripts/makemake.tcl > sources.am' in the source tree
-- Run automake for libgcj
+ cd ..
+ scripts/makemake.tcl > sources.am
+ automake
+- Build, fix, till everything works.
+ Be sure to update gnu/classpath/Configuration.java to reflect
+ the new version
+ Possibly update the gcj/javaprims.h file with scripts/classes.pl
+ (See below, it can only be done after the first source->bytecode
+ pass has finished.)
+ You will need to configure with --enable-maintainer-mode and you
+ will need to update the .class files and generated CNI header files in
+ your working tree
Over time we plan to remove as many of the remaining divergences as
possible.
In general you should not make any changes in the classpath/
directory. Changes here should come via imports from upstream.
-However, there are two (known) exceptions to this rule:
+However, there are three (known) exceptions to this rule:
* In an emergency, such as a bootstrap breakage, it is ok to commit a
patch provided that the problem is resolved (by fixing a compiler
* On a release branch to fix a bug, where a full-scale import of
Classpath is not advisable.
+* We maintain a fair number of divergences in the build system.
+ This is a pain but they don't seem suitable for upstream.
+
--
You can develop in a GCC tree using a CVS checkout of Classpath, most
at that point. This must be run from the build tree, in
<build>/classpath/lib; it uses the .class file name to determine
what to print.
-
-If you're generating a patch there is a program you can get to do an
-offline `cvs add' (it will fake an `add' if you don't have write
-permission yet). Then you can use `cvs diff -N' to generate the
-patch. See http://www.red-bean.com/cvsutils/