by Reuben Thomas email@example.com
pForth is a simple ANS Forth compiler, intended for portability and study. It has been principally used as an environment for building other Forth compilers: metacompiling itself for the Beetle and SMite portable virtual machines and the ARM-based RISC OS; compiling a cut-down version called mForth (now defunct) for RISC OS and Beetle, and building Machine Forth systems.
pForth is released purely in the hope that it might be interesting or useful to someone.
(I am aware that there are other Forth compilers called pForth; the duplication was unintentional.)
pForth comes pre-compiled for the Beetle VM (
SMite VM (
src/smite/pforth.img), and for RISC OS 3 (
doc/pforth.pdf for ANSI conformance information.
Copyright and Disclaimer
The package is distributed under the GNU Public License version 3, or, at your option, any later version. See the file COPYING.
THIS PROGRAM IS PROVIDED AS IS, WITH NO WARRANTY. USE IS AT THE USER'S RISK.
Beetle or RISC OS is required (see above). If the native build architecture is not supported, Beetle is automatically searched for.
To choose the host and/or build system manually, pass the
--build=ARCH arguments to
To give the path to a VM executor, set the
ac_cv_path_BUILD_EXECUTOR environment variables.
To build the documentation, a comprehensive TeX system such as TeXLive is required.
Building a release
From an unpacked release tarball, run:
./configure && make && [sudo] make install
See the file
INSTALL or the output of
./configure --help for more
Building from git
To build from a git checkout, GNU autotools (autoconf and automake) are also required. Run:
git submodule update --init --recursive autoreconf -fi
and then proceed as above for a release build.
Thanks to Hanno Schwalm for improved 0=, U< and U> primitives for the ARM version, and to the authors of RISC Forth, the first Forth system I studied closely, which inspired me to write pForth.
Bugs and comments
Please file bug reports and make comments on GitHub, or by email (see above).
I will probably fix any bugs. Any future development is likely to involve a
total rewrite; I'm particularly interested in rewriting pForth in a more
Forth-like manner (more decomposed, rather than implementing each word as a
single word), and perhaps using object orientation. See