--- gforth/README 2003/08/25 16:14:25 1.55 +++ gforth/README 2008/11/01 20:59:11 1.74 @@ -3,34 +3,68 @@ language. It works nicely with the Emacs 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 performance: its -inner innerpreter 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 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 - alpha-unknown-linux-gnu - alphapca56-unknown-linux-gnu - hppa1.1-unknown-linux-gnu - hppa2.0n-hp-hpux11.00 - hppa2.0w-hp-hpux11.11 - i386-unknown-freebsd5.1 - i686-pc-cygwin - i686-pc-linux-gnu - mips-sgi-irix6.5 - mipsel-pc-linux-gnu - powerpc-apple-darwin5.4 - powerpc-unknown-linux-gnu - sparc-sun-sunos4.1.4 - sparc-unknown-linux-gnu +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: + +alpha-unknown-linux-gnu + gcc-2.95.2 19991024 (release) + gcc-2.95.4 20011002 (Debian prerelease) + gcc-3.3.6 (Debian 1:3.3.6-15) + gcc-3.4.6 (Debian 3.4.6-5) + gcc-4.1.2 20061115 (prerelease) (Debian 4.1.1-21) +armv5l-unknown-linux-gnu + gcc-3.3.6 (Debian 1:3.3.6-15) + broken: gcc-4.1.2 20061115 (prerelease) (Debian 4.1.1-21) + +i686-pc-linux-gnu + gcc-2.95.4 20011002 (Debian prerelease) + gcc-3.3.5 (Debian 1:3.3.5-13) + gcc-3.4.4 20050314 (prerelease) (Debian 3.4.3-13sarge1) +ia64-hp-hpux11.23 + broken: gcc-3.4.3 + gcc-4.1.1 +powerpc-unknown-linux-gnu + gcc-2.95.4 20011002 (Debian prerelease) + gcc-3.2.3 (Debian) + gcc-3.3.6 (Debian 1:3.3.6-15) + gcc-3.4.6 (Debian 3.4.6-8) + gcc-4.0.3 20060128 (prerelease) (Debian 4.0.2-8) + gcc-4.1.3 20080623 (prerelease) (Debian 4.1.2-23) + gcc-4.3.2 +powerpc64-unknown-linux-gnu + gcc-3.4.6 (Debian 3.4.6-5) + gcc-4.1.2 20061115 (prerelease) (Debian 4.1.1-21) +sparc-sun-solaris2.10 + gcc-3.4.3 (csl-sol210-3_4-branch+sol_rpath) + gcc-4.0.2 +x86_64-unknown-linux-gnu + gcc-3.3.6 (Debian 1:3.3.6-15) + gcc-3.4.6 (Debian 3.4.6-5) + gcc-4.0.0 + gcc-4.0.4 20060904 (prerelease) (Debian 4.0.3-7) + gcc-4.1.2 20061115 (prerelease) (Debian 4.1.1-21) + gcc-4.1.3 20080623 (prerelease) (Debian 4.1.2-23) + gcc-4.2.0 + gcc-4.2.4 (Debian 4.2.4-3) + gcc-4.3.1 +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. -Read INSTALL for installation instructions, or INSTALL.DOS for DOS, -Windows 95, and OS/2, or INSTALL.BINDIST if you have a binary package. To start the system, just say `gforth' (after installing it). You can find new versions of Gforth at ftp://ftp.gnu.org/gnu/gforth/ @@ -46,8 +80,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 +114,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 +148,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/.