--- gforth/INSTALL	2003/03/09 12:54:31	1.33
+++ gforth/INSTALL	2008/07/26 20:57:05	1.39
@@ -1,9 +1,28 @@
-Copyright (C) 2003 Free Software Foundation, Inc.
+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
@@ -14,7 +33,8 @@ After configuration, type
 
 make
 
-Now you can check whether your shiny new Forth system works. Say
+This includes a check whether your shiny new Forth system works. If
+you like to invoke the check alone, do
 
 make check
 
@@ -28,9 +48,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
@@ -90,18 +107,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.
@@ -110,7 +127,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
@@ -121,13 +138,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_sizeof_intptr_t=4 ac_cv_sizeof_int128_t=0 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
 
@@ -215,4 +237,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).
-