--- gforth/README	1995/02/09 17:49:52	1.5
+++ gforth/README	1996/09/30 13:16:07	1.14
@@ -1,21 +1,35 @@
-This is the current state (alpha) of gforth. This is not a
-distribution for the general public, since it is not yet mature
-enough. There is no warranty of any kind; this program is
-distributed under the GNU General Public license (see COPYING).
-
-Read INSTALL for installation instructions. Mail us if you have
-problems.
-
-To start the system just say `gforth'. This gives you a pretty barren
-system. `gforth startup.fs' gives you most ANSI wordsets. If you miss
-a word, just grep for it in *.fs.
+Gforth is a fast and portable implementation of the ANS Forth
+language. It works nicely with the Emacs editor, offers some nice
+features such as input completion and history and a powerful locals
+facility, and it even has (the beginnings of) a manual. Gforth employs
+traditional implementation techniques: its inner innerpreter is
+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), Digital "Unix" (Alpha) and Ultrix
+(MIPS).
+
+Read INSTALL for installation instructions. 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 prep.ai.mit.edu and its mirrors
+or at
+
+http://www.complang.tuwien.ac.at/forth/gforth/
+or
+ftp://ftp.complang.tuwien.ac.at/pub/forth/gforth/
 
-If you want to work on gforth, mail me. Tasks to be done can be found
+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,
 it's ok, too. In any case, we would like to hear what you are
-doing. The most important tasks IMO are the missing ANS Forth words
-(musts before the alpha release), the documentation and the foreign
-language interface for C.
+doing. The most important tasks IMO are the missing ANS Forth words,
+the documentation and the foreign language interface for C.
 
 On popular request, here are the meanings of unusual file extensions:
 
@@ -26,4 +40,30 @@ On popular request, here are the meaning
 *.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
+
+Utilities:
+etags.fs glosgen.fs filedump.fs
+
+Games:
+tt.fs sokoban.fs
+
+Test programs:
+tester.fs coretest.fs
+checkans.fs wordsets.fs
+
+Benchmarks:
+bubble.fs siev.fs matrix.fs fib.fs sieve.fs
+
+ANS Forth implementations of Gforth extensions:
+compat/*.fs other.fs
+
+
 - anton
+anton@mips.complang.tuwien.ac.at
+http://www.complang.tuwien.ac.at/anton/home.html
\ No newline at end of file