Since Build 8, we have made several important changes to the build
process. Please read the follow instructions carefully so that you
will be able to make the most use from the improvements.

To get the best array of usage from Retro, you'll have to recompile it.
This process is not difficult (it's pretty painless now), so here's a
quick guide.


Initial step: make sure you have NASM, SED, CAT, GUNZIP, TAR, GREP,
(and possibly WGET) installed. You may also need BASH.

First you need to download and unpack the base package. If you're
reading this, you probably already have.

Second, edit the CONFIG file to select the optional components you
wish to use. You can download the latest set of optional components
by running '. fetch; . update' at a shell prompt in the optional/
directory.

Third, at a shell prompt in retro6/, run '. abuild'. At the end of
this program, you will have a compiled version of RetroForth will
all options you have chosen. The binaries are in source/images.



If you are using the native version, you'll also want to make a boot
disk. Here's how:

After compiling RetroForth, switch to the source/images directory. At
a shell prompt, type 'dd if=fat12 of=/dev/fd0'. Make sure you have a
FAT-formatted floppy in the drive! Then mount this disk image 'mount
/dev/fd0' and 'cp retro.com /floppy'. Finally, 'umount /dev/fd0' and
reboot from the floppy. Have fun!


DOS/Windows users:
  Sorry, but the build system now runs only on Linux. Precompiled
  binaries will be posted online at http://retro.tunes.org/pub/bin.zip

  Windows users can build the system using CYGWIN. See the notes
  on which files you need at a minimum.

Problems compiling?
  Use the most recent version of NASM. Older releases (without %xdefine)
  will choke and die on the source code.

  You may need to use the BASH shell. I havn't tested it with other
  shells.

  I'm working on a small (one floppy) Linux with the needed tools
  for development. It'll be useful for those who can't install Linux
  for various reasons. It'll have the source too :)
