Sin Forth   README

Description

Sin Forth is a Forth cross compiler under development, written in Forth with Gforth.

Sin Forth creates machine code programs for any model of the ZX Spectrum, ZX Spectrum 128 and compatible computers, including the ZX Spectrum Next.

Author’s website: http://programandala.net.

Installation

In order to use Sin Forth, its sources must be accessible from Gforth.

One method is to add the Sin Forth’s <src> directory to Gforth’s fpath. Consult the documentation of Gforth.

A second method is to make a symbolic link to Sin Forth’s <src> directory from Gforth’s <site-forth> directory. In a locally compiled Gforth, the command on a Linux shell would be the following:

sudo ln -s ~/YOUR-PATH/src/ /usr/local/share/gforth/site-forth/sin_forth

where "YOUR-PATH" must be replaced with the corresponding path to Sin Forth’s <src> directory on your system.

Requirements

Sin Forth uses some modules of the Galope library.

Some modules of Galope need modules of the Forth Foundation Library.

Project directories

doc

Manuals in EPUB, HTML and PDF

doc/www

Online documentation for the Fossil repository

src

Compiler sources

src/doc

Documentation sources

src/lib

Library sources

src/tests

Tests sources

target

Compiled and disassembled tests

tmp

Temporary files created by make