--- gforth/README	1995/12/15 01:54:08	1.10
+++ gforth/README	1998/12/25 22:50:47	1.31
@@ -6,22 +6,38 @@ traditional implementation techniques: i
 indirect or direct threaded.  Gforth is distributed under the GNU
 General Public license (see COPYING).
 
-Gforth runs under Unix and DOS and should not be hard to port to other
-systems supported by GCC. This version has been tested successfully on
-Linux (for Intel), SunOS (SPARC) and Ultrix (MIPS).
+Gforth runs under Unix, Win95, OS/2, and DOS and should not be hard to
+port to other systems supported by GCC. This version has been tested
+successfully on the following platforms:
+
+i486-pc-linux-gnulibc1 (libc5)
+i586-pc-linux-gnulibc1 (libc5)
+i686-pc-linux-gnu (libc6)
+alphaev56-unknown-linux-gnulibc1
+alpha-dec-osf4.0b
+mips-sgi-irix6.2
+mips-dec-ultrix4.3
+sparc-sun-sunos4.1.4
+sparc-sun-solaris2.5.1
+powerpc-unknown-linux-gnu
+hppa1.1-hp-hpux10.20
+i386-pc-cygwin32 (CygWin32 b18, Win95)
+i386-pc-djgpp (DGJPP 2.0, MS-DOS 7.0 under Win95)
+i386-pc-os2 (OS/2 3.0, EMX 0.9c)
 
-Read INSTALL for installation instructions. Mail
-gforth-bugs@mips.complang.tuwien.ac.at if you have problems.  To start
+Read INSTALL for installation instructions, or INSTALL.DOS for DOS, Windows
+95, and OS/2. Mail bug-gforth@gnu.ai.mit.edu if you have problems.  To start
 the system, just say `gforth' (after installing it).
 
-You can find new versions of Gforth at
+You can find new versions of Gforth at prep.ai.mit.edu and its mirrors
+or at
 
-http://www.complang.tuwien.ac.at/forth
+http://www.complang.tuwien.ac.at/forth/gforth/
 or
-ftp://ftp.complang.tuwien.ac.at/pub/forth
+ftp://ftp.complang.tuwien.ac.at/pub/forth/gforth/
 
-This site will also contain binary distributions of Gforth for some
-popular platforms when it has proved stable.
+The latter site contains binary distributions of Gforth for some
+popular platforms.
 
 If you want to work on Gforth, mail me. Tasks to be done can be found
 in ToDo; but if you would like to do something not mentioned there,
@@ -31,13 +47,48 @@ the documentation and the foreign langua
 
 On popular request, here are the meanings of unusual file extensions:
 
-*.fs	Forth stream source file
-*.fi	Forth image files
-*.fb	Forth blocks file
+*.fs	Forth stream source file (include with "include <file>" from within
+        gforth, or start with "gforth <file1> <file2> ...")
+*.fi	Forth image files (start with "gforth -i <image file>")
+*.fb	Forth blocks file (load with "use <block file> 1 load")
 *.i	C include files
 *.ds	documenation source
 *TAGS	etags files
 
+A number of Forth source files are included in this package that are
+not necessary for building Gforth. Not all of them are mentioned in
+the rest of the documentation, so here's a short overview:
+
+Add-ons:
+code.fs random.fs more.fs ansi.fs colorize.fs
+oof.fs oofsampl.fs objects.fs
+
+Utilities:
+ans-report.fs etags.fs glosgen.fs filedump.fs
+
+Games:
+tt.fs sokoban.fs
+
+Test programs (for testing Forth systems):
+test/*.fs
+
+Benchmarks:
+bubble.fs siev.fs matrix.fs fib.fs
+
+ANS Forth implementations of Gforth extensions:
+compat/*.fs other.fs
+
+For discussions about Gforth, use the Usenet newsgroup
+comp.lang.forth.  If you prefer not to post on Usenet, there is also a
+mailing list: GForth@ChaosSolutions.com.  To subscribe, send a mail to
+Mdaemon@ChaosSolutions.com with:
+
+subscribe GForth
+
+as the first and only line within the message body.  Send bug reports
+to bug-gforth@gnu.ai.mit.edu (whether you post them or not).
+
+
 - anton
 anton@mips.complang.tuwien.ac.at
-http://www.complang.tuwien.ac.at/anton/home.html
\ No newline at end of file
+http://www.complang.tuwien.ac.at/anton/home.html