[gforth] / gforth / README  

gforth: gforth/README


1 : anton 1.46 This snapshot is mainly intended as a Vmgen release. The Gforth part
2 :     has known bugs, and likely has portability problems (which Vmgen
3 :     inherits, of course) on anything but 386 and Alpha platforms. A
4 :     full-blown and portable release will be released Real Soon Now:-).
5 :    
6 : anton 1.7 Gforth is a fast and portable implementation of the ANS Forth
7 : anton 1.8 language. It works nicely with the Emacs editor, offers some nice
8 : anton 1.9 features such as input completion and history and a powerful locals
9 : anton 1.43 facility, and it even has a manual. Gforth employs traditional
10 :     implementation techniques: its inner innerpreter is indirect or direct
11 :     threaded. Gforth is distributed under the GNU General Public license
12 :     (see COPYING).
13 : anton 1.8
14 : pazsan 1.31 Gforth runs under Unix, Win95, OS/2, and DOS and should not be hard to
15 :     port to other systems supported by GCC. This version has been tested
16 :     successfully on the following platforms:
17 :    
18 : anton 1.43 i686-pc-linux-gnu
19 : anton 1.22
20 : anton 1.37 Read INSTALL for installation instructions, or INSTALL.DOS for DOS,
21 : anton 1.47 Windows 95, and OS/2. To start the system, just say `gforth' (after
22 :     installing it).
23 : anton 1.10
24 : anton 1.42 You can find new versions of Gforth at ftp://ftp.gnu.org/gnu/gforth/
25 :     and its mirrors or at
26 : anton 1.10
27 : anton 1.12 http://www.complang.tuwien.ac.at/forth/gforth/
28 : anton 1.10 or
29 : anton 1.12 ftp://ftp.complang.tuwien.ac.at/pub/forth/gforth/
30 : anton 1.10
31 : anton 1.42 The latter site also contains binary distributions of Gforth for some
32 : anton 1.14 popular platforms.
33 : anton 1.1
34 : anton 1.7 If you want to work on Gforth, mail me. Tasks to be done can be found
35 :     in ToDo; but if you would like to do something not mentioned there,
36 :     it's ok, too. In any case, we would like to hear what you are
37 :     doing. The most important tasks IMO are the missing ANS Forth words,
38 :     the documentation and the foreign language interface for C.
39 : anton 1.4
40 :     On popular request, here are the meanings of unusual file extensions:
41 :    
42 : pazsan 1.25 *.fs Forth stream source file (include with "include <file>" from within
43 : anton 1.26 gforth, or start with "gforth <file1> <file2> ...")
44 : pazsan 1.25 *.fi Forth image files (start with "gforth -i <image file>")
45 :     *.fb Forth blocks file (load with "use <block file> 1 load")
46 : anton 1.4 *.i C include files
47 :     *.ds documenation source
48 :     *TAGS etags files
49 : anton 1.1
50 : anton 1.11 A number of Forth source files are included in this package that are
51 :     not necessary for building Gforth. Not all of them are mentioned in
52 :     the rest of the documentation, so here's a short overview:
53 :    
54 :     Add-ons:
55 :     code.fs random.fs more.fs ansi.fs colorize.fs
56 : crook 1.36 oof.fs oofsampl.fs objects.fs blocked.fb tasker.fs
57 : anton 1.11
58 :     Utilities:
59 : anton 1.19 ans-report.fs etags.fs glosgen.fs filedump.fs
60 : anton 1.11
61 :     Games:
62 :     tt.fs sokoban.fs
63 :    
64 : anton 1.19 Test programs (for testing Forth systems):
65 : anton 1.29 test/*.fs
66 : anton 1.11
67 :     Benchmarks:
68 : anton 1.24 bubble.fs siev.fs matrix.fs fib.fs
69 : anton 1.11
70 :     ANS Forth implementations of Gforth extensions:
71 : anton 1.12 compat/*.fs other.fs
72 : pazsan 1.27
73 : anton 1.30 For discussions about Gforth, use the Usenet newsgroup
74 :     comp.lang.forth. If you prefer not to post on Usenet, there is also a
75 : anton 1.41 mailing list: GForth@ChaosSolutions.org. To subscribe, send a mail to
76 : anton 1.45 gforth-subscribe@chaossolutions.org@ChaosSolutions.org with:
77 : pazsan 1.27
78 :     subscribe GForth
79 :    
80 : anton 1.47 as the first and only line within the message body. Submit bug
81 :     reports through
82 : anton 1.11
83 : anton 1.47 https://savannah.gnu.org/bugs/?func=addbug&group=gforth
84 :    
85 :     (whether you post them or not).
86 : anton 1.11
87 : anton 1.1 - anton
88 : anton 1.6 anton@mips.complang.tuwien.ac.at
89 : pazsan 1.18 http://www.complang.tuwien.ac.at/anton/home.html

CVS Admin

Powered by ViewCVS 1.0-dev
(Powered by ViewCVS)

ViewCVS and CVS Help