Welcome to Retro
----------------
This is a small dialect of Forth. It's minimalistic (but not
barebones!) in nature, and is designed to be easy to learn and
customize for specific needs.

To get started using Retro, you should first build Ngaro (the
virtual machine) and a new image file ("retroImage"). For most
users, the following will suffice:

  make

The build process assumes a Unix-like environment with GCC and
Make. Windows users can download precompiled binaries at
http://retroforth.org/retro4win.zip


Architecture
------------
Retro is split into two parts. The first is a virtual machine
providing an emulator for a MISC processor and basic I/O devices.
The other is a portable image file containing the actual Retro
language.

The image file ("retroImage") is a raw memory image for the
virtual machine. The same image file can be used with all
implementations of the virtual machine.

The VM (called Ngaro) is built for each host system. There
are implementations in many languages (C, C#, J2ME, Go, Emacs
Lisp, JavaScript) allowing Retro to run on most of the operating
systems in use today.


Documentation
-------------
The documentation is currently contained in the various
subdirectories. Most of it is in a wiki format.