RetroForth 6.24                                                          README
-------------------------------------------------------------------------------
RetroForth is a public domain Forth system modeled after CMForth,
ColorForth, eForth, and Pygmy. It uses some, but not all, of Chuck
Moore's newer ideas. The source code is clean, elegant, and
tiny. It's easy to learn, use, and port to new platforms.


Section 1: What's New
-------------------------------------------------------------------------------
* "domain" dictionary for application specific words
  * dcode macro for primitives
  * Use the 'domain' word to select at runtime
  * Selected by default at the end of forth.f
* windows-console changes
  * Application title now set to display "RetroForth" on startup
  * Optional extended drivers.asm for windows-console
    * SetTitle
    * MessageBox
    * WinExec
    * load
    * save
* Cleanups to the forth core
  * Moved >R R> R@ into forth.f
  * Removed redundant code
  * More consistant formatting
* Makefile
  * 'make dist' option
  * 'dist-clean'  -->  'purge'
* Other changes
  * Extended wordset in extend.f


Section 2: Building the images
-------------------------------------------------------------------------------
Tools used to build:
  * NASM 0.98.38 (or another version with %xdefine)
  * FASM 1.50 (other versions not tested)
  * GCC+BINUTILS (for linking with C libraries)
  * Make

Minimal tools required:
  * NASM + LD  (or)
  * FASM

As normal, gunzip and detar the source package.

     bash# tar xzf retroforth-6.24.tar.gz

Then enter the directory and type 'make'

     bash# cd retroforth
     bash# make

Check ERRORLOG to see if any problems were encountered during the
build. The "clean" function is now invoked at the end of each build 
cycle. To remove all binaries and temporary files, do a 'make purge'


Section 3: Notes, comments, bugs
-------------------------------------------------------------------------------
To try the new, extended drivers for Windows-console, do the following at a
shell:

     cd retroforth
     cp optional/windows-console-drivers.asm ports/windows-console/drivers.asm
     make

If you are a Windows developer, these few additions are very useful.
