RetroForth 6.25                                                          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
-------------------------------------------------------------------------------
* FreeBSD port
* Reorganized directory structure
* Improved Makefiles
  * Easy configuration
  * Easy to add new ports
* Bugfixes
  * .s
  * depth
* New Forth Core Structure
      FILE                  USE
    -----------------------------------------------
  * forth.asm		Forth Primitives
  * forth.dict		Forth Dictionary (For NASM)
  * forth.f		Extended Forth Wordset
    -----------------------------------------------
  * Eliminated runtime assembly words
* Two methods of dictionary management
  * Use code/mcode/dcode
  * Simplified form using "e" and forth.dict
  * Simpler model used with NASM, old model used with FASM by default


Section 2: Building the images
-------------------------------------------------------------------------------
Tools used to build:
  * NASM 0.98.38 (or another version with %xdefine)
  * FASM 1.52 (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.25.tar.gz

Then enter the directory and type 'make'

     bash# cd retroforth
     bash# make


Section 3: Notes, comments, bugs
-------------------------------------------------------------------------------
