diff --git a/libjava/ChangeLog b/libjava/ChangeLog
index fc5d54827d81eec531098b4348e710d045c0832f..a8d8c3065014b9cd19f6c306155934c0d8dd3a38 100644
--- a/libjava/ChangeLog
+++ b/libjava/ChangeLog
@@ -1,3 +1,7 @@
+1999-09-29  Bryce McKinlay  <bryce@albatross.co.nz>
+
+	* README: New file.
+
 1999-09-28  Tom Tromey  <tromey@cygnus.com>
 
 	* configure: Rebuilt.
diff --git a/libjava/README b/libjava/README
new file mode 100644
index 0000000000000000000000000000000000000000..d3fa1565045c4b2942398ed0dfd68ead1254385e
--- /dev/null
+++ b/libjava/README
@@ -0,0 +1,47 @@
+This is libgcj: the runtime library for gcj, the GNU Compiler for Java. 
+libgcj provides a partial implementation of the Java Class Libraries.
+
+libgcj is free software.  See the file COPYING.LIB for copying permission.
+
+
+DOCUMENTATION
+=============
+
+All documentation, including detailed installation and usage instructions,
+can be found on the gcj web pages at the following URL:
+
+		http://sourceware.cygnus.com/java/
+
+
+QUICK INSTALLATION
+==================
+
+  > mkdir build
+  > cd build
+  > ../libgcj/configure --enable-java-gc=<GC TYPE> \
+    --enable-threads=<THREADS TYPE>
+  > make
+  > make install
+
+where:
+
+<GC TYPE> specifies the Garbage Collection library to be used by libgcj. 
+Currently the only supported value is "boehm".
+
+<THREADS TYPE> specifies the threads library to be used by libgcj. Currently 
+the possible values are "posix" and "none". This value must be the same as
+the value used when configuring gcc itself.
+
+Consult the gcj web pages for additional "configure" arguments.
+
+NOTE: libgcj can not be configured/built in the source directory. You must
+create a separate build directory. 
+
+
+BUGS
+====
+
+Please submit bug reports to the following URL:
+
+	http://sourceware.cygnus.com/cgi-bin/gnatsweb.pl?database=java
+