--- gforth/README 2003/03/09 17:16:38 1.51 +++ gforth/README 2008/10/23 14:21:25 1.73 @@ -1,37 +1,32 @@ -This snapshot has been tested quite well for portability. The main -thing missing before the release is an update to the documentation. - 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 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: - -alpha-dec-osf4.0d -alphapca56-unknown-linux-gnu -alpha-unknown-linux-gnu -hppa1.1-unknown-linux-gnu -hppa2.0w-hp-hpux11.11 -i386-unknown-freebsd5.0 -i486-pc-linux-gnulibc1 -i686-pc-cygwin -i686-pc-linux-gnu -mips-dec-ultrix4.3 -mipsel-pc-linux-gnu -mips-sgi-irix6.5 -powerpc-apple-darwin5.4 -powerpc-unknown-linux-gnu -sparc-sun-solaris2.7 - -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). +features such as input completion and history, backtraces, a +decompiler and a powerful locals facility, and it even has a +manual. Gforth combines traditional implementation techniques with +newer techniques for portability and performance: its inner +interpreter is direct threaded with several optimizations, but you can +also use a traditional-style indirect threaded interpreter. Gforth is +distributed under the GNU General Public license (see COPYING). + +Gforth runs under GNU, BSD, and similar systems, MS Windows, MacOS X, +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: + + i386-unknown-linux-gnu + x86_64-unknown-linux-gnu + i386-apple-darwin9.4.0 + x86_64-apple-darwin9.4.0 + ppc-apple-darwin9.4.0 + i686-pc-cygwin + gforth-ec: r8c, 4stack, misc, 8086 + +Read INSTALL for installation instructions from source, or INSTALL.DOS +for DOS, Windows, and OS/2 from source, or INSTALL.BINDIST if you have +a binary package distributed as .tar.gz or .zip file. If you received +a self-installing executable, just run it and follow the instructions. + +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 @@ -46,8 +41,8 @@ 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. +doing. The most important task IMO is the foreign language interface +for C. On popular request, here are the meanings of unusual file extensions: @@ -80,33 +75,32 @@ Benchmarks: bubble.fs siev.fs matrix.fs fib.fs ANS Forth implementations of Gforth extensions: -compat/*.fs other.fs +compat/*.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: +gforth-subscribe@chaossolutions.org with: subscribe GForth -as the first and only line within the message body. Submit bug -reports through +as the first and only line within the message body. You can also +report bugs through these channels, or you can report them through our +bug database: 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 ----- -Copyright (C) 1995,1996,1997,1998,2000,2003 Free Software Foundation, Inc. +Copyright (C) 1995,1996,1997,1998,2000,2003,2004,2006,2007 Free Software Foundation, Inc. This file is part of Gforth. Gforth is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License -as published by the Free Software Foundation; either version 2 +as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, @@ -115,5 +109,4 @@ MERCHANTABILITY or FITNESS FOR A PARTICU GNU General Public License for more details. You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA. +along with this program. If not, see http://www.gnu.org/licenses/.