Patch: FYI: update HACKING
Tom Tromey
tromey@redhat.com
Wed Jan 10 23:44:00 GMT 2007
I'm checking this in.
This updates HACKING a bit to reflect the new reality.
Tom
Index: ChangeLog
from Tom Tromey <tromey@redhat.com>
* HACKING: Various updates.
Index: HACKING
===================================================================
--- HACKING (revision 120646)
+++ HACKING (working copy)
@@ -7,6 +7,33 @@
--
+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
@@ -81,7 +108,7 @@
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
@@ -91,6 +118,9 @@
* 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
@@ -129,8 +159,3 @@
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/
More information about the Java-patches
mailing list