VolksForth/8086/msdos
Philip Zembrod c612a61455 Change INCLUDE so that it saves and restores the tib before and after
interpret-via-tib instead of clearing it after.
This way, commands after a .fth include can be passed to v4fthfile.com,
e.g. a bye to terminate a make-controlled test run.
2022-01-15 23:44:11 +01:00
..
AtariPortfolio created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
cursor created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
emulator - enable run-in-dosbox.sh to include either .fb or .fth files 2022-01-11 23:40:24 +01:00
src Change INCLUDE so that it saves and restores the tib before and after 2022-01-15 23:44:11 +01:00
tests Rename DOS-created uppercase *.FB files to lowercase, with corresponding 2022-01-15 23:26:28 +01:00
ansi.vid created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
asm.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
bios.vid created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
blocking.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
ced.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
disasm.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
disks.cfg created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
dos.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
double.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
editor.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
epson.prn created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
extend.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
f83asm.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
FORTH.COM created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
graphic.prn created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
install.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
kernel.com created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
kernel.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
kernel.org created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
m130i.prn created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
Makefile Rename DOS-created uppercase *.FB files to lowercase, with corresponding 2022-01-15 23:26:28 +01:00
META.COM created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
meta.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
MINIMAL.COM created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
minimal.sys created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
miniterm.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
multi.vid created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
nec8023.prn created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
primed.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
readme.org created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
see.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
serial.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
source.img created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
stream.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
system.cfg created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
tasker.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
timer.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
tools.fb created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
v4thfile.com - enable run-in-dosbox.sh to include either .fb or .fth files 2022-01-11 23:40:24 +01:00
volks4th.com created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00
volks4th.sys created arch directory for 8086 VolksForth 2021-04-11 13:43:39 +02:00

VolksForth MS-DOS README

How to meta-compile a new kernel

After making changes the the Forth kernel source in kernel.fb, restart volksforth.com to have a clean system and compile a new "minimal" kernel with include kernel.fb. This will create a new FORTH.COM executable.

creating a minimal system with a simple editor

Execute forth.com include minimal.sys to generate the file minimal.com which contains a minimal VolksForth system with the Retro-Forth editor https://fossil.forth-ev.de/volksforth/wiki?name=Atari8bit-retrofortheditor

This system can be used to edit the file volksforth.sys or other Forth source block files needed to create a full VolksForth system.

creating a full VolksForth system from the minimal kernel

Execute forth.com include volks4th.sys to create a new fully equipped VolksForth executable volks4th.com.

creating a version of VolksForth that works with emu2

EMU2 is a nice PC Emulator that can run MS-DOS console applications as Linux/MacOS/Windows console applications. EMU2 can be found at https://github.com/dmsc/emu2

The standard Keyboard-Interface of VolksForth (BDOS) does not work with EMU2, however it is possible to switch to the simpler BIOS keyboard interface. For that, comment out the blocks #114 and #115 by placing \\ at the beginning of the first row of these blocks and comment in block #116 by changing the \\ in the first row to \. (\ is "skip to end of line" comment, while \\ is the "skip to end of current block" commend).

The downside of this change is that the VolksForth full screen editor does not work anymore, as the BIOS interface does not support special keys like cursor or function keys. As a replacement, the Retro-Forth Editor rfe.fb or some other Forth Editor can be used.