About

SP-Forth/4 is a highly extended, 32bit, Forth-94 compatible Forth system. It generates optimized IA-32 (i686) native code for Windows and Linux platforms.

Key features

• Access external functions from DLL and SO libraries.
• Create callbacks that can be called from external functions.
• Handle SEH exceptions and Signals by automatically converting them to exceptions in Forth (catchable by CATCH).
• Provide Forth multitasking based on the operation system's preemptive multithreading.
• Export the Forth system dictionary into a standalone executable file.

Some useful links

• A set of documentaion files in /docs/, particularly:
  • readme.en.md - Overview
  • intro.en.md - SP-Forth specifics
• The documentation online at https://spf.sourceforge.net/
• Some additional hints in Wiki
• The sources in UTF-8 encoding in the repository spf4-utf8 (since some files in the spf repository are shown incorrectly via the GitHub online viewer)
• https://github.com/yarus23/SPF.JS

How to build from the sources

Clone the sources into your spf4 working tree root directory, as

git clone https://github.com/rufig/spf/ ~/spf4 && cd ~/spf4/src/

or download the ZIP archive and unpack it into your arbitrary spf4 working tree root forlder.

In Windows

Run src/compile.bat — it will build spf4.exe in the spf4 working tree root.

Prerequisites: powershell to download the initial binary.

In Linux

In the sub-directory src/ run make — it will build spf4 in the spf4 working tree root (near to the directorory src).

Prerequisites (in Debian or Ubuntu, as an example):

dpkg --add-architecture i386
apt update
apt install  coreutils ca-certificates git wget build-essential gcc-multilib

In Cygwin

In the sub-directory src/, run make — it will build spf4.exe in the spf4 working tree root.