--- gforth/INSTALL	2002/03/13 16:59:12	1.31
+++ gforth/INSTALL	2007/12/31 17:34:58	1.38
@@ -1,5 +1,28 @@
+Copyright (C) 2003,2007 Free Software Foundation, Inc.
+This file is free documentation; the Free Software Foundation gives
+unlimited permission to copy, distribute and modify it.
+
+
+		Prerequisites
+
 You need gcc version 2.0 or later to compile gforth.
 
+For the (documented) libcc.fs C interface you need a C compiler at
+run-time.
+
+For the (undocumented ) lib.fs C interface you need to install either
+the ffcall libraries or the libffi library.  Libffi comes with recent
+gccs, ffcall can be found on
+
+   ftp://ftp.santafe.edu/pub/gnu/ffcall-1.8.tar.gz (USA) 
+   ftp://ftp.ilog.fr/pub/Users/haible/gnu/ffcall-1.8.tar.gz (Europe) 
+
+On many architectures (exceptions: 386, PPC, MIPS, Alpha) you need gdb
+at run-time in order for the disassembler to work.
+
+
+		Building and Installing
+
 First, type
 
 ./configure
@@ -24,9 +47,6 @@ If everything is all right, you may want
 
 make install
 
-You have to make an entry in the info directory file manually (see
-Installing Info Files, below).
-
 For paper documentation, print gforth.ps (a Postscript file (300dpi
 fonts, i.e., it works, but does not produce best quality on better
 printers)), or say
@@ -71,16 +91,6 @@ configure has the following useful param
                           the machine.h file. This can cause a good speedup,
                           but also incorrect code with some gcc versions on
                           some processors (default disabled).
-  --enable-direct-threaded      Force direct threading. This may not work on
-                                some machines and may cause slowdown on others.
-                                (default processor-dependent)
-  --enable-indirect-threaded    Force indirect threading. This can cause a
-                                slowdown on some machines.
-                                (default processor-dependent)
-  --with-debug     specifies option -g to compile with debug info (default)
-  --without-debug  omits the -g switch and creates smaller images on
-                   machines where strip has problems with gcc style
-                   debugging informations.
   --help: tells you about other parameters.
 
 The file Benchres shows which combination of the -enable options we
@@ -96,18 +106,18 @@ hierarchy, say
 Moreover, if your GCC is not called gcc (but, e.g., gcc-2.7.1), you
 should say so during configuration. E.g.:
 
-env CC=gcc-2.7.1 ./configure
+./configure CC=gcc-2.7.1
 
 You can also pass additional options to gcc in this way, e.g., if you
 want to generate an a.out executable under Linux with gcc-2.7.0:
 
-env "CC=gcc -b i486-linuxaout -V 2.7.0" ./configure
+./configure CC="gcc -b i486-linuxaout -V 2.7.0"
 
 You can change the sizes of the various areas used in the default
 image `gforth.fi' by passing the appropriate Gforth command line
 options in the FORTHSIZES environment variable:
 
-env "FORTHSIZES=--dictionary-size=256k --data-stack-size=16k --fp-stack-size=15872b --return-stack-size=15k --locals-stack-size=14848b" ./configure
+./configure "FORTHSIZES=--dictionary-size=256k --data-stack-size=16k --fp-stack-size=15872b --return-stack-size=15k --locals-stack-size=14848b"
 
 The line above reaffirms the default sizes. Note that the locals
 stack area is also used as input buffer stack.
@@ -116,7 +126,7 @@ If C's "long long" do not work properly
 tests involving double-cell numbers fail), you can build Gforth such
 that it does not use "long long":
 
-env ac_cv_sizeof_long_long=0 ./configure
+./configure ac_cv_sizeof_long_long=0
 
 
 			Cross-Installation
@@ -127,13 +137,18 @@ You need a cross-compilation toolchain f
 The first step in cross-installation is the cross-configuration.  A
 few tests made by the configure script do not work in a
 cross-compilation situation. You have to provide the results of these
-tests by hand. E.g., if you compile for a 386 architecture processor:
+tests by hand. E.g., if you compile for an ARM:
 
-env ac_cv_sizeof_char_p=4 ac_cv_sizeof_char=1 ac_cv_sizeof_short=2 ac_cv_sizeof_int=4 ac_cv_sizeof_long=4 ac_cv_sizeof_long_long=8 ac_cv_c_bigendian=no ./configure
+env skipcode=".skip 16" ac_cv_sizeof_char_p=4 ac_cv_sizeof_char=1 \
+ac_cv_sizeof_short=2 ac_cv_sizeof_int=4 ac_cv_sizeof_long=4 \
+ac_cv_sizeof_long_long=8 ac_cv_sizeof_intptr_t=4 ac_cv_sizeof_int128_t=0 \
+ac_cv_c_bigendian=no ./configure CC=arm-elf-gcc --host=arm-linux
 
 The ac_cv_sizeof_... variables give the sizes of various C types;
 ac_cv_sizeof_char_p is the same as "sizeof(char*)" in C code. The
-ac_cv_c_bigendian variable gives the byte order.
+ac_cv_c_bigendian variable gives the byte order.  The skipcode
+specifies how to skip 16 bytes in the code (use "skipcode=no" to
+disable skipping and dynamic native code generation).
 
 After the cross-configuration you type
 
@@ -221,4 +236,3 @@ INFOPATH=/usr/local/info:/usr/info
 2. Create a file called 'dir' in 'usr/local/info'. Use the file
 '/usr/info/dir' as a template. You can add the line for gforth
 manually, or use '/sbin/install-info' (man install-info for details).
-