File:  [gforth] / gforth / README
Revision 1.36: download - view: text, annotated - select for diffs
Thu May 6 21:33:32 1999 UTC (21 years, 5 months ago) by crook
Branches: MAIN
CVS tags: HEAD
Major re-write of manual sections concerning text interpreter and
defining words. Much fine-tuning of other sections. The manual is
``nearly finished'' -- at least, all the major pieces of work that
I envisaged for the first mods (which were only going to take a
couple of weeks...). The manual has grown from 127 pages to 192
which is good news in terms of content but bad news in terms of the
time it takes to print out on my HP550C DeskJet.

Other changes are just tweaks to glossary entries.

    1: Gforth is a fast and portable implementation of the ANS Forth
    2: language. It works nicely with the Emacs editor, offers some nice
    3: features such as input completion and history and a powerful locals
    4: facility, and it even has (the beginnings of) a manual. Gforth employs
    5: traditional implementation techniques: its inner innerpreter is
    6: indirect or direct threaded.  Gforth is distributed under the GNU
    7: General Public license (see COPYING).
    8: 
    9: Gforth runs under Unix, Win95, OS/2, and DOS and should not be hard to
   10: port to other systems supported by GCC. This version has been tested
   11: successfully on the following platforms:
   12: 
   13: checking host system type... alpha-dec-osf4.0b
   14: checking host system type... alphaev56-unknown-linux-gnu
   15: checking host system type... hppa1.1-hp-hpux10.20
   16: checking host system type... i486-pc-linux-gnulibc1
   17: checking host system type... i686-pc-linux-gnu
   18: checking host system type... mips-dec-ultrix4.3
   19: checking host system type... mips-sgi-irix6.2
   20: checking host system type... powerpc-unknown-linux-gnu
   21: checking host system type... sparc-sun-solaris2.5.1
   22: checking host system type... sparc-sun-sunos4.1.4
   23: 
   24: Read INSTALL for installation instructions, or INSTALL.DOS for DOS, Windows
   25: 95, and OS/2. Mail bug-gforth@gnu.ai.mit.edu if you have problems.  To start
   26: the system, just say `gforth' (after installing it).
   27: 
   28: You can find new versions of Gforth at prep.ai.mit.edu and its mirrors
   29: or at
   30: 
   31: http://www.complang.tuwien.ac.at/forth/gforth/
   32: or
   33: ftp://ftp.complang.tuwien.ac.at/pub/forth/gforth/
   34: 
   35: The latter site contains binary distributions of Gforth for some
   36: popular platforms.
   37: 
   38: If you want to work on Gforth, mail me. Tasks to be done can be found
   39: in ToDo; but if you would like to do something not mentioned there,
   40: it's ok, too. In any case, we would like to hear what you are
   41: doing. The most important tasks IMO are the missing ANS Forth words,
   42: the documentation and the foreign language interface for C.
   43: 
   44: On popular request, here are the meanings of unusual file extensions:
   45: 
   46: *.fs	Forth stream source file (include with "include <file>" from within
   47:         gforth, or start with "gforth <file1> <file2> ...")
   48: *.fi	Forth image files (start with "gforth -i <image file>")
   49: *.fb	Forth blocks file (load with "use <block file> 1 load")
   50: *.i	C include files
   51: *.ds	documenation source
   52: *TAGS	etags files
   53: 
   54: A number of Forth source files are included in this package that are
   55: not necessary for building Gforth. Not all of them are mentioned in
   56: the rest of the documentation, so here's a short overview:
   57: 
   58: Add-ons:
   59: code.fs random.fs more.fs ansi.fs colorize.fs
   60: oof.fs oofsampl.fs objects.fs blocked.fb tasker.fs
   61: 
   62: Utilities:
   63: ans-report.fs etags.fs glosgen.fs filedump.fs
   64: 
   65: Games:
   66: tt.fs sokoban.fs
   67: 
   68: Test programs (for testing Forth systems):
   69: test/*.fs
   70: 
   71: Benchmarks:
   72: bubble.fs siev.fs matrix.fs fib.fs
   73: 
   74: ANS Forth implementations of Gforth extensions:
   75: compat/*.fs other.fs
   76: 
   77: For discussions about Gforth, use the Usenet newsgroup
   78: comp.lang.forth.  If you prefer not to post on Usenet, there is also a
   79: mailing list: GForth@ChaosSolutions.com.  To subscribe, send a mail to
   80: MDaemon@ChaosSolutions.com with:
   81: 
   82: subscribe GForth
   83: 
   84: as the first and only line within the message body.  Send bug reports
   85: to bug-gforth@gnu.ai.mit.edu (whether you post them or not).
   86: 
   87: 
   88: - anton
   89: anton@mips.complang.tuwien.ac.at
   90: http://www.complang.tuwien.ac.at/anton/home.html

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