		VNPForth Forth compiler and runtime, version 1.1
		------------------------------------------------

About the source
----------------
The source code for VNPForth comes with a 'configure' file, whose job
it is to try and decide which features your system offers, and then
configure VNPForth the best way it can for these features.

Since VNPForth is really not portable in any sense (it will work only
on IA32 Linux systems), there is in fact not much that the configure
script can or will do.  Its only real function for VNPForth is to make
sure that the various tools and libraries (for example, Flex and
Bison) are installed on the system being used for building.

VNPForth will not port to other platforms without a considerable
amount of effort.  In particular, it makes direct system calls to the
kernel, bypassing libc, and so requires a Linux 2.2, 2.4, or later
kernel on the system.  The compiler generates IA32 assembler, and
portions of the runtime library are also written in IA32 assembler,
so only Intel-based Linux systems will run VNPForth.


Building VNPForth
-----------------

To build the compiler and Forth runtime libraries, you should be able
to type the following commands in the directory where you unpacked the
source code:

    ./configure
    make all

'configure' will tell you of any problems with missing features on
your system.


Installing the library, man pages, and programs
-----------------------------------------------
Assuming the 'make all' succeeded, you can now install the programs
with

    make install

By default, this will install everything under /usr/local.  You would
probably want to be 'root' to do this, otherwise you may not have the
necessary system permissions.

Note that it is not necessary to install the programs in order to run
them.  You should be able to run any of them in the directories in
which they built themselves.


Uninstalling VNPForth
---------------------

To uninstall the programs, use

    make uninstall

with the same user/permissions as you used for installing.  To clean
out the directory for a rebuild, use

    make distclean

If you have autoconf installed on your system, you can regenerate the
configure file, if you like, from configure.in, with

    make maintainer-clean
    autoconf
