https://github.com/mynenik/kforth-32
32-bit Forth System for x86-linux
https://github.com/mynenik/kforth-32
assembly-language cpp daq forth linux-app programming-language scientific-computing
Last synced: 4 months ago
JSON representation
32-bit Forth System for x86-linux
- Host: GitHub
- URL: https://github.com/mynenik/kforth-32
- Owner: mynenik
- License: agpl-3.0
- Created: 2018-08-26T16:25:35.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-04-25T12:18:30.000Z (9 months ago)
- Last Synced: 2025-04-25T13:30:53.266Z (9 months ago)
- Topics: assembly-language, cpp, daq, forth, linux-app, programming-language, scientific-computing
- Language: Forth
- Size: 7.31 MB
- Stars: 22
- Watchers: 5
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# kForth-32
32-bit Forth System for x86-GNU/Linux
Copyright © 1998--2024 Krishna Myneni,
## LICENSE
kForth-32 for x86-GNU/Linux is provided under the terms of the GNU
Affero General Public License (AGPL), v3.0 or later.
## INSTALLATION
The following packages are required to build and maintain kForth-32 from
its source package, on a GNU/Linux system:
binutils
gcc
gcc-c++
glibc
glibc-devel
libstdc++-devel
make
readline
readline-devel
patchutils
Some or all of these packages may already be installed on your GNU/Linux
system, but if they are not, you should install them for your GNU/Linux
distribution. GNU C/C++ version 4.0 or later should be used.
To build:
1. Unpack the files if you obtained them as a `.zip` or `.tar.gz` file.
2. Change to the `kForth-32-/src/` directory, where *branch* is the project
branch e.g. `master`, and type `make` to build the executables. A successful
build results in two executables, `kforth32` and `kforth32-fast`.
3. Move the executables into the search path. It is recommended to move
the kForth-32 executables to `/usr/local/bin` . You must have superuser
privileges to do this.
4. Specify the default directory in which kforth32 will search for Forth source
files not found in the current directory. The environment variable `KFORTH_DIR`
may be set to this directory. For example, under the BASH shell, if you want
the default directory to be your `~/kForth-32-branch/forth-src/` directory, add the
following lines to your `.bash_profile` file (or `.profile` on some systems):
KFORTH_DIR=~/kForth-32-branch/forth-src
export KFORTH_DIR
## Forth Source Examples
Sample source code files, typically with the extension `.4th`, are
included in the `kForth-32-branch/forth-src/` directory. These files serve as
programming examples for kForth-32, in addition to providing useful
libraries of Forth words and applications written in Forth. Within the
`forth-src/` subdirectory, you will find additional subdirectories containing
different categories of Forth libraries or applications. These include:
`system-test/` A set of automated tests to validate the Forth system against
the Forth-2012 standard
`fsl/` modules for numeric computation from the Forth Scientific Library, including test code;
also note the subdirs, `fsl/extras/` and `fsl/demo/`
`games/` console games written in Forth
`libs/` Forth interfaces to C and Fortran shared object libraries, such
as X11 the GNU Multiprecision Library, gmp, and the GNU
Multiprecision Floating-Point Library, mpfr.
`x11/` A collection of X11 utilities providing a simple interfaces
for plotting, bitmap font handling and text rendering, and
a framework for X11 multi-page applications.
`benchmarks/` simple benchmarks to compare the relative speed of Forth systems
Important system-level files in the `forth-src/` subdirectory include,
* `ans-words.4th` Forth-94 words provided in source form
* `strings.4th` String handling library
* `files.4th` Standard Forth words for file i/o
* `ansi.4th` ANSI terminal control
* `dump.4th` Forth `DUMP` utility
* `ssd.4th` Forth `SEE` utility
* `asm-x86.4th` 32-bit x86 assembler ported to kForth-32
* `modules.4th` A framework for modular programming in Forth
* `serial.4th` Low-level serial port interface
* `syscalls.4th` Operating System calls
* `signal.4th` Signals interface -- see `signals-ex.4th` and `sigfpe.4th`
* `socket.4th` Sockets interface
* `lib-interface.4th` High-level interface to shared object libraries.
* `ttester.4th` Test harness used by automated test code
## Documentation
The current version of the kForth User's Guide is located in `kForth-32-branch/doc/`. A copy of the Forth-2012 standards document is also provided here. Please note important differences between kForth and Forth-2012/ANS Forth, discussed in section 4 of the User's Guide.