File:  [gforth] / gforth / README
Revision 1.13: download - view: text, annotated - select for diffs
Wed Aug 21 14:58:37 1996 UTC (27 years, 8 months ago) by anton
Branches: MAIN
CVS tags: HEAD
a little cleanup in 386.h
renamed special: to interpret/compile:
renamed save-string to save-mem
added extend-mem
replaced (name>) with ((name>))
replaced name> with name>int and name>comp
renamed compile-only to compile-only-error
replaced xt>i with name>int
replaced xt>c with name>comp
removed xt>s
removed found
search-wordlist now delivers interpretation-xt
replaced (sfind) with find-name
replaced C' with COMP' and [C'] with [COMP']
removed S' and [S']
added hex.
added some helper words
adapted other words to the changes
started documenting the intergration of Gforth in applications

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) 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/

This 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,
the documentation and the foreign language interface for C.

On popular request, here are the meanings of unusual file extensions:

*.fs	Forth stream source file
*.fi	Forth image files
*.fb	Forth blocks file
*.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

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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>