split-for-gcj.sh

[Andrew Haley <aph at redhat dot com>]

I'm trying to make the comments in this file slightly less opaque.

Andrew.


Index: split-for-gcj.sh
===================================================================
RCS file: /cvs/gcc/gcc/libjava/classpath/lib/split-for-gcj.sh,v
retrieving revision 1.1.1.1
diff -u -r1.1.1.1 split-for-gcj.sh
--- split-for-gcj.sh	16 Jul 2005 00:33:25 -0000	1.1.1.1
+++ split-for-gcj.sh	10 Aug 2005 16:35:44 -0000
@@ -1,7 +1,26 @@
 #! /bin/sh
 
-# Split in multiple parts for gcj.  This uses a somewhat hacky
-# procedure for finding the package of a given file.
+# We build java->class by package so we need to know what .java files
+# correspond to what package.
+
+# We have a .stamp file for each package; this is the makefile target.
+# We also have a .list file for each package, which lists all the
+# input files in that package.
+
+# gen-classlist.sh makes a list of all the .java files we are going to compile.
+
+# This script generates Makefile.deps, which looks like this:
+# 
+# java/awt/AWTUtilities.class: lists/java-awt.stamp
+# lists/java-awt.list: /home/aph/gcc/gcc/libjava/classpath/gnu/java/awt/AWTUtilities.java
+# java/awt/BitMaskExtent.class: lists/java-awt.stamp
+# lists/java-awt.list: /home/aph/gcc/gcc/libjava/classpath/gnu/java/awt/BitMaskExtent.java
+# java/awt/BitwiseXORComposite.class: lists/java-awt.stamp
+# lists/java-awt.list: /home/aph/gcc/gcc/libjava/classpath/gnu/java/awt/BitwiseXORComposite.java
+
+# This uses a somewhat hacky procedure for finding the package of a
+# given file.
+
 echo "Splitting for gcj"
 rm -f Makefile.deps > /dev/null 2>&1
 test -d lists || mkdir lists