aboutsummaryrefslogtreecommitdiff
path: root/libjava
diff options
context:
space:
mode:
authorMark Wielaard <mark@klomp.org>2001-02-17 14:24:41 +0000
committerMark Wielaard <mark@gcc.gnu.org>2001-02-17 14:24:41 +0000
commita7e96ed41a2e1a7878d41e74579ab1b76fa4fbe3 (patch)
treeaf373c633f6c47e41a2f3d7d8d5e1acfed7b891a /libjava
parentf74fd2bbc16d7e25f86390b9a9728fcc4e30cb29 (diff)
downloadgcc-a7e96ed41a2e1a7878d41e74579ab1b76fa4fbe3.zip
gcc-a7e96ed41a2e1a7878d41e74579ab1b76fa4fbe3.tar.gz
gcc-a7e96ed41a2e1a7878d41e74579ab1b76fa4fbe3.tar.bz2
* HACKING: new file
From-SVN: r39799
Diffstat (limited to 'libjava')
-rw-r--r--libjava/ChangeLog4
-rw-r--r--libjava/HACKING46
2 files changed, 50 insertions, 0 deletions
diff --git a/libjava/ChangeLog b/libjava/ChangeLog
index 6d96bd9..953f0f8 100644
--- a/libjava/ChangeLog
+++ b/libjava/ChangeLog
@@ -1,5 +1,9 @@
2001-02-17 Mark Wielaard <mark@klomp.org>
+ * HACKING: new file
+
+2001-02-17 Mark Wielaard <mark@klomp.org>
+
* java/io/DataInputStream.java: update copyright notice
* java/io/PrintWriter.java: idem
* java/io/Reader.java: idem
diff --git a/libjava/HACKING b/libjava/HACKING
new file mode 100644
index 0000000..651e1a3
--- /dev/null
+++ b/libjava/HACKING
@@ -0,0 +1,46 @@
+Things libgcj hackers should know
+---------------------------------
+
+If you want to hack on the libgcj files you need to be aware of the
+following things. There are probably lots of other things that should be
+explained in this HACKING file. Please add them if you discover them :)
+
+--
+
+A lot of the standard library files come from the GNU Classpath project.
+<http://www.gnu.org/software/classpath/>
+The libgcj and Classpath project have officially merged, but the merge
+is not yet complete. Our eventual goal is for Classpath to be an upstream
+source provider for libgcj, however it will be some time before this becomes
+reality: libgcj and Classpath have different implementations of many core
+java classes. In order to merge them, we need to select the best (most
+efficient, cleanest) implementation of each method/class/package, resolve
+any conflicts created by the merge, and test the final result.
+
+The merged files can be recognized by the standard Classpath copyright
+comments at the top of the file. If you make changes to these files then
+you should also send a patch to the classpath mailinglist.
+<http://mail.gnu.org/mailman/listinfo/classpath/>
+<mailto:classpath@gnu.org>
+
+If you merge a libgcj class with a classpath class then you must update the
+copyright notice at the top of the file so others can see that this is a
+shared libgcj/classpath file.
+
+--
+
+If you need to add new java files to libgcj then you have to edit the
+Makefile.am file in the top (libjava) directory. And run automake.
+But note the following (thanks to Bryce McKinlay):
+
+> Do you know the magic dance I have to do when adding files to Makefile.am
+> so they will appear in Makefile.in and finally in the user generated
+> Makefile?
+Yup, you need the magic libgcj automake ;-)
+
+<ftp://ftp.freesoftware.com/.0/sourceware/java/automake-gcj-1.4.tar.gz>
+
+Install that (dont worry, it should still work for other projects), add your
+files to the Makefile.am, then just type "automake" and it will regenerate the
+Makefile.in. Easy!
+