--- gforth/README	1995/11/24 18:05:32	1.7
+++ gforth/README	2002/12/27 12:32:52	1.47
@@ -1,14 +1,35 @@
+This snapshot is mainly intended as a Vmgen release.  The Gforth part
+has known bugs, and likely has portability problems (which Vmgen
+inherits, of course) on anything but 386 and Alpha platforms.  A
+full-blown and portable release will be released Real Soon Now:-).
+
 Gforth is a fast and portable implementation of the ANS Forth
-language. This represents the present state of the Gforth project
-whose goal is the development of a standard implementation model for
-ANS Forth. Gforth supports indirect threading on every machine
-supported by GCC, and direct threading on several popular
-architectures. Gforth is distributed under the GNU General Public
-license (see COPYING).
-
-Read INSTALL for installation instructions. Mail
-gforth-bugs@mips.complang.tuwien.ac.at if you have problems.  To start
-the system, just say `gforth' (after installing it).
+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 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, 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:
+
+i686-pc-linux-gnu
+
+Read INSTALL for installation instructions, or INSTALL.DOS for DOS,
+Windows 95, and OS/2.  To start the system, just say `gforth' (after
+installing it).
+
+You can find new versions of Gforth at ftp://ftp.gnu.org/gnu/gforth/
+and its mirrors or at
+
+http://www.complang.tuwien.ac.at/forth/gforth/
+or
+ftp://ftp.complang.tuwien.ac.at/pub/forth/gforth/
+
+The latter site also 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,
@@ -18,13 +39,51 @@ 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 blocked.fb tasker.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.org.  To subscribe, send a mail to
+gforth-subscribe@chaossolutions.org@ChaosSolutions.org with:
+
+subscribe GForth
+
+as the first and only line within the message body.  Submit bug
+reports through
+
+https://savannah.gnu.org/bugs/?func=addbug&group=gforth
+
+(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