https://github.com/mynenik/kforth-win32

https://github.com/mynenik/kforth-win32

assembly-language cpp forth programming windows-app

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/mynenik/kforth-win32
• Owner: mynenik
• License: agpl-3.0
• Created: 2020-06-11T17:26:36.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-04-22T12:36:03.000Z (9 months ago)
• Last Synced: 2024-04-22T12:58:12.926Z (9 months ago)
• Topics: assembly-language, cpp, forth, programming, windows-app
• Language: Forth
• Size: 9.76 MB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# kForth-Win32

A 32-bit Forth system for Windows

Copyright © 1998--2023 Krishna Myneni, 

## LICENSE

kForth-Win32 for Windows is provided under the terms of the GNU

Affero General Public License (AGPL), v3.0 or later.

## System Requirements

OS: Windows 10

A prebuilt executable, **kforth.exe**, is provided in the `bin/` folder. The executable may also be run on GNU/Linux x86/x86_64 systems with recent versions of the Windows emulator, Wine.

Development tools required to build the executable from source are:

* Digital Mars C/C++ compiler v 8.57

* A386 assembler v 4.05

The A386 assembler is needed to assemble `vm.asm` to its object file, `vm.obj`. If you do not want to modify `vm.asm` then the A386 assembler is not needed -- the preassembled `vm.obj` is supplied in the `src/` folder.

## Quick Start Instructions

1. Download the `.zip` file for the master or release version you want. The master will contain the most recent features, but a release version will usually be more stable.

2. Extract the files from the `.zip`. They will extract into a separate folder, such as `kForth-Win32-master`.

3. The executable, **kforth.exe**, is found in the sub-folder, `bin/`. Create a shortcut for the executable and drag the shortcut onto your desktop for easy access.

4. The `.exe` file must be able to find its Forth source files, which are located in the subfolder, `forth-src/` of the extracted folder. Create an environment variable, `KFORTH_DIR`, to specify the location of the Forth source files (`.4th`). Follow the steps below to set the environment variable.

5. Go to the Windows toolbar search field and type, "env". Then, click on "*Edit the environment variables for your account.*"

6. Under "*User Variables for* [your account name]", click on "New". Then, set the variable name to `KFORTH_DIR` and the variable value to the full path specifying the location of the `forth-src` folder, *e.g.* `C:\Users\kamala\kForth-Win32-2.0.1\forth-src` . Click "OK".

7. When you launch kForth from its desktop shortcut, it will open up a console and start the Forth environment.

8. Follow the kForth User's Guide, found in the `doc/` subfolder of the package, to learn how to interact with the Forth environment to perform computations, write words, or load Forth programs from text files.